docs: clarify that only jobs.query and jobs.getQueryResults are affec… (#2349)

tswast · Linchin · web-flow · commit 73228432a3c8 · 2026-01-12T10:09:58.000-08:00
…ted by page_size in query_and_wait Fixes internal issue b/433324499 Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly: - [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/python-bigquery/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [ ] Ensure the tests and linter pass - [ ] Code coverage does not decrease (if any source code was changed) - [ ] Appropriate docs were updated (if necessary) Fixes #<issue_number_goes_here> 🦕 Co-authored-by: Lingqing Gan <lingqing.gan@gmail.com>
diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
@@ -3655,6 +3655,11 @@ def query_and_wait(
             page_size (Optional[int]):
                 The maximum number of rows in each page of results from the
                 initial jobs.query request. Non-positive values are ignored.
+
+                This parameter only affects the jobs.query and
+                jobs.getQueryResults API calls. Large results downloaded with
+                the BigQuery Storage Read API are intentionally unaffected
+                by this parameter.
             max_results (Optional[int]):
                 The maximum total number of rows from this request.
 
