From 1d257067a592f9169372afa027e85304a0afa87c Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 13 May 2020 05:38:34 -0700 Subject: [PATCH 1/2] [CHANGE ME] Re-generated to pick up changes in the API or client library generator. --- .kokoro/publish-docs.sh | 2 - docs/multiprocessing.rst | 7 + .../gapic/database_admin_client.py | 84 +-- .../gapic/database_admin_client_config.py | 10 +- .../spanner_admin_database_v1/gapic/enums.py | 8 +- .../database_admin_grpc_transport.py | 22 +- .../proto/backup_pb2.py | 253 ++++---- .../proto/common_pb2.py | 25 +- .../proto/spanner_database_admin_pb2.py | 433 ++++++------- .../proto/spanner_database_admin_pb2_grpc.py | 92 +-- .../spanner_admin_instance_v1/gapic/enums.py | 3 +- .../gapic/instance_admin_client.py | 38 +- .../instance_admin_grpc_transport.py | 2 +- .../proto/spanner_instance_admin_pb2.py | 355 +++++------ .../proto/spanner_instance_admin_pb2_grpc.py | 46 +- google/cloud/spanner_v1/gapic/enums.py | 32 +- .../cloud/spanner_v1/gapic/spanner_client.py | 119 ++-- .../transports/spanner_grpc_transport.py | 40 +- google/cloud/spanner_v1/proto/keys_pb2.py | 91 ++- google/cloud/spanner_v1/proto/mutation_pb2.py | 69 +-- .../cloud/spanner_v1/proto/query_plan_pb2.py | 93 ++- .../cloud/spanner_v1/proto/result_set_pb2.py | 145 +++-- google/cloud/spanner_v1/proto/spanner_pb2.py | 578 ++++++++---------- .../cloud/spanner_v1/proto/transaction_pb2.py | 121 ++-- google/cloud/spanner_v1/proto/type_pb2.py | 51 +- synth.metadata | 24 +- 26 files changed, 1251 insertions(+), 1492 deletions(-) create mode 100644 docs/multiprocessing.rst diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index bc384fe0ce..92506af8f8 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -13,8 +13,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -#!/bin/bash - set -eo pipefail # Disable buffering, so that the logs stream through. diff --git a/docs/multiprocessing.rst b/docs/multiprocessing.rst new file mode 100644 index 0000000000..1cb29d4ca9 --- /dev/null +++ b/docs/multiprocessing.rst @@ -0,0 +1,7 @@ +.. note:: + + Because this client uses :mod:`grpcio` library, it is safe to + share instances across threads. In multiprocessing scenarios, the best + practice is to create client instances *after* the invocation of + :func:`os.fork` by :class:`multiprocessing.Pool` or + :class:`multiprocessing.Process`. diff --git a/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py b/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py index f41559acc1..849f37160a 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py +++ b/google/cloud/spanner_admin_database_v1/gapic/database_admin_client.py @@ -273,11 +273,11 @@ def create_database( Args: parent (str): Required. The name of the instance that will serve the new database. Values are of the form ``projects//instances/``. - create_statement (str): Required. A ``CREATE DATABASE`` statement, which specifies the ID of the - new database. The database ID must conform to the regular expression + create_statement (str): Required. A ``CREATE DATABASE`` statement, which specifies the ID of + the new database. The database ID must conform to the regular expression ``[a-z][a-z0-9_\-]*[a-z0-9]`` and be between 2 and 30 characters in length. If the database ID is a reserved word or if it contains a - hyphen, the database ID must be enclosed in backticks (`````). + hyphen, the database ID must be enclosed in backticks (:literal:`\``). extra_statements (list[str]): Optional. A list of DDL statements to run inside the newly created database. Statements can create tables, indexes, etc. These statements execute atomically with the creation of the database: @@ -451,9 +451,9 @@ def update_database_ddl( Args: database (str): Required. The database to update. statements (list[str]): Required. DDL statements to be applied to the database. - operation_id (str): If empty, the new update request is assigned an automatically-generated - operation ID. Otherwise, ``operation_id`` is used to construct the name - of the resulting ``Operation``. + operation_id (str): If empty, the new update request is assigned an + automatically-generated operation ID. Otherwise, ``operation_id`` is + used to construct the name of the resulting ``Operation``. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the ``UpdateDatabaseDdl`` @@ -530,8 +530,8 @@ def drop_database( metadata=None, ): """ - Drops (aka deletes) a Cloud Spanner database. Completed backups for the - database will be retained according to their ``expire_time``. + Drops (aka deletes) a Cloud Spanner database. Completed backups for + the database will be retained according to their ``expire_time``. Example: >>> from google.cloud import spanner_admin_database_v1 @@ -597,9 +597,9 @@ def get_database_ddl( metadata=None, ): """ - Returns the schema of a Cloud Spanner database as a list of formatted - DDL statements. This method does not show pending schema updates, those - may be queried using the ``Operations`` API. + Returns the schema of a Cloud Spanner database as a list of + formatted DDL statements. This method does not show pending schema + updates, those may be queried using the ``Operations`` API. Example: >>> from google.cloud import spanner_admin_database_v1 @@ -845,10 +845,10 @@ def test_iam_permissions( backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result - in a NOT\_FOUND error if the user has ``spanner.databases.list`` + in a NOT_FOUND error if the user has ``spanner.databases.list`` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does - not exist will result in a NOT\_FOUND error if the user has + not exist will result in a NOT_FOUND error if the user has ``spanner.backups.list`` permission on the containing instance. Example: @@ -867,8 +867,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -966,13 +966,13 @@ def create_backup( >>> metadata = response.metadata() Args: - parent (str): Required. The name of the instance in which the backup will be created. - This must be the same instance that contains the database the backup - will be created from. The backup will be stored in the location(s) - specified in the instance configuration of this instance. Values are of - the form ``projects//instances/``. - backup_id (str): Required. The id of the backup to be created. The ``backup_id`` appended - to ``parent`` forms the full backup name of the form + parent (str): Required. The name of the instance in which the backup will be + created. This must be the same instance that contains the database the + backup will be created from. The backup will be stored in the + location(s) specified in the instance configuration of this instance. + Values are of the form ``projects//instances/``. + backup_id (str): Required. The id of the backup to be created. The ``backup_id`` + appended to ``parent`` forms the full backup name of the form ``projects//instances//backups/``. backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to create. @@ -1129,18 +1129,18 @@ def update_backup( >>> response = client.update_backup(backup, update_mask) Args: - backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to update. ``backup.name``, and the fields to be - updated as specified by ``update_mask`` are required. Other fields are - ignored. Update is only supported for the following fields: + backup (Union[dict, ~google.cloud.spanner_admin_database_v1.types.Backup]): Required. The backup to update. ``backup.name``, and the fields to + be updated as specified by ``update_mask`` are required. Other fields + are ignored. Update is only supported for the following fields: - ``backup.expire_time``. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_admin_database_v1.types.Backup` - update_mask (Union[dict, ~google.cloud.spanner_admin_database_v1.types.FieldMask]): Required. A mask specifying which fields (e.g. ``expire_time``) in the - Backup resource should be updated. This mask is relative to the Backup - resource, not to the request message. The field mask must always be - specified; this prevents any future fields from being erased + update_mask (Union[dict, ~google.cloud.spanner_admin_database_v1.types.FieldMask]): Required. A mask specifying which fields (e.g. ``expire_time``) in + the Backup resource should be updated. This mask is relative to the + Backup resource, not to the request message. The field mask must always + be specified; this prevents any future fields from being erased accidentally by clients that do not know about them. If a dict is provided, it must be of the same form as the protobuf @@ -1450,9 +1450,9 @@ def restore_database( database. This instance must be in the same project and have the same instance configuration as the instance containing the source backup. Values are of the form ``projects//instances/``. - database_id (str): Required. The id of the database to create and restore to. This database - must not already exist. The ``database_id`` appended to ``parent`` forms - the full database name of the form + database_id (str): Required. The id of the database to create and restore to. This + database must not already exist. The ``database_id`` appended to + ``parent`` forms the full database name of the form ``projects//instances//databases/``. backup (str): Name of the backup from which to restore. Values are of the form ``projects//instances//backups/``. @@ -1526,8 +1526,8 @@ def list_database_operations( metadata=None, ): """ - Lists database ``longrunning-operations``. A database operation has a - name of the form + Lists database ``longrunning-operations``. A database operation has + a name of the form ``projects//instances//databases//operations/``. The long-running operation ``metadata`` field type ``metadata.type_url`` describes the type of the metadata. Operations returned include those @@ -1594,8 +1594,8 @@ def list_database_operations( - The operation's metadata type is ``RestoreDatabaseMetadata``. - The database is restored from a backup. - - The backup name contains "backup\_howl". - - The restored database's name contains "restored\_howl". + - The backup name contains "backup_howl". + - The restored database's name contains "restored_howl". - The operation started before 2018-03-28T14:50:00Z. - The operation resulted in an error. page_size (int): The maximum number of resources contained in the @@ -1677,8 +1677,8 @@ def list_backup_operations( metadata=None, ): """ - Lists the backup ``long-running operations`` in the given instance. A - backup operation has a name of the form + Lists the backup ``long-running operations`` in the given instance. + A backup operation has a name of the form ``projects//instances//backups//operations/``. The long-running operation ``metadata`` field type ``metadata.type_url`` describes the type of the metadata. Operations returned include those @@ -1709,8 +1709,8 @@ def list_backup_operations( ... pass Args: - parent (str): Required. The instance of the backup operations. Values are of the form - ``projects//instances/``. + parent (str): Required. The instance of the backup operations. Values are of the + form ``projects//instances/``. filter_ (str): An expression that filters the list of returned backup operations. A filter expression consists of a field name, a comparison operator, and @@ -1851,8 +1851,8 @@ def list_databases( ... pass Args: - parent (str): Required. The instance whose databases should be listed. Values are of - the form ``projects//instances/``. + parent (str): Required. The instance whose databases should be listed. Values are + of the form ``projects//instances/``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page diff --git a/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py b/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py index c82216409b..d5d61cbae7 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py +++ b/google/cloud/spanner_admin_database_v1/gapic/database_admin_client_config.py @@ -63,12 +63,12 @@ "retry_params_name": "default", }, "GetBackup": { - "timeout_millis": 30000, + "timeout_millis": 600000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "UpdateBackup": { - "timeout_millis": 30000, + "timeout_millis": 600000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, @@ -78,7 +78,7 @@ "retry_params_name": "default", }, "ListBackups": { - "timeout_millis": 30000, + "timeout_millis": 600000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, @@ -88,12 +88,12 @@ "retry_params_name": "default", }, "ListDatabaseOperations": { - "timeout_millis": 30000, + "timeout_millis": 600000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "ListBackupOperations": { - "timeout_millis": 30000, + "timeout_millis": 600000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, diff --git a/google/cloud/spanner_admin_database_v1/gapic/enums.py b/google/cloud/spanner_admin_database_v1/gapic/enums.py index d972ddfc57..575cb3a8f7 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/enums.py +++ b/google/cloud/spanner_admin_database_v1/gapic/enums.py @@ -39,8 +39,8 @@ class State(enum.IntEnum): Attributes: STATE_UNSPECIFIED (int): Not specified. - CREATING (int): The pending backup is still being created. Operations on the backup may - fail with ``FAILED_PRECONDITION`` in this state. + CREATING (int): The pending backup is still being created. Operations on the backup + may fail with ``FAILED_PRECONDITION`` in this state. READY (int): The backup is complete and ready for use. """ @@ -56,8 +56,8 @@ class State(enum.IntEnum): Attributes: STATE_UNSPECIFIED (int): Not specified. - CREATING (int): The database is still being created. Operations on the database may fail - with ``FAILED_PRECONDITION`` in this state. + CREATING (int): The database is still being created. Operations on the database may + fail with ``FAILED_PRECONDITION`` in this state. READY (int): The database is fully created and ready for use. READY_OPTIMIZING (int): The database is fully created and ready for use, but is still being optimized for performance and cannot handle full load. diff --git a/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py b/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py index 2fb41caab2..e6496e2879 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py +++ b/google/cloud/spanner_admin_database_v1/gapic/transports/database_admin_grpc_transport.py @@ -173,8 +173,8 @@ def update_database_ddl(self): def drop_database(self): """Return the gRPC stub for :meth:`DatabaseAdminClient.drop_database`. - Drops (aka deletes) a Cloud Spanner database. Completed backups for the - database will be retained according to their ``expire_time``. + Drops (aka deletes) a Cloud Spanner database. Completed backups for + the database will be retained according to their ``expire_time``. Returns: Callable: A callable which accepts the appropriate @@ -187,9 +187,9 @@ def drop_database(self): def get_database_ddl(self): """Return the gRPC stub for :meth:`DatabaseAdminClient.get_database_ddl`. - Returns the schema of a Cloud Spanner database as a list of formatted - DDL statements. This method does not show pending schema updates, those - may be queried using the ``Operations`` API. + Returns the schema of a Cloud Spanner database as a list of + formatted DDL statements. This method does not show pending schema + updates, those may be queried using the ``Operations`` API. Returns: Callable: A callable which accepts the appropriate @@ -243,10 +243,10 @@ def test_iam_permissions(self): backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result - in a NOT\_FOUND error if the user has ``spanner.databases.list`` + in a NOT_FOUND error if the user has ``spanner.databases.list`` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does - not exist will result in a NOT\_FOUND error if the user has + not exist will result in a NOT_FOUND error if the user has ``spanner.backups.list`` permission on the containing instance. Returns: @@ -360,8 +360,8 @@ def restore_database(self): def list_database_operations(self): """Return the gRPC stub for :meth:`DatabaseAdminClient.list_database_operations`. - Lists database ``longrunning-operations``. A database operation has a - name of the form + Lists database ``longrunning-operations``. A database operation has + a name of the form ``projects//instances//databases//operations/``. The long-running operation ``metadata`` field type ``metadata.type_url`` describes the type of the metadata. Operations returned include those @@ -379,8 +379,8 @@ def list_database_operations(self): def list_backup_operations(self): """Return the gRPC stub for :meth:`DatabaseAdminClient.list_backup_operations`. - Lists the backup ``long-running operations`` in the given instance. A - backup operation has a name of the form + Lists the backup ``long-running operations`` in the given instance. + A backup operation has a name of the form ``projects//instances//backups//operations/``. The long-running operation ``metadata`` field type ``metadata.type_url`` describes the type of the metadata. Operations returned include those diff --git a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py index 2d13e69a87..5fdafde823 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner/admin/database_v1/proto/backup.proto +# source: google/cloud/spanner_admin_database_v1/proto/backup.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -23,28 +20,24 @@ from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.cloud.spanner_admin_database_v1.proto import ( - common_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2, + common_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2, ) from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner/admin/database_v1/proto/backup.proto", + name="google/cloud/spanner_admin_database_v1/proto/backup.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=_b( - "\n$com.google.spanner.admin.database.v1B\013BackupProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1" - ), - serialized_pb=_b( - '\n9google/cloud/spanner/admin/database_v1/proto/backup.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/common.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x03\n\x06\x42\x61\x63kup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x05 \x01(\x03\x42\x03\xe0\x41\x03\x12\x42\n\x05state\x18\x06 \x01(\x0e\x32..google.spanner.admin.database.v1.Backup.StateB\x03\xe0\x41\x03\x12"\n\x15referencing_databases\x18\x07 \x03(\tB\x03\xe0\x41\x03"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:\\\xea\x41Y\n\x1dspanner.googleapis.com/Backup\x12\x38projects/{project}/instances/{instance}/backups/{backup}"\xa5\x01\n\x13\x43reateBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12=\n\x06\x62\x61\x63kup\x18\x03 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02"\xae\x01\n\x14\x43reateBackupMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08\x64\x61tabase\x18\x02 \x01(\t\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8a\x01\n\x13UpdateBackupRequest\x12=\n\x06\x62\x61\x63kup\x18\x01 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"G\n\x10GetBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"J\n\x13\x44\x65leteBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"\x84\x01\n\x12ListBackupsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"i\n\x13ListBackupsResponse\x12\x39\n\x07\x62\x61\x63kups\x18\x01 \x03(\x0b\x32(.google.spanner.admin.database.v1.Backup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8d\x01\n\x1bListBackupOperationsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"j\n\x1cListBackupOperationsResponse\x12\x31\n\noperations\x18\x01 \x03(\x0b\x32\x1d.google.longrunning.Operation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"f\n\nBackupInfo\x12\x0e\n\x06\x62\x61\x63kup\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fsource_database\x18\x03 \x01(\tB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x42\x61\x63kupProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3' - ), + serialized_options=b"\n$com.google.spanner.admin.database.v1B\013BackupProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1", + serialized_pb=b'\n9google/cloud/spanner_admin_database_v1/proto/backup.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/common.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x03\n\x06\x42\x61\x63kup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x05 \x01(\x03\x42\x03\xe0\x41\x03\x12\x42\n\x05state\x18\x06 \x01(\x0e\x32..google.spanner.admin.database.v1.Backup.StateB\x03\xe0\x41\x03\x12"\n\x15referencing_databases\x18\x07 \x03(\tB\x03\xe0\x41\x03"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:\\\xea\x41Y\n\x1dspanner.googleapis.com/Backup\x12\x38projects/{project}/instances/{instance}/backups/{backup}"\xa5\x01\n\x13\x43reateBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12=\n\x06\x62\x61\x63kup\x18\x03 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02"\xae\x01\n\x14\x43reateBackupMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08\x64\x61tabase\x18\x02 \x01(\t\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8a\x01\n\x13UpdateBackupRequest\x12=\n\x06\x62\x61\x63kup\x18\x01 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"G\n\x10GetBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"J\n\x13\x44\x65leteBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"\x84\x01\n\x12ListBackupsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"i\n\x13ListBackupsResponse\x12\x39\n\x07\x62\x61\x63kups\x18\x01 \x03(\x0b\x32(.google.spanner.admin.database.v1.Backup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8d\x01\n\x1bListBackupOperationsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"j\n\x1cListBackupOperationsResponse\x12\x31\n\noperations\x18\x01 \x03(\x0b\x32\x1d.google.longrunning.Operation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"f\n\nBackupInfo\x12\x0e\n\x06\x62\x61\x63kup\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fsource_database\x18\x03 \x01(\tB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x42\x61\x63kupProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_longrunning_dot_operations__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -94,13 +87,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\372A!\n\037spanner.googleapis.com/Database"), + serialized_options=b"\372A!\n\037spanner.googleapis.com/Database", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -130,7 +123,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -154,7 +147,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -172,7 +165,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -190,7 +183,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -208,16 +201,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[_BACKUP_STATE], - serialized_options=_b( - "\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}" - ), + serialized_options=b"\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -243,15 +234,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037spanner.googleapis.com/Instance" - ), + serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -263,13 +252,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -287,7 +276,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -320,7 +309,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -338,7 +327,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -419,7 +408,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -437,7 +426,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -470,15 +459,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A\037\n\035spanner.googleapis.com/Backup" - ), + serialized_options=b"\340A\002\372A\037\n\035spanner.googleapis.com/Backup", file=DESCRIPTOR, ) ], @@ -511,15 +498,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A\037\n\035spanner.googleapis.com/Backup" - ), + serialized_options=b"\340A\002\372A\037\n\035spanner.googleapis.com/Backup", file=DESCRIPTOR, ) ], @@ -552,15 +537,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037spanner.googleapis.com/Instance" - ), + serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -572,7 +555,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -608,7 +591,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -665,7 +648,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -704,15 +687,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037spanner.googleapis.com/Instance" - ), + serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -724,7 +705,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -760,7 +741,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -817,7 +798,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -856,7 +837,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -892,7 +873,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -926,7 +907,7 @@ _CREATEBACKUPMETADATA.fields_by_name[ "progress" ].message_type = ( - google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS + google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS ) _CREATEBACKUPMETADATA.fields_by_name[ "cancel_time" @@ -962,10 +943,10 @@ Backup = _reflection.GeneratedProtocolMessageType( "Backup", (_message.Message,), - dict( - DESCRIPTOR=_BACKUP, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""A backup of a Cloud Spanner database. + { + "DESCRIPTOR": _BACKUP, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """A backup of a Cloud Spanner database. Attributes: @@ -1016,17 +997,17 @@ the ``READY`` state, the reference to the backup is removed. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.Backup) - ), + }, ) _sym_db.RegisterMessage(Backup) CreateBackupRequest = _reflection.GeneratedProtocolMessageType( "CreateBackupRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEBACKUPREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _CREATEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup]. @@ -1047,17 +1028,17 @@ Required. The backup to create. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupRequest) - ), + }, ) _sym_db.RegisterMessage(CreateBackupRequest) CreateBackupMetadata = _reflection.GeneratedProtocolMessageType( "CreateBackupMetadata", (_message.Message,), - dict( - DESCRIPTOR=_CREATEBACKUPMETADATA, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""Metadata type for the operation returned by + { + "DESCRIPTOR": _CREATEBACKUPMETADATA, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """Metadata type for the operation returned by [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup]. @@ -1085,17 +1066,17 @@ corresponding to ``Code.CANCELLED``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupMetadata) - ), + }, ) _sym_db.RegisterMessage(CreateBackupMetadata) UpdateBackupRequest = _reflection.GeneratedProtocolMessageType( "UpdateBackupRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEBACKUPREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _UPDATEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [UpdateBackup][google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup]. @@ -1114,17 +1095,17 @@ clients that do not know about them. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateBackupRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateBackupRequest) GetBackupRequest = _reflection.GeneratedProtocolMessageType( "GetBackupRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETBACKUPREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _GETBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup]. @@ -1134,17 +1115,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetBackupRequest) - ), + }, ) _sym_db.RegisterMessage(GetBackupRequest) DeleteBackupRequest = _reflection.GeneratedProtocolMessageType( "DeleteBackupRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEBACKUPREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _DELETEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [DeleteBackup][google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup]. @@ -1154,17 +1135,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DeleteBackupRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteBackupRequest) ListBackupsRequest = _reflection.GeneratedProtocolMessageType( "ListBackupsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTBACKUPSREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _LISTBACKUPSREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups]. @@ -1188,40 +1169,40 @@ multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. - Here are a few examples: - ``name:Howl`` - The backup's name - contains the string "howl". - ``database:prod`` - The - database's name contains the string "prod". - + Here are a few examples: - ``name:Howl`` - The backup’s name + contains the string “howl”. - ``database:prod`` - The + database’s name contains the string “prod”. - ``state:CREATING`` - The backup is pending creation. - ``state:READY`` - The backup is fully created and ready for use. - ``(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")`` - The backup name contains the - string "howl" and ``create_time`` of the backup is before + string “howl” and ``create_time`` of the backup is before 2018-03-28T14:50:00Z. - ``expire_time < \"2018-03-28T14:50:00Z\"`` - The backup ``expire_time`` is before 2018-03-28T14:50:00Z. - ``size_bytes > 10000000000`` - - The backup's size is greater than 10GB + The backup’s size is greater than 10GB page_size: Number of backups to be returned in the response. If 0 or - less, defaults to the server's maximum allowed page size. + less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.database.v1.ListBackupsResponse.next\ - _page\_token] from a previous [ListBackupsResponse][google.spa - nner.admin.database.v1.ListBackupsResponse] to the same - ``parent`` and with the same ``filter``. + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.database.v1.ListBackupsResponse.next_pa + ge_token] from a previous [ListBackupsResponse][google.spanner + .admin.database.v1.ListBackupsResponse] to the same ``parent`` + and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsRequest) - ), + }, ) _sym_db.RegisterMessage(ListBackupsRequest) ListBackupsResponse = _reflection.GeneratedProtocolMessageType( "ListBackupsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTBACKUPSRESPONSE, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTBACKUPSRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The response for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups]. @@ -1236,17 +1217,17 @@ call to fetch more of the matching backups. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsResponse) - ), + }, ) _sym_db.RegisterMessage(ListBackupsResponse) ListBackupOperationsRequest = _reflection.GeneratedProtocolMessageType( "ListBackupOperationsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTBACKUPOPERATIONSREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _LISTBACKUPOPERATIONSREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations]. @@ -1279,46 +1260,46 @@ AND, OR, and NOT logic explicitly. Here are a few examples: - ``done:true`` - The operation is complete. - ``metadata.database:prod`` - The database the backup was taken - from has a name containing the string "prod". - ``(metadat + from has a name containing the string “prod”. - ``(metadat a.@type=type.googleapis.com/google.spanner.admin.database.v1.C reateBackupMetadata) AND`` ``(metadata.name:howl) AND`` ``(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND`` ``(error:*)`` - Returns operations where: - The - operation's metadata type is [CreateBackupMetadata][goog + operation’s metadata type is [CreateBackupMetadata][goog le.spanner.admin.database.v1.CreateBackupMetadata]. - The - backup name contains the string "howl". - The operation + backup name contains the string “howl”. - The operation started before 2018-03-28T14:50:00Z. - The operation resulted in an error. page_size: Number of operations to be returned in the response. If 0 or - less, defaults to the server's maximum allowed page size. + less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.database.v1.ListBackupOperationsRespo - nse.next\_page\_token] from a previous [ListBackupOperationsRe - sponse][google.spanner.admin.database.v1.ListBackupOperationsR - esponse] to the same ``parent`` and with the same ``filter``. + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.database.v1.ListBackupOperationsRespons + e.next_page_token] from a previous [ListBackupOperationsRespon + se][google.spanner.admin.database.v1.ListBackupOperationsRespo + nse] to the same ``parent`` and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsRequest) - ), + }, ) _sym_db.RegisterMessage(ListBackupOperationsRequest) ListBackupOperationsResponse = _reflection.GeneratedProtocolMessageType( "ListBackupOperationsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTBACKUPOPERATIONSRESPONSE, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTBACKUPOPERATIONSRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The response for [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations]. Attributes: operations: The list of matching backup [long-running - operations][google.longrunning.Operation]. Each operation's - name will be prefixed by the backup's name and the operation's + operations][google.longrunning.Operation]. Each operation’s + name will be prefixed by the backup’s name and the operation’s [metadata][google.longrunning.Operation.metadata] will be of type [CreateBackupMetadata][google.spanner.admin.database.v1.C reateBackupMetadata]. Operations returned include those that @@ -1332,17 +1313,17 @@ BackupOperations] call to fetch more of the matching metadata. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsResponse) - ), + }, ) _sym_db.RegisterMessage(ListBackupOperationsResponse) BackupInfo = _reflection.GeneratedProtocolMessageType( "BackupInfo", (_message.Message,), - dict( - DESCRIPTOR=_BACKUPINFO, - __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", - __doc__="""Information about a backup. + { + "DESCRIPTOR": _BACKUPINFO, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """Information about a backup. Attributes: @@ -1356,7 +1337,7 @@ Name of the database the backup was created from. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) - ), + }, ) _sym_db.RegisterMessage(BackupInfo) diff --git a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py index 3acf791486..e1027f7997 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner/admin/database_v1/proto/common.proto +# source: google/cloud/spanner_admin_database_v1/proto/common.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -21,15 +18,11 @@ DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner/admin/database_v1/proto/common.proto", + name="google/cloud/spanner_admin_database_v1/proto/common.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=_b( - "\n$com.google.spanner.admin.database.v1B\013CommonProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1" - ), - serialized_pb=_b( - '\n9google/cloud/spanner/admin/database_v1/proto/common.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x8b\x01\n\x11OperationProgress\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x43ommonProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3' - ), + serialized_options=b"\n$com.google.spanner.admin.database.v1B\013CommonProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1", + serialized_pb=b'\n9google/cloud/spanner_admin_database_v1/proto/common.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x8b\x01\n\x11OperationProgress\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x43ommonProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, @@ -124,10 +117,10 @@ OperationProgress = _reflection.GeneratedProtocolMessageType( "OperationProgress", (_message.Message,), - dict( - DESCRIPTOR=_OPERATIONPROGRESS, - __module__="google.cloud.spanner.admin.database_v1.proto.common_pb2", - __doc__="""Encapsulates progress related information for a Cloud Spanner long + { + "DESCRIPTOR": _OPERATIONPROGRESS, + "__module__": "google.cloud.spanner_admin_database_v1.proto.common_pb2", + "__doc__": """Encapsulates progress related information for a Cloud Spanner long running operation. @@ -142,7 +135,7 @@ completed successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OperationProgress) - ), + }, ) _sym_db.RegisterMessage(OperationProgress) diff --git a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py index 125ab3f86b..e67609530c 100644 --- a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto +# source: google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -28,23 +25,19 @@ from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.cloud.spanner_admin_database_v1.proto import ( - backup_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_backup__pb2, + backup_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_backup__pb2, ) from google.cloud.spanner_admin_database_v1.proto import ( - common_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2, + common_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2, ) DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto", + name="google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=_b( - "\n$com.google.spanner.admin.database.v1B\031SpannerDatabaseAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}" - ), - serialized_pb=_b( - '\nIgoogle/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto\x12 google.spanner.admin.database.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/backup.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/common.proto"\xab\x01\n\x0bRestoreInfo\x12H\n\x0bsource_type\x18\x01 \x01(\x0e\x32\x33.google.spanner.admin.database.v1.RestoreSourceType\x12\x43\n\x0b\x62\x61\x63kup_info\x18\x02 \x01(\x0b\x32,.google.spanner.admin.database.v1.BackupInfoH\x00\x42\r\n\x0bsource_info"\x96\x03\n\x08\x44\x61tabase\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\x05state\x18\x02 \x01(\x0e\x32\x30.google.spanner.admin.database.v1.Database.StateB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x0crestore_info\x18\x04 \x01(\x0b\x32-.google.spanner.admin.database.v1.RestoreInfoB\x03\xe0\x41\x03"M\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x14\n\x10READY_OPTIMIZING\x10\x03:b\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/instances/*}/databases\xda\x41\x06parent\x12\xa4\x02\n\x0e\x43reateDatabase\x12\x37.google.spanner.admin.database.v1.CreateDatabaseRequest\x1a\x1d.google.longrunning.Operation"\xb9\x01\x82\xd3\xe4\x93\x02\x32"-/v1/{parent=projects/*/instances/*}/databases:\x01*\xda\x41\x17parent,create_statement\xca\x41\x64\n)google.spanner.admin.database.v1.Database\x12\x37google.spanner.admin.database.v1.CreateDatabaseMetadata\x12\xad\x01\n\x0bGetDatabase\x12\x34.google.spanner.admin.database.v1.GetDatabaseRequest\x1a*.google.spanner.admin.database.v1.Database"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/instances/*/databases/*}\xda\x41\x04name\x12\x9d\x02\n\x11UpdateDatabaseDdl\x12:.google.spanner.admin.database.v1.UpdateDatabaseDdlRequest\x1a\x1d.google.longrunning.Operation"\xac\x01\x82\xd3\xe4\x93\x02:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\x01*\xda\x41\x13\x64\x61tabase,statements\xca\x41S\n\x15google.protobuf.Empty\x12:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata\x12\xa3\x01\n\x0c\x44ropDatabase\x12\x35.google.spanner.admin.database.v1.DropDatabaseRequest\x1a\x16.google.protobuf.Empty"D\x82\xd3\xe4\x93\x02\x33*1/v1/{database=projects/*/instances/*/databases/*}\xda\x41\x08\x64\x61tabase\x12\xcd\x01\n\x0eGetDatabaseDdl\x12\x37.google.spanner.admin.database.v1.GetDatabaseDdlRequest\x1a\x38.google.spanner.admin.database.v1.GetDatabaseDdlResponse"H\x82\xd3\xe4\x93\x02\x37\x12\x35/v1/{database=projects/*/instances/*/databases/*}/ddl\xda\x41\x08\x64\x61tabase\x12\xeb\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9f\x01\x82\xd3\xe4\x93\x02\x86\x01">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\x01*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\x01*ZA".google.spanner.admin.database.v1.ListBackupOperationsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1/{parent=projects/*/instances/*}/backupOperations\xda\x41\x06parent\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xac\x02\n$com.google.spanner.admin.database.v1B\x19SpannerDatabaseAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}b\x06proto3' - ), + serialized_options=b"\n$com.google.spanner.admin.database.v1B\031SpannerDatabaseAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}", + serialized_pb=b'\nIgoogle/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto\x12 google.spanner.admin.database.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/backup.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/common.proto"\xab\x01\n\x0bRestoreInfo\x12H\n\x0bsource_type\x18\x01 \x01(\x0e\x32\x33.google.spanner.admin.database.v1.RestoreSourceType\x12\x43\n\x0b\x62\x61\x63kup_info\x18\x02 \x01(\x0b\x32,.google.spanner.admin.database.v1.BackupInfoH\x00\x42\r\n\x0bsource_info"\x96\x03\n\x08\x44\x61tabase\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\x05state\x18\x02 \x01(\x0e\x32\x30.google.spanner.admin.database.v1.Database.StateB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x0crestore_info\x18\x04 \x01(\x0b\x32-.google.spanner.admin.database.v1.RestoreInfoB\x03\xe0\x41\x03"M\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x14\n\x10READY_OPTIMIZING\x10\x03:b\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/instances/*}/databases\xda\x41\x06parent\x12\xa4\x02\n\x0e\x43reateDatabase\x12\x37.google.spanner.admin.database.v1.CreateDatabaseRequest\x1a\x1d.google.longrunning.Operation"\xb9\x01\x82\xd3\xe4\x93\x02\x32"-/v1/{parent=projects/*/instances/*}/databases:\x01*\xda\x41\x17parent,create_statement\xca\x41\x64\n)google.spanner.admin.database.v1.Database\x12\x37google.spanner.admin.database.v1.CreateDatabaseMetadata\x12\xad\x01\n\x0bGetDatabase\x12\x34.google.spanner.admin.database.v1.GetDatabaseRequest\x1a*.google.spanner.admin.database.v1.Database"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/instances/*/databases/*}\xda\x41\x04name\x12\x9d\x02\n\x11UpdateDatabaseDdl\x12:.google.spanner.admin.database.v1.UpdateDatabaseDdlRequest\x1a\x1d.google.longrunning.Operation"\xac\x01\x82\xd3\xe4\x93\x02:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\x01*\xda\x41\x13\x64\x61tabase,statements\xca\x41S\n\x15google.protobuf.Empty\x12:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata\x12\xa3\x01\n\x0c\x44ropDatabase\x12\x35.google.spanner.admin.database.v1.DropDatabaseRequest\x1a\x16.google.protobuf.Empty"D\x82\xd3\xe4\x93\x02\x33*1/v1/{database=projects/*/instances/*/databases/*}\xda\x41\x08\x64\x61tabase\x12\xcd\x01\n\x0eGetDatabaseDdl\x12\x37.google.spanner.admin.database.v1.GetDatabaseDdlRequest\x1a\x38.google.spanner.admin.database.v1.GetDatabaseDdlResponse"H\x82\xd3\xe4\x93\x02\x37\x12\x35/v1/{database=projects/*/instances/*/databases/*}/ddl\xda\x41\x08\x64\x61tabase\x12\xeb\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9f\x01\x82\xd3\xe4\x93\x02\x86\x01">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\x01*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\x01*ZA".google.spanner.admin.database.v1.ListBackupOperationsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1/{parent=projects/*/instances/*}/backupOperations\xda\x41\x06parent\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xac\x02\n$com.google.spanner.admin.database.v1B\x19SpannerDatabaseAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}b\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -55,8 +48,8 @@ google_dot_longrunning_dot_operations__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_backup__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_backup__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, ], ) @@ -205,13 +198,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -229,7 +222,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -247,7 +240,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -265,16 +258,14 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\003"), + serialized_options=b"\340A\003", file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[_DATABASE_STATE], - serialized_options=_b( - "\352A_\n\037spanner.googleapis.com/Database\022/instances/``. page_size: Number of databases to be returned in the response. If 0 or - less, defaults to the server's maximum allowed page size. + less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.database.v1.ListDatabasesResponse.nex - t\_page\_token] from a previous [ListDatabasesResponse][google - .spanner.admin.database.v1.ListDatabasesResponse]. + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.database.v1.ListDatabasesResponse.next_ + page_token] from a previous [ListDatabasesResponse][google.spa + nner.admin.database.v1.ListDatabasesResponse]. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesRequest) - ), + }, ) _sym_db.RegisterMessage(ListDatabasesRequest) ListDatabasesResponse = _reflection.GeneratedProtocolMessageType( "ListDatabasesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTDATABASESRESPONSE, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTDATABASESRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The response for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases]. @@ -1463,17 +1438,17 @@ es] call to fetch more of the matching databases. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesResponse) - ), + }, ) _sym_db.RegisterMessage(ListDatabasesResponse) CreateDatabaseRequest = _reflection.GeneratedProtocolMessageType( "CreateDatabaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEDATABASEREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _CREATEDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase]. @@ -1488,7 +1463,7 @@ regular expression ``[a-z][a-z0-9_\-]*[a-z0-9]`` and be between 2 and 30 characters in length. If the database ID is a reserved word or if it contains a hyphen, the database ID must - be enclosed in backticks (`````). + be enclosed in backticks (:literal:`\``). extra_statements: Optional. A list of DDL statements to run inside the newly created database. Statements can create tables, indexes, etc. @@ -1497,17 +1472,17 @@ is not created. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseRequest) - ), + }, ) _sym_db.RegisterMessage(CreateDatabaseRequest) CreateDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "CreateDatabaseMetadata", (_message.Message,), - dict( - DESCRIPTOR=_CREATEDATABASEMETADATA, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""Metadata type for the operation returned by + { + "DESCRIPTOR": _CREATEDATABASEMETADATA, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """Metadata type for the operation returned by [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase]. @@ -1516,17 +1491,17 @@ The database being created. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseMetadata) - ), + }, ) _sym_db.RegisterMessage(CreateDatabaseMetadata) GetDatabaseRequest = _reflection.GeneratedProtocolMessageType( "GetDatabaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETDATABASEREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _GETDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase]. @@ -1537,17 +1512,17 @@ database>``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseRequest) - ), + }, ) _sym_db.RegisterMessage(GetDatabaseRequest) UpdateDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType( "UpdateDatabaseDdlRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEDATABASEDDLREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""Enqueues the given DDL statements to be applied, in order + { + "DESCRIPTOR": _UPDATEDATABASEDDLREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """Enqueues the given DDL statements to be applied, in order but not necessarily all at once, to the database schema at some point (or points) in the future. The server checks that the statements are executable (syntactically valid, name tables that exist, etc.) before @@ -1561,7 +1536,7 @@ Each batch of statements is assigned a name which can be used with the [Operations][google.longrunning.Operations] API to monitor progress. See the - [operation\_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation\_id] + [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id] field for more details. @@ -1593,17 +1568,17 @@ returns ``ALREADY_EXISTS``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateDatabaseDdlRequest) UpdateDatabaseDdlMetadata = _reflection.GeneratedProtocolMessageType( "UpdateDatabaseDdlMetadata", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEDATABASEDDLMETADATA, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""Metadata type for the operation returned by + { + "DESCRIPTOR": _UPDATEDATABASEDDLMETADATA, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """Metadata type for the operation returned by [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]. @@ -1619,17 +1594,17 @@ timestamp for the statement ``statements[i]``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata) - ), + }, ) _sym_db.RegisterMessage(UpdateDatabaseDdlMetadata) DropDatabaseRequest = _reflection.GeneratedProtocolMessageType( "DropDatabaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_DROPDATABASEREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _DROPDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase]. @@ -1638,17 +1613,17 @@ Required. The database to be dropped. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DropDatabaseRequest) - ), + }, ) _sym_db.RegisterMessage(DropDatabaseRequest) GetDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType( "GetDatabaseDdlRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETDATABASEDDLREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _GETDATABASEDDLREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl]. @@ -1657,17 +1632,17 @@ Required. The database whose schema we wish to get. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlRequest) - ), + }, ) _sym_db.RegisterMessage(GetDatabaseDdlRequest) GetDatabaseDdlResponse = _reflection.GeneratedProtocolMessageType( "GetDatabaseDdlResponse", (_message.Message,), - dict( - DESCRIPTOR=_GETDATABASEDDLRESPONSE, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _GETDATABASEDDLRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The response for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl]. @@ -1677,17 +1652,17 @@ database specified in the request. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlResponse) - ), + }, ) _sym_db.RegisterMessage(GetDatabaseDdlResponse) ListDatabaseOperationsRequest = _reflection.GeneratedProtocolMessageType( "ListDatabaseOperationsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTDATABASEOPERATIONSREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _LISTDATABASEOPERATIONSREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations]. @@ -1726,44 +1701,44 @@ ``(metadata.name:restored_howl) AND`` ``(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND`` ``(error:*)`` - Return operations where: - The - operation's metadata type is [RestoreDatabaseMetadata][g + operation’s metadata type is [RestoreDatabaseMetadata][g oogle.spanner.admin.database.v1.RestoreDatabaseMetadata]. - The database is restored from a backup. - The backup name - contains "backup\_howl". - The restored database's name - contains "restored\_howl". - The operation started before + contains “backup_howl”. - The restored database’s name + contains “restored_howl”. - The operation started before 2018-03-28T14:50:00Z. - The operation resulted in an error. page_size: Number of operations to be returned in the response. If 0 or - less, defaults to the server's maximum allowed page size. + less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.database.v1.ListDatabaseOperationsRes - ponse.next\_page\_token] from a previous [ListDatabaseOperatio - nsResponse][google.spanner.admin.database.v1.ListDatabaseOpera - tionsResponse] to the same ``parent`` and with the same + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.database.v1.ListDatabaseOperationsRespo + nse.next_page_token] from a previous [ListDatabaseOperationsRe + sponse][google.spanner.admin.database.v1.ListDatabaseOperation + sResponse] to the same ``parent`` and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsRequest) - ), + }, ) _sym_db.RegisterMessage(ListDatabaseOperationsRequest) ListDatabaseOperationsResponse = _reflection.GeneratedProtocolMessageType( "ListDatabaseOperationsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTDATABASEOPERATIONSRESPONSE, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTDATABASEOPERATIONSRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The response for [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations]. Attributes: operations: The list of matching database [long-running - operations][google.longrunning.Operation]. Each operation's - name will be prefixed by the database's name. The operation's + operations][google.longrunning.Operation]. Each operation’s + name will be prefixed by the database’s name. The operation’s [metadata][google.longrunning.Operation.metadata] field type ``metadata.type_url`` describes the type of the metadata. next_page_token: @@ -1773,17 +1748,17 @@ metadata. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsResponse) - ), + }, ) _sym_db.RegisterMessage(ListDatabaseOperationsResponse) RestoreDatabaseRequest = _reflection.GeneratedProtocolMessageType( "RestoreDatabaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_RESTOREDATABASEREQUEST, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _RESTOREDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. @@ -1808,17 +1783,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseRequest) - ), + }, ) _sym_db.RegisterMessage(RestoreDatabaseRequest) RestoreDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "RestoreDatabaseMetadata", (_message.Message,), - dict( - DESCRIPTOR=_RESTOREDATABASEMETADATA, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""Metadata type for the long-running operation returned by + { + "DESCRIPTOR": _RESTOREDATABASEMETADATA, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """Metadata type for the long-running operation returned by [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. @@ -1866,17 +1841,17 @@ the restore was not successful. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseMetadata) - ), + }, ) _sym_db.RegisterMessage(RestoreDatabaseMetadata) OptimizeRestoredDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "OptimizeRestoredDatabaseMetadata", (_message.Message,), - dict( - DESCRIPTOR=_OPTIMIZERESTOREDDATABASEMETADATA, - __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", - __doc__="""Metadata type for the long-running operation used to track + { + "DESCRIPTOR": _OPTIMIZERESTOREDDATABASEMETADATA, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """Metadata type for the long-running operation used to track the progress of optimizations performed on a newly restored database. This long-running operation is automatically created by the system after the successful completion of a database restore, and cannot be @@ -1890,7 +1865,7 @@ The progress of the post-restore optimizations. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) - ), + }, ) _sym_db.RegisterMessage(OptimizeRestoredDatabaseMetadata) @@ -1922,9 +1897,7 @@ full_name="google.spanner.admin.database.v1.DatabaseAdmin", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin" - ), + serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", serialized_start=3100, serialized_end=7054, methods=[ @@ -1935,9 +1908,7 @@ containing_service=None, input_type=_LISTDATABASESREQUEST, output_type=_LISTDATABASESRESPONSE, - serialized_options=_b( - "\202\323\344\223\002/\022-/v1/{parent=projects/*/instances/*}/databases\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002/\022-/v1/{parent=projects/*/instances/*}/databases\332A\006parent", ), _descriptor.MethodDescriptor( name="CreateDatabase", @@ -1946,9 +1917,7 @@ containing_service=None, input_type=_CREATEDATABASEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=_b( - '\202\323\344\223\0022"-/v1/{parent=projects/*/instances/*}/databases:\001*\332A\027parent,create_statement\312Ad\n)google.spanner.admin.database.v1.Database\0227google.spanner.admin.database.v1.CreateDatabaseMetadata' - ), + serialized_options=b'\202\323\344\223\0022"-/v1/{parent=projects/*/instances/*}/databases:\001*\332A\027parent,create_statement\312Ad\n)google.spanner.admin.database.v1.Database\0227google.spanner.admin.database.v1.CreateDatabaseMetadata', ), _descriptor.MethodDescriptor( name="GetDatabase", @@ -1957,9 +1926,7 @@ containing_service=None, input_type=_GETDATABASEREQUEST, output_type=_DATABASE, - serialized_options=_b( - "\202\323\344\223\002/\022-/v1/{name=projects/*/instances/*/databases/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002/\022-/v1/{name=projects/*/instances/*/databases/*}\332A\004name", ), _descriptor.MethodDescriptor( name="UpdateDatabaseDdl", @@ -1968,9 +1935,7 @@ containing_service=None, input_type=_UPDATEDATABASEDDLREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=_b( - "\202\323\344\223\002:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\001*\332A\023database,statements\312AS\n\025google.protobuf.Empty\022:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata" - ), + serialized_options=b"\202\323\344\223\002:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\001*\332A\023database,statements\312AS\n\025google.protobuf.Empty\022:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata", ), _descriptor.MethodDescriptor( name="DropDatabase", @@ -1979,9 +1944,7 @@ containing_service=None, input_type=_DROPDATABASEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0023*1/v1/{database=projects/*/instances/*/databases/*}\332A\010database" - ), + serialized_options=b"\202\323\344\223\0023*1/v1/{database=projects/*/instances/*/databases/*}\332A\010database", ), _descriptor.MethodDescriptor( name="GetDatabaseDdl", @@ -1990,9 +1953,7 @@ containing_service=None, input_type=_GETDATABASEDDLREQUEST, output_type=_GETDATABASEDDLRESPONSE, - serialized_options=_b( - "\202\323\344\223\0027\0225/v1/{database=projects/*/instances/*/databases/*}/ddl\332A\010database" - ), + serialized_options=b"\202\323\344\223\0027\0225/v1/{database=projects/*/instances/*/databases/*}/ddl\332A\010database", ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -2001,9 +1962,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002\206\001">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA"``. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- @@ -366,8 +366,8 @@ def get_instance_config( >>> response = client.get_instance_config(name) Args: - name (str): Required. The name of the requested instance configuration. Values are - of the form ``projects//instanceConfigs/``. + name (str): Required. The name of the requested instance configuration. Values + are of the form ``projects//instanceConfigs/``. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -457,8 +457,8 @@ def list_instances( resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - filter_ (str): An expression for filtering the results of the request. Filter rules are - case insensitive. The fields eligible for filtering are: + filter_ (str): An expression for filtering the results of the request. Filter rules + are case insensitive. The fields eligible for filtering are: - ``name`` - ``display_name`` @@ -562,8 +562,8 @@ def get_instance( Args: name (str): Required. The name of the requested instance. Values are of the form ``projects//instances/``. - field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): If field\_mask is present, specifies the subset of ``Instance`` fields - that should be returned. If absent, all ``Instance`` fields are + field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): If field_mask is present, specifies the subset of ``Instance`` + fields that should be returned. If absent, all ``Instance`` fields are returned. If a dict is provided, it must be of the same form as the protobuf @@ -687,9 +687,9 @@ def create_instance( Args: parent (str): Required. The name of the project in which to create the instance. Values are of the form ``projects/``. - instance_id (str): Required. The ID of the instance to create. Valid identifiers are of the - form ``[a-z][-a-z0-9]*[a-z0-9]`` and must be between 2 and 64 characters - in length. + instance_id (str): Required. The ID of the instance to create. Valid identifiers are of + the form ``[a-z][-a-z0-9]*[a-z0-9]`` and must be between 2 and 64 + characters in length. instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): Required. The instance to create. The name may be omitted, but if specified must be ``/instances/``. @@ -820,9 +820,9 @@ def update_instance( >>> metadata = response.metadata() Args: - instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): Required. The instance to update, which must always include the instance - name. Otherwise, only fields mentioned in ``field_mask`` need be - included. + instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): Required. The instance to update, which must always include the + instance name. Otherwise, only fields mentioned in ``field_mask`` need + be included. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_admin_instance_v1.types.Instance` @@ -919,8 +919,8 @@ def delete_instance( >>> client.delete_instance(name) Args: - name (str): Required. The name of the instance to be deleted. Values are of the form - ``projects//instances/`` + name (str): Required. The name of the instance to be deleted. Values are of the + form ``projects//instances/`` retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1148,7 +1148,7 @@ def test_iam_permissions( resource. Attempting this RPC on a non-existent Cloud Spanner instance resource - will result in a NOT\_FOUND error if the user has + will result in a NOT_FOUND error if the user has ``spanner.instances.list`` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions. @@ -1168,8 +1168,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used diff --git a/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py b/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py index 1d3c404bf6..c0fd87efbe 100644 --- a/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py +++ b/google/cloud/spanner_admin_instance_v1/gapic/transports/instance_admin_grpc_transport.py @@ -328,7 +328,7 @@ def test_iam_permissions(self): resource. Attempting this RPC on a non-existent Cloud Spanner instance resource - will result in a NOT\_FOUND error if the user has + will result in a NOT_FOUND error if the user has ``spanner.instances.list`` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions. diff --git a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py index f00bfbbe0a..3812bf668f 100644 --- a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py +++ b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto +# source: google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -30,15 +27,11 @@ DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto", + name="google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto", package="google.spanner.admin.instance.v1", syntax="proto3", - serialized_options=_b( - "\n$com.google.spanner.admin.instance.v1B\031SpannerInstanceAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\252\002&Google.Cloud.Spanner.Admin.Instance.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Instance\\V1" - ), - serialized_pb=_b( - '\nIgoogle/cloud/spanner/admin/instance_v1/proto/spanner_instance_admin.proto\x12 google.spanner.admin.instance.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xda\x01\n\x0bReplicaInfo\x12\x10\n\x08location\x18\x01 \x01(\t\x12G\n\x04type\x18\x02 \x01(\x0e\x32\x39.google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType\x12\x1f\n\x17\x64\x65\x66\x61ult_leader_location\x18\x03 \x01(\x08"O\n\x0bReplicaType\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nREAD_WRITE\x10\x01\x12\r\n\tREAD_ONLY\x10\x02\x12\x0b\n\x07WITNESS\x10\x03"\xd7\x01\n\x0eInstanceConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12?\n\x08replicas\x18\x03 \x03(\x0b\x32-.google.spanner.admin.instance.v1.ReplicaInfo:`\xea\x41]\n%spanner.googleapis.com/InstanceConfig\x12\x34projects/{project}/instanceConfigs/{instance_config}"\xd5\x03\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12:\n\x06\x63onfig\x18\x02 \x01(\tB*\xfa\x41\'\n%spanner.googleapis.com/InstanceConfig\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12?\n\x05state\x18\x06 \x01(\x0e\x32\x30.google.spanner.admin.instance.v1.Instance.State\x12\x46\n\x06labels\x18\x07 \x03(\x0b\x32\x36.google.spanner.admin.instance.v1.Instance.LabelsEntry\x12\x15\n\rendpoint_uris\x18\x08 \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:M\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}"\x88\x01\n\x1aListInstanceConfigsRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x82\x01\n\x1bListInstanceConfigsResponse\x12J\n\x10instance_configs\x18\x01 \x03(\x0b\x32\x30.google.spanner.admin.instance.v1.InstanceConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"W\n\x18GetInstanceConfigRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%spanner.googleapis.com/InstanceConfig"{\n\x12GetInstanceRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xb9\x01\n\x15\x43reateInstanceRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x18\n\x0binstance_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x41\n\x08instance\x18\x03 \x01(\x0b\x32*.google.spanner.admin.instance.v1.InstanceB\x03\xe0\x41\x02"\x92\x01\n\x14ListInstancesRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"o\n\x15ListInstancesResponse\x12=\n\tinstances\x18\x01 \x03(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8f\x01\n\x15UpdateInstanceRequest\x12\x41\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.InstanceB\x03\xe0\x41\x02\x12\x33\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"N\n\x15\x44\x65leteInstanceRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance"\xe5\x01\n\x16\x43reateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xe5\x01\n\x16UpdateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xbf\x10\n\rInstanceAdmin\x12\xcc\x01\n\x13ListInstanceConfigs\x12<.google.spanner.admin.instance.v1.ListInstanceConfigsRequest\x1a=.google.spanner.admin.instance.v1.ListInstanceConfigsResponse"8\x82\xd3\xe4\x93\x02)\x12\'/v1/{parent=projects/*}/instanceConfigs\xda\x41\x06parent\x12\xb9\x01\n\x11GetInstanceConfig\x12:.google.spanner.admin.instance.v1.GetInstanceConfigRequest\x1a\x30.google.spanner.admin.instance.v1.InstanceConfig"6\x82\xd3\xe4\x93\x02)\x12\'/v1/{name=projects/*/instanceConfigs/*}\xda\x41\x04name\x12\xb4\x01\n\rListInstances\x12\x36.google.spanner.admin.instance.v1.ListInstancesRequest\x1a\x37.google.spanner.admin.instance.v1.ListInstancesResponse"2\x82\xd3\xe4\x93\x02#\x12!/v1/{parent=projects/*}/instances\xda\x41\x06parent\x12\xa1\x01\n\x0bGetInstance\x12\x34.google.spanner.admin.instance.v1.GetInstanceRequest\x1a*.google.spanner.admin.instance.v1.Instance"0\x82\xd3\xe4\x93\x02#\x12!/v1/{name=projects/*/instances/*}\xda\x41\x04name\x12\x9c\x02\n\x0e\x43reateInstance\x12\x37.google.spanner.admin.instance.v1.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation"\xb1\x01\x82\xd3\xe4\x93\x02&"!/v1/{parent=projects/*}/instances:\x01*\xda\x41\x1bparent,instance_id,instance\xca\x41\x64\n)google.spanner.admin.instance.v1.Instance\x12\x37google.spanner.admin.instance.v1.CreateInstanceMetadata\x12\x9d\x02\n\x0eUpdateInstance\x12\x37.google.spanner.admin.instance.v1.UpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"\xb2\x01\x82\xd3\xe4\x93\x02/2*/v1/{instance.name=projects/*/instances/*}:\x01*\xda\x41\x13instance,field_mask\xca\x41\x64\n)google.spanner.admin.instance.v1.Instance\x12\x37google.spanner.admin.instance.v1.UpdateInstanceMetadata\x12\x93\x01\n\x0e\x44\x65leteInstance\x12\x37.google.spanner.admin.instance.v1.DeleteInstanceRequest\x1a\x16.google.protobuf.Empty"0\x82\xd3\xe4\x93\x02#*!/v1/{name=projects/*/instances/*}\xda\x41\x04name\x12\x9a\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"O\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\x93\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"H\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xc5\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"Z\x82\xd3\xe4\x93\x02="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xdf\x01\n$com.google.spanner.admin.instance.v1B\x19SpannerInstanceAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\xaa\x02&Google.Cloud.Spanner.Admin.Instance.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Instance\\V1b\x06proto3' - ), + serialized_options=b"\n$com.google.spanner.admin.instance.v1B\031SpannerInstanceAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\252\002&Google.Cloud.Spanner.Admin.Instance.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Instance\\V1", + serialized_pb=b'\nIgoogle/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto\x12 google.spanner.admin.instance.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\xda\x01\n\x0bReplicaInfo\x12\x10\n\x08location\x18\x01 \x01(\t\x12G\n\x04type\x18\x02 \x01(\x0e\x32\x39.google.spanner.admin.instance.v1.ReplicaInfo.ReplicaType\x12\x1f\n\x17\x64\x65\x66\x61ult_leader_location\x18\x03 \x01(\x08"O\n\x0bReplicaType\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x0e\n\nREAD_WRITE\x10\x01\x12\r\n\tREAD_ONLY\x10\x02\x12\x0b\n\x07WITNESS\x10\x03"\xd7\x01\n\x0eInstanceConfig\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x14\n\x0c\x64isplay_name\x18\x02 \x01(\t\x12?\n\x08replicas\x18\x03 \x03(\x0b\x32-.google.spanner.admin.instance.v1.ReplicaInfo:`\xea\x41]\n%spanner.googleapis.com/InstanceConfig\x12\x34projects/{project}/instanceConfigs/{instance_config}"\xd5\x03\n\x08Instance\x12\x0c\n\x04name\x18\x01 \x01(\t\x12:\n\x06\x63onfig\x18\x02 \x01(\tB*\xfa\x41\'\n%spanner.googleapis.com/InstanceConfig\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12?\n\x05state\x18\x06 \x01(\x0e\x32\x30.google.spanner.admin.instance.v1.Instance.State\x12\x46\n\x06labels\x18\x07 \x03(\x0b\x32\x36.google.spanner.admin.instance.v1.Instance.LabelsEntry\x12\x15\n\rendpoint_uris\x18\x08 \x03(\t\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:M\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}"\x88\x01\n\x1aListInstanceConfigsRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t"\x82\x01\n\x1bListInstanceConfigsResponse\x12J\n\x10instance_configs\x18\x01 \x03(\x0b\x32\x30.google.spanner.admin.instance.v1.InstanceConfig\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"W\n\x18GetInstanceConfigRequest\x12;\n\x04name\x18\x01 \x01(\tB-\xe0\x41\x02\xfa\x41\'\n%spanner.googleapis.com/InstanceConfig"{\n\x12GetInstanceRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12.\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"\xb9\x01\n\x15\x43reateInstanceRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x18\n\x0binstance_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x41\n\x08instance\x18\x03 \x01(\x0b\x32*.google.spanner.admin.instance.v1.InstanceB\x03\xe0\x41\x02"\x92\x01\n\x14ListInstancesRequest\x12\x43\n\x06parent\x18\x01 \x01(\tB3\xe0\x41\x02\xfa\x41-\n+cloudresourcemanager.googleapis.com/Project\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"o\n\x15ListInstancesResponse\x12=\n\tinstances\x18\x01 \x03(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8f\x01\n\x15UpdateInstanceRequest\x12\x41\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.InstanceB\x03\xe0\x41\x02\x12\x33\n\nfield_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"N\n\x15\x44\x65leteInstanceRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance"\xe5\x01\n\x16\x43reateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xe5\x01\n\x16UpdateInstanceMetadata\x12<\n\x08instance\x18\x01 \x01(\x0b\x32*.google.spanner.admin.instance.v1.Instance\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63\x61ncel_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp2\xbf\x10\n\rInstanceAdmin\x12\xcc\x01\n\x13ListInstanceConfigs\x12<.google.spanner.admin.instance.v1.ListInstanceConfigsRequest\x1a=.google.spanner.admin.instance.v1.ListInstanceConfigsResponse"8\x82\xd3\xe4\x93\x02)\x12\'/v1/{parent=projects/*}/instanceConfigs\xda\x41\x06parent\x12\xb9\x01\n\x11GetInstanceConfig\x12:.google.spanner.admin.instance.v1.GetInstanceConfigRequest\x1a\x30.google.spanner.admin.instance.v1.InstanceConfig"6\x82\xd3\xe4\x93\x02)\x12\'/v1/{name=projects/*/instanceConfigs/*}\xda\x41\x04name\x12\xb4\x01\n\rListInstances\x12\x36.google.spanner.admin.instance.v1.ListInstancesRequest\x1a\x37.google.spanner.admin.instance.v1.ListInstancesResponse"2\x82\xd3\xe4\x93\x02#\x12!/v1/{parent=projects/*}/instances\xda\x41\x06parent\x12\xa1\x01\n\x0bGetInstance\x12\x34.google.spanner.admin.instance.v1.GetInstanceRequest\x1a*.google.spanner.admin.instance.v1.Instance"0\x82\xd3\xe4\x93\x02#\x12!/v1/{name=projects/*/instances/*}\xda\x41\x04name\x12\x9c\x02\n\x0e\x43reateInstance\x12\x37.google.spanner.admin.instance.v1.CreateInstanceRequest\x1a\x1d.google.longrunning.Operation"\xb1\x01\x82\xd3\xe4\x93\x02&"!/v1/{parent=projects/*}/instances:\x01*\xda\x41\x1bparent,instance_id,instance\xca\x41\x64\n)google.spanner.admin.instance.v1.Instance\x12\x37google.spanner.admin.instance.v1.CreateInstanceMetadata\x12\x9d\x02\n\x0eUpdateInstance\x12\x37.google.spanner.admin.instance.v1.UpdateInstanceRequest\x1a\x1d.google.longrunning.Operation"\xb2\x01\x82\xd3\xe4\x93\x02/2*/v1/{instance.name=projects/*/instances/*}:\x01*\xda\x41\x13instance,field_mask\xca\x41\x64\n)google.spanner.admin.instance.v1.Instance\x12\x37google.spanner.admin.instance.v1.UpdateInstanceMetadata\x12\x93\x01\n\x0e\x44\x65leteInstance\x12\x37.google.spanner.admin.instance.v1.DeleteInstanceRequest\x1a\x16.google.protobuf.Empty"0\x82\xd3\xe4\x93\x02#*!/v1/{name=projects/*/instances/*}\xda\x41\x04name\x12\x9a\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"O\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\x93\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"H\x82\xd3\xe4\x93\x02\x37"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xc5\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"Z\x82\xd3\xe4\x93\x02="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xdf\x01\n$com.google.spanner.admin.instance.v1B\x19SpannerInstanceAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/instance/v1;instance\xaa\x02&Google.Cloud.Spanner.Admin.Instance.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Instance\\V1b\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -128,7 +121,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -203,7 +196,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -221,7 +214,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -252,9 +245,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b( - "\352A]\n%spanner.googleapis.com/InstanceConfig\0224projects/{project}/instanceConfigs/{instance_config}" - ), + serialized_options=b"\352A]\n%spanner.googleapis.com/InstanceConfig\0224projects/{project}/instanceConfigs/{instance_config}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -280,7 +271,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -298,7 +289,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -311,7 +302,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -336,7 +327,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -354,13 +345,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\372A'\n%spanner.googleapis.com/InstanceConfig"), + serialized_options=b"\372A'\n%spanner.googleapis.com/InstanceConfig", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -372,7 +363,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -457,9 +448,7 @@ extensions=[], nested_types=[_INSTANCE_LABELSENTRY], enum_types=[_INSTANCE_STATE], - serialized_options=_b( - "\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}" - ), + serialized_options=b"\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -485,15 +474,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project" - ), + serialized_options=b"\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -523,7 +510,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -580,7 +567,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -619,15 +606,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A'\n%spanner.googleapis.com/InstanceConfig" - ), + serialized_options=b"\340A\002\372A'\n%spanner.googleapis.com/InstanceConfig", file=DESCRIPTOR, ) ], @@ -660,15 +645,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037spanner.googleapis.com/Instance" - ), + serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -719,15 +702,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project" - ), + serialized_options=b"\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -739,13 +720,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -763,7 +744,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -796,15 +777,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project" - ), + serialized_options=b"\340A\002\372A-\n+cloudresourcemanager.googleapis.com/Project", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -834,7 +813,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -852,7 +831,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -909,7 +888,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -954,7 +933,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -972,7 +951,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, ), ], @@ -1005,15 +984,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037spanner.googleapis.com/Instance" - ), + serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", file=DESCRIPTOR, ) ], @@ -1277,14 +1254,14 @@ ReplicaInfo = _reflection.GeneratedProtocolMessageType( "ReplicaInfo", (_message.Message,), - dict( - DESCRIPTOR=_REPLICAINFO, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""Protocol buffer. + { + "DESCRIPTOR": _REPLICAINFO, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """Protocol buffer. Attributes: location: - The location of the serving resources, e.g. "us-central1". + The location of the serving resources, e.g. “us-central1”. type: The type of replica. default_leader_location: @@ -1294,17 +1271,17 @@ tances#region_types>`__ for more details. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ReplicaInfo) - ), + }, ) _sym_db.RegisterMessage(ReplicaInfo) InstanceConfig = _reflection.GeneratedProtocolMessageType( "InstanceConfig", (_message.Message,), - dict( - DESCRIPTOR=_INSTANCECONFIG, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""A possible configuration for a Cloud Spanner instance. + { + "DESCRIPTOR": _INSTANCECONFIG, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """A possible configuration for a Cloud Spanner instance. Configurations define the geographic placement of nodes and their replication. @@ -1321,26 +1298,26 @@ configuration and their replication properties. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) - ), + }, ) _sym_db.RegisterMessage(InstanceConfig) Instance = _reflection.GeneratedProtocolMessageType( "Instance", (_message.Message,), - dict( - LabelsEntry=_reflection.GeneratedProtocolMessageType( + { + "LabelsEntry": _reflection.GeneratedProtocolMessageType( "LabelsEntry", (_message.Message,), - dict( - DESCRIPTOR=_INSTANCE_LABELSENTRY, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2" + { + "DESCRIPTOR": _INSTANCE_LABELSENTRY, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2" # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance.LabelsEntry) - ), + }, ), - DESCRIPTOR=_INSTANCE, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""An isolated set of Cloud Spanner resources on which + "DESCRIPTOR": _INSTANCE, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """An isolated set of Cloud Spanner resources on which databases can be hosted. @@ -1352,7 +1329,7 @@ The final segment of the name must be between 2 and 64 characters in length. config: - Required. The name of the instance's configuration. Values are + Required. The name of the instance’s configuration. Values are of the form ``projects//instanceConfigs/``. See also [InstanceConfig][google.spanner.admin.instance.v1.Instanc @@ -1378,11 +1355,11 @@ labels: Cloud Labels are a flexible and lightweight mechanism for organizing cloud resources into groups that reflect a - customer's organizational needs and deployment strategies. + customer’s organizational needs and deployment strategies. Cloud Labels can be used to filter collections of resources. They can be used to control how resource metrics are aggregated. And they can be used as arguments to policy - management rules (e.g. route, firewall, load balancing, etc.). + management rules (e.g. route, firewall, load balancing, etc.). - Label keys must be between 1 and 63 characters long and must conform to the following regular expression: ``[a-z]([-a-z0-9]*[a-z0-9])?``. - Label values must be @@ -1393,15 +1370,15 @@ of labels. If you plan to use labels in your own code, please note that additional characters may be allowed in the future. And so you are advised to use an internal label - representation, such as JSON, which doesn't rely upon specific + representation, such as JSON, which doesn’t rely upon specific characters being disallowed. For example, representing labels - as the string: name + "*" + value would prove problematic if - we were to allow "*" in a future release. + as the string: name + “*" + value would prove problematic if + we were to allow "*” in a future release. endpoint_uris: Deprecated. This field is not populated. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) - ), + }, ) _sym_db.RegisterMessage(Instance) _sym_db.RegisterMessage(Instance.LabelsEntry) @@ -1409,10 +1386,10 @@ ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType( "ListInstanceConfigsRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTINSTANCECONFIGSREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _LISTINSTANCECONFIGSREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs]. @@ -1423,27 +1400,27 @@ the form ``projects/``. page_size: Number of instance configurations to be returned in the - response. If 0 or less, defaults to the server's maximum + response. If 0 or less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.instance.v1.ListInstanceConfigsRespon - se.next\_page\_token] from a previous [ListInstanceConfigsResp - onse][google.spanner.admin.instance.v1.ListInstanceConfigsResp - onse]. + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse + .next_page_token] from a previous [ListInstanceConfigsResponse + ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse + ]. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsRequest) - ), + }, ) _sym_db.RegisterMessage(ListInstanceConfigsRequest) ListInstanceConfigsResponse = _reflection.GeneratedProtocolMessageType( "ListInstanceConfigsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTINSTANCECONFIGSRESPONSE, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTINSTANCECONFIGSRESPONSE, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The response for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs]. @@ -1457,17 +1434,17 @@ configurations. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsResponse) - ), + }, ) _sym_db.RegisterMessage(ListInstanceConfigsResponse) GetInstanceConfigRequest = _reflection.GeneratedProtocolMessageType( "GetInstanceConfigRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETINSTANCECONFIGREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _GETINSTANCECONFIGREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [GetInstanceConfigRequest][google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig]. @@ -1478,17 +1455,17 @@ ``projects//instanceConfigs/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceConfigRequest) - ), + }, ) _sym_db.RegisterMessage(GetInstanceConfigRequest) GetInstanceRequest = _reflection.GeneratedProtocolMessageType( "GetInstanceRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETINSTANCEREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _GETINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [GetInstance][google.spanner.admin.instance.v1.InstanceAdmin.GetInstance]. @@ -1497,24 +1474,24 @@ Required. The name of the requested instance. Values are of the form ``projects//instances/``. field_mask: - If field\_mask is present, specifies the subset of + If field_mask is present, specifies the subset of [Instance][google.spanner.admin.instance.v1.Instance] fields that should be returned. If absent, all [Instance][google.spanner.admin.instance.v1.Instance] fields are returned. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest) - ), + }, ) _sym_db.RegisterMessage(GetInstanceRequest) CreateInstanceRequest = _reflection.GeneratedProtocolMessageType( "CreateInstanceRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEINSTANCEREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _CREATEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance]. @@ -1531,17 +1508,17 @@ if specified must be ``/instances/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceRequest) - ), + }, ) _sym_db.RegisterMessage(CreateInstanceRequest) ListInstancesRequest = _reflection.GeneratedProtocolMessageType( "ListInstancesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTINSTANCESREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _LISTINSTANCESREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances]. @@ -1552,39 +1529,39 @@ ``projects/``. page_size: Number of instances to be returned in the response. If 0 or - less, defaults to the server's maximum allowed page size. + less, defaults to the server’s maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next\_page\_tok - en][google.spanner.admin.instance.v1.ListInstancesResponse.nex - t\_page\_token] from a previous [ListInstancesResponse][google - .spanner.admin.instance.v1.ListInstancesResponse]. + If non-empty, ``page_token`` should contain a [next_page_token + ][google.spanner.admin.instance.v1.ListInstancesResponse.next_ + page_token] from a previous [ListInstancesResponse][google.spa + nner.admin.instance.v1.ListInstancesResponse]. filter: An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: - ``name`` - ``display_name`` - ``labels.key`` where key is the name of a label Some examples of using filters - are: - ``name:*`` --> The instance has a name. - - ``name:Howl`` --> The instance's name contains the string - "howl". - ``name:HOWL`` --> Equivalent to above. - - ``NAME:howl`` --> Equivalent to above. - ``labels.env:*`` --> - The instance has the label "env". - ``labels.env:dev`` --> - The instance has the label "env" and the value of the label - contains the string "dev". - ``name:howl labels.env:dev`` --> - The instance's name contains "howl" and it has the label - "env" with its value containing "dev". + are: - ``name:*`` –> The instance has a name. - + ``name:Howl`` –> The instance’s name contains the string + “howl”. - ``name:HOWL`` –> Equivalent to above. - + ``NAME:howl`` –> Equivalent to above. - ``labels.env:*`` –> + The instance has the label “env”. - ``labels.env:dev`` –> The + instance has the label “env” and the value of the label + contains the string “dev”. - ``name:howl labels.env:dev`` –> + The instance’s name contains “howl” and it has the label + “env” with its value containing “dev”. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesRequest) - ), + }, ) _sym_db.RegisterMessage(ListInstancesRequest) ListInstancesResponse = _reflection.GeneratedProtocolMessageType( "ListInstancesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTINSTANCESRESPONSE, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTINSTANCESRESPONSE, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The response for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances]. @@ -1597,26 +1574,26 @@ es] call to fetch more of the matching instances. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesResponse) - ), + }, ) _sym_db.RegisterMessage(ListInstancesResponse) UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType( "UpdateInstanceRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEINSTANCEREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _UPDATEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]. Attributes: instance: Required. The instance to update, which must always include - the instance name. Otherwise, only fields mentioned in [field\ - _mask][google.spanner.admin.instance.v1.UpdateInstanceRequest. - field\_mask] need be included. + the instance name. Otherwise, only fields mentioned in [field_ + mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.f + ield_mask] need be included. field_mask: Required. A mask specifying which fields in [Instance][google.spanner.admin.instance.v1.Instance] should @@ -1627,17 +1604,17 @@ them. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateInstanceRequest) DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType( "DeleteInstanceRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEINSTANCEREQUEST, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _DELETEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [DeleteInstance][google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance]. @@ -1647,17 +1624,17 @@ of the form ``projects//instances/`` """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.DeleteInstanceRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteInstanceRequest) CreateInstanceMetadata = _reflection.GeneratedProtocolMessageType( "CreateInstanceMetadata", (_message.Message,), - dict( - DESCRIPTOR=_CREATEINSTANCEMETADATA, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""Metadata type for the operation returned by + { + "DESCRIPTOR": _CREATEINSTANCEMETADATA, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """Metadata type for the operation returned by [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance]. @@ -1676,17 +1653,17 @@ successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceMetadata) - ), + }, ) _sym_db.RegisterMessage(CreateInstanceMetadata) UpdateInstanceMetadata = _reflection.GeneratedProtocolMessageType( "UpdateInstanceMetadata", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEINSTANCEMETADATA, - __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", - __doc__="""Metadata type for the operation returned by + { + "DESCRIPTOR": _UPDATEINSTANCEMETADATA, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """Metadata type for the operation returned by [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]. @@ -1705,7 +1682,7 @@ successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) - ), + }, ) _sym_db.RegisterMessage(UpdateInstanceMetadata) @@ -1731,9 +1708,7 @@ full_name="google.spanner.admin.instance.v1.InstanceAdmin", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin" - ), + serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", serialized_start=2957, serialized_end=5068, methods=[ @@ -1744,9 +1719,7 @@ containing_service=None, input_type=_LISTINSTANCECONFIGSREQUEST, output_type=_LISTINSTANCECONFIGSRESPONSE, - serialized_options=_b( - "\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent", ), _descriptor.MethodDescriptor( name="GetInstanceConfig", @@ -1755,9 +1728,7 @@ containing_service=None, input_type=_GETINSTANCECONFIGREQUEST, output_type=_INSTANCECONFIG, - serialized_options=_b( - "\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name", ), _descriptor.MethodDescriptor( name="ListInstances", @@ -1766,9 +1737,7 @@ containing_service=None, input_type=_LISTINSTANCESREQUEST, output_type=_LISTINSTANCESRESPONSE, - serialized_options=_b( - "\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent", ), _descriptor.MethodDescriptor( name="GetInstance", @@ -1777,9 +1746,7 @@ containing_service=None, input_type=_GETINSTANCEREQUEST, output_type=_INSTANCE, - serialized_options=_b( - "\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name", ), _descriptor.MethodDescriptor( name="CreateInstance", @@ -1788,9 +1755,7 @@ containing_service=None, input_type=_CREATEINSTANCEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=_b( - '\202\323\344\223\002&"!/v1/{parent=projects/*}/instances:\001*\332A\033parent,instance_id,instance\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.CreateInstanceMetadata' - ), + serialized_options=b'\202\323\344\223\002&"!/v1/{parent=projects/*}/instances:\001*\332A\033parent,instance_id,instance\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.CreateInstanceMetadata', ), _descriptor.MethodDescriptor( name="UpdateInstance", @@ -1799,9 +1764,7 @@ containing_service=None, input_type=_UPDATEINSTANCEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=_b( - "\202\323\344\223\002/2*/v1/{instance.name=projects/*/instances/*}:\001*\332A\023instance,field_mask\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.UpdateInstanceMetadata" - ), + serialized_options=b"\202\323\344\223\002/2*/v1/{instance.name=projects/*/instances/*}:\001*\332A\023instance,field_mask\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.UpdateInstanceMetadata", ), _descriptor.MethodDescriptor( name="DeleteInstance", @@ -1810,9 +1773,7 @@ containing_service=None, input_type=_DELETEINSTANCEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002#*!/v1/{name=projects/*/instances/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002#*!/v1/{name=projects/*/instances/*}\332A\004name", ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -1821,9 +1782,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\001*\332A\017resource,policy' - ), + serialized_options=b'\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\001*\332A\017resource,policy', ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -1832,9 +1791,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\001*\332A\010resource' - ), + serialized_options=b'\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\001*\332A\010resource', ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -1843,9 +1800,7 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\001*\332A\024resource,permissions' - ), + serialized_options=b'\202\323\344\223\002="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\001*\332A\024resource,permissions', ), ], ) diff --git a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py index b7276a9f92..3ee5c19c02 100644 --- a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py +++ b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py @@ -2,7 +2,7 @@ import grpc from google.cloud.spanner_admin_instance_v1.proto import ( - spanner_instance_admin_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2, + spanner_instance_admin_pb2 as google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2, ) from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2 from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 @@ -44,37 +44,37 @@ def __init__(self, channel): """ self.ListInstanceConfigs = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, ) self.GetInstanceConfig = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, ) self.ListInstances = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, ) self.GetInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, ) self.CreateInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, ) self.UpdateInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, ) self.DeleteInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance", - request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, ) self.SetIamPolicy = channel.unary_unary( @@ -288,37 +288,37 @@ def add_InstanceAdminServicer_to_server(servicer, server): rpc_method_handlers = { "ListInstanceConfigs": grpc.unary_unary_rpc_method_handler( servicer.ListInstanceConfigs, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.SerializeToString, ), "GetInstanceConfig": grpc.unary_unary_rpc_method_handler( servicer.GetInstanceConfig, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.SerializeToString, ), "ListInstances": grpc.unary_unary_rpc_method_handler( servicer.ListInstances, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.SerializeToString, ), "GetInstance": grpc.unary_unary_rpc_method_handler( servicer.GetInstance, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.SerializeToString, ), "CreateInstance": grpc.unary_unary_rpc_method_handler( servicer.CreateInstance, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.FromString, response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString, ), "UpdateInstance": grpc.unary_unary_rpc_method_handler( servicer.UpdateInstance, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.FromString, response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString, ), "DeleteInstance": grpc.unary_unary_rpc_method_handler( servicer.DeleteInstance, - request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.FromString, response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, ), "SetIamPolicy": grpc.unary_unary_rpc_method_handler( diff --git a/google/cloud/spanner_v1/gapic/enums.py b/google/cloud/spanner_v1/gapic/enums.py index 445abc8429..1372d3c05a 100644 --- a/google/cloud/spanner_v1/gapic/enums.py +++ b/google/cloud/spanner_v1/gapic/enums.py @@ -21,8 +21,8 @@ class NullValue(enum.IntEnum): """ - ``NullValue`` is a singleton enumeration to represent the null value for - the ``Value`` type union. + ``NullValue`` is a singleton enumeration to represent the null value + for the ``Value`` type union. The JSON representation for ``NullValue`` is JSON ``null``. @@ -35,8 +35,8 @@ class NullValue(enum.IntEnum): class TypeCode(enum.IntEnum): """ - ``TypeCode`` is used as part of ``Type`` to indicate the type of a Cloud - Spanner value. + ``TypeCode`` is used as part of ``Type`` to indicate the type of a + Cloud Spanner value. Each legal value of a type can be encoded to or decoded from a JSON value, using the encodings described below. All Cloud Spanner values can @@ -49,8 +49,8 @@ class TypeCode(enum.IntEnum): INT64 (int): Encoded as ``string``, in decimal format. FLOAT64 (int): Encoded as ``number``, or the strings ``"NaN"``, ``"Infinity"``, or ``"-Infinity"``. - TIMESTAMP (int): Encoded as ``string`` in RFC 3339 timestamp format. The time zone must - be present, and must be ``"Z"``. + TIMESTAMP (int): Encoded as ``string`` in RFC 3339 timestamp format. The time zone + must be present, and must be ``"Z"``. If the schema has the column option ``allow_commit_timestamp=true``, the placeholder string ``"spanner.commit_timestamp()"`` can be used to @@ -60,10 +60,11 @@ class TypeCode(enum.IntEnum): STRING (int): Encoded as ``string``. BYTES (int): Encoded as a base64-encoded ``string``, as described in RFC 4648, section 4. - ARRAY (int): Encoded as ``list``, where the list elements are represented according - to ``array_element_type``. - STRUCT (int): Encoded as ``list``, where list element ``i`` is represented according - to [struct\_type.fields[i]][google.spanner.v1.StructType.fields]. + ARRAY (int): Encoded as ``list``, where the list elements are represented + according to ``array_element_type``. + STRUCT (int): Encoded as ``list``, where list element ``i`` is represented + according to + [struct_type.fields[i]][google.spanner.v1.StructType.fields]. """ TYPE_CODE_UNSPECIFIED = 0 @@ -99,14 +100,15 @@ class QueryMode(enum.IntEnum): class PlanNode(object): class Kind(enum.IntEnum): """ - The kind of ``PlanNode``. Distinguishes between the two different kinds - of nodes that can appear in a query plan. + The kind of ``PlanNode``. Distinguishes between the two different + kinds of nodes that can appear in a query plan. Attributes: KIND_UNSPECIFIED (int): Not specified. - RELATIONAL (int): Denotes a Relational operator node in the expression tree. Relational - operators represent iterative processing of rows during query execution. - For example, a ``TableScan`` operation that reads rows from a table. + RELATIONAL (int): Denotes a Relational operator node in the expression tree. + Relational operators represent iterative processing of rows during query + execution. For example, a ``TableScan`` operation that reads rows from a + table. SCALAR (int): Denotes a Scalar node in the expression tree. Scalar nodes represent non-iterable entities in the query plan. For example, constants or arithmetic operators appearing inside predicate expressions or references diff --git a/google/cloud/spanner_v1/gapic/spanner_client.py b/google/cloud/spanner_v1/gapic/spanner_client.py index 20b6522780..c0454761a0 100644 --- a/google/cloud/spanner_v1/gapic/spanner_client.py +++ b/google/cloud/spanner_v1/gapic/spanner_client.py @@ -336,8 +336,8 @@ def batch_create_sessions( Args: database (str): Required. The database in which the new sessions are created. - session_count (int): Required. The number of sessions to be created in this batch call. The - API may return fewer than the requested number of sessions. If a + session_count (int): Required. The number of sessions to be created in this batch call. + The API may return fewer than the requested number of sessions. If a specific number of sessions are desired, the client can make additional calls to BatchCreateSessions (adjusting ``session_count`` as necessary). session_template (Union[dict, ~google.cloud.spanner_v1.types.Session]): Parameters to be applied to each created session. @@ -506,8 +506,8 @@ def list_sessions( resource, this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page. - filter_ (str): An expression for filtering the results of the request. Filter rules are - case insensitive. The fields eligible for filtering are: + filter_ (str): An expression for filtering the results of the request. Filter rules + are case insensitive. The fields eligible for filtering are: - ``labels.key`` where key is the name of a label @@ -665,9 +665,9 @@ def execute_sql( metadata=None, ): """ - Executes an SQL statement, returning all results in a single reply. This - method cannot be used to return a result set larger than 10 MiB; if the - query yields more data than that, the query fails with a + Executes an SQL statement, returning all results in a single reply. + This method cannot be used to return a result set larger than 10 MiB; if + the query yields more data than that, the query fails with a ``FAILED_PRECONDITION`` error. Operations inside read-write transactions might return ``ABORTED``. If @@ -705,7 +705,8 @@ def execute_sql( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.TransactionSelector` - params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL string. + params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL + string. A parameter placeholder consists of the ``@`` character followed by the parameter name (for example, ``@firstName``). Parameter names can @@ -720,9 +721,9 @@ def execute_sql( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.Struct` - param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL type - from a JSON value. For example, values of type ``BYTES`` and values of - type ``STRING`` both appear in ``params`` as JSON strings. + param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL + type from a JSON value. For example, values of type ``BYTES`` and values + of type ``STRING`` both appear in ``params`` as JSON strings. In these cases, ``param_types`` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition @@ -742,7 +743,7 @@ def execute_sql( partition_token (bytes): If present, results will be restricted to the specified partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the - PartitionQueryRequest message used to create this partition\_token. + PartitionQueryRequest message used to create this partition_token. seqno (long): A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one will succeed. @@ -833,10 +834,10 @@ def execute_streaming_sql( metadata=None, ): """ - Like ``ExecuteSql``, except returns the result set as a stream. Unlike - ``ExecuteSql``, there is no limit on the size of the returned result - set. However, no individual row in the result set can exceed 100 MiB, - and no column value can exceed 10 MiB. + Like ``ExecuteSql``, except returns the result set as a stream. + Unlike ``ExecuteSql``, there is no limit on the size of the returned + result set. However, no individual row in the result set can exceed 100 + MiB, and no column value can exceed 10 MiB. Example: >>> from google.cloud import spanner_v1 @@ -868,7 +869,8 @@ def execute_streaming_sql( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.TransactionSelector` - params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL string. + params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL + string. A parameter placeholder consists of the ``@`` character followed by the parameter name (for example, ``@firstName``). Parameter names can @@ -883,9 +885,9 @@ def execute_streaming_sql( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.Struct` - param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL type - from a JSON value. For example, values of type ``BYTES`` and values of - type ``STRING`` both appear in ``params`` as JSON strings. + param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL + type from a JSON value. For example, values of type ``BYTES`` and values + of type ``STRING`` both appear in ``params`` as JSON strings. In these cases, ``param_types`` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition @@ -905,7 +907,7 @@ def execute_streaming_sql( partition_token (bytes): If present, results will be restricted to the specified partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the - PartitionQueryRequest message used to create this partition\_token. + PartitionQueryRequest message used to create this partition_token. seqno (long): A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one will succeed. @@ -1030,11 +1032,11 @@ def execute_batch_dml( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.TransactionSelector` - statements (list[Union[dict, ~google.cloud.spanner_v1.types.Statement]]): Required. The list of statements to execute in this batch. Statements - are executed serially, such that the effects of statement ``i`` are - visible to statement ``i+1``. Each statement must be a DML statement. - Execution stops at the first failed statement; the remaining statements - are not executed. + statements (list[Union[dict, ~google.cloud.spanner_v1.types.Statement]]): Required. The list of statements to execute in this batch. + Statements are executed serially, such that the effects of statement + ``i`` are visible to statement ``i+1``. Each statement must be a DML + statement. Execution stops at the first failed statement; the remaining + statements are not executed. Callers must provide at least one statement. @@ -1114,10 +1116,11 @@ def read( metadata=None, ): """ - Reads rows from the database using key lookups and scans, as a simple - key/value style alternative to ``ExecuteSql``. This method cannot be - used to return a result set larger than 10 MiB; if the read matches more - data than that, the read fails with a ``FAILED_PRECONDITION`` error. + Reads rows from the database using key lookups and scans, as a + simple key/value style alternative to ``ExecuteSql``. This method cannot + be used to return a result set larger than 10 MiB; if the read matches + more data than that, the read fails with a ``FAILED_PRECONDITION`` + error. Reads inside read-write transactions might return ``ABORTED``. If this occurs, the application should restart the transaction from the @@ -1147,8 +1150,8 @@ def read( Args: session (str): Required. The session in which the read should be performed. table (str): Required. The name of the table in the database to be read. - columns (list[str]): Required. The columns of ``table`` to be returned for each row matching - this request. + columns (list[str]): Required. The columns of ``table`` to be returned for each row + matching this request. key_set (Union[dict, ~google.cloud.spanner_v1.types.KeySet]): Required. ``key_set`` identifies the rows to be yielded. ``key_set`` names the primary keys of the rows in ``table`` to be yielded, unless ``index`` is present. If ``index`` is present, then ``key_set`` instead @@ -1183,7 +1186,7 @@ def read( partition_token (bytes): If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the - PartitionReadRequest message used to create this partition\_token. + PartitionReadRequest message used to create this partition_token. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1284,8 +1287,8 @@ def streaming_read( Args: session (str): Required. The session in which the read should be performed. table (str): Required. The name of the table in the database to be read. - columns (list[str]): Required. The columns of ``table`` to be returned for each row matching - this request. + columns (list[str]): Required. The columns of ``table`` to be returned for each row + matching this request. key_set (Union[dict, ~google.cloud.spanner_v1.types.KeySet]): Required. ``key_set`` identifies the rows to be yielded. ``key_set`` names the primary keys of the rows in ``table`` to be yielded, unless ``index`` is present. If ``index`` is present, then ``key_set`` instead @@ -1320,7 +1323,7 @@ def streaming_read( partition_token (bytes): If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the - PartitionReadRequest message used to create this partition\_token. + PartitionReadRequest message used to create this partition_token. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1469,8 +1472,8 @@ def commit( metadata=None, ): """ - Commits a transaction. The request includes the mutations to be applied - to rows in the database. + Commits a transaction. The request includes the mutations to be + applied to rows in the database. ``Commit`` might return an ``ABORTED`` error. This can occur at any time; commonly, the cause is conflicts with concurrent transactions. @@ -1490,12 +1493,12 @@ def commit( Args: session (str): Required. The session in which the transaction to be committed is running. transaction_id (bytes): Commit a previously-started transaction. - single_use_transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionOptions]): Execute mutations in a temporary transaction. Note that unlike commit of - a previously-started transaction, commit with a temporary transaction is - non-idempotent. That is, if the ``CommitRequest`` is sent to Cloud - Spanner more than once (for instance, due to retries in the application, - or in the transport library), it is possible that the mutations are - executed more than once. If this is undesirable, use + single_use_transaction (Union[dict, ~google.cloud.spanner_v1.types.TransactionOptions]): Execute mutations in a temporary transaction. Note that unlike + commit of a previously-started transaction, commit with a temporary + transaction is non-idempotent. That is, if the ``CommitRequest`` is sent + to Cloud Spanner more than once (for instance, due to retries in the + application, or in the transport library), it is possible that the + mutations are executed more than once. If this is undesirable, use ``BeginTransaction`` and ``Commit`` instead. If a dict is provided, it must be of the same form as the protobuf @@ -1657,11 +1660,11 @@ def partition_query( metadata=None, ): """ - Creates a set of partition tokens that can be used to execute a query - operation in parallel. Each of the returned partition tokens can be used - by ``ExecuteStreamingSql`` to specify a subset of the query result to - read. The same session and read-only transaction must be used by the - PartitionQueryRequest used to create the partition tokens and the + Creates a set of partition tokens that can be used to execute a + query operation in parallel. Each of the returned partition tokens can + be used by ``ExecuteStreamingSql`` to specify a subset of the query + result to read. The same session and read-only transaction must be used + by the PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use the partition tokens. Partition tokens become invalid when the session used to create them is @@ -1683,9 +1686,9 @@ def partition_query( Args: session (str): Required. The session used to create the partitions. - sql (str): Required. The query request to generate partitions for. The request will - fail if the query is not root partitionable. The query plan of a root - partitionable query has a single distributed union operator. A + sql (str): Required. The query request to generate partitions for. The request + will fail if the query is not root partitionable. The query plan of a + root partitionable query has a single distributed union operator. A distributed union operator conceptually divides one or more tables into multiple splits, remotely evaluates a subquery independently on each split, and then unions all results. @@ -1698,7 +1701,8 @@ def partition_query( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.TransactionSelector` - params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL string. + params (Union[dict, ~google.cloud.spanner_v1.types.Struct]): Parameter names and values that bind to placeholders in the SQL + string. A parameter placeholder consists of the ``@`` character followed by the parameter name (for example, ``@firstName``). Parameter names can @@ -1713,9 +1717,9 @@ def partition_query( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.spanner_v1.types.Struct` - param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL type - from a JSON value. For example, values of type ``BYTES`` and values of - type ``STRING`` both appear in ``params`` as JSON strings. + param_types (dict[str -> Union[dict, ~google.cloud.spanner_v1.types.Type]]): It is not always possible for Cloud Spanner to infer the right SQL + type from a JSON value. For example, values of type ``BYTES`` and values + of type ``STRING`` both appear in ``params`` as JSON strings. In these cases, ``param_types`` can be used to specify the exact SQL type for some or all of the SQL query parameters. See the definition of @@ -1803,8 +1807,7 @@ def partition_read( PartitionReadRequest used to create the partition tokens and the ReadRequests that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even - within each individual StreamingRead call issued with a - partition\_token. + within each individual StreamingRead call issued with a partition_token. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too diff --git a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py index 72b7beeda6..7cb2cb2ef2 100644 --- a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py +++ b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py @@ -214,9 +214,9 @@ def delete_session(self): def execute_sql(self): """Return the gRPC stub for :meth:`SpannerClient.execute_sql`. - Executes an SQL statement, returning all results in a single reply. This - method cannot be used to return a result set larger than 10 MiB; if the - query yields more data than that, the query fails with a + Executes an SQL statement, returning all results in a single reply. + This method cannot be used to return a result set larger than 10 MiB; if + the query yields more data than that, the query fails with a ``FAILED_PRECONDITION`` error. Operations inside read-write transactions might return ``ABORTED``. If @@ -237,10 +237,10 @@ def execute_sql(self): def execute_streaming_sql(self): """Return the gRPC stub for :meth:`SpannerClient.execute_streaming_sql`. - Like ``ExecuteSql``, except returns the result set as a stream. Unlike - ``ExecuteSql``, there is no limit on the size of the returned result - set. However, no individual row in the result set can exceed 100 MiB, - and no column value can exceed 10 MiB. + Like ``ExecuteSql``, except returns the result set as a stream. + Unlike ``ExecuteSql``, there is no limit on the size of the returned + result set. However, no individual row in the result set can exceed 100 + MiB, and no column value can exceed 10 MiB. Returns: Callable: A callable which accepts the appropriate @@ -276,10 +276,11 @@ def execute_batch_dml(self): def read(self): """Return the gRPC stub for :meth:`SpannerClient.read`. - Reads rows from the database using key lookups and scans, as a simple - key/value style alternative to ``ExecuteSql``. This method cannot be - used to return a result set larger than 10 MiB; if the read matches more - data than that, the read fails with a ``FAILED_PRECONDITION`` error. + Reads rows from the database using key lookups and scans, as a + simple key/value style alternative to ``ExecuteSql``. This method cannot + be used to return a result set larger than 10 MiB; if the read matches + more data than that, the read fails with a ``FAILED_PRECONDITION`` + error. Reads inside read-write transactions might return ``ABORTED``. If this occurs, the application should restart the transaction from the @@ -330,8 +331,8 @@ def begin_transaction(self): def commit(self): """Return the gRPC stub for :meth:`SpannerClient.commit`. - Commits a transaction. The request includes the mutations to be applied - to rows in the database. + Commits a transaction. The request includes the mutations to be + applied to rows in the database. ``Commit`` might return an ``ABORTED`` error. This can occur at any time; commonly, the cause is conflicts with concurrent transactions. @@ -369,11 +370,11 @@ def rollback(self): def partition_query(self): """Return the gRPC stub for :meth:`SpannerClient.partition_query`. - Creates a set of partition tokens that can be used to execute a query - operation in parallel. Each of the returned partition tokens can be used - by ``ExecuteStreamingSql`` to specify a subset of the query result to - read. The same session and read-only transaction must be used by the - PartitionQueryRequest used to create the partition tokens and the + Creates a set of partition tokens that can be used to execute a + query operation in parallel. Each of the returned partition tokens can + be used by ``ExecuteStreamingSql`` to specify a subset of the query + result to read. The same session and read-only transaction must be used + by the PartitionQueryRequest used to create the partition tokens and the ExecuteSqlRequests that use the partition tokens. Partition tokens become invalid when the session used to create them is @@ -399,8 +400,7 @@ def partition_read(self): PartitionReadRequest used to create the partition tokens and the ReadRequests that use the partition tokens. There are no ordering guarantees on rows returned among the returned partition tokens, or even - within each individual StreamingRead call issued with a - partition\_token. + within each individual StreamingRead call issued with a partition_token. Partition tokens become invalid when the session used to create them is deleted, is idle for too long, begins a new transaction, or becomes too diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index 9d38124847..21ee5557da 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/keys.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -23,12 +20,8 @@ name="google/cloud/spanner_v1/proto/keys.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\tKeysProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n(google/cloud/spanner_v1/proto/keys.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf4\x01\n\x08KeyRange\x12\x32\n\x0cstart_closed\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nstart_open\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nend_closed\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x12.\n\x08\x65nd_open\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x42\x10\n\x0estart_key_typeB\x0e\n\x0c\x65nd_key_type"l\n\x06KeySet\x12(\n\x04keys\x18\x01 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12+\n\x06ranges\x18\x02 \x03(\x0b\x32\x1b.google.spanner.v1.KeyRange\x12\x0b\n\x03\x61ll\x18\x03 \x01(\x08\x42\x92\x01\n\x15\x63om.google.spanner.v1B\tKeysProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\tKeysProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n(google/cloud/spanner_v1/proto/keys.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf4\x01\n\x08KeyRange\x12\x32\n\x0cstart_closed\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nstart_open\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nend_closed\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x12.\n\x08\x65nd_open\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x42\x10\n\x0estart_key_typeB\x0e\n\x0c\x65nd_key_type"l\n\x06KeySet\x12(\n\x04keys\x18\x01 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12+\n\x06ranges\x18\x02 \x03(\x0b\x32\x1b.google.spanner.v1.KeyRange\x12\x0b\n\x03\x61ll\x18\x03 \x01(\x08\x42\x92\x01\n\x15\x63om.google.spanner.v1B\tKeysProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, @@ -265,10 +258,10 @@ KeyRange = _reflection.GeneratedProtocolMessageType( "KeyRange", (_message.Message,), - dict( - DESCRIPTOR=_KEYRANGE, - __module__="google.cloud.spanner_v1.proto.keys_pb2", - __doc__="""KeyRange represents a range of rows in a table or index. + { + "DESCRIPTOR": _KEYRANGE, + "__module__": "google.cloud.spanner_v1.proto.keys_pb2", + "__doc__": """KeyRange represents a range of rows in a table or index. A range has a start key and an end key. These keys can be open or closed, indicating if the range includes rows with that key. @@ -282,31 +275,31 @@ :: - CREATE TABLE UserEvents ( - UserName STRING(MAX), - EventDate STRING(10) - ) PRIMARY KEY(UserName, EventDate); + CREATE TABLE UserEvents ( + UserName STRING(MAX), + EventDate STRING(10) + ) PRIMARY KEY(UserName, EventDate); The following keys name rows in this table: :: - ["Bob", "2014-09-23"] - ["Alfred", "2015-06-12"] + ["Bob", "2014-09-23"] + ["Alfred", "2015-06-12"] - Since the ``UserEvents`` table's ``PRIMARY KEY`` clause names two + Since the ``UserEvents`` table’s ``PRIMARY KEY`` clause names two columns, each ``UserEvents`` key has two elements; the first is the ``UserName``, and the second is the ``EventDate``. Key ranges with multiple components are interpreted lexicographically by - component using the table or index key's declared sort order. For + component using the table or index key’s declared sort order. For example, the following range returns all events for user ``"Bob"`` that occurred in the year 2015: :: - "start_closed": ["Bob", "2015-01-01"] - "end_closed": ["Bob", "2015-12-31"] + "start_closed": ["Bob", "2015-01-01"] + "end_closed": ["Bob", "2015-12-31"] Start and end keys can omit trailing key components. This affects the inclusion and exclusion of rows that exactly match the provided key @@ -319,62 +312,62 @@ :: - "start_closed": ["Bob", "2000-01-01"] - "end_closed": ["Bob"] + "start_closed": ["Bob", "2000-01-01"] + "end_closed": ["Bob"] The next example retrieves all events for ``"Bob"``: :: - "start_closed": ["Bob"] - "end_closed": ["Bob"] + "start_closed": ["Bob"] + "end_closed": ["Bob"] To retrieve events before the year 2000: :: - "start_closed": ["Bob"] - "end_open": ["Bob", "2000-01-01"] + "start_closed": ["Bob"] + "end_open": ["Bob", "2000-01-01"] The following range includes all rows in the table: :: - "start_closed": [] - "end_closed": [] + "start_closed": [] + "end_closed": [] This range returns all users whose ``UserName`` begins with any character from A to C: :: - "start_closed": ["A"] - "end_open": ["D"] + "start_closed": ["A"] + "end_open": ["D"] This range returns all users whose ``UserName`` begins with B: :: - "start_closed": ["B"] - "end_open": ["C"] + "start_closed": ["B"] + "end_open": ["C"] Key ranges honor column sort order. For example, suppose a table is defined as follows: :: - CREATE TABLE DescendingSortedTable { - Key INT64, - ... - ) PRIMARY KEY(Key DESC); + CREATE TABLE DescendingSortedTable { + Key INT64, + ... + ) PRIMARY KEY(Key DESC); The following range retrieves all rows with key values between 1 and 100 inclusive: :: - "start_closed": ["100"] - "end_closed": ["1"] + "start_closed": ["100"] + "end_closed": ["1"] Note that 100 is passed as the start, and 1 is passed as the end, because ``Key`` is a descending column in the schema. @@ -402,19 +395,19 @@ ``len(end_open)`` key columns exactly match ``end_open``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.KeyRange) - ), + }, ) _sym_db.RegisterMessage(KeyRange) KeySet = _reflection.GeneratedProtocolMessageType( "KeySet", (_message.Message,), - dict( - DESCRIPTOR=_KEYSET, - __module__="google.cloud.spanner_v1.proto.keys_pb2", - __doc__="""\ ``KeySet`` defines a collection of Cloud Spanner keys - and/or key ranges. All the keys are expected to be in the same table or - index. The keys need not be sorted in any particular way. + { + "DESCRIPTOR": _KEYSET, + "__module__": "google.cloud.spanner_v1.proto.keys_pb2", + "__doc__": """``KeySet`` defines a collection of Cloud Spanner keys and/or key ranges. + All the keys are expected to be in the same table or index. The keys + need not be sorted in any particular way. If the same key is specified multiple times in the set (for example if two ranges, two keys, or a key and a range overlap), Cloud Spanner @@ -439,7 +432,7 @@ only yielded once. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) - ), + }, ) _sym_db.RegisterMessage(KeySet) diff --git a/google/cloud/spanner_v1/proto/mutation_pb2.py b/google/cloud/spanner_v1/proto/mutation_pb2.py index b6ad0429b8..c9573fcaa5 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/mutation.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -26,12 +23,8 @@ name="google/cloud/spanner_v1/proto/mutation.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\rMutationProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n,google/cloud/spanner_v1/proto/mutation.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a\x1cgoogle/api/annotations.proto"\xc6\x03\n\x08Mutation\x12\x33\n\x06insert\x18\x01 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x33\n\x06update\x18\x02 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12=\n\x10insert_or_update\x18\x03 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x07replace\x18\x04 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x06\x64\x65lete\x18\x05 \x01(\x0b\x32".google.spanner.v1.Mutation.DeleteH\x00\x1aS\n\x05Write\x12\r\n\x05table\x18\x01 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x02 \x03(\t\x12*\n\x06values\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x1a\x43\n\x06\x44\x65lete\x12\r\n\x05table\x18\x01 \x01(\t\x12*\n\x07key_set\x18\x02 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x0b\n\toperationB\x96\x01\n\x15\x63om.google.spanner.v1B\rMutationProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\rMutationProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n,google/cloud/spanner_v1/proto/mutation.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a\x1cgoogle/api/annotations.proto"\xc6\x03\n\x08Mutation\x12\x33\n\x06insert\x18\x01 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x33\n\x06update\x18\x02 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12=\n\x10insert_or_update\x18\x03 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x07replace\x18\x04 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x06\x64\x65lete\x18\x05 \x01(\x0b\x32".google.spanner.v1.Mutation.DeleteH\x00\x1aS\n\x05Write\x12\r\n\x05table\x18\x01 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x02 \x03(\t\x12*\n\x06values\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x1a\x43\n\x06\x44\x65lete\x12\r\n\x05table\x18\x01 \x01(\t\x12*\n\x07key_set\x18\x02 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x0b\n\toperationB\x96\x01\n\x15\x63om.google.spanner.v1B\rMutationProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR, @@ -56,7 +49,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -130,7 +123,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -329,16 +322,16 @@ Mutation = _reflection.GeneratedProtocolMessageType( "Mutation", (_message.Message,), - dict( - Write=_reflection.GeneratedProtocolMessageType( + { + "Write": _reflection.GeneratedProtocolMessageType( "Write", (_message.Message,), - dict( - DESCRIPTOR=_MUTATION_WRITE, - __module__="google.cloud.spanner_v1.proto.mutation_pb2", - __doc__="""Arguments to [insert][google.spanner.v1.Mutation.insert], + { + "DESCRIPTOR": _MUTATION_WRITE, + "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", + "__doc__": """Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], - [insert\_or\_update][google.spanner.v1.Mutation.insert\_or\_update], and + [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and [replace][google.spanner.v1.Mutation.replace] operations. @@ -365,15 +358,15 @@ [here][google.spanner.v1.TypeCode]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) - ), + }, ), - Delete=_reflection.GeneratedProtocolMessageType( + "Delete": _reflection.GeneratedProtocolMessageType( "Delete", (_message.Message,), - dict( - DESCRIPTOR=_MUTATION_DELETE, - __module__="google.cloud.spanner_v1.proto.mutation_pb2", - __doc__="""Arguments to [delete][google.spanner.v1.Mutation.delete] + { + "DESCRIPTOR": _MUTATION_DELETE, + "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", + "__doc__": """Arguments to [delete][google.spanner.v1.Mutation.delete] operations. @@ -384,17 +377,17 @@ Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete. The primary keys must be specified in the order in which they - appear in the ``PRIMARY KEY()`` clause of the table's + appear in the ``PRIMARY KEY()`` clause of the table’s equivalent DDL statement (the DDL statement used to create the table). Delete is idempotent. The transaction will succeed even if some or all rows do not exist. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Delete) - ), + }, ), - DESCRIPTOR=_MUTATION, - __module__="google.cloud.spanner_v1.proto.mutation_pb2", - __doc__="""A modification to one or more Cloud Spanner rows. + "DESCRIPTOR": _MUTATION, + "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", + "__doc__": """A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a [Commit][google.spanner.v1.Spanner.Commit] call. @@ -412,18 +405,18 @@ Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then its column values are overwritten with the ones provided. Any column values not - explicitly written are preserved. When using [insert\_or\_upd - ate][google.spanner.v1.Mutation.insert\_or\_update], just as - when using [insert][google.spanner.v1.Mutation.insert], all - ``NOT NULL`` columns in the table must be given a value. This - holds true even when the row already exists and will therefore + explicitly written are preserved. When using [insert_or_updat + e][google.spanner.v1.Mutation.insert_or_update], just as when + using [insert][google.spanner.v1.Mutation.insert], all ``NOT + NULL`` columns in the table must be given a value. This holds + true even when the row already exists and will therefore actually be updated. replace: Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is deleted, and the column - values provided are inserted instead. Unlike [insert\_or\_upda - te][google.spanner.v1.Mutation.insert\_or\_update], this means - any values not explicitly written become ``NULL``. In an + values provided are inserted instead. Unlike [insert_or_update + ][google.spanner.v1.Mutation.insert_or_update], this means any + values not explicitly written become ``NULL``. In an interleaved table, if you create the child table with the ``ON DELETE CASCADE`` annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child @@ -433,7 +426,7 @@ rows were present. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) - ), + }, ) _sym_db.RegisterMessage(Mutation) _sym_db.RegisterMessage(Mutation.Write) diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2.py b/google/cloud/spanner_v1/proto/query_plan_pb2.py index bc715b4549..e9b9ef46e1 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/query_plan.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -23,12 +20,8 @@ name="google/cloud/spanner_v1/proto/query_plan.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\016QueryPlanProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n.google/cloud/spanner_v1/proto/query_plan.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x08PlanNode\x12\r\n\x05index\x18\x01 \x01(\x05\x12.\n\x04kind\x18\x02 \x01(\x0e\x32 .google.spanner.v1.PlanNode.Kind\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\x0b\x63hild_links\x18\x04 \x03(\x0b\x32%.google.spanner.v1.PlanNode.ChildLink\x12M\n\x14short_representation\x18\x05 \x01(\x0b\x32/.google.spanner.v1.PlanNode.ShortRepresentation\x12)\n\x08metadata\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x30\n\x0f\x65xecution_stats\x18\x07 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a@\n\tChildLink\x12\x13\n\x0b\x63hild_index\x18\x01 \x01(\x05\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x10\n\x08variable\x18\x03 \x01(\t\x1a\xb2\x01\n\x13ShortRepresentation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12S\n\nsubqueries\x18\x02 \x03(\x0b\x32?.google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry\x1a\x31\n\x0fSubqueriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01"8\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRELATIONAL\x10\x01\x12\n\n\x06SCALAR\x10\x02"<\n\tQueryPlan\x12/\n\nplan_nodes\x18\x01 \x03(\x0b\x32\x1b.google.spanner.v1.PlanNodeB\x97\x01\n\x15\x63om.google.spanner.v1B\x0eQueryPlanProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\016QueryPlanProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n.google/cloud/spanner_v1/proto/query_plan.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x08PlanNode\x12\r\n\x05index\x18\x01 \x01(\x05\x12.\n\x04kind\x18\x02 \x01(\x0e\x32 .google.spanner.v1.PlanNode.Kind\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\x0b\x63hild_links\x18\x04 \x03(\x0b\x32%.google.spanner.v1.PlanNode.ChildLink\x12M\n\x14short_representation\x18\x05 \x01(\x0b\x32/.google.spanner.v1.PlanNode.ShortRepresentation\x12)\n\x08metadata\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x30\n\x0f\x65xecution_stats\x18\x07 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a@\n\tChildLink\x12\x13\n\x0b\x63hild_index\x18\x01 \x01(\x05\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x10\n\x08variable\x18\x03 \x01(\t\x1a\xb2\x01\n\x13ShortRepresentation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12S\n\nsubqueries\x18\x02 \x03(\x0b\x32?.google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry\x1a\x31\n\x0fSubqueriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01"8\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRELATIONAL\x10\x01\x12\n\n\x06SCALAR\x10\x02"<\n\tQueryPlan\x12/\n\nplan_nodes\x18\x01 \x03(\x0b\x32\x1b.google.spanner.v1.PlanNodeB\x97\x01\n\x15\x63om.google.spanner.v1B\x0eQueryPlanProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, @@ -98,7 +91,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -116,7 +109,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -154,7 +147,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -185,7 +178,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -210,7 +203,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -302,7 +295,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -463,14 +456,14 @@ PlanNode = _reflection.GeneratedProtocolMessageType( "PlanNode", (_message.Message,), - dict( - ChildLink=_reflection.GeneratedProtocolMessageType( + { + "ChildLink": _reflection.GeneratedProtocolMessageType( "ChildLink", (_message.Message,), - dict( - DESCRIPTOR=_PLANNODE_CHILDLINK, - __module__="google.cloud.spanner_v1.proto.query_plan_pb2", - __doc__="""Metadata associated with a parent-child relationship + { + "DESCRIPTOR": _PLANNODE_CHILDLINK, + "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", + "__doc__": """Metadata associated with a parent-child relationship appearing in a [PlanNode][google.spanner.v1.PlanNode]. @@ -494,25 +487,25 @@ the variable names assigned to the columns. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) - ), + }, ), - ShortRepresentation=_reflection.GeneratedProtocolMessageType( + "ShortRepresentation": _reflection.GeneratedProtocolMessageType( "ShortRepresentation", (_message.Message,), - dict( - SubqueriesEntry=_reflection.GeneratedProtocolMessageType( + { + "SubqueriesEntry": _reflection.GeneratedProtocolMessageType( "SubqueriesEntry", (_message.Message,), - dict( - DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, - __module__="google.cloud.spanner_v1.proto.query_plan_pb2" + { + "DESCRIPTOR": _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, + "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry) - ), + }, ), - DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION, - __module__="google.cloud.spanner_v1.proto.query_plan_pb2", - __doc__="""Condensed representation of a node and its subtree. Only present for - ``SCALAR`` [PlanNode(s)][google.spanner.v1.PlanNode]. + "DESCRIPTOR": _PLANNODE_SHORTREPRESENTATION, + "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", + "__doc__": """Condensed representation of a node and its subtree. Only + present for ``SCALAR`` [PlanNode(s)][google.spanner.v1.PlanNode]. Attributes: @@ -527,18 +520,18 @@ subquery may not necessarily be a direct child of this node. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation) - ), + }, ), - DESCRIPTOR=_PLANNODE, - __module__="google.cloud.spanner_v1.proto.query_plan_pb2", - __doc__="""Node information for nodes appearing in a - [QueryPlan.plan\_nodes][google.spanner.v1.QueryPlan.plan\_nodes]. + "DESCRIPTOR": _PLANNODE, + "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", + "__doc__": """Node information for nodes appearing in a + [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes]. Attributes: index: - The ``PlanNode``'s index in [node - list][google.spanner.v1.QueryPlan.plan\_nodes]. + The ``PlanNode``\ ’s index in [node + list][google.spanner.v1.QueryPlan.plan_nodes]. kind: Used to determine the type of node. May be needed for visualizing different kinds of nodes differently. For example, @@ -557,9 +550,9 @@ metadata: Attributes relevant to the node contained in a group of key- value pairs. For example, a Parameter Reference node could - have the following information in its metadata: :: { - "parameter_reference": "param1", "parameter_type": - "array" } + have the following information in its metadata: :: { + "parameter_reference": "param1", "parameter_type": + "array" } execution_stats: The execution statistics associated with the node, contained in a group of key-value pairs. Only present if the plan was @@ -567,7 +560,7 @@ of executions, number of rows/time per execution etc. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) - ), + }, ) _sym_db.RegisterMessage(PlanNode) _sym_db.RegisterMessage(PlanNode.ChildLink) @@ -577,10 +570,10 @@ QueryPlan = _reflection.GeneratedProtocolMessageType( "QueryPlan", (_message.Message,), - dict( - DESCRIPTOR=_QUERYPLAN, - __module__="google.cloud.spanner_v1.proto.query_plan_pb2", - __doc__="""Contains an ordered list of nodes appearing in the query + { + "DESCRIPTOR": _QUERYPLAN, + "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", + "__doc__": """Contains an ordered list of nodes appearing in the query plan. @@ -588,11 +581,11 @@ plan_nodes: The nodes in the query plan. Plan nodes are returned in pre- order starting with the plan root. Each - [PlanNode][google.spanner.v1.PlanNode]'s ``id`` corresponds to + [PlanNode][google.spanner.v1.PlanNode]’s ``id`` corresponds to its index in ``plan_nodes``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) - ), + }, ) _sym_db.RegisterMessage(QueryPlan) diff --git a/google/cloud/spanner_v1/proto/result_set_pb2.py b/google/cloud/spanner_v1/proto/result_set_pb2.py index 3740450e6b..9d01bec15e 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/result_set.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -32,12 +29,8 @@ name="google/cloud/spanner_v1/proto/result_set.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\016ResultSetProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\370\001\001\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n.google/cloud/spanner_v1/proto/result_set.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a.google/cloud/spanner_v1/proto/query_plan.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto\x1a\x1cgoogle/api/annotations.proto"\x9f\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"\xd1\x01\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"y\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\x9a\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\016ResultSetProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\370\001\001\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n.google/cloud/spanner_v1/proto/result_set.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a.google/cloud/spanner_v1/proto/query_plan.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto\x1a\x1cgoogle/api/annotations.proto"\x9f\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"\xd1\x01\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"y\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\x9a\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2.DESCRIPTOR, @@ -193,7 +186,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -438,10 +431,10 @@ ResultSet = _reflection.GeneratedProtocolMessageType( "ResultSet", (_message.Message,), - dict( - DESCRIPTOR=_RESULTSET, - __module__="google.cloud.spanner_v1.proto.result_set_pb2", - __doc__="""Results from [Read][google.spanner.v1.Spanner.Read] or + { + "DESCRIPTOR": _RESULTSET, + "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", + "__doc__": """Results from [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. @@ -450,35 +443,35 @@ Metadata about the result set, such as row type information. rows: Each element in ``rows`` is a row whose format is defined by [ - metadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_t - ype]. The ith element in each row matches the ith field in [me - tadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_typ - e]. Elements are encoded based on type as described + metadata.row_type][google.spanner.v1.ResultSetMetadata.row_typ + e]. The ith element in each row matches the ith field in [meta + data.row_type][google.spanner.v1.ResultSetMetadata.row_type]. + Elements are encoded based on type as described [here][google.spanner.v1.TypeCode]. stats: Query plan and execution statistics for the SQL statement that produced this result set. These can be requested by setting [E - xecuteSqlRequest.query\_mode][google.spanner.v1.ExecuteSqlRequ - est.query\_mode]. DML statements always produce stats - containing the number of rows modified, unless executed using - the [ExecuteSqlRequest.QueryMode.PLAN][google.spanner.v1.Execu - teSqlRequest.QueryMode.PLAN] [ExecuteSqlRequest.query\_mode][g - oogle.spanner.v1.ExecuteSqlRequest.query\_mode]. Other fields - may or may not be populated, based on the [ExecuteSqlRequest.q - uery\_mode][google.spanner.v1.ExecuteSqlRequest.query\_mode]. + xecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlReque + st.query_mode]. DML statements always produce stats containing + the number of rows modified, unless executed using the [Execut + eSqlRequest.QueryMode.PLAN][google.spanner.v1.ExecuteSqlReques + t.QueryMode.PLAN] [ExecuteSqlRequest.query_mode][google.spanne + r.v1.ExecuteSqlRequest.query_mode]. Other fields may or may + not be populated, based on the [ExecuteSqlRequest.query_mode][ + google.spanner.v1.ExecuteSqlRequest.query_mode]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSet) - ), + }, ) _sym_db.RegisterMessage(ResultSet) PartialResultSet = _reflection.GeneratedProtocolMessageType( "PartialResultSet", (_message.Message,), - dict( - DESCRIPTOR=_PARTIALRESULTSET, - __module__="google.cloud.spanner_v1.proto.result_set_pb2", - __doc__="""Partial results from a streaming read or SQL query. + { + "DESCRIPTOR": _PARTIALRESULTSET, + "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", + "__doc__": """Partial results from a streaming read or SQL query. Streaming reads and SQL queries better tolerate large result sets, large rows, and large values, but are a little trickier to consume. @@ -492,13 +485,13 @@ might be split into many ``PartialResultSet`` messages to accommodate large rows and/or large values. Every N complete values defines a row, where N is equal to the number of - entries in [metadata.row\_type.fields][google.spanner.v1.Struc - tType.fields]. Most values are encoded based on type as + entries in [metadata.row_type.fields][google.spanner.v1.Struct + Type.fields]. Most values are encoded based on type as described [here][google.spanner.v1.TypeCode]. It is possible - that the last value in values is "chunked", meaning that the + that the last value in values is “chunked”, meaning that the rest of the value is sent in subsequent ``PartialResultSet``\ - (s). This is denoted by the [chunked\_value][google.spanner.v1 - .PartialResultSet.chunked\_value] field. Two or more chunked + (s). This is denoted by the [chunked_value][google.spanner.v1. + PartialResultSet.chunked_value] field. Two or more chunked values can be merged to form a complete value as follows: - ``bool/number/null``: cannot be chunked - ``string``: concatenate the strings - ``list``: concatenate the lists. If @@ -508,29 +501,29 @@ concatenate the (field name, field value) pairs. If a field name is duplicated, then apply these rules recursively to merge the field values. Some examples of merging: :: - # Strings are concatenated. "foo", "bar" => "foobar" - # Lists of non-strings are concatenated. [2, 3], [4] => - [2, 3, 4] # Lists are concatenated, but the last and - first elements are merged # because they are strings. - ["a", "b"], ["c", "d"] => ["a", "bc", "d"] # Lists are - concatenated, but the last and first elements are merged # + # Strings are concatenated. "foo", "bar" => "foobar" # + Lists of non-strings are concatenated. [2, 3], [4] => [2, + 3, 4] # Lists are concatenated, but the last and first + elements are merged # because they are strings. ["a", + "b"], ["c", "d"] => ["a", "bc", "d"] # Lists are + concatenated, but the last and first elements are merged # because they are lists. Recursively, the last and first - elements # of the inner lists are merged because they are - strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", - "cd"], "e"] # Non-overlapping object fields are combined. - {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} # - Overlapping object fields are merged. {"a": "1"}, {"a": - "2"} => {"a": "12"} # Examples of merging objects - containing lists of strings. {"a": ["1"]}, {"a": ["2"]} => + elements # of the inner lists are merged because they are + strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", + "cd"], "e"] # Non-overlapping object fields are combined. + {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} # + Overlapping object fields are merged. {"a": "1"}, {"a": + "2"} => {"a": "12"} # Examples of merging objects + containing lists of strings. {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]} For a more complete example, suppose a streaming SQL query is yielding a result set whose rows contain a single string field. The following - ``PartialResultSet``\ s might be yielded: :: { - "metadata": { ... } "values": ["Hello", "W"] - "chunked_value": true "resume_token": "Af65..." } - { "values": ["orl"] "chunked_value": true - "resume_token": "Bqp2..." } { "values": ["d"] - "resume_token": "Zx1B..." } This sequence of + ``PartialResultSet``\ s might be yielded: :: { + "metadata": { ... } "values": ["Hello", "W"] + "chunked_value": true "resume_token": "Af65..." } { + "values": ["orl"] "chunked_value": true + "resume_token": "Bqp2..." } { "values": ["d"] + "resume_token": "Zx1B..." } This sequence of ``PartialResultSet``\ s encodes two rows, one containing the field value ``"Hello"``, and a second containing the field value ``"World" = "W" + "orl" + "d"``. @@ -548,23 +541,23 @@ stats: Query plan and execution statistics for the statement that produced this streaming result set. These can be requested by - setting [ExecuteSqlRequest.query\_mode][google.spanner.v1.Exec - uteSqlRequest.query\_mode] and are sent only once with the - last response in the stream. This field will also be present - in the last response for DML statements. + setting [ExecuteSqlRequest.query_mode][google.spanner.v1.Execu + teSqlRequest.query_mode] and are sent only once with the last + response in the stream. This field will also be present in the + last response for DML statements. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartialResultSet) - ), + }, ) _sym_db.RegisterMessage(PartialResultSet) ResultSetMetadata = _reflection.GeneratedProtocolMessageType( "ResultSetMetadata", (_message.Message,), - dict( - DESCRIPTOR=_RESULTSETMETADATA, - __module__="google.cloud.spanner_v1.proto.result_set_pb2", - __doc__="""Metadata about a [ResultSet][google.spanner.v1.ResultSet] + { + "DESCRIPTOR": _RESULTSETMETADATA, + "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", + "__doc__": """Metadata about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet]. @@ -573,25 +566,25 @@ Indicates the field names and types for the rows in the result set. For example, a SQL query like ``"SELECT UserId, UserName FROM Users"`` could return a ``row_type`` value like: :: - "fields": [ { "name": "UserId", "type": { "code": - "INT64" } }, { "name": "UserName", "type": { "code": - "STRING" } }, ] + "fields": [ { "name": "UserId", "type": { "code": "INT64" + } }, { "name": "UserName", "type": { "code": "STRING" } + }, ] transaction: If the read or SQL query began a transaction as a side-effect, the information about the new transaction is yielded here. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetMetadata) - ), + }, ) _sym_db.RegisterMessage(ResultSetMetadata) ResultSetStats = _reflection.GeneratedProtocolMessageType( "ResultSetStats", (_message.Message,), - dict( - DESCRIPTOR=_RESULTSETSTATS, - __module__="google.cloud.spanner_v1.proto.result_set_pb2", - __doc__="""Additional statistics about a + { + "DESCRIPTOR": _RESULTSETSTATS, + "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", + "__doc__": """Additional statistics about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet]. @@ -603,9 +596,9 @@ query_stats: Aggregated statistics from the execution of the query. Only present when the query is profiled. For example, a query could - return the statistics as follows: :: { - "rows_returned": "3", "elapsed_time": "1.22 secs", - "cpu_time": "1.19 secs" } + return the statistics as follows: :: { + "rows_returned": "3", "elapsed_time": "1.22 secs", + "cpu_time": "1.19 secs" } row_count: The number of rows modified by the DML statement. row_count_exact: @@ -616,7 +609,7 @@ returns a lower bound of the rows modified. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) - ), + }, ) _sym_db.RegisterMessage(ResultSetStats) diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index ab1ff4e42e..6d9c66bad4 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/spanner.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -44,12 +41,8 @@ name="google/cloud/spanner_v1/proto/spanner.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\014SpannerProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1\352A_\n\037spanner.googleapis.com/Database\022\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12 The - session has the label "env". - ``labels.env:dev`` --> The - session has the label "env" and the value of the label - contains the string "dev". + examples of using filters are: - ``labels.env:*`` –> The + session has the label “env”. - ``labels.env:dev`` –> The + session has the label “env” and the value of the label + contains the string “dev”. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsRequest) - ), + }, ) _sym_db.RegisterMessage(ListSessionsRequest) ListSessionsResponse = _reflection.GeneratedProtocolMessageType( "ListSessionsResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTSESSIONSRESPONSE, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _LISTSESSIONSRESPONSE, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The response for [ListSessions][google.spanner.v1.Spanner.ListSessions]. @@ -2510,17 +2475,17 @@ fetch more of the matching sessions. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsResponse) - ), + }, ) _sym_db.RegisterMessage(ListSessionsResponse) DeleteSessionRequest = _reflection.GeneratedProtocolMessageType( "DeleteSessionRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETESESSIONREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _DELETESESSIONREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [DeleteSession][google.spanner.v1.Spanner.DeleteSession]. @@ -2529,55 +2494,55 @@ Required. The name of the session to delete. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.DeleteSessionRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteSessionRequest) ExecuteSqlRequest = _reflection.GeneratedProtocolMessageType( "ExecuteSqlRequest", (_message.Message,), - dict( - QueryOptions=_reflection.GeneratedProtocolMessageType( + { + "QueryOptions": _reflection.GeneratedProtocolMessageType( "QueryOptions", (_message.Message,), - dict( - DESCRIPTOR=_EXECUTESQLREQUEST_QUERYOPTIONS, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""Query optimizer configuration. + { + "DESCRIPTOR": _EXECUTESQLREQUEST_QUERYOPTIONS, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """Query optimizer configuration. Attributes: optimizer_version: An option to control the selection of optimizer version. This parameter allows individual queries to pick different query - optimizer versions. Specifying "latest" as a value instructs + optimizer versions. Specifying “latest” as a value instructs Cloud Spanner to use the latest supported query optimizer version. If not specified, Cloud Spanner uses optimizer version set at the database level options. Any other positive integer (from the list of supported optimizer versions) overrides the default optimizer version for query execution. The list of supported optimizer versions can be queried from - SPANNER\_SYS.SUPPORTED\_OPTIMIZER\_VERSIONS. Executing a SQL + SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an invalid optimizer version will fail with a syntax error (``INVALID_ARGUMENT``) status. The ``optimizer_version`` statement hint has precedence over this setting. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.QueryOptions) - ), + }, ), - ParamTypesEntry=_reflection.GeneratedProtocolMessageType( + "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - dict( - DESCRIPTOR=_EXECUTESQLREQUEST_PARAMTYPESENTRY, - __module__="google.cloud.spanner_v1.proto.spanner_pb2" + { + "DESCRIPTOR": _EXECUTESQLREQUEST_PARAMTYPESENTRY, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry) - ), + }, ), - DESCRIPTOR=_EXECUTESQLREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + "DESCRIPTOR": _EXECUTESQLREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]. @@ -2629,9 +2594,9 @@ query_mode: Used to control the amount of debugging information returned in [ResultSetStats][google.spanner.v1.ResultSetStats]. If [par - tition\_token][google.spanner.v1.ExecuteSqlRequest.partition\_ - token] is set, - [query\_mode][google.spanner.v1.ExecuteSqlRequest.query\_mode] + tition_token][google.spanner.v1.ExecuteSqlRequest.partition_to + ken] is set, + [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] can only be set to [QueryMode.NORMAL][google.spanner.v1.Execut eSqlRequest.QueryMode.NORMAL]. partition_token: @@ -2639,7 +2604,7 @@ partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the PartitionQueryRequest message used to create - this partition\_token. + this partition_token. seqno: A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if @@ -2654,7 +2619,7 @@ Query optimizer configuration to use for the given query. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest) - ), + }, ) _sym_db.RegisterMessage(ExecuteSqlRequest) _sym_db.RegisterMessage(ExecuteSqlRequest.QueryOptions) @@ -2663,23 +2628,23 @@ ExecuteBatchDmlRequest = _reflection.GeneratedProtocolMessageType( "ExecuteBatchDmlRequest", (_message.Message,), - dict( - Statement=_reflection.GeneratedProtocolMessageType( + { + "Statement": _reflection.GeneratedProtocolMessageType( "Statement", (_message.Message,), - dict( - ParamTypesEntry=_reflection.GeneratedProtocolMessageType( + { + "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - dict( - DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY, - __module__="google.cloud.spanner_v1.proto.spanner_pb2" + { + "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry) - ), + }, ), - DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""A single DML statement. + "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST_STATEMENT, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """A single DML statement. Attributes: @@ -2707,11 +2672,11 @@ types. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement) - ), + }, ), - DESCRIPTOR=_EXECUTEBATCHDMLREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. @@ -2742,7 +2707,7 @@ requests will yield the same response as the first execution. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest) - ), + }, ) _sym_db.RegisterMessage(ExecuteBatchDmlRequest) _sym_db.RegisterMessage(ExecuteBatchDmlRequest.Statement) @@ -2751,10 +2716,10 @@ ExecuteBatchDmlResponse = _reflection.GeneratedProtocolMessageType( "ExecuteBatchDmlResponse", (_message.Message,), - dict( - DESCRIPTOR=_EXECUTEBATCHDMLRESPONSE, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _EXECUTEBATCHDMLRESPONSE, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The response for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. Contains a list of [ResultSet][google.spanner.v1.ResultSet] messages, one for each DML statement that has successfully executed, in the same order as the @@ -2805,17 +2770,17 @@ statement. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlResponse) - ), + }, ) _sym_db.RegisterMessage(ExecuteBatchDmlResponse) PartitionOptions = _reflection.GeneratedProtocolMessageType( "PartitionOptions", (_message.Message,), - dict( - DESCRIPTOR=_PARTITIONOPTIONS, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""Options for a PartitionQueryRequest and + { + "DESCRIPTOR": _PARTITIONOPTIONS, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """Options for a PartitionQueryRequest and PartitionReadRequest. @@ -2836,26 +2801,26 @@ be smaller or larger than this maximum count request. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionOptions) - ), + }, ) _sym_db.RegisterMessage(PartitionOptions) PartitionQueryRequest = _reflection.GeneratedProtocolMessageType( "PartitionQueryRequest", (_message.Message,), - dict( - ParamTypesEntry=_reflection.GeneratedProtocolMessageType( + { + "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - dict( - DESCRIPTOR=_PARTITIONQUERYREQUEST_PARAMTYPESENTRY, - __module__="google.cloud.spanner_v1.proto.spanner_pb2" + { + "DESCRIPTOR": _PARTITIONQUERYREQUEST_PARAMTYPESENTRY, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest.ParamTypesEntry) - ), + }, ), - DESCRIPTOR=_PARTITIONQUERYREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + "DESCRIPTOR": _PARTITIONQUERYREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery] @@ -2902,7 +2867,7 @@ created. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest) - ), + }, ) _sym_db.RegisterMessage(PartitionQueryRequest) _sym_db.RegisterMessage(PartitionQueryRequest.ParamTypesEntry) @@ -2910,10 +2875,10 @@ PartitionReadRequest = _reflection.GeneratedProtocolMessageType( "PartitionReadRequest", (_message.Message,), - dict( - DESCRIPTOR=_PARTITIONREADREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _PARTITIONREADREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [PartitionRead][google.spanner.v1.Spanner.PartitionRead] @@ -2930,10 +2895,10 @@ [table][google.spanner.v1.PartitionReadRequest.table]. This index is used instead of the table primary key when interpreting - [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] - and sorting result rows. See - [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] - for further information. + [key_set][google.spanner.v1.PartitionReadRequest.key_set] and + sorting result rows. See + [key_set][google.spanner.v1.PartitionReadRequest.key_set] for + further information. columns: The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be @@ -2947,7 +2912,7 @@ present. If [index][google.spanner.v1.PartitionReadRequest.index] is present, then - [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] + [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names index keys in [index][google.spanner.v1.PartitionReadRequest.index]. It is not an error for the ``key_set`` to name rows that do not @@ -2958,17 +2923,17 @@ created. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionReadRequest) - ), + }, ) _sym_db.RegisterMessage(PartitionReadRequest) Partition = _reflection.GeneratedProtocolMessageType( "Partition", (_message.Message,), - dict( - DESCRIPTOR=_PARTITION, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""Information returned for each partition returned in a + { + "DESCRIPTOR": _PARTITION, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """Information returned for each partition returned in a PartitionResponse. @@ -2979,17 +2944,17 @@ those identified by this partition token. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Partition) - ), + }, ) _sym_db.RegisterMessage(Partition) PartitionResponse = _reflection.GeneratedProtocolMessageType( "PartitionResponse", (_message.Message,), - dict( - DESCRIPTOR=_PARTITIONRESPONSE, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _PARTITIONRESPONSE, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The response for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery] or [PartitionRead][google.spanner.v1.Spanner.PartitionRead] @@ -3001,17 +2966,17 @@ Transaction created by this request. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionResponse) - ), + }, ) _sym_db.RegisterMessage(PartitionResponse) ReadRequest = _reflection.GeneratedProtocolMessageType( "ReadRequest", (_message.Message,), - dict( - DESCRIPTOR=_READREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for [Read][google.spanner.v1.Spanner.Read] and + { + "DESCRIPTOR": _READREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [Read][google.spanner.v1.Spanner.Read] and [StreamingRead][google.spanner.v1.Spanner.StreamingRead]. @@ -3027,9 +2992,9 @@ If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is used instead of the table primary key when interpreting - [key\_set][google.spanner.v1.ReadRequest.key\_set] and sorting + [key_set][google.spanner.v1.ReadRequest.key_set] and sorting result rows. See - [key\_set][google.spanner.v1.ReadRequest.key\_set] for further + [key_set][google.spanner.v1.ReadRequest.key_set] for further information. columns: Required. The columns of @@ -3041,17 +3006,16 @@ [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present. If [index][google.spanner.v1.ReadRequest.index] is - present, then - [key\_set][google.spanner.v1.ReadRequest.key\_set] instead - names index keys in + present, then [key_set][google.spanner.v1.ReadRequest.key_set] + instead names index keys in [index][google.spanner.v1.ReadRequest.index]. If the [partiti - on\_token][google.spanner.v1.ReadRequest.partition\_token] - field is empty, rows are yielded in table primary key order - (if [index][google.spanner.v1.ReadRequest.index] is empty) or + on_token][google.spanner.v1.ReadRequest.partition_token] field + is empty, rows are yielded in table primary key order (if + [index][google.spanner.v1.ReadRequest.index] is empty) or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If - the [partition\_token][google.spanner.v1.ReadRequest.partition - \_token] field is not empty, rows will be yielded in an + the [partition_token][google.spanner.v1.ReadRequest.partition_ + token] field is not empty, rows will be yielded in an unspecified order. It is not an error for the ``key_set`` to name rows that do not exist in the database. Read yields nothing for nonexistent rows. @@ -3072,20 +3036,20 @@ partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create - this partition\_token. + this partition_token. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ReadRequest) - ), + }, ) _sym_db.RegisterMessage(ReadRequest) BeginTransactionRequest = _reflection.GeneratedProtocolMessageType( "BeginTransactionRequest", (_message.Message,), - dict( - DESCRIPTOR=_BEGINTRANSACTIONREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _BEGINTRANSACTIONREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction]. @@ -3096,17 +3060,17 @@ Required. Options for the new transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.BeginTransactionRequest) - ), + }, ) _sym_db.RegisterMessage(BeginTransactionRequest) CommitRequest = _reflection.GeneratedProtocolMessageType( "CommitRequest", (_message.Message,), - dict( - DESCRIPTOR=_COMMITREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _COMMITREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [Commit][google.spanner.v1.Spanner.Commit]. @@ -3134,17 +3098,17 @@ in this list. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitRequest) - ), + }, ) _sym_db.RegisterMessage(CommitRequest) CommitResponse = _reflection.GeneratedProtocolMessageType( "CommitResponse", (_message.Message,), - dict( - DESCRIPTOR=_COMMITRESPONSE, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The response for + { + "DESCRIPTOR": _COMMITRESPONSE, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The response for [Commit][google.spanner.v1.Spanner.Commit]. @@ -3154,17 +3118,17 @@ committed. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitResponse) - ), + }, ) _sym_db.RegisterMessage(CommitResponse) RollbackRequest = _reflection.GeneratedProtocolMessageType( "RollbackRequest", (_message.Message,), - dict( - DESCRIPTOR=_ROLLBACKREQUEST, - __module__="google.cloud.spanner_v1.proto.spanner_pb2", - __doc__="""The request for + { + "DESCRIPTOR": _ROLLBACKREQUEST, + "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", + "__doc__": """The request for [Rollback][google.spanner.v1.Spanner.Rollback]. @@ -3176,7 +3140,7 @@ Required. The transaction to roll back. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.RollbackRequest) - ), + }, ) _sym_db.RegisterMessage(RollbackRequest) @@ -3219,9 +3183,7 @@ full_name="google.spanner.v1.Spanner", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.data" - ), + serialized_options=b"\312A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.data", serialized_start=4716, serialized_end=7596, methods=[ @@ -3232,9 +3194,7 @@ containing_service=None, input_type=_CREATESESSIONREQUEST, output_type=_SESSION, - serialized_options=_b( - '\202\323\344\223\002?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\001*\332A\010database' - ), + serialized_options=b'\202\323\344\223\002?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\001*\332A\010database', ), _descriptor.MethodDescriptor( name="BatchCreateSessions", @@ -3243,9 +3203,7 @@ containing_service=None, input_type=_BATCHCREATESESSIONSREQUEST, output_type=_BATCHCREATESESSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\001*\332A\026database,session_count' - ), + serialized_options=b'\202\323\344\223\002K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\001*\332A\026database,session_count', ), _descriptor.MethodDescriptor( name="GetSession", @@ -3254,9 +3212,7 @@ containing_service=None, input_type=_GETSESSIONREQUEST, output_type=_SESSION, - serialized_options=_b( - "\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name", ), _descriptor.MethodDescriptor( name="ListSessions", @@ -3265,9 +3221,7 @@ containing_service=None, input_type=_LISTSESSIONSREQUEST, output_type=_LISTSESSIONSRESPONSE, - serialized_options=_b( - "\202\323\344\223\002<\022:/v1/{database=projects/*/instances/*/databases/*}/sessions\332A\010database" - ), + serialized_options=b"\202\323\344\223\002<\022:/v1/{database=projects/*/instances/*/databases/*}/sessions\332A\010database", ), _descriptor.MethodDescriptor( name="DeleteSession", @@ -3276,9 +3230,7 @@ containing_service=None, input_type=_DELETESESSIONREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name", ), _descriptor.MethodDescriptor( name="ExecuteSql", @@ -3287,9 +3239,7 @@ containing_service=None, input_type=_EXECUTESQLREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET, - serialized_options=_b( - '\202\323\344\223\002K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\001*' - ), + serialized_options=b'\202\323\344\223\002K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\001*', ), _descriptor.MethodDescriptor( name="ExecuteStreamingSql", @@ -3298,9 +3248,7 @@ containing_service=None, input_type=_EXECUTESQLREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET, - serialized_options=_b( - '\202\323\344\223\002T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\001*' - ), + serialized_options=b'\202\323\344\223\002T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\001*', ), _descriptor.MethodDescriptor( name="ExecuteBatchDml", @@ -3309,9 +3257,7 @@ containing_service=None, input_type=_EXECUTEBATCHDMLREQUEST, output_type=_EXECUTEBATCHDMLRESPONSE, - serialized_options=_b( - '\202\323\344\223\002P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\001*' - ), + serialized_options=b'\202\323\344\223\002P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\001*', ), _descriptor.MethodDescriptor( name="Read", @@ -3320,9 +3266,7 @@ containing_service=None, input_type=_READREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET, - serialized_options=_b( - '\202\323\344\223\002E"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*' - ), + serialized_options=b'\202\323\344\223\002E"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*', ), _descriptor.MethodDescriptor( name="StreamingRead", @@ -3331,9 +3275,7 @@ containing_service=None, input_type=_READREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET, - serialized_options=_b( - '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\001*' - ), + serialized_options=b'\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\001*', ), _descriptor.MethodDescriptor( name="BeginTransaction", @@ -3342,9 +3284,7 @@ containing_service=None, input_type=_BEGINTRANSACTIONREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION, - serialized_options=_b( - '\202\323\344\223\002Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\001*\332A\017session,options' - ), + serialized_options=b'\202\323\344\223\002Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\001*\332A\017session,options', ), _descriptor.MethodDescriptor( name="Commit", @@ -3353,9 +3293,7 @@ containing_service=None, input_type=_COMMITREQUEST, output_type=_COMMITRESPONSE, - serialized_options=_b( - '\202\323\344\223\002G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\001*\332A session,transaction_id,mutations\332A(session,single_use_transaction,mutations' - ), + serialized_options=b'\202\323\344\223\002G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\001*\332A session,transaction_id,mutations\332A(session,single_use_transaction,mutations', ), _descriptor.MethodDescriptor( name="Rollback", @@ -3364,9 +3302,7 @@ containing_service=None, input_type=_ROLLBACKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - '\202\323\344\223\002I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*\332A\026session,transaction_id' - ), + serialized_options=b'\202\323\344\223\002I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*\332A\026session,transaction_id', ), _descriptor.MethodDescriptor( name="PartitionQuery", @@ -3375,9 +3311,7 @@ containing_service=None, input_type=_PARTITIONQUERYREQUEST, output_type=_PARTITIONRESPONSE, - serialized_options=_b( - '\202\323\344\223\002O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\001*' - ), + serialized_options=b'\202\323\344\223\002O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\001*', ), _descriptor.MethodDescriptor( name="PartitionRead", @@ -3386,9 +3320,7 @@ containing_service=None, input_type=_PARTITIONREADREQUEST, output_type=_PARTITIONRESPONSE, - serialized_options=_b( - '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*' - ), + serialized_options=b'\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*', ), ], ) diff --git a/google/cloud/spanner_v1/proto/transaction_pb2.py b/google/cloud/spanner_v1/proto/transaction_pb2.py index aa83e3373c..3de92c6a17 100644 --- a/google/cloud/spanner_v1/proto/transaction_pb2.py +++ b/google/cloud/spanner_v1/proto/transaction_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/transaction.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -24,12 +21,8 @@ name="google/cloud/spanner_v1/proto/transaction.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\020TransactionProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n/google/cloud/spanner_v1/proto/transaction.proto\x12\x11google.spanner.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xc3\x04\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x1a\x0b\n\tReadWrite\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode"M\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selectorB\x99\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\020TransactionProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n/google/cloud/spanner_v1/proto/transaction.proto\x12\x11google.spanner.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xc3\x04\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x1a\x0b\n\tReadWrite\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode"M\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selectorB\x99\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[ google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, @@ -315,7 +308,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -390,7 +383,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -541,39 +534,39 @@ TransactionOptions = _reflection.GeneratedProtocolMessageType( "TransactionOptions", (_message.Message,), - dict( - ReadWrite=_reflection.GeneratedProtocolMessageType( + { + "ReadWrite": _reflection.GeneratedProtocolMessageType( "ReadWrite", (_message.Message,), - dict( - DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""Message type to initiate a read-write transaction. + { + "DESCRIPTOR": _TRANSACTIONOPTIONS_READWRITE, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """Message type to initiate a read-write transaction. Currently this transaction type has no options. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadWrite) - ), + }, ), - PartitionedDml=_reflection.GeneratedProtocolMessageType( + "PartitionedDml": _reflection.GeneratedProtocolMessageType( "PartitionedDml", (_message.Message,), - dict( - DESCRIPTOR=_TRANSACTIONOPTIONS_PARTITIONEDDML, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""Message type to initiate a Partitioned DML transaction. + { + "DESCRIPTOR": _TRANSACTIONOPTIONS_PARTITIONEDDML, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """Message type to initiate a Partitioned DML transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.PartitionedDml) - ), + }, ), - ReadOnly=_reflection.GeneratedProtocolMessageType( + "ReadOnly": _reflection.GeneratedProtocolMessageType( "ReadOnly", (_message.Message,), - dict( - DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""Message type to initiate a read-only transaction. + { + "DESCRIPTOR": _TRANSACTIONOPTIONS_READONLY, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """Message type to initiate a read-only transaction. Attributes: @@ -596,7 +589,7 @@ Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if - the client's local clock is substantially skewed from Cloud + the client’s local clock is substantially skewed from Cloud Spanner commit timestamps. Useful for reading the freshest data available at a nearby replica, while bounding the possible staleness if the local replica has fallen behind. @@ -607,7 +600,7 @@ reads at a specific timestamp are repeatable; the same read at the same timestamp always returns the same data. If the timestamp is in the future, the read will block until the - specified timestamp, modulo the read's deadline. Useful for + specified timestamp, modulo the read’s deadline. Useful for large scale consistent reads such as mapreduces, or for coordinating many reads against a consistent snapshot of the data. A timestamp in RFC3339 UTC "Zulu" format, accurate to @@ -618,7 +611,7 @@ Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if - the client's local clock is substantially skewed from Cloud + the client’s local clock is substantially skewed from Cloud Spanner commit timestamps. Useful for reading at nearby replicas without the distributed timestamp negotiation overhead of ``max_staleness``. @@ -628,11 +621,11 @@ that describes the transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadOnly) - ), + }, ), - DESCRIPTOR=_TRANSACTIONOPTIONS, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""# Transactions + "DESCRIPTOR": _TRANSACTIONOPTIONS, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """# Transactions Each session can have at most one active transaction at a time. After the active transaction is completed, the session can immediately be @@ -683,7 +676,7 @@ not been terminated by [Commit][google.spanner.v1.Spanner.Commit] or [Rollback][google.spanner.v1.Spanner.Rollback]. Long periods of inactivity at the client may cause Cloud Spanner to release a - transaction's locks and abort it. + transaction’s locks and abort it. Conceptually, a read-write transaction consists of zero or more reads or SQL statements followed by [Commit][google.spanner.v1.Spanner.Commit]. @@ -701,7 +694,7 @@ the transaction has not modified any user data in Cloud Spanner. Unless the transaction commits, Cloud Spanner makes no guarantees about - how long the transaction's locks were held for. It is an error to use + how long the transaction’s locks were held for. It is an error to use Cloud Spanner locks for any sort of mutual exclusion other than between Cloud Spanner transactions themselves. @@ -711,7 +704,7 @@ When a transaction aborts, the application can choose to retry the whole transaction again. To maximize the chances of successfully committing the retry, the client should execute the retry in the same session as - the original attempt. The original session's lock priority increases + the original attempt. The original session’s lock priority increases with each consecutive abort, meaning that each attempt has a slightly better chance of success than the previous. @@ -727,7 +720,7 @@ A transaction is considered idle if it has no outstanding reads or SQL queries and has not started a read or SQL query within the last 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they - don't hold on to locks indefinitely. In that case, the commit will fail + don’t hold on to locks indefinitely. In that case, the commit will fail with error ``ABORTED``. If this behavior is undesirable, periodically executing a simple SQL @@ -778,8 +771,8 @@ Strong reads are guaranteed to see the effects of all transactions that have committed before the start of the read. Furthermore, all rows - yielded by a single read are consistent with each other -- if any part - of the read observes a transaction, all parts of the read see the + yielded by a single read are consistent with each other – if any part of + the read observes a transaction, all parts of the read see the transaction. Strong reads are not repeatable: two consecutive strong read-only @@ -804,15 +797,15 @@ The timestamp can either be expressed as an absolute Cloud Spanner commit timestamp or a staleness relative to the current time. - These modes do not require a "negotiation phase" to pick a timestamp. As + These modes do not require a “negotiation phase” to pick a timestamp. As a result, they execute slightly faster than the equivalent boundedly stale concurrency modes. On the other hand, boundedly stale reads usually return fresher results. See - [TransactionOptions.ReadOnly.read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read\_timestamp] + [TransactionOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read_timestamp] and - [TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness]. + [TransactionOptions.ReadOnly.exact_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness]. Bounded Staleness @@ -822,7 +815,7 @@ newest timestamp within the staleness bound that allows execution of the reads at the closest available replica without blocking. - All rows yielded are consistent with each other -- if any part of the + All rows yielded are consistent with each other – if any part of the read observes a transaction, all parts of the read see the transaction. Boundedly stale reads are not repeatable: two stale reads, even if they use the same staleness bound, can execute at different timestamps and @@ -842,16 +835,16 @@ transactions. See - [TransactionOptions.ReadOnly.max\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max\_staleness] + [TransactionOptions.ReadOnly.max_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max_staleness] and - [TransactionOptions.ReadOnly.min\_read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min\_read\_timestamp]. + [TransactionOptions.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min_read_timestamp]. Old Read Timestamps and Garbage Collection Cloud Spanner continuously garbage collects deleted and overwritten data in the background to reclaim storage space. This process is known as - "version GC". By default, version GC reclaims versions after they are + “version GC”. By default, version GC reclaims versions after they are one hour old. Because of this, Cloud Spanner cannot perform reads at read timestamps more than one hour in the past. This restriction also applies to in-progress reads and/or SQL queries whose timestamp become @@ -939,7 +932,7 @@ the ``session`` resource. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions) - ), + }, ) _sym_db.RegisterMessage(TransactionOptions) _sym_db.RegisterMessage(TransactionOptions.ReadWrite) @@ -949,10 +942,10 @@ Transaction = _reflection.GeneratedProtocolMessageType( "Transaction", (_message.Message,), - dict( - DESCRIPTOR=_TRANSACTION, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""A transaction. + { + "DESCRIPTOR": _TRANSACTION, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """A transaction. Attributes: @@ -967,23 +960,23 @@ read_timestamp: For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see [Transaction - Options.ReadOnly.return\_read\_timestamp][google.spanner.v1.Tr - ansactionOptions.ReadOnly.return\_read\_timestamp]. A - timestamp in RFC3339 UTC "Zulu" format, accurate to - nanoseconds. Example: ``"2014-10-02T15:01:23.045123456Z"``. + Options.ReadOnly.return_read_timestamp][google.spanner.v1.Tran + sactionOptions.ReadOnly.return_read_timestamp]. A timestamp + in RFC3339 UTC "Zulu" format, accurate to nanoseconds. + Example: ``"2014-10-02T15:01:23.045123456Z"``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Transaction) - ), + }, ) _sym_db.RegisterMessage(Transaction) TransactionSelector = _reflection.GeneratedProtocolMessageType( "TransactionSelector", (_message.Message,), - dict( - DESCRIPTOR=_TRANSACTIONSELECTOR, - __module__="google.cloud.spanner_v1.proto.transaction_pb2", - __doc__="""This message is used to select the transaction in which a + { + "DESCRIPTOR": _TRANSACTIONSELECTOR, + "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", + "__doc__": """This message is used to select the transaction in which a [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] call runs. @@ -1010,7 +1003,7 @@ [Transaction][google.spanner.v1.Transaction]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionSelector) - ), + }, ) _sym_db.RegisterMessage(TransactionSelector) diff --git a/google/cloud/spanner_v1/proto/type_pb2.py b/google/cloud/spanner_v1/proto/type_pb2.py index 2ef35b36c6..974f220690 100644 --- a/google/cloud/spanner_v1/proto/type_pb2.py +++ b/google/cloud/spanner_v1/proto/type_pb2.py @@ -2,9 +2,6 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/type.proto -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -23,12 +20,8 @@ name="google/cloud/spanner_v1/proto/type.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=_b( - "\n\025com.google.spanner.v1B\tTypeProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" - ), - serialized_pb=_b( - '\n(google/cloud/spanner_v1/proto/type.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto"\x9a\x01\n\x04Type\x12)\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCode\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\x8e\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\tB\x92\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' - ), + serialized_options=b"\n\025com.google.spanner.v1B\tTypeProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", + serialized_pb=b'\n(google/cloud/spanner_v1/proto/type.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto"\x9a\x01\n\x04Type\x12)\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCode\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\x8e\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\tB\x92\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR], ) @@ -184,7 +177,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -276,10 +269,10 @@ Type = _reflection.GeneratedProtocolMessageType( "Type", (_message.Message,), - dict( - DESCRIPTOR=_TYPE, - __module__="google.cloud.spanner_v1.proto.type_pb2", - __doc__="""\ ``Type`` indicates the type of a Cloud Spanner value, as + { + "DESCRIPTOR": _TYPE, + "__module__": "google.cloud.spanner_v1.proto.type_pb2", + "__doc__": """\ ``Type`` indicates the type of a Cloud Spanner value, as might be stored in a table cell or returned from an SQL query. @@ -294,25 +287,25 @@ struct_type: If [code][google.spanner.v1.Type.code] == [STRUCT][google.spanner.v1.TypeCode.STRUCT], then - ``struct_type`` provides type information for the struct's + ``struct_type`` provides type information for the struct’s fields. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Type) - ), + }, ) _sym_db.RegisterMessage(Type) StructType = _reflection.GeneratedProtocolMessageType( "StructType", (_message.Message,), - dict( - Field=_reflection.GeneratedProtocolMessageType( + { + "Field": _reflection.GeneratedProtocolMessageType( "Field", (_message.Message,), - dict( - DESCRIPTOR=_STRUCTTYPE_FIELD, - __module__="google.cloud.spanner_v1.proto.type_pb2", - __doc__="""Message representing a single field of a struct. + { + "DESCRIPTOR": _STRUCTTYPE_FIELD, + "__module__": "google.cloud.spanner_v1.proto.type_pb2", + "__doc__": """Message representing a single field of a struct. Attributes: @@ -321,18 +314,18 @@ SQL queries, it is the column alias (e.g., ``"Word"`` in the query ``"SELECT 'hello' AS Word"``), or the column name (e.g., ``"ColName"`` in the query ``"SELECT ColName FROM Table"``). - Some columns might have an empty name (e.g., !"SELECT - UPPER(ColName)"\`). Note that a query result can contain + Some columns might have an empty name (e.g., !“SELECT + UPPER(ColName)”\`). Note that a query result can contain multiple fields with the same name. type: The type of the field. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType.Field) - ), + }, ), - DESCRIPTOR=_STRUCTTYPE, - __module__="google.cloud.spanner_v1.proto.type_pb2", - __doc__="""\ ``StructType`` defines the fields of a + "DESCRIPTOR": _STRUCTTYPE, + "__module__": "google.cloud.spanner_v1.proto.type_pb2", + "__doc__": """\ ``StructType`` defines the fields of a [STRUCT][google.spanner.v1.TypeCode.STRUCT] type. @@ -347,7 +340,7 @@ the order of fields in the ``SELECT`` clause of a query. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType) - ), + }, ) _sym_db.RegisterMessage(StructType) _sym_db.RegisterMessage(StructType.Field) diff --git a/synth.metadata b/synth.metadata index 65874481f1..a157d58dab 100644 --- a/synth.metadata +++ b/synth.metadata @@ -1,32 +1,25 @@ { "sources": [ - { - "generator": { - "name": "artman", - "version": "2.0.0", - "dockerImage": "googleapis/artman@sha256:b3b47805231a305d0f40c4bf069df20f6a2635574e6d4259fac651d3f9f6e098" - } - }, { "git": { "name": ".", "remote": "https://github.com/googleapis/python-spanner.git", - "sha": "1d4976634cb81dd11b0ddc4bfc9fe9c61a7e7041" + "sha": "b8c1a671fab4f08e6ba77628bdd3fa7b84c91e54" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "42ee97c1b93a0e3759bbba3013da309f670a90ab", - "internalRef": "307114445" + "sha": "89e89786896d256c70f43e68a975470c4f4f220e", + "internalRef": "311239362" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "f5e4c17dc78a966dbf29961dd01f9bbd63e20a04" + "sha": "84c4156c49be9dcabacc8fd7b0585b6fd789ae47" } } ], @@ -37,8 +30,7 @@ "apiName": "spanner", "apiVersion": "v1", "language": "python", - "generator": "gapic", - "config": "google/spanner/artman_spanner.yaml" + "generator": "bazel" } }, { @@ -47,8 +39,7 @@ "apiName": "spanner_admin_instance", "apiVersion": "v1", "language": "python", - "generator": "gapic", - "config": "google/spanner/admin/instance/artman_spanner_admin_instance.yaml" + "generator": "bazel" } }, { @@ -57,8 +48,7 @@ "apiName": "spanner_admin_database", "apiVersion": "v1", "language": "python", - "generator": "gapic", - "config": "google/spanner/admin/database/artman_spanner_admin_database.yaml" + "generator": "bazel" } } ] From 552b9875d5bace7647a3c5322a52f6c8ef16c3e0 Mon Sep 17 00:00:00 2001 From: larkee Date: Thu, 14 May 2020 14:26:34 +1000 Subject: [PATCH 2/2] remove _pb2 files and multiprocessing due to docs failures --- docs/multiprocessing.rst | 7 - .../proto/backup_pb2.py | 253 ++++---- .../proto/common_pb2.py | 25 +- .../proto/spanner_database_admin_pb2.py | 433 +++++++------ .../proto/spanner_database_admin_pb2_grpc.py | 92 +-- .../proto/spanner_instance_admin_pb2.py | 355 ++++++----- .../proto/spanner_instance_admin_pb2_grpc.py | 46 +- google/cloud/spanner_v1/proto/keys_pb2.py | 91 +-- google/cloud/spanner_v1/proto/mutation_pb2.py | 69 ++- .../cloud/spanner_v1/proto/query_plan_pb2.py | 93 +-- .../cloud/spanner_v1/proto/result_set_pb2.py | 145 ++--- google/cloud/spanner_v1/proto/spanner_pb2.py | 578 ++++++++++-------- .../cloud/spanner_v1/proto/transaction_pb2.py | 121 ++-- google/cloud/spanner_v1/proto/type_pb2.py | 51 +- 14 files changed, 1297 insertions(+), 1062 deletions(-) delete mode 100644 docs/multiprocessing.rst diff --git a/docs/multiprocessing.rst b/docs/multiprocessing.rst deleted file mode 100644 index 1cb29d4ca9..0000000000 --- a/docs/multiprocessing.rst +++ /dev/null @@ -1,7 +0,0 @@ -.. note:: - - Because this client uses :mod:`grpcio` library, it is safe to - share instances across threads. In multiprocessing scenarios, the best - practice is to create client instances *after* the invocation of - :func:`os.fork` by :class:`multiprocessing.Pool` or - :class:`multiprocessing.Process`. diff --git a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py index 5fdafde823..2d13e69a87 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py @@ -1,7 +1,10 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner_admin_database_v1/proto/backup.proto +# source: google/cloud/spanner/admin/database_v1/proto/backup.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -20,24 +23,28 @@ from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.cloud.spanner_admin_database_v1.proto import ( - common_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2, + common_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2, ) from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner_admin_database_v1/proto/backup.proto", + name="google/cloud/spanner/admin/database_v1/proto/backup.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=b"\n$com.google.spanner.admin.database.v1B\013BackupProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1", - serialized_pb=b'\n9google/cloud/spanner_admin_database_v1/proto/backup.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/common.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x03\n\x06\x42\x61\x63kup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x05 \x01(\x03\x42\x03\xe0\x41\x03\x12\x42\n\x05state\x18\x06 \x01(\x0e\x32..google.spanner.admin.database.v1.Backup.StateB\x03\xe0\x41\x03\x12"\n\x15referencing_databases\x18\x07 \x03(\tB\x03\xe0\x41\x03"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:\\\xea\x41Y\n\x1dspanner.googleapis.com/Backup\x12\x38projects/{project}/instances/{instance}/backups/{backup}"\xa5\x01\n\x13\x43reateBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12=\n\x06\x62\x61\x63kup\x18\x03 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02"\xae\x01\n\x14\x43reateBackupMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08\x64\x61tabase\x18\x02 \x01(\t\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8a\x01\n\x13UpdateBackupRequest\x12=\n\x06\x62\x61\x63kup\x18\x01 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"G\n\x10GetBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"J\n\x13\x44\x65leteBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"\x84\x01\n\x12ListBackupsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"i\n\x13ListBackupsResponse\x12\x39\n\x07\x62\x61\x63kups\x18\x01 \x03(\x0b\x32(.google.spanner.admin.database.v1.Backup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8d\x01\n\x1bListBackupOperationsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"j\n\x1cListBackupOperationsResponse\x12\x31\n\noperations\x18\x01 \x03(\x0b\x32\x1d.google.longrunning.Operation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"f\n\nBackupInfo\x12\x0e\n\x06\x62\x61\x63kup\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fsource_database\x18\x03 \x01(\tB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x42\x61\x63kupProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3', + serialized_options=_b( + "\n$com.google.spanner.admin.database.v1B\013BackupProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1" + ), + serialized_pb=_b( + '\n9google/cloud/spanner/admin/database_v1/proto/backup.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a#google/longrunning/operations.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/common.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x03\n\x06\x42\x61\x63kup\x12\x36\n\x08\x64\x61tabase\x18\x02 \x01(\tB$\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12/\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x17\n\nsize_bytes\x18\x05 \x01(\x03\x42\x03\xe0\x41\x03\x12\x42\n\x05state\x18\x06 \x01(\x0e\x32..google.spanner.admin.database.v1.Backup.StateB\x03\xe0\x41\x03\x12"\n\x15referencing_databases\x18\x07 \x03(\tB\x03\xe0\x41\x03"7\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02:\\\xea\x41Y\n\x1dspanner.googleapis.com/Backup\x12\x38projects/{project}/instances/{instance}/backups/{backup}"\xa5\x01\n\x13\x43reateBackupRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x16\n\tbackup_id\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12=\n\x06\x62\x61\x63kup\x18\x03 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02"\xae\x01\n\x14\x43reateBackupMetadata\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x10\n\x08\x64\x61tabase\x18\x02 \x01(\t\x12\x45\n\x08progress\x18\x03 \x01(\x0b\x32\x33.google.spanner.admin.database.v1.OperationProgress\x12/\n\x0b\x63\x61ncel_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\x8a\x01\n\x13UpdateBackupRequest\x12=\n\x06\x62\x61\x63kup\x18\x01 \x01(\x0b\x32(.google.spanner.admin.database.v1.BackupB\x03\xe0\x41\x02\x12\x34\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMaskB\x03\xe0\x41\x02"G\n\x10GetBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"J\n\x13\x44\x65leteBackupRequest\x12\x33\n\x04name\x18\x01 \x01(\tB%\xe0\x41\x02\xfa\x41\x1f\n\x1dspanner.googleapis.com/Backup"\x84\x01\n\x12ListBackupsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"i\n\x13ListBackupsResponse\x12\x39\n\x07\x62\x61\x63kups\x18\x01 \x03(\x0b\x32(.google.spanner.admin.database.v1.Backup\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x8d\x01\n\x1bListBackupOperationsRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Instance\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"j\n\x1cListBackupOperationsResponse\x12\x31\n\noperations\x18\x01 \x03(\x0b\x32\x1d.google.longrunning.Operation\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"f\n\nBackupInfo\x12\x0e\n\x06\x62\x61\x63kup\x18\x01 \x01(\t\x12/\n\x0b\x63reate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x17\n\x0fsource_database\x18\x03 \x01(\tB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x42\x61\x63kupProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3' + ), dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_longrunning_dot_operations__pb2.DESCRIPTOR, google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, ], ) @@ -87,13 +94,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\372A!\n\037spanner.googleapis.com/Database", + serialized_options=_b("\372A!\n\037spanner.googleapis.com/Database"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -123,7 +130,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -147,7 +154,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -165,7 +172,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -183,7 +190,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -201,14 +208,16 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[_BACKUP_STATE], - serialized_options=b"\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}", + serialized_options=_b( + "\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}" + ), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -234,13 +243,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", + serialized_options=_b( + "\340A\002\372A!\n\037spanner.googleapis.com/Instance" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -252,13 +263,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002", + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -276,7 +287,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002", + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -309,7 +320,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -327,7 +338,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -408,7 +419,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002", + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -426,7 +437,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002", + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), ], @@ -459,13 +470,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002\372A\037\n\035spanner.googleapis.com/Backup", + serialized_options=_b( + "\340A\002\372A\037\n\035spanner.googleapis.com/Backup" + ), file=DESCRIPTOR, ) ], @@ -498,13 +511,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002\372A\037\n\035spanner.googleapis.com/Backup", + serialized_options=_b( + "\340A\002\372A\037\n\035spanner.googleapis.com/Backup" + ), file=DESCRIPTOR, ) ], @@ -537,13 +552,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", + serialized_options=_b( + "\340A\002\372A!\n\037spanner.googleapis.com/Instance" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -555,7 +572,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -591,7 +608,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -648,7 +665,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -687,13 +704,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002\372A!\n\037spanner.googleapis.com/Instance", + serialized_options=_b( + "\340A\002\372A!\n\037spanner.googleapis.com/Instance" + ), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -705,7 +724,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -741,7 +760,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -798,7 +817,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -837,7 +856,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -873,7 +892,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -907,7 +926,7 @@ _CREATEBACKUPMETADATA.fields_by_name[ "progress" ].message_type = ( - google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS + google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS ) _CREATEBACKUPMETADATA.fields_by_name[ "cancel_time" @@ -943,10 +962,10 @@ Backup = _reflection.GeneratedProtocolMessageType( "Backup", (_message.Message,), - { - "DESCRIPTOR": _BACKUP, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """A backup of a Cloud Spanner database. + dict( + DESCRIPTOR=_BACKUP, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""A backup of a Cloud Spanner database. Attributes: @@ -997,17 +1016,17 @@ the ``READY`` state, the reference to the backup is removed. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.Backup) - }, + ), ) _sym_db.RegisterMessage(Backup) CreateBackupRequest = _reflection.GeneratedProtocolMessageType( "CreateBackupRequest", (_message.Message,), - { - "DESCRIPTOR": _CREATEBACKUPREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_CREATEBACKUPREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup]. @@ -1028,17 +1047,17 @@ Required. The backup to create. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupRequest) - }, + ), ) _sym_db.RegisterMessage(CreateBackupRequest) CreateBackupMetadata = _reflection.GeneratedProtocolMessageType( "CreateBackupMetadata", (_message.Message,), - { - "DESCRIPTOR": _CREATEBACKUPMETADATA, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """Metadata type for the operation returned by + dict( + DESCRIPTOR=_CREATEBACKUPMETADATA, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""Metadata type for the operation returned by [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup]. @@ -1066,17 +1085,17 @@ corresponding to ``Code.CANCELLED``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupMetadata) - }, + ), ) _sym_db.RegisterMessage(CreateBackupMetadata) UpdateBackupRequest = _reflection.GeneratedProtocolMessageType( "UpdateBackupRequest", (_message.Message,), - { - "DESCRIPTOR": _UPDATEBACKUPREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_UPDATEBACKUPREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [UpdateBackup][google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup]. @@ -1095,17 +1114,17 @@ clients that do not know about them. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateBackupRequest) - }, + ), ) _sym_db.RegisterMessage(UpdateBackupRequest) GetBackupRequest = _reflection.GeneratedProtocolMessageType( "GetBackupRequest", (_message.Message,), - { - "DESCRIPTOR": _GETBACKUPREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_GETBACKUPREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup]. @@ -1115,17 +1134,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetBackupRequest) - }, + ), ) _sym_db.RegisterMessage(GetBackupRequest) DeleteBackupRequest = _reflection.GeneratedProtocolMessageType( "DeleteBackupRequest", (_message.Message,), - { - "DESCRIPTOR": _DELETEBACKUPREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_DELETEBACKUPREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [DeleteBackup][google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup]. @@ -1135,17 +1154,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DeleteBackupRequest) - }, + ), ) _sym_db.RegisterMessage(DeleteBackupRequest) ListBackupsRequest = _reflection.GeneratedProtocolMessageType( "ListBackupsRequest", (_message.Message,), - { - "DESCRIPTOR": _LISTBACKUPSREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_LISTBACKUPSREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups]. @@ -1169,40 +1188,40 @@ multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly. - Here are a few examples: - ``name:Howl`` - The backup’s name - contains the string “howl”. - ``database:prod`` - The - database’s name contains the string “prod”. - + Here are a few examples: - ``name:Howl`` - The backup's name + contains the string "howl". - ``database:prod`` - The + database's name contains the string "prod". - ``state:CREATING`` - The backup is pending creation. - ``state:READY`` - The backup is fully created and ready for use. - ``(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")`` - The backup name contains the - string “howl” and ``create_time`` of the backup is before + string "howl" and ``create_time`` of the backup is before 2018-03-28T14:50:00Z. - ``expire_time < \"2018-03-28T14:50:00Z\"`` - The backup ``expire_time`` is before 2018-03-28T14:50:00Z. - ``size_bytes > 10000000000`` - - The backup’s size is greater than 10GB + The backup's size is greater than 10GB page_size: Number of backups to be returned in the response. If 0 or - less, defaults to the server’s maximum allowed page size. + less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.database.v1.ListBackupsResponse.next_pa - ge_token] from a previous [ListBackupsResponse][google.spanner - .admin.database.v1.ListBackupsResponse] to the same ``parent`` - and with the same ``filter``. + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.database.v1.ListBackupsResponse.next\ + _page\_token] from a previous [ListBackupsResponse][google.spa + nner.admin.database.v1.ListBackupsResponse] to the same + ``parent`` and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsRequest) - }, + ), ) _sym_db.RegisterMessage(ListBackupsRequest) ListBackupsResponse = _reflection.GeneratedProtocolMessageType( "ListBackupsResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTBACKUPSRESPONSE, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTBACKUPSRESPONSE, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The response for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups]. @@ -1217,17 +1236,17 @@ call to fetch more of the matching backups. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsResponse) - }, + ), ) _sym_db.RegisterMessage(ListBackupsResponse) ListBackupOperationsRequest = _reflection.GeneratedProtocolMessageType( "ListBackupOperationsRequest", (_message.Message,), - { - "DESCRIPTOR": _LISTBACKUPOPERATIONSREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_LISTBACKUPOPERATIONSREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The request for [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations]. @@ -1260,46 +1279,46 @@ AND, OR, and NOT logic explicitly. Here are a few examples: - ``done:true`` - The operation is complete. - ``metadata.database:prod`` - The database the backup was taken - from has a name containing the string “prod”. - ``(metadat + from has a name containing the string "prod". - ``(metadat a.@type=type.googleapis.com/google.spanner.admin.database.v1.C reateBackupMetadata) AND`` ``(metadata.name:howl) AND`` ``(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND`` ``(error:*)`` - Returns operations where: - The - operation’s metadata type is [CreateBackupMetadata][goog + operation's metadata type is [CreateBackupMetadata][goog le.spanner.admin.database.v1.CreateBackupMetadata]. - The - backup name contains the string “howl”. - The operation + backup name contains the string "howl". - The operation started before 2018-03-28T14:50:00Z. - The operation resulted in an error. page_size: Number of operations to be returned in the response. If 0 or - less, defaults to the server’s maximum allowed page size. + less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.database.v1.ListBackupOperationsRespons - e.next_page_token] from a previous [ListBackupOperationsRespon - se][google.spanner.admin.database.v1.ListBackupOperationsRespo - nse] to the same ``parent`` and with the same ``filter``. + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.database.v1.ListBackupOperationsRespo + nse.next\_page\_token] from a previous [ListBackupOperationsRe + sponse][google.spanner.admin.database.v1.ListBackupOperationsR + esponse] to the same ``parent`` and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsRequest) - }, + ), ) _sym_db.RegisterMessage(ListBackupOperationsRequest) ListBackupOperationsResponse = _reflection.GeneratedProtocolMessageType( "ListBackupOperationsResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTBACKUPOPERATIONSRESPONSE, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTBACKUPOPERATIONSRESPONSE, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""The response for [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations]. Attributes: operations: The list of matching backup [long-running - operations][google.longrunning.Operation]. Each operation’s - name will be prefixed by the backup’s name and the operation’s + operations][google.longrunning.Operation]. Each operation's + name will be prefixed by the backup's name and the operation's [metadata][google.longrunning.Operation.metadata] will be of type [CreateBackupMetadata][google.spanner.admin.database.v1.C reateBackupMetadata]. Operations returned include those that @@ -1313,17 +1332,17 @@ BackupOperations] call to fetch more of the matching metadata. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsResponse) - }, + ), ) _sym_db.RegisterMessage(ListBackupOperationsResponse) BackupInfo = _reflection.GeneratedProtocolMessageType( "BackupInfo", (_message.Message,), - { - "DESCRIPTOR": _BACKUPINFO, - "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", - "__doc__": """Information about a backup. + dict( + DESCRIPTOR=_BACKUPINFO, + __module__="google.cloud.spanner.admin.database_v1.proto.backup_pb2", + __doc__="""Information about a backup. Attributes: @@ -1337,7 +1356,7 @@ Name of the database the backup was created from. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) - }, + ), ) _sym_db.RegisterMessage(BackupInfo) diff --git a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py index e1027f7997..3acf791486 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py @@ -1,7 +1,10 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner_admin_database_v1/proto/common.proto +# source: google/cloud/spanner/admin/database_v1/proto/common.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -18,11 +21,15 @@ DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner_admin_database_v1/proto/common.proto", + name="google/cloud/spanner/admin/database_v1/proto/common.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=b"\n$com.google.spanner.admin.database.v1B\013CommonProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1", - serialized_pb=b'\n9google/cloud/spanner_admin_database_v1/proto/common.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x8b\x01\n\x11OperationProgress\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x43ommonProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3', + serialized_options=_b( + "\n$com.google.spanner.admin.database.v1B\013CommonProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1" + ), + serialized_pb=_b( + '\n9google/cloud/spanner/admin/database_v1/proto/common.proto\x12 google.spanner.admin.database.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\x8b\x01\n\x11OperationProgress\x12\x18\n\x10progress_percent\x18\x01 \x01(\x05\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\xd1\x01\n$com.google.spanner.admin.database.v1B\x0b\x43ommonProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1b\x06proto3' + ), dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, @@ -117,10 +124,10 @@ OperationProgress = _reflection.GeneratedProtocolMessageType( "OperationProgress", (_message.Message,), - { - "DESCRIPTOR": _OPERATIONPROGRESS, - "__module__": "google.cloud.spanner_admin_database_v1.proto.common_pb2", - "__doc__": """Encapsulates progress related information for a Cloud Spanner long + dict( + DESCRIPTOR=_OPERATIONPROGRESS, + __module__="google.cloud.spanner.admin.database_v1.proto.common_pb2", + __doc__="""Encapsulates progress related information for a Cloud Spanner long running operation. @@ -135,7 +142,7 @@ completed successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OperationProgress) - }, + ), ) _sym_db.RegisterMessage(OperationProgress) diff --git a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py index e67609530c..125ab3f86b 100644 --- a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2.py @@ -1,7 +1,10 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! -# source: google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto +# source: google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -25,19 +28,23 @@ from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.cloud.spanner_admin_database_v1.proto import ( - backup_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_backup__pb2, + backup_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_backup__pb2, ) from google.cloud.spanner_admin_database_v1.proto import ( - common_pb2 as google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2, + common_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2, ) DESCRIPTOR = _descriptor.FileDescriptor( - name="google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto", + name="google/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto", package="google.spanner.admin.database.v1", syntax="proto3", - serialized_options=b"\n$com.google.spanner.admin.database.v1B\031SpannerDatabaseAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}", - serialized_pb=b'\nIgoogle/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto\x12 google.spanner.admin.database.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/backup.proto\x1a\x39google/cloud/spanner_admin_database_v1/proto/common.proto"\xab\x01\n\x0bRestoreInfo\x12H\n\x0bsource_type\x18\x01 \x01(\x0e\x32\x33.google.spanner.admin.database.v1.RestoreSourceType\x12\x43\n\x0b\x62\x61\x63kup_info\x18\x02 \x01(\x0b\x32,.google.spanner.admin.database.v1.BackupInfoH\x00\x42\r\n\x0bsource_info"\x96\x03\n\x08\x44\x61tabase\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\x05state\x18\x02 \x01(\x0e\x32\x30.google.spanner.admin.database.v1.Database.StateB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x0crestore_info\x18\x04 \x01(\x0b\x32-.google.spanner.admin.database.v1.RestoreInfoB\x03\xe0\x41\x03"M\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x14\n\x10READY_OPTIMIZING\x10\x03:b\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/instances/*}/databases\xda\x41\x06parent\x12\xa4\x02\n\x0e\x43reateDatabase\x12\x37.google.spanner.admin.database.v1.CreateDatabaseRequest\x1a\x1d.google.longrunning.Operation"\xb9\x01\x82\xd3\xe4\x93\x02\x32"-/v1/{parent=projects/*/instances/*}/databases:\x01*\xda\x41\x17parent,create_statement\xca\x41\x64\n)google.spanner.admin.database.v1.Database\x12\x37google.spanner.admin.database.v1.CreateDatabaseMetadata\x12\xad\x01\n\x0bGetDatabase\x12\x34.google.spanner.admin.database.v1.GetDatabaseRequest\x1a*.google.spanner.admin.database.v1.Database"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/instances/*/databases/*}\xda\x41\x04name\x12\x9d\x02\n\x11UpdateDatabaseDdl\x12:.google.spanner.admin.database.v1.UpdateDatabaseDdlRequest\x1a\x1d.google.longrunning.Operation"\xac\x01\x82\xd3\xe4\x93\x02:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\x01*\xda\x41\x13\x64\x61tabase,statements\xca\x41S\n\x15google.protobuf.Empty\x12:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata\x12\xa3\x01\n\x0c\x44ropDatabase\x12\x35.google.spanner.admin.database.v1.DropDatabaseRequest\x1a\x16.google.protobuf.Empty"D\x82\xd3\xe4\x93\x02\x33*1/v1/{database=projects/*/instances/*/databases/*}\xda\x41\x08\x64\x61tabase\x12\xcd\x01\n\x0eGetDatabaseDdl\x12\x37.google.spanner.admin.database.v1.GetDatabaseDdlRequest\x1a\x38.google.spanner.admin.database.v1.GetDatabaseDdlResponse"H\x82\xd3\xe4\x93\x02\x37\x12\x35/v1/{database=projects/*/instances/*/databases/*}/ddl\xda\x41\x08\x64\x61tabase\x12\xeb\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9f\x01\x82\xd3\xe4\x93\x02\x86\x01">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\x01*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\x01*ZA".google.spanner.admin.database.v1.ListBackupOperationsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1/{parent=projects/*/instances/*}/backupOperations\xda\x41\x06parent\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xac\x02\n$com.google.spanner.admin.database.v1B\x19SpannerDatabaseAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}b\x06proto3', + serialized_options=_b( + "\n$com.google.spanner.admin.database.v1B\031SpannerDatabaseAdminProtoP\001ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\252\002&Google.Cloud.Spanner.Admin.Database.V1\312\002&Google\\Cloud\\Spanner\\Admin\\Database\\V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}" + ), + serialized_pb=_b( + '\nIgoogle/cloud/spanner/admin/database_v1/proto/spanner_database_admin.proto\x12 google.spanner.admin.database.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a#google/longrunning/operations.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/backup.proto\x1a\x39google/cloud/spanner/admin/database_v1/proto/common.proto"\xab\x01\n\x0bRestoreInfo\x12H\n\x0bsource_type\x18\x01 \x01(\x0e\x32\x33.google.spanner.admin.database.v1.RestoreSourceType\x12\x43\n\x0b\x62\x61\x63kup_info\x18\x02 \x01(\x0b\x32,.google.spanner.admin.database.v1.BackupInfoH\x00\x42\r\n\x0bsource_info"\x96\x03\n\x08\x44\x61tabase\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x44\n\x05state\x18\x02 \x01(\x0e\x32\x30.google.spanner.admin.database.v1.Database.StateB\x03\xe0\x41\x03\x12\x34\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x0crestore_info\x18\x04 \x01(\x0b\x32-.google.spanner.admin.database.v1.RestoreInfoB\x03\xe0\x41\x03"M\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0c\n\x08\x43REATING\x10\x01\x12\t\n\x05READY\x10\x02\x12\x14\n\x10READY_OPTIMIZING\x10\x03:b\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\x82\xd3\xe4\x93\x02/\x12-/v1/{parent=projects/*/instances/*}/databases\xda\x41\x06parent\x12\xa4\x02\n\x0e\x43reateDatabase\x12\x37.google.spanner.admin.database.v1.CreateDatabaseRequest\x1a\x1d.google.longrunning.Operation"\xb9\x01\x82\xd3\xe4\x93\x02\x32"-/v1/{parent=projects/*/instances/*}/databases:\x01*\xda\x41\x17parent,create_statement\xca\x41\x64\n)google.spanner.admin.database.v1.Database\x12\x37google.spanner.admin.database.v1.CreateDatabaseMetadata\x12\xad\x01\n\x0bGetDatabase\x12\x34.google.spanner.admin.database.v1.GetDatabaseRequest\x1a*.google.spanner.admin.database.v1.Database"<\x82\xd3\xe4\x93\x02/\x12-/v1/{name=projects/*/instances/*/databases/*}\xda\x41\x04name\x12\x9d\x02\n\x11UpdateDatabaseDdl\x12:.google.spanner.admin.database.v1.UpdateDatabaseDdlRequest\x1a\x1d.google.longrunning.Operation"\xac\x01\x82\xd3\xe4\x93\x02:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\x01*\xda\x41\x13\x64\x61tabase,statements\xca\x41S\n\x15google.protobuf.Empty\x12:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata\x12\xa3\x01\n\x0c\x44ropDatabase\x12\x35.google.spanner.admin.database.v1.DropDatabaseRequest\x1a\x16.google.protobuf.Empty"D\x82\xd3\xe4\x93\x02\x33*1/v1/{database=projects/*/instances/*/databases/*}\xda\x41\x08\x64\x61tabase\x12\xcd\x01\n\x0eGetDatabaseDdl\x12\x37.google.spanner.admin.database.v1.GetDatabaseDdlRequest\x1a\x38.google.spanner.admin.database.v1.GetDatabaseDdlResponse"H\x82\xd3\xe4\x93\x02\x37\x12\x35/v1/{database=projects/*/instances/*/databases/*}/ddl\xda\x41\x08\x64\x61tabase\x12\xeb\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"\x9f\x01\x82\xd3\xe4\x93\x02\x86\x01">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\x01*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\x01*ZA".google.spanner.admin.database.v1.ListBackupOperationsResponse"E\x82\xd3\xe4\x93\x02\x36\x12\x34/v1/{parent=projects/*/instances/*}/backupOperations\xda\x41\x06parent\x1ax\xca\x41\x16spanner.googleapis.com\xd2\x41\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.adminB\xac\x02\n$com.google.spanner.admin.database.v1B\x19SpannerDatabaseAdminProtoP\x01ZHgoogle.golang.org/genproto/googleapis/spanner/admin/database/v1;database\xaa\x02&Google.Cloud.Spanner.Admin.Database.V1\xca\x02&Google\\Cloud\\Spanner\\Admin\\Database\\V1\xea\x41J\n\x1fspanner.googleapis.com/Instance\x12\'projects/{project}/instances/{instance}b\x06proto3' + ), dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -48,8 +55,8 @@ google_dot_longrunning_dot_operations__pb2.DESCRIPTOR, google_dot_protobuf_dot_empty__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_backup__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_backup__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner_dot_admin_dot_database__v1_dot_proto_dot_common__pb2.DESCRIPTOR, ], ) @@ -198,13 +205,13 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\002", + serialized_options=_b("\340A\002"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -222,7 +229,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -240,7 +247,7 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), _descriptor.FieldDescriptor( @@ -258,14 +265,16 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=b"\340A\003", + serialized_options=_b("\340A\003"), file=DESCRIPTOR, ), ], extensions=[], nested_types=[], enum_types=[_DATABASE_STATE], - serialized_options=b"\352A_\n\037spanner.googleapis.com/Database\022/instances/``. page_size: Number of databases to be returned in the response. If 0 or - less, defaults to the server’s maximum allowed page size. + less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.database.v1.ListDatabasesResponse.next_ - page_token] from a previous [ListDatabasesResponse][google.spa - nner.admin.database.v1.ListDatabasesResponse]. + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.database.v1.ListDatabasesResponse.nex + t\_page\_token] from a previous [ListDatabasesResponse][google + .spanner.admin.database.v1.ListDatabasesResponse]. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesRequest) - }, + ), ) _sym_db.RegisterMessage(ListDatabasesRequest) ListDatabasesResponse = _reflection.GeneratedProtocolMessageType( "ListDatabasesResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTDATABASESRESPONSE, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTDATABASESRESPONSE, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The response for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases]. @@ -1438,17 +1463,17 @@ es] call to fetch more of the matching databases. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabasesResponse) - }, + ), ) _sym_db.RegisterMessage(ListDatabasesResponse) CreateDatabaseRequest = _reflection.GeneratedProtocolMessageType( "CreateDatabaseRequest", (_message.Message,), - { - "DESCRIPTOR": _CREATEDATABASEREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_CREATEDATABASEREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase]. @@ -1463,7 +1488,7 @@ regular expression ``[a-z][a-z0-9_\-]*[a-z0-9]`` and be between 2 and 30 characters in length. If the database ID is a reserved word or if it contains a hyphen, the database ID must - be enclosed in backticks (:literal:`\``). + be enclosed in backticks (`````). extra_statements: Optional. A list of DDL statements to run inside the newly created database. Statements can create tables, indexes, etc. @@ -1472,17 +1497,17 @@ is not created. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseRequest) - }, + ), ) _sym_db.RegisterMessage(CreateDatabaseRequest) CreateDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "CreateDatabaseMetadata", (_message.Message,), - { - "DESCRIPTOR": _CREATEDATABASEMETADATA, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """Metadata type for the operation returned by + dict( + DESCRIPTOR=_CREATEDATABASEMETADATA, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""Metadata type for the operation returned by [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase]. @@ -1491,17 +1516,17 @@ The database being created. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateDatabaseMetadata) - }, + ), ) _sym_db.RegisterMessage(CreateDatabaseMetadata) GetDatabaseRequest = _reflection.GeneratedProtocolMessageType( "GetDatabaseRequest", (_message.Message,), - { - "DESCRIPTOR": _GETDATABASEREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_GETDATABASEREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase]. @@ -1512,17 +1537,17 @@ database>``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseRequest) - }, + ), ) _sym_db.RegisterMessage(GetDatabaseRequest) UpdateDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType( "UpdateDatabaseDdlRequest", (_message.Message,), - { - "DESCRIPTOR": _UPDATEDATABASEDDLREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """Enqueues the given DDL statements to be applied, in order + dict( + DESCRIPTOR=_UPDATEDATABASEDDLREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""Enqueues the given DDL statements to be applied, in order but not necessarily all at once, to the database schema at some point (or points) in the future. The server checks that the statements are executable (syntactically valid, name tables that exist, etc.) before @@ -1536,7 +1561,7 @@ Each batch of statements is assigned a name which can be used with the [Operations][google.longrunning.Operations] API to monitor progress. See the - [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id] + [operation\_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation\_id] field for more details. @@ -1568,17 +1593,17 @@ returns ``ALREADY_EXISTS``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlRequest) - }, + ), ) _sym_db.RegisterMessage(UpdateDatabaseDdlRequest) UpdateDatabaseDdlMetadata = _reflection.GeneratedProtocolMessageType( "UpdateDatabaseDdlMetadata", (_message.Message,), - { - "DESCRIPTOR": _UPDATEDATABASEDDLMETADATA, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """Metadata type for the operation returned by + dict( + DESCRIPTOR=_UPDATEDATABASEDDLMETADATA, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""Metadata type for the operation returned by [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]. @@ -1594,17 +1619,17 @@ timestamp for the statement ``statements[i]``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata) - }, + ), ) _sym_db.RegisterMessage(UpdateDatabaseDdlMetadata) DropDatabaseRequest = _reflection.GeneratedProtocolMessageType( "DropDatabaseRequest", (_message.Message,), - { - "DESCRIPTOR": _DROPDATABASEREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_DROPDATABASEREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase]. @@ -1613,17 +1638,17 @@ Required. The database to be dropped. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DropDatabaseRequest) - }, + ), ) _sym_db.RegisterMessage(DropDatabaseRequest) GetDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType( "GetDatabaseDdlRequest", (_message.Message,), - { - "DESCRIPTOR": _GETDATABASEDDLREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_GETDATABASEDDLREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl]. @@ -1632,17 +1657,17 @@ Required. The database whose schema we wish to get. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlRequest) - }, + ), ) _sym_db.RegisterMessage(GetDatabaseDdlRequest) GetDatabaseDdlResponse = _reflection.GeneratedProtocolMessageType( "GetDatabaseDdlResponse", (_message.Message,), - { - "DESCRIPTOR": _GETDATABASEDDLRESPONSE, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_GETDATABASEDDLRESPONSE, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The response for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl]. @@ -1652,17 +1677,17 @@ database specified in the request. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlResponse) - }, + ), ) _sym_db.RegisterMessage(GetDatabaseDdlResponse) ListDatabaseOperationsRequest = _reflection.GeneratedProtocolMessageType( "ListDatabaseOperationsRequest", (_message.Message,), - { - "DESCRIPTOR": _LISTDATABASEOPERATIONSREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_LISTDATABASEOPERATIONSREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations]. @@ -1701,44 +1726,44 @@ ``(metadata.name:restored_howl) AND`` ``(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND`` ``(error:*)`` - Return operations where: - The - operation’s metadata type is [RestoreDatabaseMetadata][g + operation's metadata type is [RestoreDatabaseMetadata][g oogle.spanner.admin.database.v1.RestoreDatabaseMetadata]. - The database is restored from a backup. - The backup name - contains “backup_howl”. - The restored database’s name - contains “restored_howl”. - The operation started before + contains "backup\_howl". - The restored database's name + contains "restored\_howl". - The operation started before 2018-03-28T14:50:00Z. - The operation resulted in an error. page_size: Number of operations to be returned in the response. If 0 or - less, defaults to the server’s maximum allowed page size. + less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.database.v1.ListDatabaseOperationsRespo - nse.next_page_token] from a previous [ListDatabaseOperationsRe - sponse][google.spanner.admin.database.v1.ListDatabaseOperation - sResponse] to the same ``parent`` and with the same + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.database.v1.ListDatabaseOperationsRes + ponse.next\_page\_token] from a previous [ListDatabaseOperatio + nsResponse][google.spanner.admin.database.v1.ListDatabaseOpera + tionsResponse] to the same ``parent`` and with the same ``filter``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsRequest) - }, + ), ) _sym_db.RegisterMessage(ListDatabaseOperationsRequest) ListDatabaseOperationsResponse = _reflection.GeneratedProtocolMessageType( "ListDatabaseOperationsResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTDATABASEOPERATIONSRESPONSE, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTDATABASEOPERATIONSRESPONSE, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The response for [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations]. Attributes: operations: The list of matching database [long-running - operations][google.longrunning.Operation]. Each operation’s - name will be prefixed by the database’s name. The operation’s + operations][google.longrunning.Operation]. Each operation's + name will be prefixed by the database's name. The operation's [metadata][google.longrunning.Operation.metadata] field type ``metadata.type_url`` describes the type of the metadata. next_page_token: @@ -1748,17 +1773,17 @@ metadata. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsResponse) - }, + ), ) _sym_db.RegisterMessage(ListDatabaseOperationsResponse) RestoreDatabaseRequest = _reflection.GeneratedProtocolMessageType( "RestoreDatabaseRequest", (_message.Message,), - { - "DESCRIPTOR": _RESTOREDATABASEREQUEST, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_RESTOREDATABASEREQUEST, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""The request for [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. @@ -1783,17 +1808,17 @@ ``projects//instances//backups/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseRequest) - }, + ), ) _sym_db.RegisterMessage(RestoreDatabaseRequest) RestoreDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "RestoreDatabaseMetadata", (_message.Message,), - { - "DESCRIPTOR": _RESTOREDATABASEMETADATA, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """Metadata type for the long-running operation returned by + dict( + DESCRIPTOR=_RESTOREDATABASEMETADATA, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""Metadata type for the long-running operation returned by [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. @@ -1841,17 +1866,17 @@ the restore was not successful. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseMetadata) - }, + ), ) _sym_db.RegisterMessage(RestoreDatabaseMetadata) OptimizeRestoredDatabaseMetadata = _reflection.GeneratedProtocolMessageType( "OptimizeRestoredDatabaseMetadata", (_message.Message,), - { - "DESCRIPTOR": _OPTIMIZERESTOREDDATABASEMETADATA, - "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", - "__doc__": """Metadata type for the long-running operation used to track + dict( + DESCRIPTOR=_OPTIMIZERESTOREDDATABASEMETADATA, + __module__="google.cloud.spanner.admin.database_v1.proto.spanner_database_admin_pb2", + __doc__="""Metadata type for the long-running operation used to track the progress of optimizations performed on a newly restored database. This long-running operation is automatically created by the system after the successful completion of a database restore, and cannot be @@ -1865,7 +1890,7 @@ The progress of the post-restore optimizations. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) - }, + ), ) _sym_db.RegisterMessage(OptimizeRestoredDatabaseMetadata) @@ -1897,7 +1922,9 @@ full_name="google.spanner.admin.database.v1.DatabaseAdmin", file=DESCRIPTOR, index=0, - serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", + serialized_options=_b( + "\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin" + ), serialized_start=3100, serialized_end=7054, methods=[ @@ -1908,7 +1935,9 @@ containing_service=None, input_type=_LISTDATABASESREQUEST, output_type=_LISTDATABASESRESPONSE, - serialized_options=b"\202\323\344\223\002/\022-/v1/{parent=projects/*/instances/*}/databases\332A\006parent", + serialized_options=_b( + "\202\323\344\223\002/\022-/v1/{parent=projects/*/instances/*}/databases\332A\006parent" + ), ), _descriptor.MethodDescriptor( name="CreateDatabase", @@ -1917,7 +1946,9 @@ containing_service=None, input_type=_CREATEDATABASEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=b'\202\323\344\223\0022"-/v1/{parent=projects/*/instances/*}/databases:\001*\332A\027parent,create_statement\312Ad\n)google.spanner.admin.database.v1.Database\0227google.spanner.admin.database.v1.CreateDatabaseMetadata', + serialized_options=_b( + '\202\323\344\223\0022"-/v1/{parent=projects/*/instances/*}/databases:\001*\332A\027parent,create_statement\312Ad\n)google.spanner.admin.database.v1.Database\0227google.spanner.admin.database.v1.CreateDatabaseMetadata' + ), ), _descriptor.MethodDescriptor( name="GetDatabase", @@ -1926,7 +1957,9 @@ containing_service=None, input_type=_GETDATABASEREQUEST, output_type=_DATABASE, - serialized_options=b"\202\323\344\223\002/\022-/v1/{name=projects/*/instances/*/databases/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002/\022-/v1/{name=projects/*/instances/*/databases/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="UpdateDatabaseDdl", @@ -1935,7 +1968,9 @@ containing_service=None, input_type=_UPDATEDATABASEDDLREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=b"\202\323\344\223\002:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\001*\332A\023database,statements\312AS\n\025google.protobuf.Empty\022:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata", + serialized_options=_b( + "\202\323\344\223\002:25/v1/{database=projects/*/instances/*/databases/*}/ddl:\001*\332A\023database,statements\312AS\n\025google.protobuf.Empty\022:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata" + ), ), _descriptor.MethodDescriptor( name="DropDatabase", @@ -1944,7 +1979,9 @@ containing_service=None, input_type=_DROPDATABASEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=b"\202\323\344\223\0023*1/v1/{database=projects/*/instances/*/databases/*}\332A\010database", + serialized_options=_b( + "\202\323\344\223\0023*1/v1/{database=projects/*/instances/*/databases/*}\332A\010database" + ), ), _descriptor.MethodDescriptor( name="GetDatabaseDdl", @@ -1953,7 +1990,9 @@ containing_service=None, input_type=_GETDATABASEDDLREQUEST, output_type=_GETDATABASEDDLRESPONSE, - serialized_options=b"\202\323\344\223\0027\0225/v1/{database=projects/*/instances/*/databases/*}/ddl\332A\010database", + serialized_options=_b( + "\202\323\344\223\0027\0225/v1/{database=projects/*/instances/*/databases/*}/ddl\332A\010database" + ), ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -1962,7 +2001,9 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=b'\202\323\344\223\002\206\001">/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA"`__ for more details. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ReplicaInfo) - }, + ), ) _sym_db.RegisterMessage(ReplicaInfo) InstanceConfig = _reflection.GeneratedProtocolMessageType( "InstanceConfig", (_message.Message,), - { - "DESCRIPTOR": _INSTANCECONFIG, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """A possible configuration for a Cloud Spanner instance. + dict( + DESCRIPTOR=_INSTANCECONFIG, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""A possible configuration for a Cloud Spanner instance. Configurations define the geographic placement of nodes and their replication. @@ -1298,26 +1321,26 @@ configuration and their replication properties. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) - }, + ), ) _sym_db.RegisterMessage(InstanceConfig) Instance = _reflection.GeneratedProtocolMessageType( "Instance", (_message.Message,), - { - "LabelsEntry": _reflection.GeneratedProtocolMessageType( + dict( + LabelsEntry=_reflection.GeneratedProtocolMessageType( "LabelsEntry", (_message.Message,), - { - "DESCRIPTOR": _INSTANCE_LABELSENTRY, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2" + dict( + DESCRIPTOR=_INSTANCE_LABELSENTRY, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2" # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance.LabelsEntry) - }, + ), ), - "DESCRIPTOR": _INSTANCE, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """An isolated set of Cloud Spanner resources on which + DESCRIPTOR=_INSTANCE, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""An isolated set of Cloud Spanner resources on which databases can be hosted. @@ -1329,7 +1352,7 @@ The final segment of the name must be between 2 and 64 characters in length. config: - Required. The name of the instance’s configuration. Values are + Required. The name of the instance's configuration. Values are of the form ``projects//instanceConfigs/``. See also [InstanceConfig][google.spanner.admin.instance.v1.Instanc @@ -1355,11 +1378,11 @@ labels: Cloud Labels are a flexible and lightweight mechanism for organizing cloud resources into groups that reflect a - customer’s organizational needs and deployment strategies. + customer's organizational needs and deployment strategies. Cloud Labels can be used to filter collections of resources. They can be used to control how resource metrics are aggregated. And they can be used as arguments to policy - management rules (e.g. route, firewall, load balancing, etc.). + management rules (e.g. route, firewall, load balancing, etc.). - Label keys must be between 1 and 63 characters long and must conform to the following regular expression: ``[a-z]([-a-z0-9]*[a-z0-9])?``. - Label values must be @@ -1370,15 +1393,15 @@ of labels. If you plan to use labels in your own code, please note that additional characters may be allowed in the future. And so you are advised to use an internal label - representation, such as JSON, which doesn’t rely upon specific + representation, such as JSON, which doesn't rely upon specific characters being disallowed. For example, representing labels - as the string: name + “*" + value would prove problematic if - we were to allow "*” in a future release. + as the string: name + "*" + value would prove problematic if + we were to allow "*" in a future release. endpoint_uris: Deprecated. This field is not populated. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) - }, + ), ) _sym_db.RegisterMessage(Instance) _sym_db.RegisterMessage(Instance.LabelsEntry) @@ -1386,10 +1409,10 @@ ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType( "ListInstanceConfigsRequest", (_message.Message,), - { - "DESCRIPTOR": _LISTINSTANCECONFIGSREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_LISTINSTANCECONFIGSREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs]. @@ -1400,27 +1423,27 @@ the form ``projects/``. page_size: Number of instance configurations to be returned in the - response. If 0 or less, defaults to the server’s maximum + response. If 0 or less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse - .next_page_token] from a previous [ListInstanceConfigsResponse - ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse - ]. + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.instance.v1.ListInstanceConfigsRespon + se.next\_page\_token] from a previous [ListInstanceConfigsResp + onse][google.spanner.admin.instance.v1.ListInstanceConfigsResp + onse]. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsRequest) - }, + ), ) _sym_db.RegisterMessage(ListInstanceConfigsRequest) ListInstanceConfigsResponse = _reflection.GeneratedProtocolMessageType( "ListInstanceConfigsResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTINSTANCECONFIGSRESPONSE, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTINSTANCECONFIGSRESPONSE, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The response for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs]. @@ -1434,17 +1457,17 @@ configurations. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsResponse) - }, + ), ) _sym_db.RegisterMessage(ListInstanceConfigsResponse) GetInstanceConfigRequest = _reflection.GeneratedProtocolMessageType( "GetInstanceConfigRequest", (_message.Message,), - { - "DESCRIPTOR": _GETINSTANCECONFIGREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_GETINSTANCECONFIGREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [GetInstanceConfigRequest][google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig]. @@ -1455,17 +1478,17 @@ ``projects//instanceConfigs/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceConfigRequest) - }, + ), ) _sym_db.RegisterMessage(GetInstanceConfigRequest) GetInstanceRequest = _reflection.GeneratedProtocolMessageType( "GetInstanceRequest", (_message.Message,), - { - "DESCRIPTOR": _GETINSTANCEREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_GETINSTANCEREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [GetInstance][google.spanner.admin.instance.v1.InstanceAdmin.GetInstance]. @@ -1474,24 +1497,24 @@ Required. The name of the requested instance. Values are of the form ``projects//instances/``. field_mask: - If field_mask is present, specifies the subset of + If field\_mask is present, specifies the subset of [Instance][google.spanner.admin.instance.v1.Instance] fields that should be returned. If absent, all [Instance][google.spanner.admin.instance.v1.Instance] fields are returned. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest) - }, + ), ) _sym_db.RegisterMessage(GetInstanceRequest) CreateInstanceRequest = _reflection.GeneratedProtocolMessageType( "CreateInstanceRequest", (_message.Message,), - { - "DESCRIPTOR": _CREATEINSTANCEREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_CREATEINSTANCEREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance]. @@ -1508,17 +1531,17 @@ if specified must be ``/instances/``. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceRequest) - }, + ), ) _sym_db.RegisterMessage(CreateInstanceRequest) ListInstancesRequest = _reflection.GeneratedProtocolMessageType( "ListInstancesRequest", (_message.Message,), - { - "DESCRIPTOR": _LISTINSTANCESREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_LISTINSTANCESREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances]. @@ -1529,39 +1552,39 @@ ``projects/``. page_size: Number of instances to be returned in the response. If 0 or - less, defaults to the server’s maximum allowed page size. + less, defaults to the server's maximum allowed page size. page_token: - If non-empty, ``page_token`` should contain a [next_page_token - ][google.spanner.admin.instance.v1.ListInstancesResponse.next_ - page_token] from a previous [ListInstancesResponse][google.spa - nner.admin.instance.v1.ListInstancesResponse]. + If non-empty, ``page_token`` should contain a [next\_page\_tok + en][google.spanner.admin.instance.v1.ListInstancesResponse.nex + t\_page\_token] from a previous [ListInstancesResponse][google + .spanner.admin.instance.v1.ListInstancesResponse]. filter: An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: - ``name`` - ``display_name`` - ``labels.key`` where key is the name of a label Some examples of using filters - are: - ``name:*`` –> The instance has a name. - - ``name:Howl`` –> The instance’s name contains the string - “howl”. - ``name:HOWL`` –> Equivalent to above. - - ``NAME:howl`` –> Equivalent to above. - ``labels.env:*`` –> - The instance has the label “env”. - ``labels.env:dev`` –> The - instance has the label “env” and the value of the label - contains the string “dev”. - ``name:howl labels.env:dev`` –> - The instance’s name contains “howl” and it has the label - “env” with its value containing “dev”. + are: - ``name:*`` --> The instance has a name. - + ``name:Howl`` --> The instance's name contains the string + "howl". - ``name:HOWL`` --> Equivalent to above. - + ``NAME:howl`` --> Equivalent to above. - ``labels.env:*`` --> + The instance has the label "env". - ``labels.env:dev`` --> + The instance has the label "env" and the value of the label + contains the string "dev". - ``name:howl labels.env:dev`` --> + The instance's name contains "howl" and it has the label + "env" with its value containing "dev". """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesRequest) - }, + ), ) _sym_db.RegisterMessage(ListInstancesRequest) ListInstancesResponse = _reflection.GeneratedProtocolMessageType( "ListInstancesResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTINSTANCESRESPONSE, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTINSTANCESRESPONSE, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The response for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances]. @@ -1574,26 +1597,26 @@ es] call to fetch more of the matching instances. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesResponse) - }, + ), ) _sym_db.RegisterMessage(ListInstancesResponse) UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType( "UpdateInstanceRequest", (_message.Message,), - { - "DESCRIPTOR": _UPDATEINSTANCEREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_UPDATEINSTANCEREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]. Attributes: instance: Required. The instance to update, which must always include - the instance name. Otherwise, only fields mentioned in [field_ - mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.f - ield_mask] need be included. + the instance name. Otherwise, only fields mentioned in [field\ + _mask][google.spanner.admin.instance.v1.UpdateInstanceRequest. + field\_mask] need be included. field_mask: Required. A mask specifying which fields in [Instance][google.spanner.admin.instance.v1.Instance] should @@ -1604,17 +1627,17 @@ them. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest) - }, + ), ) _sym_db.RegisterMessage(UpdateInstanceRequest) DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType( "DeleteInstanceRequest", (_message.Message,), - { - "DESCRIPTOR": _DELETEINSTANCEREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_DELETEINSTANCEREQUEST, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""The request for [DeleteInstance][google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance]. @@ -1624,17 +1647,17 @@ of the form ``projects//instances/`` """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.DeleteInstanceRequest) - }, + ), ) _sym_db.RegisterMessage(DeleteInstanceRequest) CreateInstanceMetadata = _reflection.GeneratedProtocolMessageType( "CreateInstanceMetadata", (_message.Message,), - { - "DESCRIPTOR": _CREATEINSTANCEMETADATA, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """Metadata type for the operation returned by + dict( + DESCRIPTOR=_CREATEINSTANCEMETADATA, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""Metadata type for the operation returned by [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance]. @@ -1653,17 +1676,17 @@ successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceMetadata) - }, + ), ) _sym_db.RegisterMessage(CreateInstanceMetadata) UpdateInstanceMetadata = _reflection.GeneratedProtocolMessageType( "UpdateInstanceMetadata", (_message.Message,), - { - "DESCRIPTOR": _UPDATEINSTANCEMETADATA, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """Metadata type for the operation returned by + dict( + DESCRIPTOR=_UPDATEINSTANCEMETADATA, + __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2", + __doc__="""Metadata type for the operation returned by [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]. @@ -1682,7 +1705,7 @@ successfully. """, # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) - }, + ), ) _sym_db.RegisterMessage(UpdateInstanceMetadata) @@ -1708,7 +1731,9 @@ full_name="google.spanner.admin.instance.v1.InstanceAdmin", file=DESCRIPTOR, index=0, - serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", + serialized_options=_b( + "\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin" + ), serialized_start=2957, serialized_end=5068, methods=[ @@ -1719,7 +1744,9 @@ containing_service=None, input_type=_LISTINSTANCECONFIGSREQUEST, output_type=_LISTINSTANCECONFIGSRESPONSE, - serialized_options=b"\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent", + serialized_options=_b( + "\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent" + ), ), _descriptor.MethodDescriptor( name="GetInstanceConfig", @@ -1728,7 +1755,9 @@ containing_service=None, input_type=_GETINSTANCECONFIGREQUEST, output_type=_INSTANCECONFIG, - serialized_options=b"\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="ListInstances", @@ -1737,7 +1766,9 @@ containing_service=None, input_type=_LISTINSTANCESREQUEST, output_type=_LISTINSTANCESRESPONSE, - serialized_options=b"\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent", + serialized_options=_b( + "\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent" + ), ), _descriptor.MethodDescriptor( name="GetInstance", @@ -1746,7 +1777,9 @@ containing_service=None, input_type=_GETINSTANCEREQUEST, output_type=_INSTANCE, - serialized_options=b"\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="CreateInstance", @@ -1755,7 +1788,9 @@ containing_service=None, input_type=_CREATEINSTANCEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=b'\202\323\344\223\002&"!/v1/{parent=projects/*}/instances:\001*\332A\033parent,instance_id,instance\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.CreateInstanceMetadata', + serialized_options=_b( + '\202\323\344\223\002&"!/v1/{parent=projects/*}/instances:\001*\332A\033parent,instance_id,instance\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.CreateInstanceMetadata' + ), ), _descriptor.MethodDescriptor( name="UpdateInstance", @@ -1764,7 +1799,9 @@ containing_service=None, input_type=_UPDATEINSTANCEREQUEST, output_type=google_dot_longrunning_dot_operations__pb2._OPERATION, - serialized_options=b"\202\323\344\223\002/2*/v1/{instance.name=projects/*/instances/*}:\001*\332A\023instance,field_mask\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.UpdateInstanceMetadata", + serialized_options=_b( + "\202\323\344\223\002/2*/v1/{instance.name=projects/*/instances/*}:\001*\332A\023instance,field_mask\312Ad\n)google.spanner.admin.instance.v1.Instance\0227google.spanner.admin.instance.v1.UpdateInstanceMetadata" + ), ), _descriptor.MethodDescriptor( name="DeleteInstance", @@ -1773,7 +1810,9 @@ containing_service=None, input_type=_DELETEINSTANCEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=b"\202\323\344\223\002#*!/v1/{name=projects/*/instances/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002#*!/v1/{name=projects/*/instances/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -1782,7 +1821,9 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=b'\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\001*\332A\017resource,policy', + serialized_options=_b( + '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:setIamPolicy:\001*\332A\017resource,policy' + ), ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -1791,7 +1832,9 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=b'\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\001*\332A\010resource', + serialized_options=_b( + '\202\323\344\223\0027"2/v1/{resource=projects/*/instances/*}:getIamPolicy:\001*\332A\010resource' + ), ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -1800,7 +1843,9 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=b'\202\323\344\223\002="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\001*\332A\024resource,permissions', + serialized_options=_b( + '\202\323\344\223\002="8/v1/{resource=projects/*/instances/*}:testIamPermissions:\001*\332A\024resource,permissions' + ), ), ], ) diff --git a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py index 3ee5c19c02..b7276a9f92 100644 --- a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py +++ b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2_grpc.py @@ -2,7 +2,7 @@ import grpc from google.cloud.spanner_admin_instance_v1.proto import ( - spanner_instance_admin_pb2 as google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2, + spanner_instance_admin_pb2 as google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2, ) from google.iam.v1 import iam_policy_pb2 as google_dot_iam_dot_v1_dot_iam__policy__pb2 from google.iam.v1 import policy_pb2 as google_dot_iam_dot_v1_dot_policy__pb2 @@ -44,37 +44,37 @@ def __init__(self, channel): """ self.ListInstanceConfigs = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, ) self.GetInstanceConfig = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, ) self.ListInstances = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, ) self.GetInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, - response_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, + response_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, ) self.CreateInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, ) self.UpdateInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, ) self.DeleteInstance = channel.unary_unary( "/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance", - request_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, + request_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, ) self.SetIamPolicy = channel.unary_unary( @@ -288,37 +288,37 @@ def add_InstanceAdminServicer_to_server(servicer, server): rpc_method_handlers = { "ListInstanceConfigs": grpc.unary_unary_rpc_method_handler( servicer.ListInstanceConfigs, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.SerializeToString, ), "GetInstanceConfig": grpc.unary_unary_rpc_method_handler( servicer.GetInstanceConfig, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.SerializeToString, ), "ListInstances": grpc.unary_unary_rpc_method_handler( servicer.ListInstances, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.SerializeToString, ), "GetInstance": grpc.unary_unary_rpc_method_handler( servicer.GetInstance, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.FromString, - response_serializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.SerializeToString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.FromString, + response_serializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.SerializeToString, ), "CreateInstance": grpc.unary_unary_rpc_method_handler( servicer.CreateInstance, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.FromString, response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString, ), "UpdateInstance": grpc.unary_unary_rpc_method_handler( servicer.UpdateInstance, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.FromString, response_serializer=google_dot_longrunning_dot_operations__pb2.Operation.SerializeToString, ), "DeleteInstance": grpc.unary_unary_rpc_method_handler( servicer.DeleteInstance, - request_deserializer=google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.FromString, + request_deserializer=google_dot_cloud_dot_spanner_dot_admin_dot_instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.FromString, response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, ), "SetIamPolicy": grpc.unary_unary_rpc_method_handler( diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index 21ee5557da..9d38124847 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/keys.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -20,8 +23,12 @@ name="google/cloud/spanner_v1/proto/keys.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\tKeysProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n(google/cloud/spanner_v1/proto/keys.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf4\x01\n\x08KeyRange\x12\x32\n\x0cstart_closed\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nstart_open\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nend_closed\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x12.\n\x08\x65nd_open\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x42\x10\n\x0estart_key_typeB\x0e\n\x0c\x65nd_key_type"l\n\x06KeySet\x12(\n\x04keys\x18\x01 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12+\n\x06ranges\x18\x02 \x03(\x0b\x32\x1b.google.spanner.v1.KeyRange\x12\x0b\n\x03\x61ll\x18\x03 \x01(\x08\x42\x92\x01\n\x15\x63om.google.spanner.v1B\tKeysProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\tKeysProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n(google/cloud/spanner_v1/proto/keys.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf4\x01\n\x08KeyRange\x12\x32\n\x0cstart_closed\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nstart_open\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x12\x30\n\nend_closed\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x12.\n\x08\x65nd_open\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x01\x42\x10\n\x0estart_key_typeB\x0e\n\x0c\x65nd_key_type"l\n\x06KeySet\x12(\n\x04keys\x18\x01 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12+\n\x06ranges\x18\x02 \x03(\x0b\x32\x1b.google.spanner.v1.KeyRange\x12\x0b\n\x03\x61ll\x18\x03 \x01(\x08\x42\x92\x01\n\x15\x63om.google.spanner.v1B\tKeysProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, @@ -258,10 +265,10 @@ KeyRange = _reflection.GeneratedProtocolMessageType( "KeyRange", (_message.Message,), - { - "DESCRIPTOR": _KEYRANGE, - "__module__": "google.cloud.spanner_v1.proto.keys_pb2", - "__doc__": """KeyRange represents a range of rows in a table or index. + dict( + DESCRIPTOR=_KEYRANGE, + __module__="google.cloud.spanner_v1.proto.keys_pb2", + __doc__="""KeyRange represents a range of rows in a table or index. A range has a start key and an end key. These keys can be open or closed, indicating if the range includes rows with that key. @@ -275,31 +282,31 @@ :: - CREATE TABLE UserEvents ( - UserName STRING(MAX), - EventDate STRING(10) - ) PRIMARY KEY(UserName, EventDate); + CREATE TABLE UserEvents ( + UserName STRING(MAX), + EventDate STRING(10) + ) PRIMARY KEY(UserName, EventDate); The following keys name rows in this table: :: - ["Bob", "2014-09-23"] - ["Alfred", "2015-06-12"] + ["Bob", "2014-09-23"] + ["Alfred", "2015-06-12"] - Since the ``UserEvents`` table’s ``PRIMARY KEY`` clause names two + Since the ``UserEvents`` table's ``PRIMARY KEY`` clause names two columns, each ``UserEvents`` key has two elements; the first is the ``UserName``, and the second is the ``EventDate``. Key ranges with multiple components are interpreted lexicographically by - component using the table or index key’s declared sort order. For + component using the table or index key's declared sort order. For example, the following range returns all events for user ``"Bob"`` that occurred in the year 2015: :: - "start_closed": ["Bob", "2015-01-01"] - "end_closed": ["Bob", "2015-12-31"] + "start_closed": ["Bob", "2015-01-01"] + "end_closed": ["Bob", "2015-12-31"] Start and end keys can omit trailing key components. This affects the inclusion and exclusion of rows that exactly match the provided key @@ -312,62 +319,62 @@ :: - "start_closed": ["Bob", "2000-01-01"] - "end_closed": ["Bob"] + "start_closed": ["Bob", "2000-01-01"] + "end_closed": ["Bob"] The next example retrieves all events for ``"Bob"``: :: - "start_closed": ["Bob"] - "end_closed": ["Bob"] + "start_closed": ["Bob"] + "end_closed": ["Bob"] To retrieve events before the year 2000: :: - "start_closed": ["Bob"] - "end_open": ["Bob", "2000-01-01"] + "start_closed": ["Bob"] + "end_open": ["Bob", "2000-01-01"] The following range includes all rows in the table: :: - "start_closed": [] - "end_closed": [] + "start_closed": [] + "end_closed": [] This range returns all users whose ``UserName`` begins with any character from A to C: :: - "start_closed": ["A"] - "end_open": ["D"] + "start_closed": ["A"] + "end_open": ["D"] This range returns all users whose ``UserName`` begins with B: :: - "start_closed": ["B"] - "end_open": ["C"] + "start_closed": ["B"] + "end_open": ["C"] Key ranges honor column sort order. For example, suppose a table is defined as follows: :: - CREATE TABLE DescendingSortedTable { - Key INT64, - ... - ) PRIMARY KEY(Key DESC); + CREATE TABLE DescendingSortedTable { + Key INT64, + ... + ) PRIMARY KEY(Key DESC); The following range retrieves all rows with key values between 1 and 100 inclusive: :: - "start_closed": ["100"] - "end_closed": ["1"] + "start_closed": ["100"] + "end_closed": ["1"] Note that 100 is passed as the start, and 1 is passed as the end, because ``Key`` is a descending column in the schema. @@ -395,19 +402,19 @@ ``len(end_open)`` key columns exactly match ``end_open``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.KeyRange) - }, + ), ) _sym_db.RegisterMessage(KeyRange) KeySet = _reflection.GeneratedProtocolMessageType( "KeySet", (_message.Message,), - { - "DESCRIPTOR": _KEYSET, - "__module__": "google.cloud.spanner_v1.proto.keys_pb2", - "__doc__": """``KeySet`` defines a collection of Cloud Spanner keys and/or key ranges. - All the keys are expected to be in the same table or index. The keys - need not be sorted in any particular way. + dict( + DESCRIPTOR=_KEYSET, + __module__="google.cloud.spanner_v1.proto.keys_pb2", + __doc__="""\ ``KeySet`` defines a collection of Cloud Spanner keys + and/or key ranges. All the keys are expected to be in the same table or + index. The keys need not be sorted in any particular way. If the same key is specified multiple times in the set (for example if two ranges, two keys, or a key and a range overlap), Cloud Spanner @@ -432,7 +439,7 @@ only yielded once. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) - }, + ), ) _sym_db.RegisterMessage(KeySet) diff --git a/google/cloud/spanner_v1/proto/mutation_pb2.py b/google/cloud/spanner_v1/proto/mutation_pb2.py index c9573fcaa5..b6ad0429b8 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/mutation.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -23,8 +26,12 @@ name="google/cloud/spanner_v1/proto/mutation.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\rMutationProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n,google/cloud/spanner_v1/proto/mutation.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a\x1cgoogle/api/annotations.proto"\xc6\x03\n\x08Mutation\x12\x33\n\x06insert\x18\x01 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x33\n\x06update\x18\x02 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12=\n\x10insert_or_update\x18\x03 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x07replace\x18\x04 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x06\x64\x65lete\x18\x05 \x01(\x0b\x32".google.spanner.v1.Mutation.DeleteH\x00\x1aS\n\x05Write\x12\r\n\x05table\x18\x01 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x02 \x03(\t\x12*\n\x06values\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x1a\x43\n\x06\x44\x65lete\x12\r\n\x05table\x18\x01 \x01(\t\x12*\n\x07key_set\x18\x02 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x0b\n\toperationB\x96\x01\n\x15\x63om.google.spanner.v1B\rMutationProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\rMutationProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n,google/cloud/spanner_v1/proto/mutation.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a\x1cgoogle/api/annotations.proto"\xc6\x03\n\x08Mutation\x12\x33\n\x06insert\x18\x01 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x33\n\x06update\x18\x02 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12=\n\x10insert_or_update\x18\x03 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x07replace\x18\x04 \x01(\x0b\x32!.google.spanner.v1.Mutation.WriteH\x00\x12\x34\n\x06\x64\x65lete\x18\x05 \x01(\x0b\x32".google.spanner.v1.Mutation.DeleteH\x00\x1aS\n\x05Write\x12\r\n\x05table\x18\x01 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x02 \x03(\t\x12*\n\x06values\x18\x03 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x1a\x43\n\x06\x44\x65lete\x12\r\n\x05table\x18\x01 \x01(\t\x12*\n\x07key_set\x18\x02 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x0b\n\toperationB\x96\x01\n\x15\x63om.google.spanner.v1B\rMutationProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR, @@ -49,7 +56,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -123,7 +130,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -322,16 +329,16 @@ Mutation = _reflection.GeneratedProtocolMessageType( "Mutation", (_message.Message,), - { - "Write": _reflection.GeneratedProtocolMessageType( + dict( + Write=_reflection.GeneratedProtocolMessageType( "Write", (_message.Message,), - { - "DESCRIPTOR": _MUTATION_WRITE, - "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", - "__doc__": """Arguments to [insert][google.spanner.v1.Mutation.insert], + dict( + DESCRIPTOR=_MUTATION_WRITE, + __module__="google.cloud.spanner_v1.proto.mutation_pb2", + __doc__="""Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], - [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and + [insert\_or\_update][google.spanner.v1.Mutation.insert\_or\_update], and [replace][google.spanner.v1.Mutation.replace] operations. @@ -358,15 +365,15 @@ [here][google.spanner.v1.TypeCode]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) - }, + ), ), - "Delete": _reflection.GeneratedProtocolMessageType( + Delete=_reflection.GeneratedProtocolMessageType( "Delete", (_message.Message,), - { - "DESCRIPTOR": _MUTATION_DELETE, - "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", - "__doc__": """Arguments to [delete][google.spanner.v1.Mutation.delete] + dict( + DESCRIPTOR=_MUTATION_DELETE, + __module__="google.cloud.spanner_v1.proto.mutation_pb2", + __doc__="""Arguments to [delete][google.spanner.v1.Mutation.delete] operations. @@ -377,17 +384,17 @@ Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete. The primary keys must be specified in the order in which they - appear in the ``PRIMARY KEY()`` clause of the table’s + appear in the ``PRIMARY KEY()`` clause of the table's equivalent DDL statement (the DDL statement used to create the table). Delete is idempotent. The transaction will succeed even if some or all rows do not exist. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Delete) - }, + ), ), - "DESCRIPTOR": _MUTATION, - "__module__": "google.cloud.spanner_v1.proto.mutation_pb2", - "__doc__": """A modification to one or more Cloud Spanner rows. + DESCRIPTOR=_MUTATION, + __module__="google.cloud.spanner_v1.proto.mutation_pb2", + __doc__="""A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a [Commit][google.spanner.v1.Spanner.Commit] call. @@ -405,18 +412,18 @@ Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then its column values are overwritten with the ones provided. Any column values not - explicitly written are preserved. When using [insert_or_updat - e][google.spanner.v1.Mutation.insert_or_update], just as when - using [insert][google.spanner.v1.Mutation.insert], all ``NOT - NULL`` columns in the table must be given a value. This holds - true even when the row already exists and will therefore + explicitly written are preserved. When using [insert\_or\_upd + ate][google.spanner.v1.Mutation.insert\_or\_update], just as + when using [insert][google.spanner.v1.Mutation.insert], all + ``NOT NULL`` columns in the table must be given a value. This + holds true even when the row already exists and will therefore actually be updated. replace: Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is deleted, and the column - values provided are inserted instead. Unlike [insert_or_update - ][google.spanner.v1.Mutation.insert_or_update], this means any - values not explicitly written become ``NULL``. In an + values provided are inserted instead. Unlike [insert\_or\_upda + te][google.spanner.v1.Mutation.insert\_or\_update], this means + any values not explicitly written become ``NULL``. In an interleaved table, if you create the child table with the ``ON DELETE CASCADE`` annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child @@ -426,7 +433,7 @@ rows were present. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) - }, + ), ) _sym_db.RegisterMessage(Mutation) _sym_db.RegisterMessage(Mutation.Write) diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2.py b/google/cloud/spanner_v1/proto/query_plan_pb2.py index e9b9ef46e1..bc715b4549 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/query_plan.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -20,8 +23,12 @@ name="google/cloud/spanner_v1/proto/query_plan.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\016QueryPlanProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n.google/cloud/spanner_v1/proto/query_plan.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x08PlanNode\x12\r\n\x05index\x18\x01 \x01(\x05\x12.\n\x04kind\x18\x02 \x01(\x0e\x32 .google.spanner.v1.PlanNode.Kind\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\x0b\x63hild_links\x18\x04 \x03(\x0b\x32%.google.spanner.v1.PlanNode.ChildLink\x12M\n\x14short_representation\x18\x05 \x01(\x0b\x32/.google.spanner.v1.PlanNode.ShortRepresentation\x12)\n\x08metadata\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x30\n\x0f\x65xecution_stats\x18\x07 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a@\n\tChildLink\x12\x13\n\x0b\x63hild_index\x18\x01 \x01(\x05\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x10\n\x08variable\x18\x03 \x01(\t\x1a\xb2\x01\n\x13ShortRepresentation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12S\n\nsubqueries\x18\x02 \x03(\x0b\x32?.google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry\x1a\x31\n\x0fSubqueriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01"8\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRELATIONAL\x10\x01\x12\n\n\x06SCALAR\x10\x02"<\n\tQueryPlan\x12/\n\nplan_nodes\x18\x01 \x03(\x0b\x32\x1b.google.spanner.v1.PlanNodeB\x97\x01\n\x15\x63om.google.spanner.v1B\x0eQueryPlanProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\016QueryPlanProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n.google/cloud/spanner_v1/proto/query_plan.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1cgoogle/api/annotations.proto"\xf8\x04\n\x08PlanNode\x12\r\n\x05index\x18\x01 \x01(\x05\x12.\n\x04kind\x18\x02 \x01(\x0e\x32 .google.spanner.v1.PlanNode.Kind\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12:\n\x0b\x63hild_links\x18\x04 \x03(\x0b\x32%.google.spanner.v1.PlanNode.ChildLink\x12M\n\x14short_representation\x18\x05 \x01(\x0b\x32/.google.spanner.v1.PlanNode.ShortRepresentation\x12)\n\x08metadata\x18\x06 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x30\n\x0f\x65xecution_stats\x18\x07 \x01(\x0b\x32\x17.google.protobuf.Struct\x1a@\n\tChildLink\x12\x13\n\x0b\x63hild_index\x18\x01 \x01(\x05\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x10\n\x08variable\x18\x03 \x01(\t\x1a\xb2\x01\n\x13ShortRepresentation\x12\x13\n\x0b\x64\x65scription\x18\x01 \x01(\t\x12S\n\nsubqueries\x18\x02 \x03(\x0b\x32?.google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry\x1a\x31\n\x0fSubqueriesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01"8\n\x04Kind\x12\x14\n\x10KIND_UNSPECIFIED\x10\x00\x12\x0e\n\nRELATIONAL\x10\x01\x12\n\n\x06SCALAR\x10\x02"<\n\tQueryPlan\x12/\n\nplan_nodes\x18\x01 \x03(\x0b\x32\x1b.google.spanner.v1.PlanNodeB\x97\x01\n\x15\x63om.google.spanner.v1B\x0eQueryPlanProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, @@ -91,7 +98,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -109,7 +116,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -147,7 +154,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -178,7 +185,7 @@ extensions=[], nested_types=[], enum_types=[], - serialized_options=b"8\001", + serialized_options=_b("8\001"), is_extendable=False, syntax="proto3", extension_ranges=[], @@ -203,7 +210,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -295,7 +302,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -456,14 +463,14 @@ PlanNode = _reflection.GeneratedProtocolMessageType( "PlanNode", (_message.Message,), - { - "ChildLink": _reflection.GeneratedProtocolMessageType( + dict( + ChildLink=_reflection.GeneratedProtocolMessageType( "ChildLink", (_message.Message,), - { - "DESCRIPTOR": _PLANNODE_CHILDLINK, - "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", - "__doc__": """Metadata associated with a parent-child relationship + dict( + DESCRIPTOR=_PLANNODE_CHILDLINK, + __module__="google.cloud.spanner_v1.proto.query_plan_pb2", + __doc__="""Metadata associated with a parent-child relationship appearing in a [PlanNode][google.spanner.v1.PlanNode]. @@ -487,25 +494,25 @@ the variable names assigned to the columns. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) - }, + ), ), - "ShortRepresentation": _reflection.GeneratedProtocolMessageType( + ShortRepresentation=_reflection.GeneratedProtocolMessageType( "ShortRepresentation", (_message.Message,), - { - "SubqueriesEntry": _reflection.GeneratedProtocolMessageType( + dict( + SubqueriesEntry=_reflection.GeneratedProtocolMessageType( "SubqueriesEntry", (_message.Message,), - { - "DESCRIPTOR": _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, - "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2" + dict( + DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, + __module__="google.cloud.spanner_v1.proto.query_plan_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry) - }, + ), ), - "DESCRIPTOR": _PLANNODE_SHORTREPRESENTATION, - "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", - "__doc__": """Condensed representation of a node and its subtree. Only - present for ``SCALAR`` [PlanNode(s)][google.spanner.v1.PlanNode]. + DESCRIPTOR=_PLANNODE_SHORTREPRESENTATION, + __module__="google.cloud.spanner_v1.proto.query_plan_pb2", + __doc__="""Condensed representation of a node and its subtree. Only present for + ``SCALAR`` [PlanNode(s)][google.spanner.v1.PlanNode]. Attributes: @@ -520,18 +527,18 @@ subquery may not necessarily be a direct child of this node. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ShortRepresentation) - }, + ), ), - "DESCRIPTOR": _PLANNODE, - "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", - "__doc__": """Node information for nodes appearing in a - [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes]. + DESCRIPTOR=_PLANNODE, + __module__="google.cloud.spanner_v1.proto.query_plan_pb2", + __doc__="""Node information for nodes appearing in a + [QueryPlan.plan\_nodes][google.spanner.v1.QueryPlan.plan\_nodes]. Attributes: index: - The ``PlanNode``\ ’s index in [node - list][google.spanner.v1.QueryPlan.plan_nodes]. + The ``PlanNode``'s index in [node + list][google.spanner.v1.QueryPlan.plan\_nodes]. kind: Used to determine the type of node. May be needed for visualizing different kinds of nodes differently. For example, @@ -550,9 +557,9 @@ metadata: Attributes relevant to the node contained in a group of key- value pairs. For example, a Parameter Reference node could - have the following information in its metadata: :: { - "parameter_reference": "param1", "parameter_type": - "array" } + have the following information in its metadata: :: { + "parameter_reference": "param1", "parameter_type": + "array" } execution_stats: The execution statistics associated with the node, contained in a group of key-value pairs. Only present if the plan was @@ -560,7 +567,7 @@ of executions, number of rows/time per execution etc. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) - }, + ), ) _sym_db.RegisterMessage(PlanNode) _sym_db.RegisterMessage(PlanNode.ChildLink) @@ -570,10 +577,10 @@ QueryPlan = _reflection.GeneratedProtocolMessageType( "QueryPlan", (_message.Message,), - { - "DESCRIPTOR": _QUERYPLAN, - "__module__": "google.cloud.spanner_v1.proto.query_plan_pb2", - "__doc__": """Contains an ordered list of nodes appearing in the query + dict( + DESCRIPTOR=_QUERYPLAN, + __module__="google.cloud.spanner_v1.proto.query_plan_pb2", + __doc__="""Contains an ordered list of nodes appearing in the query plan. @@ -581,11 +588,11 @@ plan_nodes: The nodes in the query plan. Plan nodes are returned in pre- order starting with the plan root. Each - [PlanNode][google.spanner.v1.PlanNode]’s ``id`` corresponds to + [PlanNode][google.spanner.v1.PlanNode]'s ``id`` corresponds to its index in ``plan_nodes``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) - }, + ), ) _sym_db.RegisterMessage(QueryPlan) diff --git a/google/cloud/spanner_v1/proto/result_set_pb2.py b/google/cloud/spanner_v1/proto/result_set_pb2.py index 9d01bec15e..3740450e6b 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/result_set.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -29,8 +32,12 @@ name="google/cloud/spanner_v1/proto/result_set.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\016ResultSetProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\370\001\001\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n.google/cloud/spanner_v1/proto/result_set.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a.google/cloud/spanner_v1/proto/query_plan.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto\x1a\x1cgoogle/api/annotations.proto"\x9f\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"\xd1\x01\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"y\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\x9a\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\016ResultSetProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\370\001\001\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n.google/cloud/spanner_v1/proto/result_set.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a.google/cloud/spanner_v1/proto/query_plan.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto\x1a\x1cgoogle/api/annotations.proto"\x9f\x01\n\tResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12(\n\x04rows\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\x12\x30\n\x05stats\x18\x03 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"\xd1\x01\n\x10PartialResultSet\x12\x36\n\x08metadata\x18\x01 \x01(\x0b\x32$.google.spanner.v1.ResultSetMetadata\x12&\n\x06values\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\x12\x15\n\rchunked_value\x18\x03 \x01(\x08\x12\x14\n\x0cresume_token\x18\x04 \x01(\x0c\x12\x30\n\x05stats\x18\x05 \x01(\x0b\x32!.google.spanner.v1.ResultSetStats"y\n\x11ResultSetMetadata\x12/\n\x08row_type\x18\x01 \x01(\x0b\x32\x1d.google.spanner.v1.StructType\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xb9\x01\n\x0eResultSetStats\x12\x30\n\nquery_plan\x18\x01 \x01(\x0b\x32\x1c.google.spanner.v1.QueryPlan\x12,\n\x0bquery_stats\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x19\n\x0frow_count_exact\x18\x03 \x01(\x03H\x00\x12\x1f\n\x15row_count_lower_bound\x18\x04 \x01(\x03H\x00\x42\x0b\n\trow_countB\x9a\x01\n\x15\x63om.google.spanner.v1B\x0eResultSetProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xf8\x01\x01\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[ google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2.DESCRIPTOR, @@ -186,7 +193,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"", + default_value=_b(""), message_type=None, enum_type=None, containing_type=None, @@ -431,10 +438,10 @@ ResultSet = _reflection.GeneratedProtocolMessageType( "ResultSet", (_message.Message,), - { - "DESCRIPTOR": _RESULTSET, - "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", - "__doc__": """Results from [Read][google.spanner.v1.Spanner.Read] or + dict( + DESCRIPTOR=_RESULTSET, + __module__="google.cloud.spanner_v1.proto.result_set_pb2", + __doc__="""Results from [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. @@ -443,35 +450,35 @@ Metadata about the result set, such as row type information. rows: Each element in ``rows`` is a row whose format is defined by [ - metadata.row_type][google.spanner.v1.ResultSetMetadata.row_typ - e]. The ith element in each row matches the ith field in [meta - data.row_type][google.spanner.v1.ResultSetMetadata.row_type]. - Elements are encoded based on type as described + metadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_t + ype]. The ith element in each row matches the ith field in [me + tadata.row\_type][google.spanner.v1.ResultSetMetadata.row\_typ + e]. Elements are encoded based on type as described [here][google.spanner.v1.TypeCode]. stats: Query plan and execution statistics for the SQL statement that produced this result set. These can be requested by setting [E - xecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlReque - st.query_mode]. DML statements always produce stats containing - the number of rows modified, unless executed using the [Execut - eSqlRequest.QueryMode.PLAN][google.spanner.v1.ExecuteSqlReques - t.QueryMode.PLAN] [ExecuteSqlRequest.query_mode][google.spanne - r.v1.ExecuteSqlRequest.query_mode]. Other fields may or may - not be populated, based on the [ExecuteSqlRequest.query_mode][ - google.spanner.v1.ExecuteSqlRequest.query_mode]. + xecuteSqlRequest.query\_mode][google.spanner.v1.ExecuteSqlRequ + est.query\_mode]. DML statements always produce stats + containing the number of rows modified, unless executed using + the [ExecuteSqlRequest.QueryMode.PLAN][google.spanner.v1.Execu + teSqlRequest.QueryMode.PLAN] [ExecuteSqlRequest.query\_mode][g + oogle.spanner.v1.ExecuteSqlRequest.query\_mode]. Other fields + may or may not be populated, based on the [ExecuteSqlRequest.q + uery\_mode][google.spanner.v1.ExecuteSqlRequest.query\_mode]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSet) - }, + ), ) _sym_db.RegisterMessage(ResultSet) PartialResultSet = _reflection.GeneratedProtocolMessageType( "PartialResultSet", (_message.Message,), - { - "DESCRIPTOR": _PARTIALRESULTSET, - "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", - "__doc__": """Partial results from a streaming read or SQL query. + dict( + DESCRIPTOR=_PARTIALRESULTSET, + __module__="google.cloud.spanner_v1.proto.result_set_pb2", + __doc__="""Partial results from a streaming read or SQL query. Streaming reads and SQL queries better tolerate large result sets, large rows, and large values, but are a little trickier to consume. @@ -485,13 +492,13 @@ might be split into many ``PartialResultSet`` messages to accommodate large rows and/or large values. Every N complete values defines a row, where N is equal to the number of - entries in [metadata.row_type.fields][google.spanner.v1.Struct - Type.fields]. Most values are encoded based on type as + entries in [metadata.row\_type.fields][google.spanner.v1.Struc + tType.fields]. Most values are encoded based on type as described [here][google.spanner.v1.TypeCode]. It is possible - that the last value in values is “chunked”, meaning that the + that the last value in values is "chunked", meaning that the rest of the value is sent in subsequent ``PartialResultSet``\ - (s). This is denoted by the [chunked_value][google.spanner.v1. - PartialResultSet.chunked_value] field. Two or more chunked + (s). This is denoted by the [chunked\_value][google.spanner.v1 + .PartialResultSet.chunked\_value] field. Two or more chunked values can be merged to form a complete value as follows: - ``bool/number/null``: cannot be chunked - ``string``: concatenate the strings - ``list``: concatenate the lists. If @@ -501,29 +508,29 @@ concatenate the (field name, field value) pairs. If a field name is duplicated, then apply these rules recursively to merge the field values. Some examples of merging: :: - # Strings are concatenated. "foo", "bar" => "foobar" # - Lists of non-strings are concatenated. [2, 3], [4] => [2, - 3, 4] # Lists are concatenated, but the last and first - elements are merged # because they are strings. ["a", - "b"], ["c", "d"] => ["a", "bc", "d"] # Lists are - concatenated, but the last and first elements are merged # + # Strings are concatenated. "foo", "bar" => "foobar" + # Lists of non-strings are concatenated. [2, 3], [4] => + [2, 3, 4] # Lists are concatenated, but the last and + first elements are merged # because they are strings. + ["a", "b"], ["c", "d"] => ["a", "bc", "d"] # Lists are + concatenated, but the last and first elements are merged # because they are lists. Recursively, the last and first - elements # of the inner lists are merged because they are - strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", - "cd"], "e"] # Non-overlapping object fields are combined. - {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} # - Overlapping object fields are merged. {"a": "1"}, {"a": - "2"} => {"a": "12"} # Examples of merging objects - containing lists of strings. {"a": ["1"]}, {"a": ["2"]} => + elements # of the inner lists are merged because they are + strings. ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", + "cd"], "e"] # Non-overlapping object fields are combined. + {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"} # + Overlapping object fields are merged. {"a": "1"}, {"a": + "2"} => {"a": "12"} # Examples of merging objects + containing lists of strings. {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]} For a more complete example, suppose a streaming SQL query is yielding a result set whose rows contain a single string field. The following - ``PartialResultSet``\ s might be yielded: :: { - "metadata": { ... } "values": ["Hello", "W"] - "chunked_value": true "resume_token": "Af65..." } { - "values": ["orl"] "chunked_value": true - "resume_token": "Bqp2..." } { "values": ["d"] - "resume_token": "Zx1B..." } This sequence of + ``PartialResultSet``\ s might be yielded: :: { + "metadata": { ... } "values": ["Hello", "W"] + "chunked_value": true "resume_token": "Af65..." } + { "values": ["orl"] "chunked_value": true + "resume_token": "Bqp2..." } { "values": ["d"] + "resume_token": "Zx1B..." } This sequence of ``PartialResultSet``\ s encodes two rows, one containing the field value ``"Hello"``, and a second containing the field value ``"World" = "W" + "orl" + "d"``. @@ -541,23 +548,23 @@ stats: Query plan and execution statistics for the statement that produced this streaming result set. These can be requested by - setting [ExecuteSqlRequest.query_mode][google.spanner.v1.Execu - teSqlRequest.query_mode] and are sent only once with the last - response in the stream. This field will also be present in the - last response for DML statements. + setting [ExecuteSqlRequest.query\_mode][google.spanner.v1.Exec + uteSqlRequest.query\_mode] and are sent only once with the + last response in the stream. This field will also be present + in the last response for DML statements. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartialResultSet) - }, + ), ) _sym_db.RegisterMessage(PartialResultSet) ResultSetMetadata = _reflection.GeneratedProtocolMessageType( "ResultSetMetadata", (_message.Message,), - { - "DESCRIPTOR": _RESULTSETMETADATA, - "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", - "__doc__": """Metadata about a [ResultSet][google.spanner.v1.ResultSet] + dict( + DESCRIPTOR=_RESULTSETMETADATA, + __module__="google.cloud.spanner_v1.proto.result_set_pb2", + __doc__="""Metadata about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet]. @@ -566,25 +573,25 @@ Indicates the field names and types for the rows in the result set. For example, a SQL query like ``"SELECT UserId, UserName FROM Users"`` could return a ``row_type`` value like: :: - "fields": [ { "name": "UserId", "type": { "code": "INT64" - } }, { "name": "UserName", "type": { "code": "STRING" } - }, ] + "fields": [ { "name": "UserId", "type": { "code": + "INT64" } }, { "name": "UserName", "type": { "code": + "STRING" } }, ] transaction: If the read or SQL query began a transaction as a side-effect, the information about the new transaction is yielded here. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetMetadata) - }, + ), ) _sym_db.RegisterMessage(ResultSetMetadata) ResultSetStats = _reflection.GeneratedProtocolMessageType( "ResultSetStats", (_message.Message,), - { - "DESCRIPTOR": _RESULTSETSTATS, - "__module__": "google.cloud.spanner_v1.proto.result_set_pb2", - "__doc__": """Additional statistics about a + dict( + DESCRIPTOR=_RESULTSETSTATS, + __module__="google.cloud.spanner_v1.proto.result_set_pb2", + __doc__="""Additional statistics about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet]. @@ -596,9 +603,9 @@ query_stats: Aggregated statistics from the execution of the query. Only present when the query is profiled. For example, a query could - return the statistics as follows: :: { - "rows_returned": "3", "elapsed_time": "1.22 secs", - "cpu_time": "1.19 secs" } + return the statistics as follows: :: { + "rows_returned": "3", "elapsed_time": "1.22 secs", + "cpu_time": "1.19 secs" } row_count: The number of rows modified by the DML statement. row_count_exact: @@ -609,7 +616,7 @@ returns a lower bound of the rows modified. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) - }, + ), ) _sym_db.RegisterMessage(ResultSetStats) diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index 6d9c66bad4..ab1ff4e42e 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/spanner.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -41,8 +44,12 @@ name="google/cloud/spanner_v1/proto/spanner.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\014SpannerProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1\352A_\n\037spanner.googleapis.com/Database\022\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12 The - session has the label “env”. - ``labels.env:dev`` –> The - session has the label “env” and the value of the label - contains the string “dev”. + examples of using filters are: - ``labels.env:*`` --> The + session has the label "env". - ``labels.env:dev`` --> The + session has the label "env" and the value of the label + contains the string "dev". """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsRequest) - }, + ), ) _sym_db.RegisterMessage(ListSessionsRequest) ListSessionsResponse = _reflection.GeneratedProtocolMessageType( "ListSessionsResponse", (_message.Message,), - { - "DESCRIPTOR": _LISTSESSIONSRESPONSE, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_LISTSESSIONSRESPONSE, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The response for [ListSessions][google.spanner.v1.Spanner.ListSessions]. @@ -2475,17 +2510,17 @@ fetch more of the matching sessions. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ListSessionsResponse) - }, + ), ) _sym_db.RegisterMessage(ListSessionsResponse) DeleteSessionRequest = _reflection.GeneratedProtocolMessageType( "DeleteSessionRequest", (_message.Message,), - { - "DESCRIPTOR": _DELETESESSIONREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_DELETESESSIONREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [DeleteSession][google.spanner.v1.Spanner.DeleteSession]. @@ -2494,55 +2529,55 @@ Required. The name of the session to delete. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.DeleteSessionRequest) - }, + ), ) _sym_db.RegisterMessage(DeleteSessionRequest) ExecuteSqlRequest = _reflection.GeneratedProtocolMessageType( "ExecuteSqlRequest", (_message.Message,), - { - "QueryOptions": _reflection.GeneratedProtocolMessageType( + dict( + QueryOptions=_reflection.GeneratedProtocolMessageType( "QueryOptions", (_message.Message,), - { - "DESCRIPTOR": _EXECUTESQLREQUEST_QUERYOPTIONS, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """Query optimizer configuration. + dict( + DESCRIPTOR=_EXECUTESQLREQUEST_QUERYOPTIONS, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""Query optimizer configuration. Attributes: optimizer_version: An option to control the selection of optimizer version. This parameter allows individual queries to pick different query - optimizer versions. Specifying “latest” as a value instructs + optimizer versions. Specifying "latest" as a value instructs Cloud Spanner to use the latest supported query optimizer version. If not specified, Cloud Spanner uses optimizer version set at the database level options. Any other positive integer (from the list of supported optimizer versions) overrides the default optimizer version for query execution. The list of supported optimizer versions can be queried from - SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL + SPANNER\_SYS.SUPPORTED\_OPTIMIZER\_VERSIONS. Executing a SQL statement with an invalid optimizer version will fail with a syntax error (``INVALID_ARGUMENT``) status. The ``optimizer_version`` statement hint has precedence over this setting. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.QueryOptions) - }, + ), ), - "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( + ParamTypesEntry=_reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - { - "DESCRIPTOR": _EXECUTESQLREQUEST_PARAMTYPESENTRY, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" + dict( + DESCRIPTOR=_EXECUTESQLREQUEST_PARAMTYPESENTRY, + __module__="google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry) - }, + ), ), - "DESCRIPTOR": _EXECUTESQLREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + DESCRIPTOR=_EXECUTESQLREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]. @@ -2594,9 +2629,9 @@ query_mode: Used to control the amount of debugging information returned in [ResultSetStats][google.spanner.v1.ResultSetStats]. If [par - tition_token][google.spanner.v1.ExecuteSqlRequest.partition_to - ken] is set, - [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] + tition\_token][google.spanner.v1.ExecuteSqlRequest.partition\_ + token] is set, + [query\_mode][google.spanner.v1.ExecuteSqlRequest.query\_mode] can only be set to [QueryMode.NORMAL][google.spanner.v1.Execut eSqlRequest.QueryMode.NORMAL]. partition_token: @@ -2604,7 +2639,7 @@ partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the PartitionQueryRequest message used to create - this partition_token. + this partition\_token. seqno: A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if @@ -2619,7 +2654,7 @@ Query optimizer configuration to use for the given query. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest) - }, + ), ) _sym_db.RegisterMessage(ExecuteSqlRequest) _sym_db.RegisterMessage(ExecuteSqlRequest.QueryOptions) @@ -2628,23 +2663,23 @@ ExecuteBatchDmlRequest = _reflection.GeneratedProtocolMessageType( "ExecuteBatchDmlRequest", (_message.Message,), - { - "Statement": _reflection.GeneratedProtocolMessageType( + dict( + Statement=_reflection.GeneratedProtocolMessageType( "Statement", (_message.Message,), - { - "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( + dict( + ParamTypesEntry=_reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - { - "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" + dict( + DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY, + __module__="google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry) - }, + ), ), - "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST_STATEMENT, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """A single DML statement. + DESCRIPTOR=_EXECUTEBATCHDMLREQUEST_STATEMENT, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""A single DML statement. Attributes: @@ -2672,11 +2707,11 @@ types. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest.Statement) - }, + ), ), - "DESCRIPTOR": _EXECUTEBATCHDMLREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + DESCRIPTOR=_EXECUTEBATCHDMLREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. @@ -2707,7 +2742,7 @@ requests will yield the same response as the first execution. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlRequest) - }, + ), ) _sym_db.RegisterMessage(ExecuteBatchDmlRequest) _sym_db.RegisterMessage(ExecuteBatchDmlRequest.Statement) @@ -2716,10 +2751,10 @@ ExecuteBatchDmlResponse = _reflection.GeneratedProtocolMessageType( "ExecuteBatchDmlResponse", (_message.Message,), - { - "DESCRIPTOR": _EXECUTEBATCHDMLRESPONSE, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_EXECUTEBATCHDMLRESPONSE, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The response for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. Contains a list of [ResultSet][google.spanner.v1.ResultSet] messages, one for each DML statement that has successfully executed, in the same order as the @@ -2770,17 +2805,17 @@ statement. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteBatchDmlResponse) - }, + ), ) _sym_db.RegisterMessage(ExecuteBatchDmlResponse) PartitionOptions = _reflection.GeneratedProtocolMessageType( "PartitionOptions", (_message.Message,), - { - "DESCRIPTOR": _PARTITIONOPTIONS, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """Options for a PartitionQueryRequest and + dict( + DESCRIPTOR=_PARTITIONOPTIONS, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""Options for a PartitionQueryRequest and PartitionReadRequest. @@ -2801,26 +2836,26 @@ be smaller or larger than this maximum count request. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionOptions) - }, + ), ) _sym_db.RegisterMessage(PartitionOptions) PartitionQueryRequest = _reflection.GeneratedProtocolMessageType( "PartitionQueryRequest", (_message.Message,), - { - "ParamTypesEntry": _reflection.GeneratedProtocolMessageType( + dict( + ParamTypesEntry=_reflection.GeneratedProtocolMessageType( "ParamTypesEntry", (_message.Message,), - { - "DESCRIPTOR": _PARTITIONQUERYREQUEST_PARAMTYPESENTRY, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2" + dict( + DESCRIPTOR=_PARTITIONQUERYREQUEST_PARAMTYPESENTRY, + __module__="google.cloud.spanner_v1.proto.spanner_pb2" # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest.ParamTypesEntry) - }, + ), ), - "DESCRIPTOR": _PARTITIONQUERYREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + DESCRIPTOR=_PARTITIONQUERYREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery] @@ -2867,7 +2902,7 @@ created. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionQueryRequest) - }, + ), ) _sym_db.RegisterMessage(PartitionQueryRequest) _sym_db.RegisterMessage(PartitionQueryRequest.ParamTypesEntry) @@ -2875,10 +2910,10 @@ PartitionReadRequest = _reflection.GeneratedProtocolMessageType( "PartitionReadRequest", (_message.Message,), - { - "DESCRIPTOR": _PARTITIONREADREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_PARTITIONREADREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [PartitionRead][google.spanner.v1.Spanner.PartitionRead] @@ -2895,10 +2930,10 @@ [table][google.spanner.v1.PartitionReadRequest.table]. This index is used instead of the table primary key when interpreting - [key_set][google.spanner.v1.PartitionReadRequest.key_set] and - sorting result rows. See - [key_set][google.spanner.v1.PartitionReadRequest.key_set] for - further information. + [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] + and sorting result rows. See + [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] + for further information. columns: The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be @@ -2912,7 +2947,7 @@ present. If [index][google.spanner.v1.PartitionReadRequest.index] is present, then - [key_set][google.spanner.v1.PartitionReadRequest.key_set] + [key\_set][google.spanner.v1.PartitionReadRequest.key\_set] instead names index keys in [index][google.spanner.v1.PartitionReadRequest.index]. It is not an error for the ``key_set`` to name rows that do not @@ -2923,17 +2958,17 @@ created. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionReadRequest) - }, + ), ) _sym_db.RegisterMessage(PartitionReadRequest) Partition = _reflection.GeneratedProtocolMessageType( "Partition", (_message.Message,), - { - "DESCRIPTOR": _PARTITION, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """Information returned for each partition returned in a + dict( + DESCRIPTOR=_PARTITION, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""Information returned for each partition returned in a PartitionResponse. @@ -2944,17 +2979,17 @@ those identified by this partition token. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Partition) - }, + ), ) _sym_db.RegisterMessage(Partition) PartitionResponse = _reflection.GeneratedProtocolMessageType( "PartitionResponse", (_message.Message,), - { - "DESCRIPTOR": _PARTITIONRESPONSE, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_PARTITIONRESPONSE, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The response for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery] or [PartitionRead][google.spanner.v1.Spanner.PartitionRead] @@ -2966,17 +3001,17 @@ Transaction created by this request. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.PartitionResponse) - }, + ), ) _sym_db.RegisterMessage(PartitionResponse) ReadRequest = _reflection.GeneratedProtocolMessageType( "ReadRequest", (_message.Message,), - { - "DESCRIPTOR": _READREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for [Read][google.spanner.v1.Spanner.Read] and + dict( + DESCRIPTOR=_READREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [Read][google.spanner.v1.Spanner.Read] and [StreamingRead][google.spanner.v1.Spanner.StreamingRead]. @@ -2992,9 +3027,9 @@ If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is used instead of the table primary key when interpreting - [key_set][google.spanner.v1.ReadRequest.key_set] and sorting + [key\_set][google.spanner.v1.ReadRequest.key\_set] and sorting result rows. See - [key_set][google.spanner.v1.ReadRequest.key_set] for further + [key\_set][google.spanner.v1.ReadRequest.key\_set] for further information. columns: Required. The columns of @@ -3006,16 +3041,17 @@ [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present. If [index][google.spanner.v1.ReadRequest.index] is - present, then [key_set][google.spanner.v1.ReadRequest.key_set] - instead names index keys in + present, then + [key\_set][google.spanner.v1.ReadRequest.key\_set] instead + names index keys in [index][google.spanner.v1.ReadRequest.index]. If the [partiti - on_token][google.spanner.v1.ReadRequest.partition_token] field - is empty, rows are yielded in table primary key order (if - [index][google.spanner.v1.ReadRequest.index] is empty) or + on\_token][google.spanner.v1.ReadRequest.partition\_token] + field is empty, rows are yielded in table primary key order + (if [index][google.spanner.v1.ReadRequest.index] is empty) or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If - the [partition_token][google.spanner.v1.ReadRequest.partition_ - token] field is not empty, rows will be yielded in an + the [partition\_token][google.spanner.v1.ReadRequest.partition + \_token] field is not empty, rows will be yielded in an unspecified order. It is not an error for the ``key_set`` to name rows that do not exist in the database. Read yields nothing for nonexistent rows. @@ -3036,20 +3072,20 @@ partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create - this partition_token. + this partition\_token. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.ReadRequest) - }, + ), ) _sym_db.RegisterMessage(ReadRequest) BeginTransactionRequest = _reflection.GeneratedProtocolMessageType( "BeginTransactionRequest", (_message.Message,), - { - "DESCRIPTOR": _BEGINTRANSACTIONREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_BEGINTRANSACTIONREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction]. @@ -3060,17 +3096,17 @@ Required. Options for the new transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.BeginTransactionRequest) - }, + ), ) _sym_db.RegisterMessage(BeginTransactionRequest) CommitRequest = _reflection.GeneratedProtocolMessageType( "CommitRequest", (_message.Message,), - { - "DESCRIPTOR": _COMMITREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_COMMITREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [Commit][google.spanner.v1.Spanner.Commit]. @@ -3098,17 +3134,17 @@ in this list. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitRequest) - }, + ), ) _sym_db.RegisterMessage(CommitRequest) CommitResponse = _reflection.GeneratedProtocolMessageType( "CommitResponse", (_message.Message,), - { - "DESCRIPTOR": _COMMITRESPONSE, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The response for + dict( + DESCRIPTOR=_COMMITRESPONSE, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The response for [Commit][google.spanner.v1.Spanner.Commit]. @@ -3118,17 +3154,17 @@ committed. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.CommitResponse) - }, + ), ) _sym_db.RegisterMessage(CommitResponse) RollbackRequest = _reflection.GeneratedProtocolMessageType( "RollbackRequest", (_message.Message,), - { - "DESCRIPTOR": _ROLLBACKREQUEST, - "__module__": "google.cloud.spanner_v1.proto.spanner_pb2", - "__doc__": """The request for + dict( + DESCRIPTOR=_ROLLBACKREQUEST, + __module__="google.cloud.spanner_v1.proto.spanner_pb2", + __doc__="""The request for [Rollback][google.spanner.v1.Spanner.Rollback]. @@ -3140,7 +3176,7 @@ Required. The transaction to roll back. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.RollbackRequest) - }, + ), ) _sym_db.RegisterMessage(RollbackRequest) @@ -3183,7 +3219,9 @@ full_name="google.spanner.v1.Spanner", file=DESCRIPTOR, index=0, - serialized_options=b"\312A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.data", + serialized_options=_b( + "\312A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.data" + ), serialized_start=4716, serialized_end=7596, methods=[ @@ -3194,7 +3232,9 @@ containing_service=None, input_type=_CREATESESSIONREQUEST, output_type=_SESSION, - serialized_options=b'\202\323\344\223\002?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\001*\332A\010database', + serialized_options=_b( + '\202\323\344\223\002?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\001*\332A\010database' + ), ), _descriptor.MethodDescriptor( name="BatchCreateSessions", @@ -3203,7 +3243,9 @@ containing_service=None, input_type=_BATCHCREATESESSIONSREQUEST, output_type=_BATCHCREATESESSIONSRESPONSE, - serialized_options=b'\202\323\344\223\002K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\001*\332A\026database,session_count', + serialized_options=_b( + '\202\323\344\223\002K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\001*\332A\026database,session_count' + ), ), _descriptor.MethodDescriptor( name="GetSession", @@ -3212,7 +3254,9 @@ containing_service=None, input_type=_GETSESSIONREQUEST, output_type=_SESSION, - serialized_options=b"\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002:\0228/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="ListSessions", @@ -3221,7 +3265,9 @@ containing_service=None, input_type=_LISTSESSIONSREQUEST, output_type=_LISTSESSIONSRESPONSE, - serialized_options=b"\202\323\344\223\002<\022:/v1/{database=projects/*/instances/*/databases/*}/sessions\332A\010database", + serialized_options=_b( + "\202\323\344\223\002<\022:/v1/{database=projects/*/instances/*/databases/*}/sessions\332A\010database" + ), ), _descriptor.MethodDescriptor( name="DeleteSession", @@ -3230,7 +3276,9 @@ containing_service=None, input_type=_DELETESESSIONREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=b"\202\323\344\223\002:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name", + serialized_options=_b( + "\202\323\344\223\002:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\332A\004name" + ), ), _descriptor.MethodDescriptor( name="ExecuteSql", @@ -3239,7 +3287,9 @@ containing_service=None, input_type=_EXECUTESQLREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET, - serialized_options=b'\202\323\344\223\002K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\001*', + serialized_options=_b( + '\202\323\344\223\002K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\001*' + ), ), _descriptor.MethodDescriptor( name="ExecuteStreamingSql", @@ -3248,7 +3298,9 @@ containing_service=None, input_type=_EXECUTESQLREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET, - serialized_options=b'\202\323\344\223\002T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\001*', + serialized_options=_b( + '\202\323\344\223\002T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\001*' + ), ), _descriptor.MethodDescriptor( name="ExecuteBatchDml", @@ -3257,7 +3309,9 @@ containing_service=None, input_type=_EXECUTEBATCHDMLREQUEST, output_type=_EXECUTEBATCHDMLRESPONSE, - serialized_options=b'\202\323\344\223\002P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\001*', + serialized_options=_b( + '\202\323\344\223\002P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\001*' + ), ), _descriptor.MethodDescriptor( name="Read", @@ -3266,7 +3320,9 @@ containing_service=None, input_type=_READREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._RESULTSET, - serialized_options=b'\202\323\344\223\002E"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*', + serialized_options=_b( + '\202\323\344\223\002E"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\001*' + ), ), _descriptor.MethodDescriptor( name="StreamingRead", @@ -3275,7 +3331,9 @@ containing_service=None, input_type=_READREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2._PARTIALRESULTSET, - serialized_options=b'\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\001*', + serialized_options=_b( + '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\001*' + ), ), _descriptor.MethodDescriptor( name="BeginTransaction", @@ -3284,7 +3342,9 @@ containing_service=None, input_type=_BEGINTRANSACTIONREQUEST, output_type=google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION, - serialized_options=b'\202\323\344\223\002Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\001*\332A\017session,options', + serialized_options=_b( + '\202\323\344\223\002Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\001*\332A\017session,options' + ), ), _descriptor.MethodDescriptor( name="Commit", @@ -3293,7 +3353,9 @@ containing_service=None, input_type=_COMMITREQUEST, output_type=_COMMITRESPONSE, - serialized_options=b'\202\323\344\223\002G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\001*\332A session,transaction_id,mutations\332A(session,single_use_transaction,mutations', + serialized_options=_b( + '\202\323\344\223\002G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\001*\332A session,transaction_id,mutations\332A(session,single_use_transaction,mutations' + ), ), _descriptor.MethodDescriptor( name="Rollback", @@ -3302,7 +3364,9 @@ containing_service=None, input_type=_ROLLBACKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=b'\202\323\344\223\002I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*\332A\026session,transaction_id', + serialized_options=_b( + '\202\323\344\223\002I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\001*\332A\026session,transaction_id' + ), ), _descriptor.MethodDescriptor( name="PartitionQuery", @@ -3311,7 +3375,9 @@ containing_service=None, input_type=_PARTITIONQUERYREQUEST, output_type=_PARTITIONRESPONSE, - serialized_options=b'\202\323\344\223\002O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\001*', + serialized_options=_b( + '\202\323\344\223\002O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\001*' + ), ), _descriptor.MethodDescriptor( name="PartitionRead", @@ -3320,7 +3386,9 @@ containing_service=None, input_type=_PARTITIONREADREQUEST, output_type=_PARTITIONRESPONSE, - serialized_options=b'\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*', + serialized_options=_b( + '\202\323\344\223\002N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\001*' + ), ), ], ) diff --git a/google/cloud/spanner_v1/proto/transaction_pb2.py b/google/cloud/spanner_v1/proto/transaction_pb2.py index 3de92c6a17..aa83e3373c 100644 --- a/google/cloud/spanner_v1/proto/transaction_pb2.py +++ b/google/cloud/spanner_v1/proto/transaction_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/transaction.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -21,8 +24,12 @@ name="google/cloud/spanner_v1/proto/transaction.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\020TransactionProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n/google/cloud/spanner_v1/proto/transaction.proto\x12\x11google.spanner.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xc3\x04\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x1a\x0b\n\tReadWrite\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode"M\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selectorB\x99\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\020TransactionProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n/google/cloud/spanner_v1/proto/transaction.proto\x12\x11google.spanner.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xc3\x04\n\x12TransactionOptions\x12\x45\n\nread_write\x18\x01 \x01(\x0b\x32/.google.spanner.v1.TransactionOptions.ReadWriteH\x00\x12O\n\x0fpartitioned_dml\x18\x03 \x01(\x0b\x32\x34.google.spanner.v1.TransactionOptions.PartitionedDmlH\x00\x12\x43\n\tread_only\x18\x02 \x01(\x0b\x32..google.spanner.v1.TransactionOptions.ReadOnlyH\x00\x1a\x0b\n\tReadWrite\x1a\x10\n\x0ePartitionedDml\x1a\xa8\x02\n\x08ReadOnly\x12\x10\n\x06strong\x18\x01 \x01(\x08H\x00\x12\x38\n\x12min_read_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x32\n\rmax_staleness\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x34\n\x0eread_timestamp\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampH\x00\x12\x34\n\x0f\x65xact_staleness\x18\x05 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12\x1d\n\x15return_read_timestamp\x18\x06 \x01(\x08\x42\x11\n\x0ftimestamp_boundB\x06\n\x04mode"M\n\x0bTransaction\x12\n\n\x02id\x18\x01 \x01(\x0c\x12\x32\n\x0eread_timestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"\xa4\x01\n\x13TransactionSelector\x12;\n\nsingle_use\x18\x01 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12\x0c\n\x02id\x18\x02 \x01(\x0cH\x00\x12\x36\n\x05\x62\x65gin\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x42\n\n\x08selectorB\x99\x01\n\x15\x63om.google.spanner.v1B\x10TransactionProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[ google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, @@ -308,7 +315,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"", + default_value=_b(""), message_type=None, enum_type=None, containing_type=None, @@ -383,7 +390,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"", + default_value=_b(""), message_type=None, enum_type=None, containing_type=None, @@ -534,39 +541,39 @@ TransactionOptions = _reflection.GeneratedProtocolMessageType( "TransactionOptions", (_message.Message,), - { - "ReadWrite": _reflection.GeneratedProtocolMessageType( + dict( + ReadWrite=_reflection.GeneratedProtocolMessageType( "ReadWrite", (_message.Message,), - { - "DESCRIPTOR": _TRANSACTIONOPTIONS_READWRITE, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """Message type to initiate a read-write transaction. + dict( + DESCRIPTOR=_TRANSACTIONOPTIONS_READWRITE, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""Message type to initiate a read-write transaction. Currently this transaction type has no options. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadWrite) - }, + ), ), - "PartitionedDml": _reflection.GeneratedProtocolMessageType( + PartitionedDml=_reflection.GeneratedProtocolMessageType( "PartitionedDml", (_message.Message,), - { - "DESCRIPTOR": _TRANSACTIONOPTIONS_PARTITIONEDDML, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """Message type to initiate a Partitioned DML transaction. + dict( + DESCRIPTOR=_TRANSACTIONOPTIONS_PARTITIONEDDML, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""Message type to initiate a Partitioned DML transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.PartitionedDml) - }, + ), ), - "ReadOnly": _reflection.GeneratedProtocolMessageType( + ReadOnly=_reflection.GeneratedProtocolMessageType( "ReadOnly", (_message.Message,), - { - "DESCRIPTOR": _TRANSACTIONOPTIONS_READONLY, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """Message type to initiate a read-only transaction. + dict( + DESCRIPTOR=_TRANSACTIONOPTIONS_READONLY, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""Message type to initiate a read-only transaction. Attributes: @@ -589,7 +596,7 @@ Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if - the client’s local clock is substantially skewed from Cloud + the client's local clock is substantially skewed from Cloud Spanner commit timestamps. Useful for reading the freshest data available at a nearby replica, while bounding the possible staleness if the local replica has fallen behind. @@ -600,7 +607,7 @@ reads at a specific timestamp are repeatable; the same read at the same timestamp always returns the same data. If the timestamp is in the future, the read will block until the - specified timestamp, modulo the read’s deadline. Useful for + specified timestamp, modulo the read's deadline. Useful for large scale consistent reads such as mapreduces, or for coordinating many reads against a consistent snapshot of the data. A timestamp in RFC3339 UTC "Zulu" format, accurate to @@ -611,7 +618,7 @@ Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if - the client’s local clock is substantially skewed from Cloud + the client's local clock is substantially skewed from Cloud Spanner commit timestamps. Useful for reading at nearby replicas without the distributed timestamp negotiation overhead of ``max_staleness``. @@ -621,11 +628,11 @@ that describes the transaction. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions.ReadOnly) - }, + ), ), - "DESCRIPTOR": _TRANSACTIONOPTIONS, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """# Transactions + DESCRIPTOR=_TRANSACTIONOPTIONS, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""# Transactions Each session can have at most one active transaction at a time. After the active transaction is completed, the session can immediately be @@ -676,7 +683,7 @@ not been terminated by [Commit][google.spanner.v1.Spanner.Commit] or [Rollback][google.spanner.v1.Spanner.Rollback]. Long periods of inactivity at the client may cause Cloud Spanner to release a - transaction’s locks and abort it. + transaction's locks and abort it. Conceptually, a read-write transaction consists of zero or more reads or SQL statements followed by [Commit][google.spanner.v1.Spanner.Commit]. @@ -694,7 +701,7 @@ the transaction has not modified any user data in Cloud Spanner. Unless the transaction commits, Cloud Spanner makes no guarantees about - how long the transaction’s locks were held for. It is an error to use + how long the transaction's locks were held for. It is an error to use Cloud Spanner locks for any sort of mutual exclusion other than between Cloud Spanner transactions themselves. @@ -704,7 +711,7 @@ When a transaction aborts, the application can choose to retry the whole transaction again. To maximize the chances of successfully committing the retry, the client should execute the retry in the same session as - the original attempt. The original session’s lock priority increases + the original attempt. The original session's lock priority increases with each consecutive abort, meaning that each attempt has a slightly better chance of success than the previous. @@ -720,7 +727,7 @@ A transaction is considered idle if it has no outstanding reads or SQL queries and has not started a read or SQL query within the last 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they - don’t hold on to locks indefinitely. In that case, the commit will fail + don't hold on to locks indefinitely. In that case, the commit will fail with error ``ABORTED``. If this behavior is undesirable, periodically executing a simple SQL @@ -771,8 +778,8 @@ Strong reads are guaranteed to see the effects of all transactions that have committed before the start of the read. Furthermore, all rows - yielded by a single read are consistent with each other – if any part of - the read observes a transaction, all parts of the read see the + yielded by a single read are consistent with each other -- if any part + of the read observes a transaction, all parts of the read see the transaction. Strong reads are not repeatable: two consecutive strong read-only @@ -797,15 +804,15 @@ The timestamp can either be expressed as an absolute Cloud Spanner commit timestamp or a staleness relative to the current time. - These modes do not require a “negotiation phase” to pick a timestamp. As + These modes do not require a "negotiation phase" to pick a timestamp. As a result, they execute slightly faster than the equivalent boundedly stale concurrency modes. On the other hand, boundedly stale reads usually return fresher results. See - [TransactionOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read_timestamp] + [TransactionOptions.ReadOnly.read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read\_timestamp] and - [TransactionOptions.ReadOnly.exact_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness]. + [TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness]. Bounded Staleness @@ -815,7 +822,7 @@ newest timestamp within the staleness bound that allows execution of the reads at the closest available replica without blocking. - All rows yielded are consistent with each other – if any part of the + All rows yielded are consistent with each other -- if any part of the read observes a transaction, all parts of the read see the transaction. Boundedly stale reads are not repeatable: two stale reads, even if they use the same staleness bound, can execute at different timestamps and @@ -835,16 +842,16 @@ transactions. See - [TransactionOptions.ReadOnly.max_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max_staleness] + [TransactionOptions.ReadOnly.max\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max\_staleness] and - [TransactionOptions.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min_read_timestamp]. + [TransactionOptions.ReadOnly.min\_read\_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min\_read\_timestamp]. Old Read Timestamps and Garbage Collection Cloud Spanner continuously garbage collects deleted and overwritten data in the background to reclaim storage space. This process is known as - “version GC”. By default, version GC reclaims versions after they are + "version GC". By default, version GC reclaims versions after they are one hour old. Because of this, Cloud Spanner cannot perform reads at read timestamps more than one hour in the past. This restriction also applies to in-progress reads and/or SQL queries whose timestamp become @@ -932,7 +939,7 @@ the ``session`` resource. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionOptions) - }, + ), ) _sym_db.RegisterMessage(TransactionOptions) _sym_db.RegisterMessage(TransactionOptions.ReadWrite) @@ -942,10 +949,10 @@ Transaction = _reflection.GeneratedProtocolMessageType( "Transaction", (_message.Message,), - { - "DESCRIPTOR": _TRANSACTION, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """A transaction. + dict( + DESCRIPTOR=_TRANSACTION, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""A transaction. Attributes: @@ -960,23 +967,23 @@ read_timestamp: For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see [Transaction - Options.ReadOnly.return_read_timestamp][google.spanner.v1.Tran - sactionOptions.ReadOnly.return_read_timestamp]. A timestamp - in RFC3339 UTC "Zulu" format, accurate to nanoseconds. - Example: ``"2014-10-02T15:01:23.045123456Z"``. + Options.ReadOnly.return\_read\_timestamp][google.spanner.v1.Tr + ansactionOptions.ReadOnly.return\_read\_timestamp]. A + timestamp in RFC3339 UTC "Zulu" format, accurate to + nanoseconds. Example: ``"2014-10-02T15:01:23.045123456Z"``. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Transaction) - }, + ), ) _sym_db.RegisterMessage(Transaction) TransactionSelector = _reflection.GeneratedProtocolMessageType( "TransactionSelector", (_message.Message,), - { - "DESCRIPTOR": _TRANSACTIONSELECTOR, - "__module__": "google.cloud.spanner_v1.proto.transaction_pb2", - "__doc__": """This message is used to select the transaction in which a + dict( + DESCRIPTOR=_TRANSACTIONSELECTOR, + __module__="google.cloud.spanner_v1.proto.transaction_pb2", + __doc__="""This message is used to select the transaction in which a [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] call runs. @@ -1003,7 +1010,7 @@ [Transaction][google.spanner.v1.Transaction]. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.TransactionSelector) - }, + ), ) _sym_db.RegisterMessage(TransactionSelector) diff --git a/google/cloud/spanner_v1/proto/type_pb2.py b/google/cloud/spanner_v1/proto/type_pb2.py index 974f220690..2ef35b36c6 100644 --- a/google/cloud/spanner_v1/proto/type_pb2.py +++ b/google/cloud/spanner_v1/proto/type_pb2.py @@ -2,6 +2,9 @@ # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/spanner_v1/proto/type.proto +import sys + +_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -20,8 +23,12 @@ name="google/cloud/spanner_v1/proto/type.proto", package="google.spanner.v1", syntax="proto3", - serialized_options=b"\n\025com.google.spanner.v1B\tTypeProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1", - serialized_pb=b'\n(google/cloud/spanner_v1/proto/type.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto"\x9a\x01\n\x04Type\x12)\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCode\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\x8e\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\tB\x92\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3', + serialized_options=_b( + "\n\025com.google.spanner.v1B\tTypeProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1" + ), + serialized_pb=_b( + '\n(google/cloud/spanner_v1/proto/type.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto"\x9a\x01\n\x04Type\x12)\n\x04\x63ode\x18\x01 \x01(\x0e\x32\x1b.google.spanner.v1.TypeCode\x12\x33\n\x12\x61rray_element_type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type\x12\x32\n\x0bstruct_type\x18\x03 \x01(\x0b\x32\x1d.google.spanner.v1.StructType"\x7f\n\nStructType\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.spanner.v1.StructType.Field\x1a<\n\x05\x46ield\x12\x0c\n\x04name\x18\x01 \x01(\t\x12%\n\x04type\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type*\x8e\x01\n\x08TypeCode\x12\x19\n\x15TYPE_CODE_UNSPECIFIED\x10\x00\x12\x08\n\x04\x42OOL\x10\x01\x12\t\n\x05INT64\x10\x02\x12\x0b\n\x07\x46LOAT64\x10\x03\x12\r\n\tTIMESTAMP\x10\x04\x12\x08\n\x04\x44\x41TE\x10\x05\x12\n\n\x06STRING\x10\x06\x12\t\n\x05\x42YTES\x10\x07\x12\t\n\x05\x41RRAY\x10\x08\x12\n\n\x06STRUCT\x10\tB\x92\x01\n\x15\x63om.google.spanner.v1B\tTypeProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1b\x06proto3' + ), dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR], ) @@ -177,7 +184,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=b"".decode("utf-8"), + default_value=_b("").decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -269,10 +276,10 @@ Type = _reflection.GeneratedProtocolMessageType( "Type", (_message.Message,), - { - "DESCRIPTOR": _TYPE, - "__module__": "google.cloud.spanner_v1.proto.type_pb2", - "__doc__": """\ ``Type`` indicates the type of a Cloud Spanner value, as + dict( + DESCRIPTOR=_TYPE, + __module__="google.cloud.spanner_v1.proto.type_pb2", + __doc__="""\ ``Type`` indicates the type of a Cloud Spanner value, as might be stored in a table cell or returned from an SQL query. @@ -287,25 +294,25 @@ struct_type: If [code][google.spanner.v1.Type.code] == [STRUCT][google.spanner.v1.TypeCode.STRUCT], then - ``struct_type`` provides type information for the struct’s + ``struct_type`` provides type information for the struct's fields. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.Type) - }, + ), ) _sym_db.RegisterMessage(Type) StructType = _reflection.GeneratedProtocolMessageType( "StructType", (_message.Message,), - { - "Field": _reflection.GeneratedProtocolMessageType( + dict( + Field=_reflection.GeneratedProtocolMessageType( "Field", (_message.Message,), - { - "DESCRIPTOR": _STRUCTTYPE_FIELD, - "__module__": "google.cloud.spanner_v1.proto.type_pb2", - "__doc__": """Message representing a single field of a struct. + dict( + DESCRIPTOR=_STRUCTTYPE_FIELD, + __module__="google.cloud.spanner_v1.proto.type_pb2", + __doc__="""Message representing a single field of a struct. Attributes: @@ -314,18 +321,18 @@ SQL queries, it is the column alias (e.g., ``"Word"`` in the query ``"SELECT 'hello' AS Word"``), or the column name (e.g., ``"ColName"`` in the query ``"SELECT ColName FROM Table"``). - Some columns might have an empty name (e.g., !“SELECT - UPPER(ColName)”\`). Note that a query result can contain + Some columns might have an empty name (e.g., !"SELECT + UPPER(ColName)"\`). Note that a query result can contain multiple fields with the same name. type: The type of the field. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType.Field) - }, + ), ), - "DESCRIPTOR": _STRUCTTYPE, - "__module__": "google.cloud.spanner_v1.proto.type_pb2", - "__doc__": """\ ``StructType`` defines the fields of a + DESCRIPTOR=_STRUCTTYPE, + __module__="google.cloud.spanner_v1.proto.type_pb2", + __doc__="""\ ``StructType`` defines the fields of a [STRUCT][google.spanner.v1.TypeCode.STRUCT] type. @@ -340,7 +347,7 @@ the order of fields in the ``SELECT`` clause of a query. """, # @@protoc_insertion_point(class_scope:google.spanner.v1.StructType) - }, + ), ) _sym_db.RegisterMessage(StructType) _sym_db.RegisterMessage(StructType.Field)