Merge branch 'main' into owl-bot-update-lock-3b3a31be60853477bc39ed8d9bac162cac3ba083724cecaad54eb81d4e4dae9c

chalmerlowe · web-flow · commit 08923ac5090b · 2025-05-12T15:14:33.000-04:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,25 @@
 [1]: https://pypi.org/project/google-cloud-bigquery/#history
 
 
+## [3.32.0](https://github.com/googleapis/python-bigquery/compare/v3.31.0...v3.32.0) (2025-05-12)
+
+
+### Features
+
+* Add dataset access policy version attribute ([#2169](https://github.com/googleapis/python-bigquery/issues/2169)) ([b7656b9](https://github.com/googleapis/python-bigquery/commit/b7656b97c1bd6c204d0508b1851d114719686655))
+* Add preview support for incremental results ([#2145](https://github.com/googleapis/python-bigquery/issues/2145)) ([22b80bb](https://github.com/googleapis/python-bigquery/commit/22b80bba9d0bed319fd3102e567906c9b458dd02))
+* Add WRITE_TRUNCATE_DATA enum ([#2166](https://github.com/googleapis/python-bigquery/issues/2166)) ([4692747](https://github.com/googleapis/python-bigquery/commit/46927479085f13fd326e3f2388f60dfdd37f7f69))
+* Adds condition class and assoc. unit tests ([#2159](https://github.com/googleapis/python-bigquery/issues/2159)) ([a69d6b7](https://github.com/googleapis/python-bigquery/commit/a69d6b796d2edb6ba453980c9553bc9b206c5a6e))
+* Support BigLakeConfiguration (managed Iceberg tables) ([#2162](https://github.com/googleapis/python-bigquery/issues/2162)) ([a1c8e9a](https://github.com/googleapis/python-bigquery/commit/a1c8e9aaf60986924868d54a0ab0334e77002a39))
+* Update the AccessEntry class with a new condition attribute and unit tests ([#2163](https://github.com/googleapis/python-bigquery/issues/2163)) ([7301667](https://github.com/googleapis/python-bigquery/commit/7301667272dfbdd04b1a831418a9ad2d037171fb))
+
+
+### Bug Fixes
+
+* `query()` now warns when `job_id` is set and the default `job_retry` is ignored ([#2167](https://github.com/googleapis/python-bigquery/issues/2167)) ([ca1798a](https://github.com/googleapis/python-bigquery/commit/ca1798aaee2d5905fe688d3097f8ee5c989da333))
+* Empty record dtypes ([#2147](https://github.com/googleapis/python-bigquery/issues/2147)) ([77d7173](https://github.com/googleapis/python-bigquery/commit/77d71736fcc006d3ab8f8ba17955ad5f06e21876))
+* Table iterator should not use bqstorage when page_size is not None ([#2154](https://github.com/googleapis/python-bigquery/issues/2154)) ([e89a707](https://github.com/googleapis/python-bigquery/commit/e89a707b162182ededbf94cc9a0f7594bc2be475))
+
 ## [3.31.0](https://github.com/googleapis/python-bigquery/compare/v3.30.0...v3.31.0) (2025-03-20)
 
 
diff --git a/google/cloud/bigquery/dataset.py b/google/cloud/bigquery/dataset.py
@@ -589,6 +589,7 @@ class Dataset(object):
         "default_rounding_mode": "defaultRoundingMode",
         "resource_tags": "resourceTags",
         "external_catalog_dataset_options": "externalCatalogDatasetOptions",
+        "access_policy_version": "accessPolicyVersion",
     }
 
     def __init__(self, dataset_ref) -> None:
@@ -979,6 +980,16 @@ def external_catalog_dataset_options(self, value):
             self._PROPERTY_TO_API_FIELD["external_catalog_dataset_options"]
         ] = (value.to_api_repr() if value is not None else None)
 
+    @property
+    def access_policy_version(self):
+        return self._properties.get("accessPolicyVersion")
+
+    @access_policy_version.setter
+    def access_policy_version(self, value):
+        if not isinstance(value, int) and value is not None:
+            raise ValueError("Pass an integer, or None")
+        self._properties["accessPolicyVersion"] = value
+
     @classmethod
     def from_string(cls, full_dataset_id: str) -> "Dataset":
         """Construct a dataset from fully-qualified dataset ID.
@@ -1217,8 +1228,8 @@ def from_api_repr(cls, resource: Dict[str, Any]) -> "Condition":
 
         return cls(
             expression=resource["expression"],
-            title=resource.get("title", None),
-            description=resource.get("description", None),
+            title=resource.get("title"),
+            description=resource.get("description"),
         )
 
     def __eq__(self, other: object) -> bool:
diff --git a/google/cloud/bigquery/enums.py b/google/cloud/bigquery/enums.py
@@ -338,6 +338,10 @@ class WriteDisposition(object):
     WRITE_TRUNCATE = "WRITE_TRUNCATE"
     """If the table already exists, BigQuery overwrites the table data."""
 
+    WRITE_TRUNCATE_DATA = "WRITE_TRUNCATE_DATA"
+    """For existing tables, truncate data but preserve existing schema
+    and constraints."""
+
     WRITE_EMPTY = "WRITE_EMPTY"
     """If the table already exists and contains data, a 'duplicate' error is
     returned in the job result."""
diff --git a/google/cloud/bigquery/version.py b/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.31.0"
+__version__ = "3.32.0"
diff --git a/samples/desktopapp/requirements-test.txt b/samples/desktopapp/requirements-test.txt
@@ -1,4 +1,4 @@
-google-cloud-testutils==1.6.0
+google-cloud-testutils==1.6.2
 pytest==8.3.5
 mock==5.2.0
 pytest-xdist==3.6.1
diff --git a/samples/desktopapp/requirements.txt b/samples/desktopapp/requirements.txt
@@ -1,2 +1,2 @@
 google-cloud-bigquery==3.31.0
-google-auth-oauthlib==1.2.1
+google-auth-oauthlib==1.2.2
diff --git a/samples/geography/requirements.txt b/samples/geography/requirements.txt
@@ -1,30 +1,31 @@
 attrs==25.3.0
-certifi==2025.1.31
+certifi==2025.4.26
 cffi==1.17.1
-charset-normalizer==3.4.1
-click==8.1.8
+charset-normalizer==3.4.2
+click===8.1.8; python_version == '3.9'
+click==8.2.0; python_version >= '3.10'
 click-plugins==1.1.1
 cligj==0.7.2
-db-dtypes==1.4.2
+db-dtypes==1.4.3
 Fiona==1.10.1
 geojson==3.2.0
 geopandas==1.0.1
 google-api-core==2.24.2
-google-auth==2.38.0
+google-auth==2.40.1
 google-cloud-bigquery==3.31.0
-google-cloud-bigquery-storage==2.30.0
+google-cloud-bigquery-storage==2.31.0
 google-cloud-core==2.4.3
 google-crc32c==1.7.1
 google-resumable-media==2.7.2
-googleapis-common-protos==1.69.2
+googleapis-common-protos==1.70.0
 grpcio==1.71.0
 idna==3.10
 munch==4.0.0
-mypy-extensions==1.0.0
-packaging==24.2
+mypy-extensions==1.1.0
+packaging==25.0
 pandas==2.2.3
 proto-plus==1.26.1
-pyarrow==19.0.1
+pyarrow==20.0.0
 pyasn1==0.6.1
 pyasn1-modules==0.4.2
 pycparser==2.22
@@ -33,10 +34,10 @@ python-dateutil==2.9.0.post0
 pytz==2025.2
 PyYAML==6.0.2
 requests==2.32.3
-rsa==4.9
+rsa==4.9.1
 Shapely===2.0.7; python_version == '3.9'
 Shapely==2.1.0; python_version >= '3.10'
 six==1.17.0
-typing-extensions==4.13.1
+typing-extensions==4.13.2
 typing-inspect==0.9.0
-urllib3==2.3.0
+urllib3==2.4.0
diff --git a/samples/magics/requirements-test.txt b/samples/magics/requirements-test.txt
@@ -1,4 +1,4 @@
-google-cloud-testutils==1.6.0
+google-cloud-testutils==1.6.2
 pytest==8.3.5
 mock==5.2.0
 pytest-xdist==3.6.1
diff --git a/samples/magics/requirements.txt b/samples/magics/requirements.txt
@@ -1,6 +1,6 @@
 bigquery_magics==0.9.0
-db-dtypes==1.4.2
+db-dtypes==1.4.3
 google.cloud.bigquery==3.31.0
-google-cloud-bigquery-storage==2.30.0
+google-cloud-bigquery-storage==2.31.0
 ipython===8.18.1
 pandas==2.2.3
diff --git a/samples/notebooks/requirements-test.txt b/samples/notebooks/requirements-test.txt
@@ -1,4 +1,4 @@
-google-cloud-testutils==1.6.0
+google-cloud-testutils==1.6.2
 pytest==8.3.5
 mock==5.2.0
 pytest-xdist==3.6.1
diff --git a/samples/notebooks/requirements.txt b/samples/notebooks/requirements.txt
@@ -1,9 +1,9 @@
 bigquery-magics==0.9.0
-db-dtypes==1.4.2
+db-dtypes==1.4.3
 google-cloud-bigquery==3.31.0
-google-cloud-bigquery-storage==2.30.0
+google-cloud-bigquery-storage==2.31.0
 ipython===8.18.1; python_version == '3.9'
-ipython==9.0.2; python_version >= '3.10'
+ipython==9.2.0; python_version >= '3.10'
 matplotlib===3.9.2; python_version == '3.9'
-matplotlib==3.10.1; python_version >= '3.10'
+matplotlib==3.10.3; python_version >= '3.10'
 pandas==2.2.3
diff --git a/samples/snippets/requirements-test.txt b/samples/snippets/requirements-test.txt
@@ -1,5 +1,5 @@
 # samples/snippets should be runnable with no "extras"
-google-cloud-testutils==1.6.0
+google-cloud-testutils==1.6.2
 pytest==8.3.5
 mock==5.2.0
 pytest-xdist==3.6.1
diff --git a/tests/unit/test_dataset.py b/tests/unit/test_dataset.py
@@ -1049,6 +1049,7 @@ def test_ctor_defaults(self):
         self.assertIsNone(dataset.friendly_name)
         self.assertIsNone(dataset.location)
         self.assertEqual(dataset.is_case_insensitive, False)
+        self.assertIsNone(dataset.access_policy_version)
 
     def test_ctor_string(self):
         dataset = self._make_one("some-project.some_dset")
@@ -1423,6 +1424,35 @@ def test_external_catalog_dataset_options_to_api_repr(self):
         expected = api_repr["externalCatalogDatasetOptions"]
         assert result == expected
 
+    def test_access_policy_version_valid_input(self):
+        dataset = self._make_one(self.DS_REF)
+        # Valid inputs for access_policy_version are currently
+        # ints 1, 2, 3, and None
+        # We rely upon the BQ backend to validate acceptable integer
+        # values, rather than perform that validation in the client.
+        for expected in [1, 2, 3, None]:
+            # set property using setter and integer
+            dataset.access_policy_version = expected
+
+            # check getter and _properties dict
+            assert (
+                dataset.access_policy_version == expected
+            ), f"Expected {expected} but got {dataset.access_policy_version}"
+            assert dataset._properties["accessPolicyVersion"] == expected
+
+    def test_access_policy_version_invalid_input(self):
+        dataset = self._make_one(self.DS_REF)
+        # Valid inputs for access_policy_version are currently
+        # ints 1, 2, 3, and None
+
+        with pytest.raises(ValueError):
+            invalid_value = "a string"
+            dataset.access_policy_version = invalid_value
+
+        with pytest.raises(ValueError):
+            invalid_value = 42.0
+            dataset.access_policy_version = invalid_value
+
 
 class TestDatasetListItem(unittest.TestCase):
     @staticmethod

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`google-cloud-bigquery==3.31.0`
`2`		`-google-auth-oauthlib==1.2.1`
	`2`	`+google-auth-oauthlib==1.2.2`