Merge branch 'main' into job-rate-limit

Author: kiraksi

docs/usage/queries.rst

@@ -5,9 +5,9 @@ Querying data
 ^^^^^^^^^^^^^
 
 Run a query and wait for it to finish with the
-:func:`~google.cloud.bigquery.client.Client.query` method:
+:func:`~google.cloud.bigquery.client.Client.query_and_wait` method:
 
-.. literalinclude:: ../samples/client_query.py
+.. literalinclude:: ../samples/snippets/client_query.py
    :language: python
    :dedent: 4
    :start-after: [START bigquery_query]

samples/client_query.py

@@ -61,10 +61,10 @@ def main(project: str) -> None:
     WHERE name = 'William'
     GROUP BY name;
     """
-    query_job = client.query(query_string)
+    results = client.query_and_wait(query_string)
 
     # Print the results.
-    for row in query_job.result():  # Wait for the job to complete.
+    for row in results:  # Wait for the job to complete.
         print("{}: {}".format(row["name"], row["total"]))
     # [END bigquery_auth_user_query]