feat: add support for ssl credentials; add throttled field to UpdateDatabaseDdlMetadata (#161)

* changes without context

        autosynth cannot find the source of changes triggered by earlier changes in this
        repository, or by version upgrades to tools such as linters.

* chore: revert breaking docstrings and unneeded bigquery doc ignore

Co-authored-by: larkee <[email protected]>

Author: yoshi-automation

docs/spanner_admin_database_v1/types.rst

@@ -3,3 +3,4 @@ Types for Google Cloud Spanner Admin Database v1 API
 
 .. automodule:: google.cloud.spanner_admin_database_v1.types
     :members:
+    :show-inheritance:

docs/spanner_admin_instance_v1/types.rst

@@ -3,3 +3,4 @@ Types for Google Cloud Spanner Admin Instance v1 API
 
 .. automodule:: google.cloud.spanner_admin_instance_v1.types
     :members:
+    :show-inheritance:

docs/spanner_v1/types.rst

@@ -3,3 +3,4 @@ Types for Google Cloud Spanner v1 API
 
 .. automodule:: google.cloud.spanner_v1.types
     :members:
+    :show-inheritance:

google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto

@@ -514,6 +514,11 @@ message UpdateDatabaseDdlMetadata {
   // succeeded so far, where `commit_timestamps[i]` is the commit
   // timestamp for the statement `statements[i]`.
   repeated google.protobuf.Timestamp commit_timestamps = 3;
+
+  // Output only. When true, indicates that the operation is throttled e.g
+  // due to resource constraints. When resources become available the operation
+  // will resume and this field will be false again.
+  bool throttled = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].

google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc.py

@@ -113,13 +113,16 @@ def __init__(
           google.api_core.exceptions.DuplicateCredentialArgs: If both ``credentials``
               and ``credentials_file`` are passed.
         """
+        self._ssl_channel_credentials = ssl_channel_credentials
+
         if channel:
             # Sanity check: Ensure that channel and credentials are not both
             # provided.
             credentials = False
 
             # If a channel was explicitly provided, set it.
             self._grpc_channel = channel
+            self._ssl_channel_credentials = None
         elif api_mtls_endpoint:
             warnings.warn(
                 "api_mtls_endpoint and client_cert_source are deprecated",
@@ -156,6 +159,7 @@ def __init__(
                 scopes=scopes or self.AUTH_SCOPES,
                 quota_project_id=quota_project_id,
             )
+            self._ssl_channel_credentials = ssl_credentials
         else:
             host = host if ":" in host else host + ":443"
 

google/cloud/spanner_admin_database_v1/services/database_admin/transports/grpc_asyncio.py

@@ -158,13 +158,16 @@ def __init__(
           google.api_core.exceptions.DuplicateCredentialArgs: If both ``credentials``
               and ``credentials_file`` are passed.
         """
+        self._ssl_channel_credentials = ssl_channel_credentials
+
         if channel:
             # Sanity check: Ensure that channel and credentials are not both
             # provided.
             credentials = False
 
             # If a channel was explicitly provided, set it.
             self._grpc_channel = channel
+            self._ssl_channel_credentials = None
         elif api_mtls_endpoint:
             warnings.warn(
                 "api_mtls_endpoint and client_cert_source are deprecated",
@@ -201,6 +204,7 @@ def __init__(
                 scopes=scopes or self.AUTH_SCOPES,
                 quota_project_id=quota_project_id,
             )
+            self._ssl_channel_credentials = ssl_credentials
         else:
             host = host if ":" in host else host + ":443"
 

google/cloud/spanner_admin_database_v1/types/spanner_database_admin.py

@@ -287,6 +287,12 @@ class UpdateDatabaseDdlMetadata(proto.Message):
             Reports the commit timestamps of all statements that have
             succeeded so far, where ``commit_timestamps[i]`` is the
             commit timestamp for the statement ``statements[i]``.
+        throttled (bool):
+            Output only. When true, indicates that the
+            operation is throttled e.g due to resource
+            constraints. When resources become available the
+            operation will resume and this field will be
+            false again.
     """
 
     database = proto.Field(proto.STRING, number=1)
@@ -297,6 +303,8 @@ class UpdateDatabaseDdlMetadata(proto.Message):
         proto.MESSAGE, number=3, message=timestamp.Timestamp,
     )
 
+    throttled = proto.Field(proto.BOOL, number=4)
+
 
 class DropDatabaseRequest(proto.Message):
     r"""The request for

google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc.py

@@ -126,13 +126,16 @@ def __init__(
           google.api_core.exceptions.DuplicateCredentialArgs: If both ``credentials``
               and ``credentials_file`` are passed.
         """
+        self._ssl_channel_credentials = ssl_channel_credentials
+
         if channel:
             # Sanity check: Ensure that channel and credentials are not both
             # provided.
             credentials = False
 
             # If a channel was explicitly provided, set it.
             self._grpc_channel = channel
+            self._ssl_channel_credentials = None
         elif api_mtls_endpoint:
             warnings.warn(
                 "api_mtls_endpoint and client_cert_source are deprecated",
@@ -169,6 +172,7 @@ def __init__(
                 scopes=scopes or self.AUTH_SCOPES,
                 quota_project_id=quota_project_id,
             )
+            self._ssl_channel_credentials = ssl_credentials
         else:
             host = host if ":" in host else host + ":443"
 

google/cloud/spanner_admin_instance_v1/services/instance_admin/transports/grpc_asyncio.py

@@ -171,13 +171,16 @@ def __init__(
           google.api_core.exceptions.DuplicateCredentialArgs: If both ``credentials``
               and ``credentials_file`` are passed.
         """
+        self._ssl_channel_credentials = ssl_channel_credentials
+
         if channel:
             # Sanity check: Ensure that channel and credentials are not both
             # provided.
             credentials = False
 
             # If a channel was explicitly provided, set it.
             self._grpc_channel = channel
+            self._ssl_channel_credentials = None
         elif api_mtls_endpoint:
             warnings.warn(
                 "api_mtls_endpoint and client_cert_source are deprecated",
@@ -214,6 +217,7 @@ def __init__(
                 scopes=scopes or self.AUTH_SCOPES,
                 quota_project_id=quota_project_id,
             )
+            self._ssl_channel_credentials = ssl_credentials
         else:
             host = host if ":" in host else host + ":443"
 

google/cloud/spanner_v1/services/spanner/transports/grpc.py

@@ -106,13 +106,16 @@ def __init__(
           google.api_core.exceptions.DuplicateCredentialArgs: If both ``credentials``
               and ``credentials_file`` are passed.
         """
+        self._ssl_channel_credentials = ssl_channel_credentials
+
         if channel:
             # Sanity check: Ensure that channel and credentials are not both
             # provided.
             credentials = False
 
             # If a channel was explicitly provided, set it.
             self._grpc_channel = channel
+            self._ssl_channel_credentials = None
         elif api_mtls_endpoint:
             warnings.warn(
                 "api_mtls_endpoint and client_cert_source are deprecated",
@@ -149,6 +152,7 @@ def __init__(
                 scopes=scopes or self.AUTH_SCOPES,
                 quota_project_id=quota_project_id,
             )
+            self._ssl_channel_credentials = ssl_credentials
         else:
             host = host if ":" in host else host + ":443"