feat: Add BigQuery Metastore Partition Service API version v1alpha (#817

)

* chore(python): Use `google.cloud.bigquery_storage` instead of `google.cloud.bigquery.storage` for v1alpha

PiperOrigin-RevId: 666369744

Source-Link: googleapis/googleapis@63947bf

Source-Link: googleapis/googleapis-gen@f31ef2a
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZjMxZWYyYTZhZmRiZmYwNjU5M2Y2ZTZmZWMyNjQzMDk1M2Y4NDNiYSJ9

* feat: add documentation for partition value limit

BREAKING CHANGE: make the client library gRPC only

PiperOrigin-RevId: 666551276

Source-Link: googleapis/googleapis@6f3c628

Source-Link: googleapis/googleapis-gen@9c59969
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOWM1OTk2OThmOTBhZTU2YTYxZTM4YTI2NmJkNzcwNTYxNGM1ZGZmNiJ9

* build: Only generate gRPC clients for google/cloud/bigquery/storage/v1alpha

PiperOrigin-RevId: 667933064

Source-Link: googleapis/googleapis@3165e16

Source-Link: googleapis/googleapis-gen@bcf1bcc
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmNmMWJjY2QwMGQ4ZDIzMTVjOTQ1YmJhMWQ5M2ZjZmFiMTk5OTc3OSJ9

* exclude replacements for v1alpha

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* Update docs/index.rst; add gapic_version.py

* docs: A comment for message `StreamMetastorePartitionsRequest` is changed
docs: A comment for message `StreamMetastorePartitionsResponse` is changed
docs: A comment for field `location_uri` in message `.google.cloud.bigquery.storage.v1alpha.StorageDescriptor` is changed

PiperOrigin-RevId: 670602530

Source-Link: googleapis/googleapis@9c6ceea

Source-Link: googleapis/googleapis-gen@1ab1ed5
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMWFiMWVkNTljZTQzYmE5NmU3MWNiNTg5NzA0MzM5ZjNiOGM2ZTUyNCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <[email protected]>

docs/bigquery_storage_v1alpha/metastore_partition_service.rst

@@ -0,0 +1,6 @@
+MetastorePartitionService
+-------------------------------------------
+
+.. automodule:: google.cloud.bigquery_storage_v1alpha.services.metastore_partition_service
+    :members:
+    :inherited-members:

docs/bigquery_storage_v1alpha/services_.rst

@@ -0,0 +1,6 @@
+Services for Google Cloud Bigquery Storage v1alpha API
+======================================================
+.. toctree::
+    :maxdepth: 2
+
+    metastore_partition_service

docs/bigquery_storage_v1alpha/types_.rst

@@ -0,0 +1,6 @@
+Types for Google Cloud Bigquery Storage v1alpha API
+===================================================
+
+.. automodule:: google.cloud.bigquery_storage_v1alpha.types
+    :members:
+    :show-inheritance:

docs/index.rst

@@ -24,6 +24,8 @@ API Reference
     bigquery_storage_v1beta2/library
     bigquery_storage_v1beta2/services_
     bigquery_storage_v1beta2/types_
+    bigquery_storage_v1alpha/services_
+    bigquery_storage_v1alpha/types_
 
 
 Migration Guide

google/cloud/bigquery_storage_v1alpha/gapic_metadata.json

@@ -0,0 +1,73 @@
+ {
+  "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+  "language": "python",
+  "libraryPackage": "google.cloud.bigquery_storage_v1alpha",
+  "protoPackage": "google.cloud.bigquery.storage.v1alpha",
+  "schema": "1.0",
+  "services": {
+    "MetastorePartitionService": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "MetastorePartitionServiceClient",
+          "rpcs": {
+            "BatchCreateMetastorePartitions": {
+              "methods": [
+                "batch_create_metastore_partitions"
+              ]
+            },
+            "BatchDeleteMetastorePartitions": {
+              "methods": [
+                "batch_delete_metastore_partitions"
+              ]
+            },
+            "BatchUpdateMetastorePartitions": {
+              "methods": [
+                "batch_update_metastore_partitions"
+              ]
+            },
+            "ListMetastorePartitions": {
+              "methods": [
+                "list_metastore_partitions"
+              ]
+            },
+            "StreamMetastorePartitions": {
+              "methods": [
+                "stream_metastore_partitions"
+              ]
+            }
+          }
+        },
+        "grpc-async": {
+          "libraryClient": "MetastorePartitionServiceAsyncClient",
+          "rpcs": {
+            "BatchCreateMetastorePartitions": {
+              "methods": [
+                "batch_create_metastore_partitions"
+              ]
+            },
+            "BatchDeleteMetastorePartitions": {
+              "methods": [
+                "batch_delete_metastore_partitions"
+              ]
+            },
+            "BatchUpdateMetastorePartitions": {
+              "methods": [
+                "batch_update_metastore_partitions"
+              ]
+            },
+            "ListMetastorePartitions": {
+              "methods": [
+                "list_metastore_partitions"
+              ]
+            },
+            "StreamMetastorePartitions": {
+              "methods": [
+                "stream_metastore_partitions"
+              ]
+            }
+          }
+        }
+      }
+    }
+  }
+}

google/cloud/bigquery_storage_v1alpha/gapic_version.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+__version__ = "2.25.0"  # {x-release-please-version}

google/cloud/bigquery_storage_v1alpha/py.typed

@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-bigquery-storage package uses inline types.

google/cloud/bigquery_storage_v1alpha/services/__init__.py

@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#

google/cloud/bigquery_storage_v1alpha/services/metastore_partition_service/__init__.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from .async_client import MetastorePartitionServiceAsyncClient
+from .client import MetastorePartitionServiceClient
+
+__all__ = (
+    "MetastorePartitionServiceClient",
+    "MetastorePartitionServiceAsyncClient",
+)