Merge branch 'main' into incstats

Author: shollyman

CHANGELOG.md

@@ -5,6 +5,24 @@
 [1]: https://pypi.org/project/google-cloud-bigquery/#history
 
 
+## [3.37.0](https://github.com/googleapis/python-bigquery/compare/v3.36.0...v3.37.0) (2025-09-08)
+
+
+### Features
+
+* Updates to fastpath query execution ([#2268](https://github.com/googleapis/python-bigquery/issues/2268)) ([ef2740a](https://github.com/googleapis/python-bigquery/commit/ef2740a158199633b5543a7b6eb19587580792cd))
+
+
+### Bug Fixes
+
+* Remove deepcopy while setting properties for _QueryResults ([#2280](https://github.com/googleapis/python-bigquery/issues/2280)) ([33ea296](https://github.com/googleapis/python-bigquery/commit/33ea29616c06a2e2a106a785d216e784737ae386))
+
+
+### Documentation
+
+* Clarify that the presence of `XyzJob.errors`  doesn't necessarily mean that the job has not completed or was unsuccessful ([#2278](https://github.com/googleapis/python-bigquery/issues/2278)) ([6e88d7d](https://github.com/googleapis/python-bigquery/commit/6e88d7dbe42ebfc35986da665d656b49ac481db4))
+* Clarify the api_method arg for client.query() ([#2277](https://github.com/googleapis/python-bigquery/issues/2277)) ([8a13c12](https://github.com/googleapis/python-bigquery/commit/8a13c12905ffcb3dbb6086a61df37556f0c2cd31))
+
 ## [3.36.0](https://github.com/googleapis/python-bigquery/compare/v3.35.1...v3.36.0) (2025-08-20)
 
 

google/cloud/bigquery/job/base.py

@@ -693,7 +693,12 @@ def transaction_info(self) -> Optional[TransactionInfo]:
 
     @property
     def error_result(self):
-        """Error information about the job as a whole.
+        """Output only. Final error result of the job.
+
+        If present, indicates that the job has completed and was unsuccessful.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobStatus.FIELDS.error_result
 
         Returns:
             Optional[Mapping]: the error information (None until set from the server).
@@ -704,7 +709,13 @@ def error_result(self):
 
     @property
     def errors(self):
-        """Information about individual errors generated by the job.
+        """Output only. The first errors encountered during the running of the job.
+
+        The final message includes the number of errors that caused the process to stop.
+        Errors here do not necessarily mean that the job has not completed or was unsuccessful.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobStatus.FIELDS.errors
 
         Returns:
             Optional[List[Mapping]]:
@@ -716,7 +727,12 @@ def errors(self):
 
     @property
     def state(self):
-        """Status of the job.
+        """Output only. Running state of the job.
+
+        Valid states include 'PENDING', 'RUNNING', and 'DONE'.
+
+        See:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobStatus.FIELDS.state
 
         Returns:
             Optional[str]:

google/cloud/bigquery/query.py

@@ -1400,7 +1400,7 @@ def _set_properties(self, api_response):
             api_response (Dict): Response returned from an API call
         """
         self._properties.clear()
-        self._properties.update(copy.deepcopy(api_response))
+        self._properties.update(api_response)
 
 
 def _query_param_from_api_repr(resource):

google/cloud/bigquery/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "3.36.0"
+__version__ = "3.37.0"