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: https://github.com/googleapis/googleapis-gen/commit/f31ef2a6afdbff06593f6e6fec26430953f843ba
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: https://github.com/googleapis/googleapis-gen/commit/9c599698f90ae56a61e38a266bd7705614c5dff6
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOWM1OTk2OThmOTBhZTU2YTYxZTM4YTI2NmJkNzcwNTYxNGM1ZGZmNiJ9

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

PiperOrigin-RevId: 667933064

Source-Link: googleapis/googleapis@3165e16

Source-Link: https://github.com/googleapis/googleapis-gen/commit/bcf1bccd00d8d2315c945bba1d93fcfab1999779
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: https://github.com/googleapis/googleapis-gen/commit/1ab1ed59ce43ba96e71cb589704339f3b8c6e524
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 <partheniou@google.com>

Author: gcf-owl-bot[bot]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_create_metastore_partitions_async.py

@@ -0,0 +1,58 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchCreateMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchCreateMetastorePartitions_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+async def sample_batch_create_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceAsyncClient()
+
+    # Initialize request argument(s)
+    requests = bigquery_storage_v1alpha.CreateMetastorePartitionRequest()
+    requests.parent = "parent_value"
+    requests.metastore_partition.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchCreateMetastorePartitionsRequest(
+        parent="parent_value",
+        requests=requests,
+    )
+
+    # Make the request
+    response = await client.batch_create_metastore_partitions(request=request)
+
+    # Handle the response
+    print(response)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchCreateMetastorePartitions_async]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_create_metastore_partitions_sync.py

@@ -0,0 +1,58 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchCreateMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchCreateMetastorePartitions_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+def sample_batch_create_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceClient()
+
+    # Initialize request argument(s)
+    requests = bigquery_storage_v1alpha.CreateMetastorePartitionRequest()
+    requests.parent = "parent_value"
+    requests.metastore_partition.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchCreateMetastorePartitionsRequest(
+        parent="parent_value",
+        requests=requests,
+    )
+
+    # Make the request
+    response = client.batch_create_metastore_partitions(request=request)
+
+    # Handle the response
+    print(response)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchCreateMetastorePartitions_sync]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_delete_metastore_partitions_async.py

@@ -0,0 +1,54 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchDeleteMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchDeleteMetastorePartitions_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+async def sample_batch_delete_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceAsyncClient()
+
+    # Initialize request argument(s)
+    partition_values = bigquery_storage_v1alpha.MetastorePartitionValues()
+    partition_values.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchDeleteMetastorePartitionsRequest(
+        parent="parent_value",
+        partition_values=partition_values,
+    )
+
+    # Make the request
+    await client.batch_delete_metastore_partitions(request=request)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchDeleteMetastorePartitions_async]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_delete_metastore_partitions_sync.py

@@ -0,0 +1,54 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchDeleteMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchDeleteMetastorePartitions_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+def sample_batch_delete_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceClient()
+
+    # Initialize request argument(s)
+    partition_values = bigquery_storage_v1alpha.MetastorePartitionValues()
+    partition_values.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchDeleteMetastorePartitionsRequest(
+        parent="parent_value",
+        partition_values=partition_values,
+    )
+
+    # Make the request
+    client.batch_delete_metastore_partitions(request=request)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchDeleteMetastorePartitions_sync]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_update_metastore_partitions_async.py

@@ -0,0 +1,57 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchUpdateMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchUpdateMetastorePartitions_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+async def sample_batch_update_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceAsyncClient()
+
+    # Initialize request argument(s)
+    requests = bigquery_storage_v1alpha.UpdateMetastorePartitionRequest()
+    requests.metastore_partition.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchUpdateMetastorePartitionsRequest(
+        parent="parent_value",
+        requests=requests,
+    )
+
+    # Make the request
+    response = await client.batch_update_metastore_partitions(request=request)
+
+    # Handle the response
+    print(response)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchUpdateMetastorePartitions_async]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_batch_update_metastore_partitions_sync.py

@@ -0,0 +1,57 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchUpdateMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchUpdateMetastorePartitions_sync]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+def sample_batch_update_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceClient()
+
+    # Initialize request argument(s)
+    requests = bigquery_storage_v1alpha.UpdateMetastorePartitionRequest()
+    requests.metastore_partition.values = ["values_value1", "values_value2"]
+
+    request = bigquery_storage_v1alpha.BatchUpdateMetastorePartitionsRequest(
+        parent="parent_value",
+        requests=requests,
+    )
+
+    # Make the request
+    response = client.batch_update_metastore_partitions(request=request)
+
+    # Handle the response
+    print(response)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_BatchUpdateMetastorePartitions_sync]

bigquery_storage/generated_samples/bigquerystorage_v1alpha_generated_metastore_partition_service_list_metastore_partitions_async.py

@@ -0,0 +1,53 @@
+# -*- 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for ListMetastorePartitions
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-bigquery-storage
+
+
+# [START bigquerystorage_v1alpha_generated_MetastorePartitionService_ListMetastorePartitions_async]
+# This snippet has been automatically generated and should be regarded as a
+# code template only.
+# It will require modifications to work:
+# - It may require correct/in-range values for request initialization.
+# - It may require specifying regional endpoints when creating the service
+#   client as shown in:
+#   https://googleapis.dev/python/google-api-core/latest/client_options.html
+from google.cloud import bigquery_storage_v1alpha
+
+
+async def sample_list_metastore_partitions():
+    # Create a client
+    client = bigquery_storage_v1alpha.MetastorePartitionServiceAsyncClient()
+
+    # Initialize request argument(s)
+    request = bigquery_storage_v1alpha.ListMetastorePartitionsRequest(
+        parent="parent_value",
+    )
+
+    # Make the request
+    response = await client.list_metastore_partitions(request=request)
+
+    # Handle the response
+    print(response)
+
+
+# [END bigquerystorage_v1alpha_generated_MetastorePartitionService_ListMetastorePartitions_async]