From 9fbc555eb68683704de54c5bc279304459f06b27 Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 08:50:48 -0700 Subject: [PATCH 1/9] changes without context autosynth cannot find the source of changes triggered by earlier changes in this repository, or by version upgrades to tools such as linters. --- .../gapic/database_admin_client_config.py | 4 +- .../proto/spanner_database_admin_pb2.py | 18 +- .../proto/spanner_instance_admin_pb2.py | 24 +- google/cloud/spanner_v1/proto/keys_pb2.py | 2 +- google/cloud/spanner_v1/proto/spanner_pb2.py | 19 +- .../cloud/spanner_v1/proto/transaction_pb2.py | 445 +++++++----------- synth.metadata | 41 +- 7 files changed, 247 insertions(+), 306 deletions(-) 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 ca3fa3cbe8..936fa54ef9 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 @@ -118,8 +118,8 @@ }, "UpdateBackup": { "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "DeleteBackup": { "timeout_millis": 3600000, 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 f0accdbecd..fa8d83ede0 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 @@ -1489,10 +1489,10 @@ Number of databases to be returned in the 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.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) }, @@ -1780,11 +1780,11 @@ Number of operations to be returned in the 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.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) 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 8d086520e5..ae72e014de 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 @@ -1487,11 +1487,11 @@ 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) }, @@ -1610,10 +1610,10 @@ Number of instances to be returned in the 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.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 @@ -1668,9 +1668,9 @@ 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 diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index 8481775d4b..0f0dba9787 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -347,7 +347,7 @@ { "DESCRIPTOR": _KEYSET, "__module__": "google.cloud.spanner_v1.proto.keys_pb2", - "__doc__": """``KeySet`` defines a collection of Cloud Spanner keys and/or key + "__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 diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index a48a12ca59..995420df80 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -3088,9 +3088,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 @@ -3102,17 +3102,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. diff --git a/google/cloud/spanner_v1/proto/transaction_pb2.py b/google/cloud/spanner_v1/proto/transaction_pb2.py index 865a2446ad..44596d1111 100644 --- a/google/cloud/spanner_v1/proto/transaction_pb2.py +++ b/google/cloud/spanner_v1/proto/transaction_pb2.py @@ -644,50 +644,34 @@ ), "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 - re-used for the next transaction. It is not necessary to create a new - session for each transaction. - - Transaction Modes - - - Cloud Spanner supports three transaction modes: - - 1. Locking read-write. This type of transaction is the only way to write - data into Cloud Spanner. These transactions rely on pessimistic - locking and, if necessary, two-phase commit. Locking read-write - transactions may abort, requiring the application to retry. - - 2. Snapshot read-only. This transaction type provides guaranteed - consistency across several reads, but does not allow writes. Snapshot - read-only transactions can be configured to read at timestamps in the - past. Snapshot read-only transactions do not need to be committed. - - 3. Partitioned DML. This type of transaction is used to execute a single - Partitioned DML statement. Partitioned DML partitions the key space - and runs the DML statement over each partition in parallel using - separate, internal transactions that commit independently. - Partitioned DML transactions do not need to be committed. - - For transactions that only read, snapshot read-only transactions provide - simpler semantics and are almost always faster. In particular, read-only - transactions do not take locks, so they do not conflict with read-write - transactions. As a consequence of not taking locks, they also do not - abort, so retry loops are not needed. - - Transactions may only read/write data in a single database. They may, - however, read/write data in different tables within that database. - - Locking Read-Write Transactions - - - Locking transactions may be used to atomically read-modify-write data - anywhere in a database. This type of transaction is externally - consistent. - + "__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 re-used for the next transaction. It is not necessary + to create a new session for each transaction. Transaction Modes + Cloud Spanner supports three transaction modes: 1. + Locking read-write. This type of transaction is the only way to write + data into Cloud Spanner. These transactions rely on pessimistic + locking and, if necessary, two-phase commit. Locking read-write + transactions may abort, requiring the application to retry. 2. + Snapshot read-only. This transaction type provides guaranteed + consistency across several reads, but does not allow writes. Snapshot + read-only transactions can be configured to read at timestamps in the + past. Snapshot read-only transactions do not need to be committed. 3. + Partitioned DML. This type of transaction is used to execute a single + Partitioned DML statement. Partitioned DML partitions the key space + and runs the DML statement over each partition in parallel using + separate, internal transactions that commit independently. + Partitioned DML transactions do not need to be committed. For + transactions that only read, snapshot read-only transactions provide + simpler semantics and are almost always faster. In particular, read- + only transactions do not take locks, so they do not conflict with + read-write transactions. As a consequence of not taking locks, they + also do not abort, so retry loops are not needed. Transactions may + only read/write data in a single database. They may, however, + read/write data in different tables within that database. Locking + Read-Write Transactions Locking + transactions may be used to atomically read-modify-write data anywhere + in a database. This type of transaction is externally consistent. Clients should attempt to minimize the amount of time a transaction is active. Faster transactions commit with higher probability and cause less contention. Cloud Spanner attempts to keep read locks active as @@ -695,238 +679,160 @@ 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. - - Conceptually, a read-write transaction consists of zero or more reads or - SQL statements followed by [Commit][google.spanner.v1.Spanner.Commit]. - At any time before [Commit][google.spanner.v1.Spanner.Commit], the - client can send a [Rollback][google.spanner.v1.Spanner.Rollback] request - to abort the transaction. - - Semantics - - - Cloud Spanner can commit the transaction if all read locks it acquired - are still valid at commit time, and it is able to acquire write locks - for all writes. Cloud Spanner can abort the transaction for any reason. - If a commit attempt returns ``ABORTED``, Cloud Spanner guarantees that - 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 - Cloud Spanner locks for any sort of mutual exclusion other than between - Cloud Spanner transactions themselves. - - Retrying Aborted Transactions - - - 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 - with each consecutive abort, meaning that each attempt has a slightly - better chance of success than the previous. - - Under some circumstances (e.g., many transactions attempting to modify - the same row(s)), a transaction can abort many times in a short period - before successfully committing. Thus, it is not a good idea to cap the - number of retries a transaction can attempt; instead, it is better to - limit the total amount of wall time spent retrying. - - Idle Transactions - - - A transaction is considered idle if it has no outstanding reads or SQL + 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]. At any time before + [Commit][google.spanner.v1.Spanner.Commit], the client can send a + [Rollback][google.spanner.v1.Spanner.Rollback] request to abort the + transaction. Semantics Cloud Spanner can commit the + transaction if all read locks it acquired are still valid at commit + time, and it is able to acquire write locks for all writes. Cloud + Spanner can abort the transaction for any reason. If a commit attempt + returns ``ABORTED``, Cloud Spanner guarantees that 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 Cloud Spanner + locks for any sort of mutual exclusion other than between Cloud + Spanner transactions themselves. Retrying Aborted Transactions + 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 with each consecutive + abort, meaning that each attempt has a slightly better chance of + success than the previous. Under some circumstances (e.g., many + transactions attempting to modify the same row(s)), a transaction can + abort many times in a short period before successfully committing. + Thus, it is not a good idea to cap the number of retries a transaction + can attempt; instead, it is better to limit the total amount of wall + time spent retrying. Idle Transactions 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 - with error ``ABORTED``. - - If this behavior is undesirable, periodically executing a simple SQL - query in the transaction (e.g., ``SELECT 1``) prevents the transaction - from becoming idle. - - Snapshot Read-Only Transactions - - - Snapshot read-only transactions provides a simpler method than locking - read-write transactions for doing several consistent reads. However, - this type of transaction does not support writes. - - Snapshot transactions do not take locks. Instead, they work by choosing - a Cloud Spanner timestamp, then executing all reads at that timestamp. - Since they do not acquire locks, they do not block concurrent read-write - transactions. - - Unlike locking read-write transactions, snapshot read-only transactions - never abort. They can fail if the chosen read timestamp is garbage + 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 with error ``ABORTED``. If this behavior is undesirable, + periodically executing a simple SQL query in the transaction (e.g., + ``SELECT 1``) prevents the transaction from becoming idle. Snapshot + Read-Only Transactions Snapshot read- + only transactions provides a simpler method than locking read-write + transactions for doing several consistent reads. However, this type of + transaction does not support writes. Snapshot transactions do not + take locks. Instead, they work by choosing a Cloud Spanner timestamp, + then executing all reads at that timestamp. Since they do not acquire + locks, they do not block concurrent read-write transactions. Unlike + locking read-write transactions, snapshot read-only transactions never + abort. They can fail if the chosen read timestamp is garbage collected; however, the default garbage collection policy is generous enough that most applications do not need to worry about this in - practice. - - Snapshot read-only transactions do not need to call + practice. Snapshot read-only transactions do not need to call [Commit][google.spanner.v1.Spanner.Commit] or [Rollback][google.spanner.v1.Spanner.Rollback] (and in fact are not - permitted to do so). - - To execute a snapshot transaction, the client specifies a timestamp - bound, which tells Cloud Spanner how to choose a read timestamp. - - The types of timestamp bound are: - - - Strong (the default). - - Bounded staleness. - - Exact staleness. - - If the Cloud Spanner database to be read is geographically distributed, - stale read-only transactions can execute more quickly than strong or - read-write transaction, because they are able to execute far from the - leader replica. - - Each type of timestamp bound is discussed in detail below. - - Strong - - - 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 - transaction. - - Strong reads are not repeatable: two consecutive strong read-only - transactions might return inconsistent results if there are concurrent - writes. If consistency across reads is required, the reads should be - executed within a transaction or at an exact read timestamp. - - See - [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong]. - - Exact Staleness - - - These timestamp bounds execute reads at a user-specified timestamp. - Reads at a timestamp are guaranteed to see a consistent prefix of the - global transaction history: they observe modifications done by all - transactions with a commit timestamp <= the read timestamp, and observe - none of the modifications done by transactions with a larger commit - timestamp. They will block until all conflicting transactions that may - be assigned commit timestamps <= the read timestamp have finished. - - 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 - 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] - and - [TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness]. - - Bounded Staleness - - - Bounded staleness modes allow Cloud Spanner to pick the read timestamp, - subject to a user-provided staleness bound. Cloud Spanner chooses the - 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 - 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 - thus return inconsistent results. - - Boundedly stale reads execute in two phases: the first phase negotiates - a timestamp among all replicas needed to serve the read. In the second - phase, reads are executed at the negotiated timestamp. - - As a result of the two phase execution, bounded staleness reads are - usually a little slower than comparable exact staleness reads. However, - they are typically able to return fresher results, and are more likely - to execute at the closest replica. - + permitted to do so). To execute a snapshot transaction, the client + specifies a timestamp bound, which tells Cloud Spanner how to choose a + read timestamp. The types of timestamp bound are: - Strong (the + default). - Bounded staleness. - Exact staleness. If the Cloud + Spanner database to be read is geographically distributed, stale read- + only transactions can execute more quickly than strong or read-write + transaction, because they are able to execute far from the leader + replica. Each type of timestamp bound is discussed in detail below. + Strong 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 transaction. Strong reads are not repeatable: two + consecutive strong read-only transactions might return inconsistent + results if there are concurrent writes. If consistency across reads is + required, the reads should be executed within a transaction or at an + exact read timestamp. See [TransactionOptions.ReadOnly.strong][google + .spanner.v1.TransactionOptions.ReadOnly.strong]. Exact Staleness + These timestamp bounds execute reads at a user- + specified timestamp. Reads at a timestamp are guaranteed to see a + consistent prefix of the global transaction history: they observe + modifications done by all transactions with a commit timestamp <= the + read timestamp, and observe none of the modifications done by + transactions with a larger commit timestamp. They will block until all + conflicting transactions that may be assigned commit timestamps <= the + read timestamp have finished. 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 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 [Transactio + nOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions + .ReadOnly.read_timestamp] and [TransactionOptions.ReadOnly.exact_stale + ness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness]. + Bounded Staleness Bounded staleness modes allow + Cloud Spanner to pick the read timestamp, subject to a user-provided + staleness bound. Cloud Spanner chooses the 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 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 thus return + inconsistent results. Boundedly stale reads execute in two phases: + the first phase negotiates a timestamp among all replicas needed to + serve the read. In the second phase, reads are executed at the + negotiated timestamp. As a result of the two phase execution, bounded + staleness reads are usually a little slower than comparable exact + staleness reads. However, they are typically able to return fresher + results, and are more likely to execute at the closest replica. Because the timestamp negotiation requires up-front knowledge of which rows will be read, it can only be used with single-use read-only - transactions. - - See - [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]. - - 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 - one hour old. Because of this, Cloud Spanner cannot perform reads at - read timestamps more than one hour in the past. This restriction also + transactions. See [TransactionOptions.ReadOnly.max_staleness][google. + spanner.v1.TransactionOptions.ReadOnly.max_staleness] and [Transaction + Options.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOpti + ons.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 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 too old while executing. Reads and SQL queries with too-old read - timestamps fail with the error ``FAILED_PRECONDITION``. - - Partitioned DML Transactions - - - Partitioned DML transactions are used to execute DML statements with a - different execution strategy that provides different, and often better, + timestamps fail with the error ``FAILED_PRECONDITION``. Partitioned + DML Transactions Partitioned DML + transactions are used to execute DML statements with a different + execution strategy that provides different, and often better, scalability properties for large, table-wide operations than DML in a ReadWrite transaction. Smaller scoped statements, such as an OLTP - workload, should prefer using ReadWrite transactions. - - Partitioned DML partitions the keyspace and runs the DML statement on - each partition in separate, internal transactions. These transactions - commit automatically when complete, and run independently from one - another. - + workload, should prefer using ReadWrite transactions. Partitioned DML + partitions the keyspace and runs the DML statement on each partition + in separate, internal transactions. These transactions commit + automatically when complete, and run independently from one another. To reduce lock contention, this execution strategy only acquires read locks on rows that match the WHERE clause of the statement. - Additionally, the smaller per-partition transactions hold locks for less - time. - - That said, Partitioned DML is not a drop-in replacement for standard DML - used in ReadWrite transactions. - - - The DML statement must be fully-partitionable. Specifically, the - statement must be expressible as the union of many statements which - each access only a single row of the table. - - - The statement is not applied atomically to all rows of the table. - Rather, the statement is applied atomically to partitions of the - table, in independent transactions. Secondary index rows are updated - atomically with the base table rows. - - - Partitioned DML does not guarantee exactly-once execution semantics - against a partition. The statement will be applied at least once to - each partition. It is strongly recommended that the DML statement - should be idempotent to avoid unexpected results. For instance, it is - potentially dangerous to run a statement such as - ``UPDATE table SET column = column + 1`` as it could be run multiple - times against some rows. - - - The partitions are committed automatically - there is no support for - Commit or Rollback. If the call returns an error, or if the client - issuing the ExecuteSql call dies, it is possible that some rows had - the statement executed on them successfully. It is also possible that - statement was never executed against other rows. - - - Partitioned DML transactions may only contain the execution of a - single DML statement via ExecuteSql or ExecuteStreamingSql. - - - If any error is encountered during the execution of the partitioned - DML operation (for instance, a UNIQUE INDEX violation, division by - zero, or a value that cannot be stored due to schema constraints), - then the operation is stopped at that point and an error is returned. - It is possible that at this point, some partitions have been - committed (or even committed multiple times), and other partitions - have not been run at all. - - Given the above, Partitioned DML is good fit for large, database-wide, + Additionally, the smaller per-partition transactions hold locks for + less time. That said, Partitioned DML is not a drop-in replacement + for standard DML used in ReadWrite transactions. - The DML statement + must be fully-partitionable. Specifically, the statement must be + expressible as the union of many statements which each access only + a single row of the table. - The statement is not applied atomically + to all rows of the table. Rather, the statement is applied + atomically to partitions of the table, in independent transactions. + Secondary index rows are updated atomically with the base table + rows. - Partitioned DML does not guarantee exactly-once execution + semantics against a partition. The statement will be applied at + least once to each partition. It is strongly recommended that the + DML statement should be idempotent to avoid unexpected results. For + instance, it is potentially dangerous to run a statement such as + ``UPDATE table SET column = column + 1`` as it could be run multiple + times against some rows. - The partitions are committed + automatically - there is no support for Commit or Rollback. If the + call returns an error, or if the client issuing the ExecuteSql call + dies, it is possible that some rows had the statement executed on + them successfully. It is also possible that statement was never + executed against other rows. - Partitioned DML transactions may only + contain the execution of a single DML statement via ExecuteSql or + ExecuteStreamingSql. - If any error is encountered during the + execution of the partitioned DML operation (for instance, a UNIQUE + INDEX violation, division by zero, or a value that cannot be stored + due to schema constraints), then the operation is stopped at that + point and an error is returned. It is possible that at this point, + some partitions have been committed (or even committed multiple + times), and other partitions have not been run at all. Given the + above, Partitioned DML is good fit for large, database-wide, operations that are idempotent, such as deleting old rows from a very large table. @@ -977,10 +883,10 @@ 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) }, @@ -995,9 +901,8 @@ "__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. - - See [TransactionOptions][google.spanner.v1.TransactionOptions] for more + [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] call runs. See + [TransactionOptions][google.spanner.v1.TransactionOptions] for more information about transactions. Attributes: diff --git a/synth.metadata b/synth.metadata index df4ded371b..d7e46df40a 100644 --- a/synth.metadata +++ b/synth.metadata @@ -3,8 +3,16 @@ { "git": { "name": ".", - "remote": "git@github.com:larkee/python-spanner.git", - "sha": "3e54af6f8582e9620afb704e1d08994eab12c365" + "remote": "https://github.com/googleapis/python-spanner.git", + "sha": "891077105d5093a73caf96683d10afef2cd17823" + } + }, + { + "git": { + "name": "googleapis", + "remote": "https://github.com/googleapis/googleapis.git", + "sha": "6fd07563a2f1a6785066f5955ad9659a315e4492", + "internalRef": "324941614" } }, { @@ -21,5 +29,34 @@ "sha": "2686d7075fa456972bf4d08680d99617f5eb32b1" } } + ], + "destinations": [ + { + "client": { + "source": "googleapis", + "apiName": "spanner", + "apiVersion": "v1", + "language": "python", + "generator": "bazel" + } + }, + { + "client": { + "source": "googleapis", + "apiName": "spanner_admin_instance", + "apiVersion": "v1", + "language": "python", + "generator": "bazel" + } + }, + { + "client": { + "source": "googleapis", + "apiName": "spanner_admin_database", + "apiVersion": "v1", + "language": "python", + "generator": "bazel" + } + } ] } \ No newline at end of file From da47227b8460b22d6bf5ee1e3497600ff32f7399 Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 08:51:29 -0700 Subject: [PATCH 2/9] feat(python-library): changes to docs job * feat(python-library): changes to docs job * migrate to Trampoline V2 * add docs-presubmit job * create docfx yaml files and upload them to another bucket * remove redundant envvars Source-Author: Takashi Matsuo Source-Date: Wed Jul 29 16:15:18 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: f07cb4446192952f19be3056957f56d180586055 Source-Link: https://github.com/googleapis/synthtool/commit/f07cb4446192952f19be3056957f56d180586055 --- .../gapic/database_admin_client.py | 736 ++- .../gapic/database_admin_client_config.py | 292 +- .../spanner_admin_database_v1/gapic/enums.py | 4 +- .../database_admin_grpc_transport.py | 70 +- .../proto/backup_pb2.py | 1662 +++---- .../proto/backup_pb2_grpc.py | 1 + .../proto/common_pb2.py | 167 +- .../proto/common_pb2_grpc.py | 1 + .../proto/spanner_database_admin_pb2.py | 2768 ++++------- .../proto/spanner_database_admin_pb2_grpc.py | 952 ++-- .../spanner_admin_instance_v1/gapic/enums.py | 3 +- .../gapic/instance_admin_client.py | 453 +- .../gapic/instance_admin_client_config.py | 222 +- .../instance_admin_grpc_transport.py | 56 +- .../proto/spanner_instance_admin_pb2.py | 2454 ++++----- .../proto/spanner_instance_admin_pb2_grpc.py | 563 +-- google/cloud/spanner_v1/gapic/enums.py | 5 +- .../cloud/spanner_v1/gapic/spanner_client.py | 683 ++- .../spanner_v1/gapic/spanner_client_config.py | 272 +- .../transports/spanner_grpc_transport.py | 74 +- google/cloud/spanner_v1/proto/keys_pb2.py | 405 +- .../cloud/spanner_v1/proto/keys_pb2_grpc.py | 1 + google/cloud/spanner_v1/proto/mutation_pb2.py | 530 +- .../spanner_v1/proto/mutation_pb2_grpc.py | 1 + .../cloud/spanner_v1/proto/query_plan_pb2.py | 786 ++- .../spanner_v1/proto/query_plan_pb2_grpc.py | 1 + .../cloud/spanner_v1/proto/result_set_pb2.py | 701 +-- .../spanner_v1/proto/result_set_pb2_grpc.py | 1 + google/cloud/spanner_v1/proto/spanner_pb2.py | 4363 ++++++----------- .../spanner_v1/proto/spanner_pb2_grpc.py | 842 ++-- .../cloud/spanner_v1/proto/transaction_pb2.py | 914 ++-- .../spanner_v1/proto/transaction_pb2_grpc.py | 1 + google/cloud/spanner_v1/proto/type_pb2.py | 530 +- .../cloud/spanner_v1/proto/type_pb2_grpc.py | 1 + synth.metadata | 4 +- .../gapic/v1/test_database_admin_client_v1.py | 369 +- .../gapic/v1/test_instance_admin_client_v1.py | 245 +- tests/unit/gapic/v1/test_spanner_client_v1.py | 316 +- 38 files changed, 8418 insertions(+), 13031 deletions(-) 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 dc11cb0283..50e25d10c0 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 @@ -36,9 +36,7 @@ from google.cloud.spanner_admin_database_v1.gapic import database_admin_client_config from google.cloud.spanner_admin_database_v1.gapic import enums -from google.cloud.spanner_admin_database_v1.gapic.transports import ( - database_admin_grpc_transport, -) +from google.cloud.spanner_admin_database_v1.gapic.transports import database_admin_grpc_transport from google.cloud.spanner_admin_database_v1.proto import backup_pb2 from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2 from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2_grpc @@ -50,7 +48,10 @@ from google.protobuf import field_mask_pb2 -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version + +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution( + 'google-cloud-spanner', +).version class DatabaseAdminClient(object): @@ -63,12 +64,13 @@ class DatabaseAdminClient(object): database and to restore from an existing backup. """ - SERVICE_ADDRESS = "spanner.googleapis.com:443" + SERVICE_ADDRESS = 'spanner.googleapis.com:443' """The default address of the service.""" # The name of the interface for this client. This is the key used to # find the method configuration in the client_config dictionary. - _INTERFACE_NAME = "google.spanner.admin.database.v1.DatabaseAdmin" + _INTERFACE_NAME = 'google.spanner.admin.database.v1.DatabaseAdmin' + @classmethod def from_service_account_file(cls, filename, *args, **kwargs): @@ -84,17 +86,19 @@ def from_service_account_file(cls, filename, *args, **kwargs): Returns: DatabaseAdminClient: The constructed client. """ - credentials = service_account.Credentials.from_service_account_file(filename) - kwargs["credentials"] = credentials + credentials = service_account.Credentials.from_service_account_file( + filename) + kwargs['credentials'] = credentials return cls(*args, **kwargs) from_service_account_json = from_service_account_file + @classmethod def backup_path(cls, project, instance, backup): """Return a fully-qualified backup string.""" return google.api_core.path_template.expand( - "projects/{project}/instances/{instance}/backups/{backup}", + 'projects/{project}/instances/{instance}/backups/{backup}', project=project, instance=instance, backup=backup, @@ -104,7 +108,7 @@ def backup_path(cls, project, instance, backup): def database_path(cls, project, instance, database): """Return a fully-qualified database string.""" return google.api_core.path_template.expand( - "projects/{project}/instances/{instance}/databases/{database}", + 'projects/{project}/instances/{instance}/databases/{database}', project=project, instance=instance, database=database, @@ -114,20 +118,13 @@ def database_path(cls, project, instance, database): def instance_path(cls, project, instance): """Return a fully-qualified instance string.""" return google.api_core.path_template.expand( - "projects/{project}/instances/{instance}", + 'projects/{project}/instances/{instance}', project=project, instance=instance, ) - def __init__( - self, - transport=None, - channel=None, - credentials=None, - client_config=None, - client_info=None, - client_options=None, - ): + def __init__(self, transport=None, channel=None, credentials=None, + client_config=None, client_info=None, client_options=None): """Constructor. Args: @@ -163,27 +160,20 @@ def __init__( """ # Raise deprecation warnings for things we want to go away. if client_config is not None: - warnings.warn( - "The `client_config` argument is deprecated.", - PendingDeprecationWarning, - stacklevel=2, - ) + warnings.warn('The `client_config` argument is deprecated.', + PendingDeprecationWarning, stacklevel=2) else: client_config = database_admin_client_config.config if channel: - warnings.warn( - "The `channel` argument is deprecated; use " "`transport` instead.", - PendingDeprecationWarning, - stacklevel=2, - ) + warnings.warn('The `channel` argument is deprecated; use ' + '`transport` instead.', + PendingDeprecationWarning, stacklevel=2) api_endpoint = self.SERVICE_ADDRESS if client_options: if type(client_options) == dict: - client_options = google.api_core.client_options.from_dict( - client_options - ) + client_options = google.api_core.client_options.from_dict(client_options) if client_options.api_endpoint: api_endpoint = client_options.api_endpoint @@ -200,18 +190,20 @@ def __init__( else: if credentials: raise ValueError( - "Received both a transport instance and " - "credentials; these are mutually exclusive." + 'Received both a transport instance and ' + 'credentials; these are mutually exclusive.' ) self.transport = transport else: self.transport = database_admin_grpc_transport.DatabaseAdminGrpcTransport( - address=api_endpoint, channel=channel, credentials=credentials + address=api_endpoint, + channel=channel, + credentials=credentials, ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION + gapic_version=_GAPIC_LIBRARY_VERSION, ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -222,7 +214,7 @@ def __init__( # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config["interfaces"][self._INTERFACE_NAME] + client_config['interfaces'][self._INTERFACE_NAME], ) # Save a dictionary of cached API call functions. @@ -233,14 +225,13 @@ def __init__( # Service calls def create_database( - self, - parent, - create_statement, - extra_statements=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + create_statement, + extra_statements=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Creates a new Cloud Spanner database and starts to prepare it for serving. The returned ``long-running operation`` will have a name of the @@ -302,13 +293,11 @@ def create_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "create_database" not in self._inner_api_calls: - self._inner_api_calls[ - "create_database" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'create_database' not in self._inner_api_calls: + self._inner_api_calls['create_database'] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_database, - default_retry=self._method_configs["CreateDatabase"].retry, - default_timeout=self._method_configs["CreateDatabase"].timeout, + default_retry=self._method_configs['CreateDatabase'].retry, + default_timeout=self._method_configs['CreateDatabase'].timeout, client_info=self._client_info, ) @@ -321,18 +310,14 @@ def create_database( metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - operation = self._inner_api_calls["create_database"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + operation = self._inner_api_calls['create_database'](request, retry=retry, timeout=timeout, metadata=metadata) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -341,14 +326,13 @@ def create_database( ) def update_database_ddl( - self, - database, - statements, - operation_id=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + statements, + operation_id=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns, indexes, etc. The returned @@ -416,35 +400,31 @@ def update_database_ddl( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "update_database_ddl" not in self._inner_api_calls: - self._inner_api_calls[ - "update_database_ddl" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'update_database_ddl' not in self._inner_api_calls: + self._inner_api_calls['update_database_ddl'] = google.api_core.gapic_v1.method.wrap_method( self.transport.update_database_ddl, - default_retry=self._method_configs["UpdateDatabaseDdl"].retry, - default_timeout=self._method_configs["UpdateDatabaseDdl"].timeout, + default_retry=self._method_configs['UpdateDatabaseDdl'].retry, + default_timeout=self._method_configs['UpdateDatabaseDdl'].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.UpdateDatabaseDdlRequest( - database=database, statements=statements, operation_id=operation_id + database=database, + statements=statements, + operation_id=operation_id, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - operation = self._inner_api_calls["update_database_ddl"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + operation = self._inner_api_calls['update_database_ddl'](request, retry=retry, timeout=timeout, metadata=metadata) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -453,14 +433,13 @@ def update_database_ddl( ) def create_backup( - self, - parent, - backup_id, - backup, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + backup_id, + backup, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Starts creating a new Cloud Spanner Backup. The returned backup ``long-running operation`` will have a name of the format @@ -529,35 +508,31 @@ def create_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "create_backup" not in self._inner_api_calls: - self._inner_api_calls[ - "create_backup" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'create_backup' not in self._inner_api_calls: + self._inner_api_calls['create_backup'] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_backup, - default_retry=self._method_configs["CreateBackup"].retry, - default_timeout=self._method_configs["CreateBackup"].timeout, + default_retry=self._method_configs['CreateBackup'].retry, + default_timeout=self._method_configs['CreateBackup'].timeout, client_info=self._client_info, ) request = backup_pb2.CreateBackupRequest( - parent=parent, backup_id=backup_id, backup=backup + parent=parent, + backup_id=backup_id, + backup=backup, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - operation = self._inner_api_calls["create_backup"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + operation = self._inner_api_calls['create_backup'](request, retry=retry, timeout=timeout, metadata=metadata) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -566,14 +541,13 @@ def create_backup( ) def restore_database( - self, - parent, - database_id, - backup=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + database_id, + backup=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Create a new database by restoring from a completed backup. The new database must be in the same project and in an instance with the same @@ -641,39 +615,37 @@ def restore_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "restore_database" not in self._inner_api_calls: - self._inner_api_calls[ - "restore_database" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'restore_database' not in self._inner_api_calls: + self._inner_api_calls['restore_database'] = google.api_core.gapic_v1.method.wrap_method( self.transport.restore_database, - default_retry=self._method_configs["RestoreDatabase"].retry, - default_timeout=self._method_configs["RestoreDatabase"].timeout, + default_retry=self._method_configs['RestoreDatabase'].retry, + default_timeout=self._method_configs['RestoreDatabase'].timeout, client_info=self._client_info, ) # Sanity check: We have some fields which are mutually exclusive; # raise ValueError if more than one is sent. - google.api_core.protobuf_helpers.check_oneof(backup=backup) + google.api_core.protobuf_helpers.check_oneof( + backup=backup, + ) request = spanner_database_admin_pb2.RestoreDatabaseRequest( - parent=parent, database_id=database_id, backup=backup + parent=parent, + database_id=database_id, + backup=backup, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - operation = self._inner_api_calls["restore_database"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + operation = self._inner_api_calls['restore_database'](request, retry=retry, timeout=timeout, metadata=metadata) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -682,13 +654,12 @@ def restore_database( ) def list_databases( - self, - parent, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Lists Cloud Spanner databases. @@ -744,54 +715,45 @@ def list_databases( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "list_databases" not in self._inner_api_calls: - self._inner_api_calls[ - "list_databases" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'list_databases' not in self._inner_api_calls: + self._inner_api_calls['list_databases'] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_databases, - default_retry=self._method_configs["ListDatabases"].retry, - default_timeout=self._method_configs["ListDatabases"].timeout, + default_retry=self._method_configs['ListDatabases'].retry, + default_timeout=self._method_configs['ListDatabases'].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.ListDatabasesRequest( - parent=parent, page_size=page_size + parent=parent, + page_size=page_size, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial( - self._inner_api_calls["list_databases"], - retry=retry, - timeout=timeout, - metadata=metadata, - ), + method=functools.partial(self._inner_api_calls['list_databases'], retry=retry, timeout=timeout, metadata=metadata), request=request, - items_field="databases", - request_token_field="page_token", - response_token_field="next_page_token", + items_field='databases', + request_token_field='page_token', + response_token_field='next_page_token', ) return iterator def get_database( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Gets the state of a Cloud Spanner database. @@ -827,41 +789,36 @@ def get_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "get_database" not in self._inner_api_calls: - self._inner_api_calls[ - "get_database" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'get_database' not in self._inner_api_calls: + self._inner_api_calls['get_database'] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_database, - default_retry=self._method_configs["GetDatabase"].retry, - default_timeout=self._method_configs["GetDatabase"].timeout, + default_retry=self._method_configs['GetDatabase'].retry, + default_timeout=self._method_configs['GetDatabase'].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.GetDatabaseRequest(name=name) + request = spanner_database_admin_pb2.GetDatabaseRequest( + name=name, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("name", name)] + routing_header = [('name', name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["get_database"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['get_database'](request, retry=retry, timeout=timeout, metadata=metadata) def drop_database( - self, - database, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Drops (aka deletes) a Cloud Spanner database. Completed backups for the database will be retained according to their ``expire_time``. @@ -894,41 +851,36 @@ def drop_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "drop_database" not in self._inner_api_calls: - self._inner_api_calls[ - "drop_database" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'drop_database' not in self._inner_api_calls: + self._inner_api_calls['drop_database'] = google.api_core.gapic_v1.method.wrap_method( self.transport.drop_database, - default_retry=self._method_configs["DropDatabase"].retry, - default_timeout=self._method_configs["DropDatabase"].timeout, + default_retry=self._method_configs['DropDatabase'].retry, + default_timeout=self._method_configs['DropDatabase'].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.DropDatabaseRequest(database=database) + request = spanner_database_admin_pb2.DropDatabaseRequest( + database=database, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - self._inner_api_calls["drop_database"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + self._inner_api_calls['drop_database'](request, retry=retry, timeout=timeout, metadata=metadata) def get_database_ddl( - self, - database, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Returns the schema of a Cloud Spanner database as a list of formatted DDL statements. This method does not show pending schema @@ -965,42 +917,37 @@ def get_database_ddl( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "get_database_ddl" not in self._inner_api_calls: - self._inner_api_calls[ - "get_database_ddl" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'get_database_ddl' not in self._inner_api_calls: + self._inner_api_calls['get_database_ddl'] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_database_ddl, - default_retry=self._method_configs["GetDatabaseDdl"].retry, - default_timeout=self._method_configs["GetDatabaseDdl"].timeout, + default_retry=self._method_configs['GetDatabaseDdl'].retry, + default_timeout=self._method_configs['GetDatabaseDdl'].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.GetDatabaseDdlRequest(database=database) + request = spanner_database_admin_pb2.GetDatabaseDdlRequest( + database=database, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["get_database_ddl"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['get_database_ddl'](request, retry=retry, timeout=timeout, metadata=metadata) def set_iam_policy( - self, - resource, - policy, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + resource, + policy, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Sets the access control policy on a database or backup resource. Replaces any existing policy. @@ -1052,42 +999,38 @@ def set_iam_policy( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "set_iam_policy" not in self._inner_api_calls: - self._inner_api_calls[ - "set_iam_policy" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'set_iam_policy' not in self._inner_api_calls: + self._inner_api_calls['set_iam_policy'] = google.api_core.gapic_v1.method.wrap_method( self.transport.set_iam_policy, - default_retry=self._method_configs["SetIamPolicy"].retry, - default_timeout=self._method_configs["SetIamPolicy"].timeout, + default_retry=self._method_configs['SetIamPolicy'].retry, + default_timeout=self._method_configs['SetIamPolicy'].timeout, client_info=self._client_info, ) - request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) + request = iam_policy_pb2.SetIamPolicyRequest( + resource=resource, + policy=policy, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("resource", resource)] + routing_header = [('resource', resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["set_iam_policy"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['set_iam_policy'](request, retry=retry, timeout=timeout, metadata=metadata) def get_iam_policy( - self, - resource, - options_=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + resource, + options_=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have @@ -1135,44 +1078,38 @@ def get_iam_policy( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "get_iam_policy" not in self._inner_api_calls: - self._inner_api_calls[ - "get_iam_policy" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'get_iam_policy' not in self._inner_api_calls: + self._inner_api_calls['get_iam_policy'] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_iam_policy, - default_retry=self._method_configs["GetIamPolicy"].retry, - default_timeout=self._method_configs["GetIamPolicy"].timeout, + default_retry=self._method_configs['GetIamPolicy'].retry, + default_timeout=self._method_configs['GetIamPolicy'].timeout, client_info=self._client_info, ) request = iam_policy_pb2.GetIamPolicyRequest( - resource=resource, options=options_ + resource=resource, + options=options_, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("resource", resource)] + routing_header = [('resource', resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["get_iam_policy"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['get_iam_policy'](request, retry=retry, timeout=timeout, metadata=metadata) def test_iam_permissions( - self, - resource, - permissions, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + resource, + permissions, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Returns permissions that the caller has on the specified database or backup resource. @@ -1224,43 +1161,37 @@ def test_iam_permissions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "test_iam_permissions" not in self._inner_api_calls: - self._inner_api_calls[ - "test_iam_permissions" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'test_iam_permissions' not in self._inner_api_calls: + self._inner_api_calls['test_iam_permissions'] = google.api_core.gapic_v1.method.wrap_method( self.transport.test_iam_permissions, - default_retry=self._method_configs["TestIamPermissions"].retry, - default_timeout=self._method_configs["TestIamPermissions"].timeout, + default_retry=self._method_configs['TestIamPermissions'].retry, + default_timeout=self._method_configs['TestIamPermissions'].timeout, client_info=self._client_info, ) request = iam_policy_pb2.TestIamPermissionsRequest( - resource=resource, permissions=permissions + resource=resource, + permissions=permissions, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("resource", resource)] + routing_header = [('resource', resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["test_iam_permissions"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['test_iam_permissions'](request, retry=retry, timeout=timeout, metadata=metadata) def get_backup( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Gets metadata on a pending or completed ``Backup``. @@ -1296,42 +1227,37 @@ def get_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "get_backup" not in self._inner_api_calls: - self._inner_api_calls[ - "get_backup" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'get_backup' not in self._inner_api_calls: + self._inner_api_calls['get_backup'] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_backup, - default_retry=self._method_configs["GetBackup"].retry, - default_timeout=self._method_configs["GetBackup"].timeout, + default_retry=self._method_configs['GetBackup'].retry, + default_timeout=self._method_configs['GetBackup'].timeout, client_info=self._client_info, ) - request = backup_pb2.GetBackupRequest(name=name) + request = backup_pb2.GetBackupRequest( + name=name, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("name", name)] + routing_header = [('name', name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["get_backup"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['get_backup'](request, retry=retry, timeout=timeout, metadata=metadata) def update_backup( - self, - backup, - update_mask, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + backup, + update_mask, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Updates a pending or completed ``Backup``. @@ -1385,41 +1311,37 @@ def update_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "update_backup" not in self._inner_api_calls: - self._inner_api_calls[ - "update_backup" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'update_backup' not in self._inner_api_calls: + self._inner_api_calls['update_backup'] = google.api_core.gapic_v1.method.wrap_method( self.transport.update_backup, - default_retry=self._method_configs["UpdateBackup"].retry, - default_timeout=self._method_configs["UpdateBackup"].timeout, + default_retry=self._method_configs['UpdateBackup'].retry, + default_timeout=self._method_configs['UpdateBackup'].timeout, client_info=self._client_info, ) - request = backup_pb2.UpdateBackupRequest(backup=backup, update_mask=update_mask) + request = backup_pb2.UpdateBackupRequest( + backup=backup, + update_mask=update_mask, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("backup.name", backup.name)] + routing_header = [('backup.name', backup.name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["update_backup"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['update_backup'](request, retry=retry, timeout=timeout, metadata=metadata) def delete_backup( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Deletes a pending or completed ``Backup``. @@ -1452,43 +1374,38 @@ def delete_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "delete_backup" not in self._inner_api_calls: - self._inner_api_calls[ - "delete_backup" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'delete_backup' not in self._inner_api_calls: + self._inner_api_calls['delete_backup'] = google.api_core.gapic_v1.method.wrap_method( self.transport.delete_backup, - default_retry=self._method_configs["DeleteBackup"].retry, - default_timeout=self._method_configs["DeleteBackup"].timeout, + default_retry=self._method_configs['DeleteBackup'].retry, + default_timeout=self._method_configs['DeleteBackup'].timeout, client_info=self._client_info, ) - request = backup_pb2.DeleteBackupRequest(name=name) + request = backup_pb2.DeleteBackupRequest( + name=name, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("name", name)] + routing_header = [('name', name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - self._inner_api_calls["delete_backup"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + self._inner_api_calls['delete_backup'](request, retry=retry, timeout=timeout, metadata=metadata) def list_backups( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Lists completed and pending backups. Backups returned are ordered by ``create_time`` in descending order, starting from the most recent @@ -1579,56 +1496,48 @@ def list_backups( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "list_backups" not in self._inner_api_calls: - self._inner_api_calls[ - "list_backups" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'list_backups' not in self._inner_api_calls: + self._inner_api_calls['list_backups'] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_backups, - default_retry=self._method_configs["ListBackups"].retry, - default_timeout=self._method_configs["ListBackups"].timeout, + default_retry=self._method_configs['ListBackups'].retry, + default_timeout=self._method_configs['ListBackups'].timeout, client_info=self._client_info, ) request = backup_pb2.ListBackupsRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, + filter=filter_, + page_size=page_size, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial( - self._inner_api_calls["list_backups"], - retry=retry, - timeout=timeout, - metadata=metadata, - ), + method=functools.partial(self._inner_api_calls['list_backups'], retry=retry, timeout=timeout, metadata=metadata), request=request, - items_field="backups", - request_token_field="page_token", - response_token_field="next_page_token", + items_field='backups', + request_token_field='page_token', + response_token_field='next_page_token', ) return iterator def list_database_operations( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Lists database ``longrunning-operations``. A database operation has a name of the form @@ -1730,56 +1639,48 @@ def list_database_operations( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "list_database_operations" not in self._inner_api_calls: - self._inner_api_calls[ - "list_database_operations" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'list_database_operations' not in self._inner_api_calls: + self._inner_api_calls['list_database_operations'] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_database_operations, - default_retry=self._method_configs["ListDatabaseOperations"].retry, - default_timeout=self._method_configs["ListDatabaseOperations"].timeout, + default_retry=self._method_configs['ListDatabaseOperations'].retry, + default_timeout=self._method_configs['ListDatabaseOperations'].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.ListDatabaseOperationsRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, + filter=filter_, + page_size=page_size, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial( - self._inner_api_calls["list_database_operations"], - retry=retry, - timeout=timeout, - metadata=metadata, - ), + method=functools.partial(self._inner_api_calls['list_database_operations'], retry=retry, timeout=timeout, metadata=metadata), request=request, - items_field="operations", - request_token_field="page_token", - response_token_field="next_page_token", + items_field='operations', + request_token_field='page_token', + response_token_field='next_page_token', ) return iterator def list_backup_operations( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Lists the backup ``long-running operations`` in the given instance. A backup operation has a name of the form @@ -1881,43 +1782,36 @@ def list_backup_operations( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "list_backup_operations" not in self._inner_api_calls: - self._inner_api_calls[ - "list_backup_operations" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'list_backup_operations' not in self._inner_api_calls: + self._inner_api_calls['list_backup_operations'] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_backup_operations, - default_retry=self._method_configs["ListBackupOperations"].retry, - default_timeout=self._method_configs["ListBackupOperations"].timeout, + default_retry=self._method_configs['ListBackupOperations'].retry, + default_timeout=self._method_configs['ListBackupOperations'].timeout, client_info=self._client_info, ) request = backup_pb2.ListBackupOperationsRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, + filter=filter_, + page_size=page_size, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("parent", parent)] + routing_header = [('parent', parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial( - self._inner_api_calls["list_backup_operations"], - retry=retry, - timeout=timeout, - metadata=metadata, - ), + method=functools.partial(self._inner_api_calls['list_backup_operations'], retry=retry, timeout=timeout, metadata=metadata), request=request, - items_field="operations", - request_token_field="page_token", - response_token_field="next_page_token", + items_field='operations', + request_token_field='page_token', + response_token_field='next_page_token', ) return iterator 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 936fa54ef9..a987f180ad 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 @@ -1,147 +1,153 @@ config = { - "interfaces": { - "google.spanner.admin.database.v1.DatabaseAdmin": { - "retry_codes": { - "retry_policy_1_codes": ["UNAVAILABLE", "DEADLINE_EXCEEDED"], - "no_retry_2_codes": [], - "no_retry_codes": [], - "retry_policy_2_codes": ["UNAVAILABLE", "DEADLINE_EXCEEDED"], - "no_retry_1_codes": [], - }, - "retry_params": { - "retry_policy_1_params": { - "initial_retry_delay_millis": 1000, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000, - }, - "retry_policy_2_params": { - "initial_retry_delay_millis": 1000, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000, - }, - "no_retry_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 0, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 0, - "total_timeout_millis": 0, - }, - "no_retry_1_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000, - }, - "no_retry_2_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000, - }, - }, - "methods": { - "CreateDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", - }, - "UpdateDatabaseDdl": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "CreateBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", - }, - "RestoreDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", - }, - "ListDatabases": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "GetDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "DropDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "GetDatabaseDdl": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "SetIamPolicy": { - "timeout_millis": 30000, - "retry_codes_name": "no_retry_2_codes", - "retry_params_name": "no_retry_2_params", - }, - "GetIamPolicy": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_2_codes", - "retry_params_name": "retry_policy_2_params", - }, - "TestIamPermissions": { - "timeout_millis": 30000, - "retry_codes_name": "no_retry_2_codes", - "retry_params_name": "no_retry_2_params", - }, - "GetBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "UpdateBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "DeleteBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "ListBackups": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "ListDatabaseOperations": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "ListBackupOperations": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - }, + "interfaces": { + "google.spanner.admin.database.v1.DatabaseAdmin": { + "retry_codes": { + "retry_policy_1_codes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ], + "no_retry_2_codes": [], + "no_retry_codes": [], + "retry_policy_2_codes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ], + "no_retry_1_codes": [] + }, + "retry_params": { + "retry_policy_1_params": { + "initial_retry_delay_millis": 1000, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000 + }, + "retry_policy_2_params": { + "initial_retry_delay_millis": 1000, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000 + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0 + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000 + }, + "no_retry_2_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000 } + }, + "methods": { + "CreateDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "UpdateDatabaseDdl": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "CreateBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "RestoreDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "ListDatabases": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "GetDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "DropDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "GetDatabaseDdl": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "SetIamPolicy": { + "timeout_millis": 30000, + "retry_codes_name": "no_retry_2_codes", + "retry_params_name": "no_retry_2_params" + }, + "GetIamPolicy": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_2_codes", + "retry_params_name": "retry_policy_2_params" + }, + "TestIamPermissions": { + "timeout_millis": 30000, + "retry_codes_name": "no_retry_2_codes", + "retry_params_name": "no_retry_2_params" + }, + "GetBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "UpdateBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "DeleteBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "ListBackups": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "ListDatabaseOperations": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "ListBackupOperations": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + } + } } + } } diff --git a/google/cloud/spanner_admin_database_v1/gapic/enums.py b/google/cloud/spanner_admin_database_v1/gapic/enums.py index 575cb3a8f7..ecc74f33dc 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/enums.py +++ b/google/cloud/spanner_admin_database_v1/gapic/enums.py @@ -27,7 +27,6 @@ class RestoreSourceType(enum.IntEnum): TYPE_UNSPECIFIED (int): No restore associated. BACKUP (int): A backup was used as the source of the restore. """ - TYPE_UNSPECIFIED = 0 BACKUP = 1 @@ -43,7 +42,6 @@ class State(enum.IntEnum): may fail with ``FAILED_PRECONDITION`` in this state. READY (int): The backup is complete and ready for use. """ - STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -67,8 +65,8 @@ class State(enum.IntEnum): complete, the full performance of the database will be restored, and the database will transition to ``READY`` state. """ - STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 READY_OPTIMIZING = 3 + \ No newline at end of file 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 f2fb755668..8c6452d41f 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 @@ -29,17 +29,15 @@ class DatabaseAdminGrpcTransport(object): which can be used to take advantage of advanced features of gRPC. """ - # The scopes needed to make gRPC calls to all of the methods defined # in this service. _OAUTH_SCOPES = ( - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/spanner.admin", + 'https://www.googleapis.com/auth/cloud-platform', + 'https://www.googleapis.com/auth/spanner.admin', ) - def __init__( - self, channel=None, credentials=None, address="spanner.googleapis.com:443" - ): + def __init__(self, channel=None, credentials=None, + address='spanner.googleapis.com:443'): """Instantiate the transport class. Args: @@ -57,7 +55,8 @@ def __init__( # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - "The `channel` and `credentials` arguments are mutually " "exclusive." + 'The `channel` and `credentials` arguments are mutually ' + 'exclusive.', ) # Create the channel. @@ -66,8 +65,8 @@ def __init__( address=address, credentials=credentials, options={ - "grpc.max_send_message_length": -1, - "grpc.max_receive_message_length": -1, + 'grpc.max_send_message_length': -1, + 'grpc.max_receive_message_length': -1, }.items(), ) @@ -76,22 +75,20 @@ def __init__( # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. self._stubs = { - "database_admin_stub": spanner_database_admin_pb2_grpc.DatabaseAdminStub( - channel - ) + 'database_admin_stub': spanner_database_admin_pb2_grpc.DatabaseAdminStub(channel), } # Because this API includes a method that returns a # long-running operation (proto: google.longrunning.Operation), # instantiate an LRO client. - self._operations_client = google.api_core.operations_v1.OperationsClient( - channel - ) + self._operations_client = google.api_core.operations_v1.OperationsClient(channel) @classmethod def create_channel( - cls, address="spanner.googleapis.com:443", credentials=None, **kwargs - ): + cls, + address='spanner.googleapis.com:443', + credentials=None, + **kwargs): """Create and return a gRPC channel object. Args: @@ -108,7 +105,10 @@ def create_channel( grpc.Channel: A gRPC channel object. """ return google.api_core.grpc_helpers.create_channel( - address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs + address, + credentials=credentials, + scopes=cls._OAUTH_SCOPES, + **kwargs ) @property @@ -136,7 +136,7 @@ def create_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].CreateDatabase + return self._stubs['database_admin_stub'].CreateDatabase @property def update_database_ddl(self): @@ -154,7 +154,7 @@ def update_database_ddl(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].UpdateDatabaseDdl + return self._stubs['database_admin_stub'].UpdateDatabaseDdl @property def create_backup(self): @@ -175,7 +175,7 @@ def create_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].CreateBackup + return self._stubs['database_admin_stub'].CreateBackup @property def restore_database(self): @@ -200,7 +200,7 @@ def restore_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].RestoreDatabase + return self._stubs['database_admin_stub'].RestoreDatabase @property def list_databases(self): @@ -213,7 +213,7 @@ def list_databases(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].ListDatabases + return self._stubs['database_admin_stub'].ListDatabases @property def get_database(self): @@ -226,7 +226,7 @@ def get_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].GetDatabase + return self._stubs['database_admin_stub'].GetDatabase @property def drop_database(self): @@ -240,7 +240,7 @@ def drop_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].DropDatabase + return self._stubs['database_admin_stub'].DropDatabase @property def get_database_ddl(self): @@ -255,7 +255,7 @@ def get_database_ddl(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].GetDatabaseDdl + return self._stubs['database_admin_stub'].GetDatabaseDdl @property def set_iam_policy(self): @@ -273,7 +273,7 @@ def set_iam_policy(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].SetIamPolicy + return self._stubs['database_admin_stub'].SetIamPolicy @property def get_iam_policy(self): @@ -292,7 +292,7 @@ def get_iam_policy(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].GetIamPolicy + return self._stubs['database_admin_stub'].GetIamPolicy @property def test_iam_permissions(self): @@ -313,7 +313,7 @@ def test_iam_permissions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].TestIamPermissions + return self._stubs['database_admin_stub'].TestIamPermissions @property def get_backup(self): @@ -326,7 +326,7 @@ def get_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].GetBackup + return self._stubs['database_admin_stub'].GetBackup @property def update_backup(self): @@ -339,7 +339,7 @@ def update_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].UpdateBackup + return self._stubs['database_admin_stub'].UpdateBackup @property def delete_backup(self): @@ -352,7 +352,7 @@ def delete_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].DeleteBackup + return self._stubs['database_admin_stub'].DeleteBackup @property def list_backups(self): @@ -367,7 +367,7 @@ def list_backups(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].ListBackups + return self._stubs['database_admin_stub'].ListBackups @property def list_database_operations(self): @@ -386,7 +386,7 @@ def list_database_operations(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].ListDatabaseOperations + return self._stubs['database_admin_stub'].ListDatabaseOperations @property def list_backup_operations(self): @@ -407,4 +407,4 @@ def list_backup_operations(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["database_admin_stub"].ListBackupOperations + return self._stubs['database_admin_stub'].ListBackupOperations \ No newline at end of file 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 707412b7da..af4b7e5029 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py @@ -6,7 +6,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -14,996 +13,592 @@ from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 -from google.longrunning import ( - operations_pb2 as google_dot_longrunning_dot_operations__pb2, -) +from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 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, -) +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 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", - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1", - create_key=_descriptor._internal_create_key, - 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\xff\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\\V1\xea\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_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1', + create_key=_descriptor._internal_create_key, + 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\xff\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\\V1\xea\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_api_dot_annotations__pb2.DESCRIPTOR,]) + _BACKUP_STATE = _descriptor.EnumDescriptor( - name="State", - full_name="google.spanner.admin.database.v1.Backup.State", - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name="STATE_UNSPECIFIED", - index=0, - number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="CREATING", - index=1, - number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="READY", - index=2, - number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - ], - containing_type=None, - serialized_options=None, - serialized_start=661, - serialized_end=716, + name='State', + full_name='google.spanner.admin.database.v1.Backup.State', + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name='STATE_UNSPECIFIED', index=0, number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='CREATING', index=1, number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='READY', index=2, number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + ], + containing_type=None, + serialized_options=None, + serialized_start=661, + serialized_end=716, ) _sym_db.RegisterEnumDescriptor(_BACKUP_STATE) _BACKUP = _descriptor.Descriptor( - name="Backup", - full_name="google.spanner.admin.database.v1.Backup", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="database", - full_name="google.spanner.admin.database.v1.Backup.database", - index=0, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="expire_time", - full_name="google.spanner.admin.database.v1.Backup.expire_time", - index=1, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="name", - full_name="google.spanner.admin.database.v1.Backup.name", - index=2, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="create_time", - full_name="google.spanner.admin.database.v1.Backup.create_time", - index=3, - number=4, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="size_bytes", - full_name="google.spanner.admin.database.v1.Backup.size_bytes", - index=4, - number=5, - type=3, - cpp_type=2, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="state", - full_name="google.spanner.admin.database.v1.Backup.state", - index=5, - number=6, - type=14, - cpp_type=8, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="referencing_databases", - full_name="google.spanner.admin.database.v1.Backup.referencing_databases", - index=6, - number=7, - type=9, - cpp_type=9, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[_BACKUP_STATE], - serialized_options=b"\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}", - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=349, - serialized_end=810, + name='Backup', + full_name='google.spanner.admin.database.v1.Backup', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='database', full_name='google.spanner.admin.database.v1.Backup.database', index=0, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='expire_time', full_name='google.spanner.admin.database.v1.Backup.expire_time', index=1, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='name', full_name='google.spanner.admin.database.v1.Backup.name', index=2, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='create_time', full_name='google.spanner.admin.database.v1.Backup.create_time', index=3, + number=4, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='size_bytes', full_name='google.spanner.admin.database.v1.Backup.size_bytes', index=4, + number=5, type=3, cpp_type=2, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='state', full_name='google.spanner.admin.database.v1.Backup.state', index=5, + number=6, type=14, cpp_type=8, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='referencing_databases', full_name='google.spanner.admin.database.v1.Backup.referencing_databases', index=6, + number=7, type=9, cpp_type=9, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + _BACKUP_STATE, + ], + serialized_options=b'\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}', + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=349, + serialized_end=810, ) _CREATEBACKUPREQUEST = _descriptor.Descriptor( - name="CreateBackupRequest", - full_name="google.spanner.admin.database.v1.CreateBackupRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="parent", - full_name="google.spanner.admin.database.v1.CreateBackupRequest.parent", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="backup_id", - full_name="google.spanner.admin.database.v1.CreateBackupRequest.backup_id", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="backup", - full_name="google.spanner.admin.database.v1.CreateBackupRequest.backup", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\002", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=813, - serialized_end=978, + name='CreateBackupRequest', + full_name='google.spanner.admin.database.v1.CreateBackupRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='parent', full_name='google.spanner.admin.database.v1.CreateBackupRequest.parent', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='backup_id', full_name='google.spanner.admin.database.v1.CreateBackupRequest.backup_id', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='backup', full_name='google.spanner.admin.database.v1.CreateBackupRequest.backup', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=813, + serialized_end=978, ) _CREATEBACKUPMETADATA = _descriptor.Descriptor( - name="CreateBackupMetadata", - full_name="google.spanner.admin.database.v1.CreateBackupMetadata", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="name", - full_name="google.spanner.admin.database.v1.CreateBackupMetadata.name", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="database", - full_name="google.spanner.admin.database.v1.CreateBackupMetadata.database", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="progress", - full_name="google.spanner.admin.database.v1.CreateBackupMetadata.progress", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="cancel_time", - full_name="google.spanner.admin.database.v1.CreateBackupMetadata.cancel_time", - index=3, - number=4, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=981, - serialized_end=1155, + name='CreateBackupMetadata', + full_name='google.spanner.admin.database.v1.CreateBackupMetadata', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='name', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.name', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='database', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.database', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='progress', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.progress', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='cancel_time', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.cancel_time', index=3, + number=4, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=981, + serialized_end=1155, ) _UPDATEBACKUPREQUEST = _descriptor.Descriptor( - name="UpdateBackupRequest", - full_name="google.spanner.admin.database.v1.UpdateBackupRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="backup", - full_name="google.spanner.admin.database.v1.UpdateBackupRequest.backup", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\002", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="update_mask", - full_name="google.spanner.admin.database.v1.UpdateBackupRequest.update_mask", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\002", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1158, - serialized_end=1296, + name='UpdateBackupRequest', + full_name='google.spanner.admin.database.v1.UpdateBackupRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='backup', full_name='google.spanner.admin.database.v1.UpdateBackupRequest.backup', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='update_mask', full_name='google.spanner.admin.database.v1.UpdateBackupRequest.update_mask', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1158, + serialized_end=1296, ) _GETBACKUPREQUEST = _descriptor.Descriptor( - name="GetBackupRequest", - full_name="google.spanner.admin.database.v1.GetBackupRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="name", - full_name="google.spanner.admin.database.v1.GetBackupRequest.name", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ) - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1298, - serialized_end=1369, + name='GetBackupRequest', + full_name='google.spanner.admin.database.v1.GetBackupRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='name', full_name='google.spanner.admin.database.v1.GetBackupRequest.name', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1298, + serialized_end=1369, ) _DELETEBACKUPREQUEST = _descriptor.Descriptor( - name="DeleteBackupRequest", - full_name="google.spanner.admin.database.v1.DeleteBackupRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="name", - full_name="google.spanner.admin.database.v1.DeleteBackupRequest.name", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ) - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1371, - serialized_end=1445, + name='DeleteBackupRequest', + full_name='google.spanner.admin.database.v1.DeleteBackupRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='name', full_name='google.spanner.admin.database.v1.DeleteBackupRequest.name', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1371, + serialized_end=1445, ) _LISTBACKUPSREQUEST = _descriptor.Descriptor( - name="ListBackupsRequest", - full_name="google.spanner.admin.database.v1.ListBackupsRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="parent", - full_name="google.spanner.admin.database.v1.ListBackupsRequest.parent", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="filter", - full_name="google.spanner.admin.database.v1.ListBackupsRequest.filter", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="page_size", - full_name="google.spanner.admin.database.v1.ListBackupsRequest.page_size", - index=2, - number=3, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="page_token", - full_name="google.spanner.admin.database.v1.ListBackupsRequest.page_token", - index=3, - number=4, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1448, - serialized_end=1580, + name='ListBackupsRequest', + full_name='google.spanner.admin.database.v1.ListBackupsRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='parent', full_name='google.spanner.admin.database.v1.ListBackupsRequest.parent', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='filter', full_name='google.spanner.admin.database.v1.ListBackupsRequest.filter', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='page_size', full_name='google.spanner.admin.database.v1.ListBackupsRequest.page_size', index=2, + number=3, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='page_token', full_name='google.spanner.admin.database.v1.ListBackupsRequest.page_token', index=3, + number=4, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1448, + serialized_end=1580, ) _LISTBACKUPSRESPONSE = _descriptor.Descriptor( - name="ListBackupsResponse", - full_name="google.spanner.admin.database.v1.ListBackupsResponse", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="backups", - full_name="google.spanner.admin.database.v1.ListBackupsResponse.backups", - index=0, - number=1, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="next_page_token", - full_name="google.spanner.admin.database.v1.ListBackupsResponse.next_page_token", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1582, - serialized_end=1687, + name='ListBackupsResponse', + full_name='google.spanner.admin.database.v1.ListBackupsResponse', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='backups', full_name='google.spanner.admin.database.v1.ListBackupsResponse.backups', index=0, + number=1, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='next_page_token', full_name='google.spanner.admin.database.v1.ListBackupsResponse.next_page_token', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1582, + serialized_end=1687, ) _LISTBACKUPOPERATIONSREQUEST = _descriptor.Descriptor( - name="ListBackupOperationsRequest", - full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="parent", - full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.parent", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="filter", - full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.filter", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="page_size", - full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.page_size", - index=2, - number=3, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="page_token", - full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.page_token", - index=3, - number=4, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1690, - serialized_end=1831, + name='ListBackupOperationsRequest', + full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='parent', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.parent', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='filter', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.filter', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='page_size', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.page_size', index=2, + number=3, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='page_token', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.page_token', index=3, + number=4, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1690, + serialized_end=1831, ) _LISTBACKUPOPERATIONSRESPONSE = _descriptor.Descriptor( - name="ListBackupOperationsResponse", - full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="operations", - full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse.operations", - index=0, - number=1, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="next_page_token", - full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse.next_page_token", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1833, - serialized_end=1939, + name='ListBackupOperationsResponse', + full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='operations', full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse.operations', index=0, + number=1, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='next_page_token', full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse.next_page_token', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1833, + serialized_end=1939, ) _BACKUPINFO = _descriptor.Descriptor( - name="BackupInfo", - full_name="google.spanner.admin.database.v1.BackupInfo", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="backup", - full_name="google.spanner.admin.database.v1.BackupInfo.backup", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="create_time", - full_name="google.spanner.admin.database.v1.BackupInfo.create_time", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="source_database", - full_name="google.spanner.admin.database.v1.BackupInfo.source_database", - index=2, - number=3, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=1941, - serialized_end=2043, + name='BackupInfo', + full_name='google.spanner.admin.database.v1.BackupInfo', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='backup', full_name='google.spanner.admin.database.v1.BackupInfo.backup', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='create_time', full_name='google.spanner.admin.database.v1.BackupInfo.create_time', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='source_database', full_name='google.spanner.admin.database.v1.BackupInfo.source_database', index=2, + number=3, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=1941, + serialized_end=2043, ) -_BACKUP.fields_by_name[ - "expire_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_BACKUP.fields_by_name[ - "create_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_BACKUP.fields_by_name["state"].enum_type = _BACKUP_STATE +_BACKUP.fields_by_name['expire_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_BACKUP.fields_by_name['create_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_BACKUP.fields_by_name['state'].enum_type = _BACKUP_STATE _BACKUP_STATE.containing_type = _BACKUP -_CREATEBACKUPREQUEST.fields_by_name["backup"].message_type = _BACKUP -_CREATEBACKUPMETADATA.fields_by_name[ - "progress" -].message_type = ( - google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS -) -_CREATEBACKUPMETADATA.fields_by_name[ - "cancel_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_UPDATEBACKUPREQUEST.fields_by_name["backup"].message_type = _BACKUP -_UPDATEBACKUPREQUEST.fields_by_name[ - "update_mask" -].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK -_LISTBACKUPSRESPONSE.fields_by_name["backups"].message_type = _BACKUP -_LISTBACKUPOPERATIONSRESPONSE.fields_by_name[ - "operations" -].message_type = google_dot_longrunning_dot_operations__pb2._OPERATION -_BACKUPINFO.fields_by_name[ - "create_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -DESCRIPTOR.message_types_by_name["Backup"] = _BACKUP -DESCRIPTOR.message_types_by_name["CreateBackupRequest"] = _CREATEBACKUPREQUEST -DESCRIPTOR.message_types_by_name["CreateBackupMetadata"] = _CREATEBACKUPMETADATA -DESCRIPTOR.message_types_by_name["UpdateBackupRequest"] = _UPDATEBACKUPREQUEST -DESCRIPTOR.message_types_by_name["GetBackupRequest"] = _GETBACKUPREQUEST -DESCRIPTOR.message_types_by_name["DeleteBackupRequest"] = _DELETEBACKUPREQUEST -DESCRIPTOR.message_types_by_name["ListBackupsRequest"] = _LISTBACKUPSREQUEST -DESCRIPTOR.message_types_by_name["ListBackupsResponse"] = _LISTBACKUPSRESPONSE -DESCRIPTOR.message_types_by_name[ - "ListBackupOperationsRequest" -] = _LISTBACKUPOPERATIONSREQUEST -DESCRIPTOR.message_types_by_name[ - "ListBackupOperationsResponse" -] = _LISTBACKUPOPERATIONSRESPONSE -DESCRIPTOR.message_types_by_name["BackupInfo"] = _BACKUPINFO +_CREATEBACKUPREQUEST.fields_by_name['backup'].message_type = _BACKUP +_CREATEBACKUPMETADATA.fields_by_name['progress'].message_type = google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS +_CREATEBACKUPMETADATA.fields_by_name['cancel_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_UPDATEBACKUPREQUEST.fields_by_name['backup'].message_type = _BACKUP +_UPDATEBACKUPREQUEST.fields_by_name['update_mask'].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LISTBACKUPSRESPONSE.fields_by_name['backups'].message_type = _BACKUP +_LISTBACKUPOPERATIONSRESPONSE.fields_by_name['operations'].message_type = google_dot_longrunning_dot_operations__pb2._OPERATION +_BACKUPINFO.fields_by_name['create_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +DESCRIPTOR.message_types_by_name['Backup'] = _BACKUP +DESCRIPTOR.message_types_by_name['CreateBackupRequest'] = _CREATEBACKUPREQUEST +DESCRIPTOR.message_types_by_name['CreateBackupMetadata'] = _CREATEBACKUPMETADATA +DESCRIPTOR.message_types_by_name['UpdateBackupRequest'] = _UPDATEBACKUPREQUEST +DESCRIPTOR.message_types_by_name['GetBackupRequest'] = _GETBACKUPREQUEST +DESCRIPTOR.message_types_by_name['DeleteBackupRequest'] = _DELETEBACKUPREQUEST +DESCRIPTOR.message_types_by_name['ListBackupsRequest'] = _LISTBACKUPSREQUEST +DESCRIPTOR.message_types_by_name['ListBackupsResponse'] = _LISTBACKUPSRESPONSE +DESCRIPTOR.message_types_by_name['ListBackupOperationsRequest'] = _LISTBACKUPOPERATIONSREQUEST +DESCRIPTOR.message_types_by_name['ListBackupOperationsResponse'] = _LISTBACKUPOPERATIONSRESPONSE +DESCRIPTOR.message_types_by_name['BackupInfo'] = _BACKUPINFO _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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. +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. Attributes: database: @@ -1052,18 +647,15 @@ being deleted. When a restored database from the backup enters the ``READY`` state, the reference to the backup is removed. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.Backup) - }, -) + # @@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 [CreateBackup][google.spanner.admin.database.v1.Databa +CreateBackupRequest = _reflection.GeneratedProtocolMessageType('CreateBackupRequest', (_message.Message,), { + 'DESCRIPTOR' : _CREATEBACKUPREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [CreateBackup][google.spanner.admin.database.v1.Databa seAdmin.CreateBackup]. Attributes: @@ -1082,18 +674,15 @@ backup: Required. The backup to create. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupRequest) - }, -) + # @@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 [CreateBackup][google.span +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 [CreateBackup][google.span ner.admin.database.v1.DatabaseAdmin.CreateBackup]. Attributes: @@ -1119,18 +708,15 @@ [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to ``Code.CANCELLED``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupMetadata) - }, -) + # @@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 [UpdateBackup][google.spanner.admin.database.v1.Databa +UpdateBackupRequest = _reflection.GeneratedProtocolMessageType('UpdateBackupRequest', (_message.Message,), { + 'DESCRIPTOR' : _UPDATEBACKUPREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [UpdateBackup][google.spanner.admin.database.v1.Databa seAdmin.UpdateBackup]. Attributes: @@ -1147,18 +733,15 @@ prevents any future fields from being erased accidentally by clients that do not know about them. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateBackupRequest) - }, -) + # @@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 +GetBackupRequest = _reflection.GeneratedProtocolMessageType('GetBackupRequest', (_message.Message,), { + 'DESCRIPTOR' : _GETBACKUPREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup]. Attributes: @@ -1166,18 +749,15 @@ Required. Name of the backup. Values are of the form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetBackupRequest) - }, -) + # @@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 [DeleteBackup][google.spanner.admin.database.v1.Databa +DeleteBackupRequest = _reflection.GeneratedProtocolMessageType('DeleteBackupRequest', (_message.Message,), { + 'DESCRIPTOR' : _DELETEBACKUPREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [DeleteBackup][google.spanner.admin.database.v1.Databa seAdmin.DeleteBackup]. Attributes: @@ -1185,18 +765,15 @@ Required. Name of the backup to delete. Values are of the form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DeleteBackupRequest) - }, -) + # @@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 [ListBackups][google.spanner.admin.database.v1.Databas +ListBackupsRequest = _reflection.GeneratedProtocolMessageType('ListBackupsRequest', (_message.Message,), { + 'DESCRIPTOR' : _LISTBACKUPSREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [ListBackups][google.spanner.admin.database.v1.Databas eAdmin.ListBackups]. Attributes: @@ -1241,18 +818,15 @@ .admin.database.v1.ListBackupsResponse] to the same ``parent`` and with the same ``filter``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsRequest) - }, -) + # @@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 [ListBackups][google.spanner.admin.database.v1.Databa +ListBackupsResponse = _reflection.GeneratedProtocolMessageType('ListBackupsResponse', (_message.Message,), { + 'DESCRIPTOR' : _LISTBACKUPSRESPONSE, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The response for [ListBackups][google.spanner.admin.database.v1.Databa seAdmin.ListBackups]. Attributes: @@ -1265,18 +839,15 @@ ][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups] call to fetch more of the matching backups. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsResponse) - }, -) + # @@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 [ListBackupOperations][google.spanner.admin.database.v +ListBackupOperationsRequest = _reflection.GeneratedProtocolMessageType('ListBackupOperationsRequest', (_message.Message,), { + 'DESCRIPTOR' : _LISTBACKUPOPERATIONSREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """The request for [ListBackupOperations][google.spanner.admin.database.v 1.DatabaseAdmin.ListBackupOperations]. Attributes: @@ -1328,18 +899,15 @@ 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) - }, -) + # @@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 [ListBackupOperations][google.spanner.admin.database. +ListBackupOperationsResponse = _reflection.GeneratedProtocolMessageType('ListBackupOperationsResponse', (_message.Message,), { + '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: @@ -1359,18 +927,15 @@ perations][google.spanner.admin.database.v1.DatabaseAdmin.List BackupOperations] call to fetch more of the matching metadata. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsResponse) - }, -) + # @@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. +BackupInfo = _reflection.GeneratedProtocolMessageType('BackupInfo', (_message.Message,), { + 'DESCRIPTOR' : _BACKUPINFO, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.backup_pb2' + , + '__doc__': """Information about a backup. Attributes: backup: @@ -1382,26 +947,25 @@ source_database: Name of the database the backup was created from. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) + }) _sym_db.RegisterMessage(BackupInfo) DESCRIPTOR._options = None -_BACKUP.fields_by_name["database"]._options = None -_BACKUP.fields_by_name["create_time"]._options = None -_BACKUP.fields_by_name["size_bytes"]._options = None -_BACKUP.fields_by_name["state"]._options = None -_BACKUP.fields_by_name["referencing_databases"]._options = None +_BACKUP.fields_by_name['database']._options = None +_BACKUP.fields_by_name['create_time']._options = None +_BACKUP.fields_by_name['size_bytes']._options = None +_BACKUP.fields_by_name['state']._options = None +_BACKUP.fields_by_name['referencing_databases']._options = None _BACKUP._options = None -_CREATEBACKUPREQUEST.fields_by_name["parent"]._options = None -_CREATEBACKUPREQUEST.fields_by_name["backup_id"]._options = None -_CREATEBACKUPREQUEST.fields_by_name["backup"]._options = None -_UPDATEBACKUPREQUEST.fields_by_name["backup"]._options = None -_UPDATEBACKUPREQUEST.fields_by_name["update_mask"]._options = None -_GETBACKUPREQUEST.fields_by_name["name"]._options = None -_DELETEBACKUPREQUEST.fields_by_name["name"]._options = None -_LISTBACKUPSREQUEST.fields_by_name["parent"]._options = None -_LISTBACKUPOPERATIONSREQUEST.fields_by_name["parent"]._options = None +_CREATEBACKUPREQUEST.fields_by_name['parent']._options = None +_CREATEBACKUPREQUEST.fields_by_name['backup_id']._options = None +_CREATEBACKUPREQUEST.fields_by_name['backup']._options = None +_UPDATEBACKUPREQUEST.fields_by_name['backup']._options = None +_UPDATEBACKUPREQUEST.fields_by_name['update_mask']._options = None +_GETBACKUPREQUEST.fields_by_name['name']._options = None +_DELETEBACKUPREQUEST.fields_by_name['name']._options = None +_LISTBACKUPSREQUEST.fields_by_name['parent']._options = None +_LISTBACKUPOPERATIONSREQUEST.fields_by_name['parent']._options = None # @@protoc_insertion_point(module_scope) diff --git a/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py b/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + 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 b4e89476eb..1e3d6b0ff4 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py @@ -6,7 +6,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -18,114 +17,73 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1", - create_key=_descriptor._internal_create_key, - 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\xff\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\\V1\xea\x02+Google::Cloud::Spanner::Admin::Database::V1b\x06proto3', - dependencies=[ - google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, - google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1', + create_key=_descriptor._internal_create_key, + 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\xff\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\\V1\xea\x02+Google::Cloud::Spanner::Admin::Database::V1b\x06proto3' + , + dependencies=[google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) + + _OPERATIONPROGRESS = _descriptor.Descriptor( - name="OperationProgress", - full_name="google.spanner.admin.database.v1.OperationProgress", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="progress_percent", - full_name="google.spanner.admin.database.v1.OperationProgress.progress_percent", - index=0, - number=1, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="start_time", - full_name="google.spanner.admin.database.v1.OperationProgress.start_time", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="end_time", - full_name="google.spanner.admin.database.v1.OperationProgress.end_time", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=192, - serialized_end=331, + name='OperationProgress', + full_name='google.spanner.admin.database.v1.OperationProgress', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='progress_percent', full_name='google.spanner.admin.database.v1.OperationProgress.progress_percent', index=0, + number=1, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='start_time', full_name='google.spanner.admin.database.v1.OperationProgress.start_time', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='end_time', full_name='google.spanner.admin.database.v1.OperationProgress.end_time', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=192, + serialized_end=331, ) -_OPERATIONPROGRESS.fields_by_name[ - "start_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_OPERATIONPROGRESS.fields_by_name[ - "end_time" -].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -DESCRIPTOR.message_types_by_name["OperationProgress"] = _OPERATIONPROGRESS +_OPERATIONPROGRESS.fields_by_name['start_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_OPERATIONPROGRESS.fields_by_name['end_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +DESCRIPTOR.message_types_by_name['OperationProgress'] = _OPERATIONPROGRESS _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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 +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 running operation. Attributes: @@ -138,9 +96,8 @@ If set, the time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OperationProgress) - }, -) + # @@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/common_pb2_grpc.py b/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + 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 fa8d83ede0..60fd5db2f1 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 @@ -7,7 +7,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -19,69 +18,45 @@ from google.api import resource_pb2 as google_dot_api_dot_resource__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 -from google.longrunning import ( - operations_pb2 as google_dot_longrunning_dot_operations__pb2, -) +from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 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, -) -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, -) +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 +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 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}", - create_key=_descriptor._internal_create_key, - 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\xda\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\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, - google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, - google_dot_api_dot_resource__pb2.DESCRIPTOR, - google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR, - google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR, - 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, - ], -) + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1\352AJ\n\037spanner.googleapis.com/Instance\022\'projects/{project}/instances/{instance}', + create_key=_descriptor._internal_create_key, + 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\xda\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\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,google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,google_dot_api_dot_resource__pb2.DESCRIPTOR,google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,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,]) _RESTORESOURCETYPE = _descriptor.EnumDescriptor( - name="RestoreSourceType", - full_name="google.spanner.admin.database.v1.RestoreSourceType", - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name="TYPE_UNSPECIFIED", - index=0, - number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="BACKUP", - index=1, - number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - ], - containing_type=None, - serialized_options=None, - serialized_start=3044, - serialized_end=3097, + name='RestoreSourceType', + full_name='google.spanner.admin.database.v1.RestoreSourceType', + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name='TYPE_UNSPECIFIED', index=0, number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='BACKUP', index=1, number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + ], + containing_type=None, + serialized_options=None, + serialized_start=3044, + serialized_end=3097, ) _sym_db.RegisterEnumDescriptor(_RESTORESOURCETYPE) @@ -91,1342 +66,823 @@ _DATABASE_STATE = _descriptor.EnumDescriptor( - name="State", - full_name="google.spanner.admin.database.v1.Database.State", - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name="STATE_UNSPECIFIED", - index=0, - number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="CREATING", - index=1, - number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="READY", - index=2, - number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="READY_OPTIMIZING", - index=3, - number=3, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - ], - containing_type=None, - serialized_options=None, - serialized_start=907, - serialized_end=984, + name='State', + full_name='google.spanner.admin.database.v1.Database.State', + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name='STATE_UNSPECIFIED', index=0, number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='CREATING', index=1, number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='READY', index=2, number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='READY_OPTIMIZING', index=3, number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + ], + containing_type=None, + serialized_options=None, + serialized_start=907, + serialized_end=984, ) _sym_db.RegisterEnumDescriptor(_DATABASE_STATE) _RESTOREINFO = _descriptor.Descriptor( - name="RestoreInfo", - full_name="google.spanner.admin.database.v1.RestoreInfo", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="source_type", - full_name="google.spanner.admin.database.v1.RestoreInfo.source_type", - index=0, - number=1, - type=14, - cpp_type=8, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="backup_info", - full_name="google.spanner.admin.database.v1.RestoreInfo.backup_info", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name="source_info", - full_name="google.spanner.admin.database.v1.RestoreInfo.source_info", - index=0, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[], - ) - ], - serialized_start=504, - serialized_end=675, + name='RestoreInfo', + full_name='google.spanner.admin.database.v1.RestoreInfo', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='source_type', full_name='google.spanner.admin.database.v1.RestoreInfo.source_type', index=0, + number=1, type=14, cpp_type=8, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='backup_info', full_name='google.spanner.admin.database.v1.RestoreInfo.backup_info', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name='source_info', full_name='google.spanner.admin.database.v1.RestoreInfo.source_info', + index=0, containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[]), + ], + serialized_start=504, + serialized_end=675, ) _DATABASE = _descriptor.Descriptor( - name="Database", - full_name="google.spanner.admin.database.v1.Database", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="name", - full_name="google.spanner.admin.database.v1.Database.name", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - 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", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="state", - full_name="google.spanner.admin.database.v1.Database.state", - index=1, - number=2, - type=14, - cpp_type=8, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="create_time", - full_name="google.spanner.admin.database.v1.Database.create_time", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="restore_info", - full_name="google.spanner.admin.database.v1.Database.restore_info", - index=3, - number=4, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=b"\340A\003", - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[_DATABASE_STATE], - serialized_options=b"\352A_\n\037spanner.googleapis.com/Database\022/instances//databases/< database>``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseRequest) - }, -) + # @@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 but not +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 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 @@ -1640,18 +1075,15 @@ .spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns ``ALREADY_EXISTS``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlRequest) - }, -) + # @@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 [UpdateDatabaseDdl][google +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 [UpdateDatabaseDdl][google .spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]. Attributes: @@ -1665,54 +1097,45 @@ succeeded so far, where ``commit_timestamps[i]`` is the commit timestamp for the statement ``statements[i]``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata) - }, -) + # @@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 [DropDatabase][google.spanner.admin.database.v1.Databa +DropDatabaseRequest = _reflection.GeneratedProtocolMessageType('DropDatabaseRequest', (_message.Message,), { + 'DESCRIPTOR' : _DROPDATABASEREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2' + , + '__doc__': """The request for [DropDatabase][google.spanner.admin.database.v1.Databa seAdmin.DropDatabase]. Attributes: database: Required. The database to be dropped. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DropDatabaseRequest) - }, -) + # @@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 [GetDatabaseDdl][google.spanner.admin.database.v1.Data +GetDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType('GetDatabaseDdlRequest', (_message.Message,), { + 'DESCRIPTOR' : _GETDATABASEDDLREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2' + , + '__doc__': """The request for [GetDatabaseDdl][google.spanner.admin.database.v1.Data baseAdmin.GetDatabaseDdl]. Attributes: database: Required. The database whose schema we wish to get. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlRequest) - }, -) + # @@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 [GetDatabaseDdl][google.spanner.admin.database.v1.Dat +GetDatabaseDdlResponse = _reflection.GeneratedProtocolMessageType('GetDatabaseDdlResponse', (_message.Message,), { + 'DESCRIPTOR' : _GETDATABASEDDLRESPONSE, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2' + , + '__doc__': """The response for [GetDatabaseDdl][google.spanner.admin.database.v1.Dat abaseAdmin.GetDatabaseDdl]. Attributes: @@ -1720,18 +1143,15 @@ A list of formatted DDL statements defining the schema of the database specified in the request. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlResponse) - }, -) + # @@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 [ListDatabaseOperations][google.spanner.admin.database +ListDatabaseOperationsRequest = _reflection.GeneratedProtocolMessageType('ListDatabaseOperationsRequest', (_message.Message,), { + '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]. Attributes: @@ -1787,18 +1207,15 @@ sResponse] to the same ``parent`` and with the same ``filter``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsRequest) - }, -) + # @@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 [ListDatabaseOperations][google.spanner.admin.databas +ListDatabaseOperationsResponse = _reflection.GeneratedProtocolMessageType('ListDatabaseOperationsResponse', (_message.Message,), { + 'DESCRIPTOR' : _LISTDATABASEOPERATIONSRESPONSE, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2' + , + '__doc__': """The response for [ListDatabaseOperations][google.spanner.admin.databas e.v1.DatabaseAdmin.ListDatabaseOperations]. Attributes: @@ -1814,18 +1231,15 @@ stDatabaseOperations] call to fetch more of the matching metadata. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsResponse) - }, -) + # @@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 [RestoreDatabase][google.spanner.admin.database.v1.Dat +RestoreDatabaseRequest = _reflection.GeneratedProtocolMessageType('RestoreDatabaseRequest', (_message.Message,), { + 'DESCRIPTOR' : _RESTOREDATABASEREQUEST, + '__module__' : 'google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2' + , + '__doc__': """The request for [RestoreDatabase][google.spanner.admin.database.v1.Dat abaseAdmin.RestoreDatabase]. Attributes: @@ -1848,18 +1262,15 @@ form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseRequest) - }, -) + # @@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 [RestoreDatab +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 [RestoreDatab ase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. Attributes: @@ -1905,18 +1316,15 @@ completes successfully. This operation will not be created if the restore was not successful. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseMetadata) - }, -) + # @@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 the +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 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 @@ -1928,218 +1336,216 @@ progress: The progress of the post-restore optimizations. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) + }) _sym_db.RegisterMessage(OptimizeRestoredDatabaseMetadata) DESCRIPTOR._options = None -_DATABASE.fields_by_name["name"]._options = None -_DATABASE.fields_by_name["state"]._options = None -_DATABASE.fields_by_name["create_time"]._options = None -_DATABASE.fields_by_name["restore_info"]._options = None +_DATABASE.fields_by_name['name']._options = None +_DATABASE.fields_by_name['state']._options = None +_DATABASE.fields_by_name['create_time']._options = None +_DATABASE.fields_by_name['restore_info']._options = None _DATABASE._options = None -_LISTDATABASESREQUEST.fields_by_name["parent"]._options = None -_CREATEDATABASEREQUEST.fields_by_name["parent"]._options = None -_CREATEDATABASEREQUEST.fields_by_name["create_statement"]._options = None -_CREATEDATABASEREQUEST.fields_by_name["extra_statements"]._options = None -_CREATEDATABASEMETADATA.fields_by_name["database"]._options = None -_GETDATABASEREQUEST.fields_by_name["name"]._options = None -_UPDATEDATABASEDDLREQUEST.fields_by_name["database"]._options = None -_UPDATEDATABASEDDLREQUEST.fields_by_name["statements"]._options = None -_UPDATEDATABASEDDLMETADATA.fields_by_name["database"]._options = None -_DROPDATABASEREQUEST.fields_by_name["database"]._options = None -_GETDATABASEDDLREQUEST.fields_by_name["database"]._options = None -_LISTDATABASEOPERATIONSREQUEST.fields_by_name["parent"]._options = None -_RESTOREDATABASEREQUEST.fields_by_name["parent"]._options = None -_RESTOREDATABASEREQUEST.fields_by_name["database_id"]._options = None -_RESTOREDATABASEREQUEST.fields_by_name["backup"]._options = None +_LISTDATABASESREQUEST.fields_by_name['parent']._options = None +_CREATEDATABASEREQUEST.fields_by_name['parent']._options = None +_CREATEDATABASEREQUEST.fields_by_name['create_statement']._options = None +_CREATEDATABASEREQUEST.fields_by_name['extra_statements']._options = None +_CREATEDATABASEMETADATA.fields_by_name['database']._options = None +_GETDATABASEREQUEST.fields_by_name['name']._options = None +_UPDATEDATABASEDDLREQUEST.fields_by_name['database']._options = None +_UPDATEDATABASEDDLREQUEST.fields_by_name['statements']._options = None +_UPDATEDATABASEDDLMETADATA.fields_by_name['database']._options = None +_DROPDATABASEREQUEST.fields_by_name['database']._options = None +_GETDATABASEDDLREQUEST.fields_by_name['database']._options = None +_LISTDATABASEOPERATIONSREQUEST.fields_by_name['parent']._options = None +_RESTOREDATABASEREQUEST.fields_by_name['parent']._options = None +_RESTOREDATABASEREQUEST.fields_by_name['database_id']._options = None +_RESTOREDATABASEREQUEST.fields_by_name['backup']._options = None _DATABASEADMIN = _descriptor.ServiceDescriptor( - name="DatabaseAdmin", - full_name="google.spanner.admin.database.v1.DatabaseAdmin", - file=DESCRIPTOR, + name='DatabaseAdmin', + 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', + create_key=_descriptor._internal_create_key, + serialized_start=3100, + serialized_end=7087, + methods=[ + _descriptor.MethodDescriptor( + name='ListDatabases', + full_name='google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases', index=0, - serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", + 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', create_key=_descriptor._internal_create_key, - serialized_start=3100, - serialized_end=7087, - methods=[ - _descriptor.MethodDescriptor( - name="ListDatabases", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases", - index=0, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="CreateDatabase", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase", - index=1, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="GetDatabase", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase", - index=2, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="UpdateDatabaseDdl", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl", - index=3, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="DropDatabase", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase", - index=4, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="GetDatabaseDdl", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl", - index=5, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="SetIamPolicy", - full_name="google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy", - index=6, - 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/*}:getIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA\"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA\"`__ for more details. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ReplicaInfo) - }, -) + # @@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. Configurations +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. Configurations define the geographic placement of nodes and their replication. Attributes: @@ -1383,27 +853,22 @@ The geographic placement of nodes in this instance configuration and their replication properties. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) + }) _sym_db.RegisterMessage(InstanceConfig) -Instance = _reflection.GeneratedProtocolMessageType( - "Instance", - (_message.Message,), - { - "LabelsEntry": _reflection.GeneratedProtocolMessageType( - "LabelsEntry", - (_message.Message,), - { - "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 databases can be +Instance = _reflection.GeneratedProtocolMessageType('Instance', (_message.Message,), { + + 'LabelsEntry' : _reflection.GeneratedProtocolMessageType('LabelsEntry', (_message.Message,), { + '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 databases can be hosted. Attributes: @@ -1462,19 +927,16 @@ endpoint_uris: Deprecated. This field is not populated. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) + }) _sym_db.RegisterMessage(Instance) _sym_db.RegisterMessage(Instance.LabelsEntry) -ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType( - "ListInstanceConfigsRequest", - (_message.Message,), - { - "DESCRIPTOR": _LISTINSTANCECONFIGSREQUEST, - "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", - "__doc__": """The request for [ListInstanceConfigs][google.spanner.admin.instance.v1 +ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType('ListInstanceConfigsRequest', (_message.Message,), { + '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]. Attributes: @@ -1493,18 +955,15 @@ ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse ]. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsRequest) - }, -) + # @@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 [ListInstanceConfigs][google.spanner.admin.instance.v +ListInstanceConfigsResponse = _reflection.GeneratedProtocolMessageType('ListInstanceConfigsResponse', (_message.Message,), { + 'DESCRIPTOR' : _LISTINSTANCECONFIGSRESPONSE, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The response for [ListInstanceConfigs][google.spanner.admin.instance.v 1.InstanceAdmin.ListInstanceConfigs]. Attributes: @@ -1516,18 +975,15 @@ nstanceConfigs] call to fetch more of the matching instance configurations. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsResponse) - }, -) + # @@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 [GetInstanceConfigRequest][google.spanner.admin.instan +GetInstanceConfigRequest = _reflection.GeneratedProtocolMessageType('GetInstanceConfigRequest', (_message.Message,), { + 'DESCRIPTOR' : _GETINSTANCECONFIGREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [GetInstanceConfigRequest][google.spanner.admin.instan ce.v1.InstanceAdmin.GetInstanceConfig]. Attributes: @@ -1536,18 +992,15 @@ Values are of the form ``projects//instanceConfigs/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceConfigRequest) - }, -) + # @@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 [GetInstance][google.spanner.admin.instance.v1.Instanc +GetInstanceRequest = _reflection.GeneratedProtocolMessageType('GetInstanceRequest', (_message.Message,), { + 'DESCRIPTOR' : _GETINSTANCEREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [GetInstance][google.spanner.admin.instance.v1.Instanc eAdmin.GetInstance]. Attributes: @@ -1561,18 +1014,15 @@ [Instance][google.spanner.admin.instance.v1.Instance] fields are returned. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest) - }, -) + # @@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 [CreateInstance][google.spanner.admin.instance.v1.Inst +CreateInstanceRequest = _reflection.GeneratedProtocolMessageType('CreateInstanceRequest', (_message.Message,), { + 'DESCRIPTOR' : _CREATEINSTANCEREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [CreateInstance][google.spanner.admin.instance.v1.Inst anceAdmin.CreateInstance]. Attributes: @@ -1587,18 +1037,15 @@ Required. The instance to create. The name may be omitted, but if specified must be ``/instances/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceRequest) - }, -) + # @@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 [ListInstances][google.spanner.admin.instance.v1.Insta +ListInstancesRequest = _reflection.GeneratedProtocolMessageType('ListInstancesRequest', (_message.Message,), { + 'DESCRIPTOR' : _LISTINSTANCESREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [ListInstances][google.spanner.admin.instance.v1.Insta nceAdmin.ListInstances]. Attributes: @@ -1629,18 +1076,15 @@ 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) - }, -) + # @@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 [ListInstances][google.spanner.admin.instance.v1.Inst +ListInstancesResponse = _reflection.GeneratedProtocolMessageType('ListInstancesResponse', (_message.Message,), { + 'DESCRIPTOR' : _LISTINSTANCESRESPONSE, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The response for [ListInstances][google.spanner.admin.instance.v1.Inst anceAdmin.ListInstances]. Attributes: @@ -1651,18 +1095,15 @@ es][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanc es] call to fetch more of the matching instances. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesResponse) - }, -) + # @@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 [UpdateInstance][google.spanner.admin.instance.v1.Inst +UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType('UpdateInstanceRequest', (_message.Message,), { + 'DESCRIPTOR' : _UPDATEINSTANCEREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [UpdateInstance][google.spanner.admin.instance.v1.Inst anceAdmin.UpdateInstance]. Attributes: @@ -1680,18 +1121,15 @@ being erased accidentally by clients that do not know about them. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest) - }, -) + # @@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 [DeleteInstance][google.spanner.admin.instance.v1.Inst +DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType('DeleteInstanceRequest', (_message.Message,), { + 'DESCRIPTOR' : _DELETEINSTANCEREQUEST, + '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' + , + '__doc__': """The request for [DeleteInstance][google.spanner.admin.instance.v1.Inst anceAdmin.DeleteInstance]. Attributes: @@ -1699,18 +1137,15 @@ Required. The name of the instance to be deleted. Values are of the form ``projects//instances/`` """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.DeleteInstanceRequest) - }, -) + # @@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 [CreateInstance][google.sp +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 [CreateInstance][google.sp anner.admin.instance.v1.InstanceAdmin.CreateInstance]. Attributes: @@ -1727,18 +1162,15 @@ The time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceMetadata) - }, -) + # @@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 [UpdateInstance][google.sp +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 [UpdateInstance][google.sp anner.admin.instance.v1.InstanceAdmin.UpdateInstance]. Attributes: @@ -1755,142 +1187,140 @@ The time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) + }) _sym_db.RegisterMessage(UpdateInstanceMetadata) DESCRIPTOR._options = None _INSTANCECONFIG._options = None _INSTANCE_LABELSENTRY._options = None -_INSTANCE.fields_by_name["config"]._options = None +_INSTANCE.fields_by_name['config']._options = None _INSTANCE._options = None -_LISTINSTANCECONFIGSREQUEST.fields_by_name["parent"]._options = None -_GETINSTANCECONFIGREQUEST.fields_by_name["name"]._options = None -_GETINSTANCEREQUEST.fields_by_name["name"]._options = None -_CREATEINSTANCEREQUEST.fields_by_name["parent"]._options = None -_CREATEINSTANCEREQUEST.fields_by_name["instance_id"]._options = None -_CREATEINSTANCEREQUEST.fields_by_name["instance"]._options = None -_LISTINSTANCESREQUEST.fields_by_name["parent"]._options = None -_UPDATEINSTANCEREQUEST.fields_by_name["instance"]._options = None -_UPDATEINSTANCEREQUEST.fields_by_name["field_mask"]._options = None -_DELETEINSTANCEREQUEST.fields_by_name["name"]._options = None +_LISTINSTANCECONFIGSREQUEST.fields_by_name['parent']._options = None +_GETINSTANCECONFIGREQUEST.fields_by_name['name']._options = None +_GETINSTANCEREQUEST.fields_by_name['name']._options = None +_CREATEINSTANCEREQUEST.fields_by_name['parent']._options = None +_CREATEINSTANCEREQUEST.fields_by_name['instance_id']._options = None +_CREATEINSTANCEREQUEST.fields_by_name['instance']._options = None +_LISTINSTANCESREQUEST.fields_by_name['parent']._options = None +_UPDATEINSTANCEREQUEST.fields_by_name['instance']._options = None +_UPDATEINSTANCEREQUEST.fields_by_name['field_mask']._options = None +_DELETEINSTANCEREQUEST.fields_by_name['name']._options = None _INSTANCEADMIN = _descriptor.ServiceDescriptor( - name="InstanceAdmin", - full_name="google.spanner.admin.instance.v1.InstanceAdmin", - file=DESCRIPTOR, + name='InstanceAdmin', + 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', + create_key=_descriptor._internal_create_key, + serialized_start=2957, + serialized_end=5068, + methods=[ + _descriptor.MethodDescriptor( + name='ListInstanceConfigs', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs', index=0, - serialized_options=b"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", + containing_service=None, + input_type=_LISTINSTANCECONFIGSREQUEST, + output_type=_LISTINSTANCECONFIGSRESPONSE, + serialized_options=b'\202\323\344\223\002)\022\'/v1/{parent=projects/*}/instanceConfigs\332A\006parent', create_key=_descriptor._internal_create_key, - serialized_start=2957, - serialized_end=5068, - methods=[ - _descriptor.MethodDescriptor( - name="ListInstanceConfigs", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs", - index=0, - containing_service=None, - input_type=_LISTINSTANCECONFIGSREQUEST, - output_type=_LISTINSTANCECONFIGSRESPONSE, - serialized_options=b"\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="GetInstanceConfig", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig", - index=1, - containing_service=None, - input_type=_GETINSTANCECONFIGREQUEST, - output_type=_INSTANCECONFIG, - serialized_options=b"\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="ListInstances", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances", - index=2, - containing_service=None, - input_type=_LISTINSTANCESREQUEST, - output_type=_LISTINSTANCESRESPONSE, - serialized_options=b"\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="GetInstance", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance", - index=3, - containing_service=None, - input_type=_GETINSTANCEREQUEST, - output_type=_INSTANCE, - serialized_options=b"\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="CreateInstance", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance", - index=4, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="UpdateInstance", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance", - index=5, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="DeleteInstance", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance", - index=6, - 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", - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="SetIamPolicy", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy", - index=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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="GetIamPolicy", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy", - index=8, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name="TestIamPermissions", - full_name="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions", - index=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', - create_key=_descriptor._internal_create_key, - ), - ], -) + ), + _descriptor.MethodDescriptor( + name='GetInstanceConfig', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig', + index=1, + containing_service=None, + input_type=_GETINSTANCECONFIGREQUEST, + output_type=_INSTANCECONFIG, + serialized_options=b'\202\323\344\223\002)\022\'/v1/{name=projects/*/instanceConfigs/*}\332A\004name', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='ListInstances', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.ListInstances', + index=2, + containing_service=None, + input_type=_LISTINSTANCESREQUEST, + output_type=_LISTINSTANCESRESPONSE, + serialized_options=b'\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='GetInstance', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetInstance', + index=3, + containing_service=None, + input_type=_GETINSTANCEREQUEST, + output_type=_INSTANCE, + serialized_options=b'\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='CreateInstance', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance', + index=4, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='UpdateInstance', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance', + index=5, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='DeleteInstance', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance', + index=6, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='SetIamPolicy', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy', + index=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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='GetIamPolicy', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy', + index=8, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name='TestIamPermissions', + full_name='google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions', + index=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', + create_key=_descriptor._internal_create_key, + ), +]) _sym_db.RegisterServiceDescriptor(_INSTANCEADMIN) -DESCRIPTOR.services_by_name["InstanceAdmin"] = _INSTANCEADMIN +DESCRIPTOR.services_by_name['InstanceAdmin'] = _INSTANCEADMIN # @@protoc_insertion_point(module_scope) 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 29964606bd..3164d8b188 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,14 +2,10 @@ """Client and server classes corresponding to protobuf-defined services.""" 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, -) +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 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 -from google.longrunning import ( - operations_pb2 as google_dot_longrunning_dot_operations__pb2, -) +from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 @@ -44,55 +40,55 @@ def __init__(self, channel): channel: A grpc.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, - ) + '/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, + ) 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, - ) + '/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, + ) 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, - ) + '/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, + ) 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, - ) + '/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, + ) 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, - response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, - ) + '/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, + 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, - response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, - ) + '/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, + 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, - response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, - ) + '/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, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) self.SetIamPolicy = channel.unary_unary( - "/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy", - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - ) + '/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy', + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) self.GetIamPolicy = channel.unary_unary( - "/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy", - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - ) + '/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy', + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) self.TestIamPermissions = channel.unary_unary( - "/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions", - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, - ) + '/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions', + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + ) class InstanceAdminServicer(object): @@ -123,29 +119,29 @@ def ListInstanceConfigs(self, request, context): """Lists the supported instance configurations for a given project. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def GetInstanceConfig(self, request, context): """Gets information about a particular instance configuration. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def ListInstances(self, request, context): """Lists all instances in the given project. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def GetInstance(self, request, context): """Gets information about a particular instance. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def CreateInstance(self, request, context): """Creates an instance and begins preparing it to begin serving. The @@ -184,8 +180,8 @@ def CreateInstance(self, request, context): [Instance][google.spanner.admin.instance.v1.Instance], if successful. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def UpdateInstance(self, request, context): """Updates an instance, and begins allocating or releasing resources @@ -230,8 +226,8 @@ def UpdateInstance(self, request, context): resource [name][google.spanner.admin.instance.v1.Instance.name]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def DeleteInstance(self, request, context): """Deletes an instance. @@ -247,8 +243,8 @@ def DeleteInstance(self, request, context): is permanently deleted. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def SetIamPolicy(self, request, context): """Sets the access control policy on an instance resource. Replaces any @@ -258,8 +254,8 @@ def SetIamPolicy(self, request, context): [resource][google.iam.v1.SetIamPolicyRequest.resource]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def GetIamPolicy(self, request, context): """Gets the access control policy for an instance resource. Returns an empty @@ -269,8 +265,8 @@ def GetIamPolicy(self, request, context): [resource][google.iam.v1.GetIamPolicyRequest.resource]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') def TestIamPermissions(self, request, context): """Returns permissions that the caller has on the specified instance resource. @@ -281,70 +277,69 @@ def TestIamPermissions(self, request, context): empty set of permissions. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details("Method not implemented!") - raise NotImplementedError("Method not implemented!") + context.set_details('Method not implemented!') + raise NotImplementedError('Method not implemented!') 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, - ), - "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, - ), - "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, - ), - "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, - ), - "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, - 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, - 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, - response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, - ), - "SetIamPolicy": grpc.unary_unary_rpc_method_handler( - servicer.SetIamPolicy, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, - ), - "GetIamPolicy": grpc.unary_unary_rpc_method_handler( - servicer.GetIamPolicy, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, - ), - "TestIamPermissions": grpc.unary_unary_rpc_method_handler( - servicer.TestIamPermissions, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString, - ), + '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, + ), + '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, + ), + '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, + ), + '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, + ), + '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, + 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, + 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, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + 'SetIamPolicy': grpc.unary_unary_rpc_method_handler( + servicer.SetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + 'GetIamPolicy': grpc.unary_unary_rpc_method_handler( + servicer.GetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + 'TestIamPermissions': grpc.unary_unary_rpc_method_handler( + servicer.TestIamPermissions, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString, + ), } generic_handler = grpc.method_handlers_generic_handler( - "google.spanner.admin.instance.v1.InstanceAdmin", rpc_method_handlers - ) + 'google.spanner.admin.instance.v1.InstanceAdmin', rpc_method_handlers) server.add_generic_rpc_handlers((generic_handler,)) -# This class is part of an EXPERIMENTAL API. + # This class is part of an EXPERIMENTAL API. class InstanceAdmin(object): """Cloud Spanner Instance Admin API @@ -370,271 +365,161 @@ class InstanceAdmin(object): """ @staticmethod - def ListInstanceConfigs( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def ListInstanceConfigs(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def GetInstanceConfig( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def GetInstanceConfig(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def ListInstances( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def ListInstances(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def GetInstance( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def GetInstance(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def CreateInstance( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def CreateInstance(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, google_dot_longrunning_dot_operations__pb2.Operation.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def UpdateInstance( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def UpdateInstance(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, google_dot_longrunning_dot_operations__pb2.Operation.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def DeleteInstance( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def DeleteInstance(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance', google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, google_dot_protobuf_dot_empty__pb2.Empty.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def SetIamPolicy( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def SetIamPolicy(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy', google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def GetIamPolicy( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def GetIamPolicy(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy', google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) @staticmethod - def TestIamPermissions( - request, - target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None, - ): - return grpc.experimental.unary_unary( - request, + def TestIamPermissions(request, target, - "/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions", + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None): + return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions', google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, - options, - channel_credentials, - call_credentials, - compression, - wait_for_ready, - timeout, - metadata, - ) + options, channel_credentials, + call_credentials, compression, wait_for_ready, timeout, metadata) diff --git a/google/cloud/spanner_v1/gapic/enums.py b/google/cloud/spanner_v1/gapic/enums.py index 3d4a941849..3ba143c433 100644 --- a/google/cloud/spanner_v1/gapic/enums.py +++ b/google/cloud/spanner_v1/gapic/enums.py @@ -29,7 +29,6 @@ class NullValue(enum.IntEnum): Attributes: NULL_VALUE (int): Null value. """ - NULL_VALUE = 0 @@ -74,7 +73,6 @@ class TypeCode(enum.IntEnum): \``+-\ ``.Digits[ExponentIndicator[+-]Digits]`` (ExponentIndicator is \`"e"\` or \`"E"`) """ - TYPE_CODE_UNSPECIFIED = 0 BOOL = 1 INT64 = 2 @@ -100,7 +98,6 @@ class QueryMode(enum.IntEnum): PROFILE (int): This mode returns both the query plan and the execution statistics along with the results. """ - NORMAL = 0 PLAN = 1 PROFILE = 2 @@ -123,7 +120,7 @@ class Kind(enum.IntEnum): arithmetic operators appearing inside predicate expressions or references to column names. """ - KIND_UNSPECIFIED = 0 RELATIONAL = 1 SCALAR = 2 + \ No newline at end of file diff --git a/google/cloud/spanner_v1/gapic/spanner_client.py b/google/cloud/spanner_v1/gapic/spanner_client.py index c0454761a0..bc6c543f56 100644 --- a/google/cloud/spanner_v1/gapic/spanner_client.py +++ b/google/cloud/spanner_v1/gapic/spanner_client.py @@ -45,7 +45,10 @@ from google.protobuf import struct_pb2 -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version + +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution( + 'google-cloud-spanner', +).version class SpannerClient(object): @@ -56,12 +59,13 @@ class SpannerClient(object): transactions on data stored in Cloud Spanner databases. """ - SERVICE_ADDRESS = "spanner.googleapis.com:443" + SERVICE_ADDRESS = 'spanner.googleapis.com:443' """The default address of the service.""" # The name of the interface for this client. This is the key used to # find the method configuration in the client_config dictionary. - _INTERFACE_NAME = "google.spanner.v1.Spanner" + _INTERFACE_NAME = 'google.spanner.v1.Spanner' + @classmethod def from_service_account_file(cls, filename, *args, **kwargs): @@ -77,17 +81,19 @@ def from_service_account_file(cls, filename, *args, **kwargs): Returns: SpannerClient: The constructed client. """ - credentials = service_account.Credentials.from_service_account_file(filename) - kwargs["credentials"] = credentials + credentials = service_account.Credentials.from_service_account_file( + filename) + kwargs['credentials'] = credentials return cls(*args, **kwargs) from_service_account_json = from_service_account_file + @classmethod def database_path(cls, project, instance, database): """Return a fully-qualified database string.""" return google.api_core.path_template.expand( - "projects/{project}/instances/{instance}/databases/{database}", + 'projects/{project}/instances/{instance}/databases/{database}', project=project, instance=instance, database=database, @@ -97,22 +103,15 @@ def database_path(cls, project, instance, database): def session_path(cls, project, instance, database, session): """Return a fully-qualified session string.""" return google.api_core.path_template.expand( - "projects/{project}/instances/{instance}/databases/{database}/sessions/{session}", + 'projects/{project}/instances/{instance}/databases/{database}/sessions/{session}', project=project, instance=instance, database=database, session=session, ) - def __init__( - self, - transport=None, - channel=None, - credentials=None, - client_config=None, - client_info=None, - client_options=None, - ): + def __init__(self, transport=None, channel=None, credentials=None, + client_config=None, client_info=None, client_options=None): """Constructor. Args: @@ -148,27 +147,20 @@ def __init__( """ # Raise deprecation warnings for things we want to go away. if client_config is not None: - warnings.warn( - "The `client_config` argument is deprecated.", - PendingDeprecationWarning, - stacklevel=2, - ) + warnings.warn('The `client_config` argument is deprecated.', + PendingDeprecationWarning, stacklevel=2) else: client_config = spanner_client_config.config if channel: - warnings.warn( - "The `channel` argument is deprecated; use " "`transport` instead.", - PendingDeprecationWarning, - stacklevel=2, - ) + warnings.warn('The `channel` argument is deprecated; use ' + '`transport` instead.', + PendingDeprecationWarning, stacklevel=2) api_endpoint = self.SERVICE_ADDRESS if client_options: if type(client_options) == dict: - client_options = google.api_core.client_options.from_dict( - client_options - ) + client_options = google.api_core.client_options.from_dict(client_options) if client_options.api_endpoint: api_endpoint = client_options.api_endpoint @@ -185,18 +177,20 @@ def __init__( else: if credentials: raise ValueError( - "Received both a transport instance and " - "credentials; these are mutually exclusive." + 'Received both a transport instance and ' + 'credentials; these are mutually exclusive.' ) self.transport = transport else: self.transport = spanner_grpc_transport.SpannerGrpcTransport( - address=api_endpoint, channel=channel, credentials=credentials + address=api_endpoint, + channel=channel, + credentials=credentials, ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION + gapic_version=_GAPIC_LIBRARY_VERSION, ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -207,7 +201,7 @@ def __init__( # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config["interfaces"][self._INTERFACE_NAME] + client_config['interfaces'][self._INTERFACE_NAME], ) # Save a dictionary of cached API call functions. @@ -218,13 +212,12 @@ def __init__( # Service calls def create_session( - self, - database, - session=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + session=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Creates a new session. A session can be used to perform transactions that read and/or modify data in a Cloud Spanner database. Sessions are @@ -279,43 +272,39 @@ def create_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "create_session" not in self._inner_api_calls: - self._inner_api_calls[ - "create_session" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'create_session' not in self._inner_api_calls: + self._inner_api_calls['create_session'] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_session, - default_retry=self._method_configs["CreateSession"].retry, - default_timeout=self._method_configs["CreateSession"].timeout, + default_retry=self._method_configs['CreateSession'].retry, + default_timeout=self._method_configs['CreateSession'].timeout, client_info=self._client_info, ) - request = spanner_pb2.CreateSessionRequest(database=database, session=session) + request = spanner_pb2.CreateSessionRequest( + database=database, + session=session, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["create_session"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['create_session'](request, retry=retry, timeout=timeout, metadata=metadata) def batch_create_sessions( - self, - database, - session_count, - session_template=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + session_count, + session_template=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Creates multiple new sessions. @@ -364,13 +353,11 @@ def batch_create_sessions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "batch_create_sessions" not in self._inner_api_calls: - self._inner_api_calls[ - "batch_create_sessions" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'batch_create_sessions' not in self._inner_api_calls: + self._inner_api_calls['batch_create_sessions'] = google.api_core.gapic_v1.method.wrap_method( self.transport.batch_create_sessions, - default_retry=self._method_configs["BatchCreateSessions"].retry, - default_timeout=self._method_configs["BatchCreateSessions"].timeout, + default_retry=self._method_configs['BatchCreateSessions'].retry, + default_timeout=self._method_configs['BatchCreateSessions'].timeout, client_info=self._client_info, ) @@ -383,26 +370,21 @@ def batch_create_sessions( metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["batch_create_sessions"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['batch_create_sessions'](request, retry=retry, timeout=timeout, metadata=metadata) def get_session( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Gets a session. Returns ``NOT_FOUND`` if the session does not exist. This is mainly useful for determining whether a session is still alive. @@ -438,43 +420,38 @@ def get_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "get_session" not in self._inner_api_calls: - self._inner_api_calls[ - "get_session" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'get_session' not in self._inner_api_calls: + self._inner_api_calls['get_session'] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_session, - default_retry=self._method_configs["GetSession"].retry, - default_timeout=self._method_configs["GetSession"].timeout, + default_retry=self._method_configs['GetSession'].retry, + default_timeout=self._method_configs['GetSession'].timeout, client_info=self._client_info, ) - request = spanner_pb2.GetSessionRequest(name=name) + request = spanner_pb2.GetSessionRequest( + name=name, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("name", name)] + routing_header = [('name', name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["get_session"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['get_session'](request, retry=retry, timeout=timeout, metadata=metadata) def list_sessions( - self, - database, - page_size=None, - filter_=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + database, + page_size=None, + filter_=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Lists all sessions in a given database. @@ -539,54 +516,46 @@ def list_sessions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "list_sessions" not in self._inner_api_calls: - self._inner_api_calls[ - "list_sessions" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'list_sessions' not in self._inner_api_calls: + self._inner_api_calls['list_sessions'] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_sessions, - default_retry=self._method_configs["ListSessions"].retry, - default_timeout=self._method_configs["ListSessions"].timeout, + default_retry=self._method_configs['ListSessions'].retry, + default_timeout=self._method_configs['ListSessions'].timeout, client_info=self._client_info, ) request = spanner_pb2.ListSessionsRequest( - database=database, page_size=page_size, filter=filter_ + database=database, + page_size=page_size, + filter=filter_, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("database", database)] + routing_header = [('database', database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial( - self._inner_api_calls["list_sessions"], - retry=retry, - timeout=timeout, - metadata=metadata, - ), + method=functools.partial(self._inner_api_calls['list_sessions'], retry=retry, timeout=timeout, metadata=metadata), request=request, - items_field="sessions", - request_token_field="page_token", - response_token_field="next_page_token", + items_field='sessions', + request_token_field='page_token', + response_token_field='next_page_token', ) return iterator def delete_session( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Ends a session, releasing server resources associated with it. This will asynchronously trigger cancellation of any operations that are running with @@ -620,50 +589,45 @@ def delete_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "delete_session" not in self._inner_api_calls: - self._inner_api_calls[ - "delete_session" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'delete_session' not in self._inner_api_calls: + self._inner_api_calls['delete_session'] = google.api_core.gapic_v1.method.wrap_method( self.transport.delete_session, - default_retry=self._method_configs["DeleteSession"].retry, - default_timeout=self._method_configs["DeleteSession"].timeout, + default_retry=self._method_configs['DeleteSession'].retry, + default_timeout=self._method_configs['DeleteSession'].timeout, client_info=self._client_info, ) - request = spanner_pb2.DeleteSessionRequest(name=name) + request = spanner_pb2.DeleteSessionRequest( + name=name, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("name", name)] + routing_header = [('name', name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - self._inner_api_calls["delete_session"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + self._inner_api_calls['delete_session'](request, retry=retry, timeout=timeout, metadata=metadata) def execute_sql( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - resume_token=None, - query_mode=None, - partition_token=None, - seqno=None, - query_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + resume_token=None, + query_mode=None, + partition_token=None, + seqno=None, + query_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + 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 @@ -778,13 +742,11 @@ def execute_sql( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "execute_sql" not in self._inner_api_calls: - self._inner_api_calls[ - "execute_sql" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'execute_sql' not in self._inner_api_calls: + self._inner_api_calls['execute_sql'] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_sql, - default_retry=self._method_configs["ExecuteSql"].retry, - default_timeout=self._method_configs["ExecuteSql"].timeout, + default_retry=self._method_configs['ExecuteSql'].retry, + default_timeout=self._method_configs['ExecuteSql'].timeout, client_info=self._client_info, ) @@ -804,35 +766,30 @@ def execute_sql( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["execute_sql"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['execute_sql'](request, retry=retry, timeout=timeout, metadata=metadata) def execute_streaming_sql( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - resume_token=None, - query_mode=None, - partition_token=None, - seqno=None, - query_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + resume_token=None, + query_mode=None, + partition_token=None, + seqno=None, + query_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Like ``ExecuteSql``, except returns the result set as a stream. Unlike ``ExecuteSql``, there is no limit on the size of the returned @@ -942,13 +899,11 @@ def execute_streaming_sql( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "execute_streaming_sql" not in self._inner_api_calls: - self._inner_api_calls[ - "execute_streaming_sql" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'execute_streaming_sql' not in self._inner_api_calls: + self._inner_api_calls['execute_streaming_sql'] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_streaming_sql, - default_retry=self._method_configs["ExecuteStreamingSql"].retry, - default_timeout=self._method_configs["ExecuteStreamingSql"].timeout, + default_retry=self._method_configs['ExecuteStreamingSql'].retry, + default_timeout=self._method_configs['ExecuteStreamingSql'].timeout, client_info=self._client_info, ) @@ -968,29 +923,24 @@ def execute_streaming_sql( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["execute_streaming_sql"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['execute_streaming_sql'](request, retry=retry, timeout=timeout, metadata=metadata) def execute_batch_dml( - self, - session, - transaction, - statements, - seqno, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + transaction, + statements, + seqno, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Executes a batch of SQL DML statements. This method allows many statements to be run with lower latency than submitting them @@ -1070,51 +1020,47 @@ def execute_batch_dml( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "execute_batch_dml" not in self._inner_api_calls: - self._inner_api_calls[ - "execute_batch_dml" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'execute_batch_dml' not in self._inner_api_calls: + self._inner_api_calls['execute_batch_dml'] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_batch_dml, - default_retry=self._method_configs["ExecuteBatchDml"].retry, - default_timeout=self._method_configs["ExecuteBatchDml"].timeout, + default_retry=self._method_configs['ExecuteBatchDml'].retry, + default_timeout=self._method_configs['ExecuteBatchDml'].timeout, client_info=self._client_info, ) request = spanner_pb2.ExecuteBatchDmlRequest( - session=session, transaction=transaction, statements=statements, seqno=seqno + session=session, + transaction=transaction, + statements=statements, + seqno=seqno, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["execute_batch_dml"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['execute_batch_dml'](request, retry=retry, timeout=timeout, metadata=metadata) def read( - self, - session, - table, - columns, - key_set, - transaction=None, - index=None, - limit=None, - resume_token=None, - partition_token=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + table, + columns, + key_set, + transaction=None, + index=None, + limit=None, + resume_token=None, + partition_token=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ``ExecuteSql``. This method cannot @@ -1207,11 +1153,11 @@ def read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "read" not in self._inner_api_calls: - self._inner_api_calls["read"] = google.api_core.gapic_v1.method.wrap_method( + if 'read' not in self._inner_api_calls: + self._inner_api_calls['read'] = google.api_core.gapic_v1.method.wrap_method( self.transport.read, - default_retry=self._method_configs["Read"].retry, - default_timeout=self._method_configs["Read"].timeout, + default_retry=self._method_configs['Read'].retry, + default_timeout=self._method_configs['Read'].timeout, client_info=self._client_info, ) @@ -1230,34 +1176,29 @@ def read( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["read"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['read'](request, retry=retry, timeout=timeout, metadata=metadata) def streaming_read( - self, - session, - table, - columns, - key_set, - transaction=None, - index=None, - limit=None, - resume_token=None, - partition_token=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + table, + columns, + key_set, + transaction=None, + index=None, + limit=None, + resume_token=None, + partition_token=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Like ``Read``, except returns the result set as a stream. Unlike ``Read``, there is no limit on the size of the returned result set. @@ -1344,13 +1285,11 @@ def streaming_read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "streaming_read" not in self._inner_api_calls: - self._inner_api_calls[ - "streaming_read" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'streaming_read' not in self._inner_api_calls: + self._inner_api_calls['streaming_read'] = google.api_core.gapic_v1.method.wrap_method( self.transport.streaming_read, - default_retry=self._method_configs["StreamingRead"].retry, - default_timeout=self._method_configs["StreamingRead"].timeout, + default_retry=self._method_configs['StreamingRead'].retry, + default_timeout=self._method_configs['StreamingRead'].timeout, client_info=self._client_info, ) @@ -1369,27 +1308,22 @@ def streaming_read( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["streaming_read"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['streaming_read'](request, retry=retry, timeout=timeout, metadata=metadata) def begin_transaction( - self, - session, - options_, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + options_, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Begins a new transaction. This step can often be skipped: ``Read``, ``ExecuteSql`` and ``Commit`` can begin a new transaction as a @@ -1433,44 +1367,40 @@ def begin_transaction( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "begin_transaction" not in self._inner_api_calls: - self._inner_api_calls[ - "begin_transaction" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'begin_transaction' not in self._inner_api_calls: + self._inner_api_calls['begin_transaction'] = google.api_core.gapic_v1.method.wrap_method( self.transport.begin_transaction, - default_retry=self._method_configs["BeginTransaction"].retry, - default_timeout=self._method_configs["BeginTransaction"].timeout, + default_retry=self._method_configs['BeginTransaction'].retry, + default_timeout=self._method_configs['BeginTransaction'].timeout, client_info=self._client_info, ) - request = spanner_pb2.BeginTransactionRequest(session=session, options=options_) + request = spanner_pb2.BeginTransactionRequest( + session=session, + options=options_, + ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["begin_transaction"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['begin_transaction'](request, retry=retry, timeout=timeout, metadata=metadata) def commit( - self, - session, - transaction_id=None, - single_use_transaction=None, - mutations=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + transaction_id=None, + single_use_transaction=None, + mutations=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Commits a transaction. The request includes the mutations to be applied to rows in the database. @@ -1529,20 +1459,19 @@ def commit( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "commit" not in self._inner_api_calls: - self._inner_api_calls[ - "commit" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'commit' not in self._inner_api_calls: + self._inner_api_calls['commit'] = google.api_core.gapic_v1.method.wrap_method( self.transport.commit, - default_retry=self._method_configs["Commit"].retry, - default_timeout=self._method_configs["Commit"].timeout, + default_retry=self._method_configs['Commit'].retry, + default_timeout=self._method_configs['Commit'].timeout, client_info=self._client_info, ) # Sanity check: We have some fields which are mutually exclusive; # raise ValueError if more than one is sent. google.api_core.protobuf_helpers.check_oneof( - transaction_id=transaction_id, single_use_transaction=single_use_transaction + transaction_id=transaction_id, + single_use_transaction=single_use_transaction, ) request = spanner_pb2.CommitRequest( @@ -1555,27 +1484,22 @@ def commit( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["commit"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['commit'](request, retry=retry, timeout=timeout, metadata=metadata) def rollback( - self, - session, - transaction_id, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + transaction_id, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any transaction that includes one or more ``Read`` @@ -1617,48 +1541,42 @@ def rollback( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "rollback" not in self._inner_api_calls: - self._inner_api_calls[ - "rollback" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'rollback' not in self._inner_api_calls: + self._inner_api_calls['rollback'] = google.api_core.gapic_v1.method.wrap_method( self.transport.rollback, - default_retry=self._method_configs["Rollback"].retry, - default_timeout=self._method_configs["Rollback"].timeout, + default_retry=self._method_configs['Rollback'].retry, + default_timeout=self._method_configs['Rollback'].timeout, client_info=self._client_info, ) request = spanner_pb2.RollbackRequest( - session=session, transaction_id=transaction_id + session=session, + transaction_id=transaction_id, ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - self._inner_api_calls["rollback"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + self._inner_api_calls['rollback'](request, retry=retry, timeout=timeout, metadata=metadata) def partition_query( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - partition_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + partition_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + 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 @@ -1751,13 +1669,11 @@ def partition_query( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "partition_query" not in self._inner_api_calls: - self._inner_api_calls[ - "partition_query" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'partition_query' not in self._inner_api_calls: + self._inner_api_calls['partition_query'] = google.api_core.gapic_v1.method.wrap_method( self.transport.partition_query, - default_retry=self._method_configs["PartitionQuery"].retry, - default_timeout=self._method_configs["PartitionQuery"].timeout, + default_retry=self._method_configs['PartitionQuery'].retry, + default_timeout=self._method_configs['PartitionQuery'].timeout, client_info=self._client_info, ) @@ -1773,32 +1689,27 @@ def partition_query( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["partition_query"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['partition_query'](request, retry=retry, timeout=timeout, metadata=metadata) def partition_read( - self, - session, - table, - key_set, - transaction=None, - index=None, - columns=None, - partition_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None, - ): + self, + session, + table, + key_set, + transaction=None, + index=None, + columns=None, + partition_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None): """ Creates a set of partition tokens that can be used to execute a read operation in parallel. Each of the returned partition tokens can be used @@ -1876,13 +1787,11 @@ def partition_read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if "partition_read" not in self._inner_api_calls: - self._inner_api_calls[ - "partition_read" - ] = google.api_core.gapic_v1.method.wrap_method( + if 'partition_read' not in self._inner_api_calls: + self._inner_api_calls['partition_read'] = google.api_core.gapic_v1.method.wrap_method( self.transport.partition_read, - default_retry=self._method_configs["PartitionRead"].retry, - default_timeout=self._method_configs["PartitionRead"].timeout, + default_retry=self._method_configs['PartitionRead'].retry, + default_timeout=self._method_configs['PartitionRead'].timeout, client_info=self._client_info, ) @@ -1899,15 +1808,11 @@ def partition_read( metadata = [] metadata = list(metadata) try: - routing_header = [("session", session)] + routing_header = [('session', session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( - routing_header - ) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) metadata.append(routing_metadata) - return self._inner_api_calls["partition_read"]( - request, retry=retry, timeout=timeout, metadata=metadata - ) + return self._inner_api_calls['partition_read'](request, retry=retry, timeout=timeout, metadata=metadata) diff --git a/google/cloud/spanner_v1/gapic/spanner_client_config.py b/google/cloud/spanner_v1/gapic/spanner_client_config.py index 458ea6d731..ca2d1856ba 100644 --- a/google/cloud/spanner_v1/gapic/spanner_client_config.py +++ b/google/cloud/spanner_v1/gapic/spanner_client_config.py @@ -1,137 +1,143 @@ config = { - "interfaces": { - "google.spanner.v1.Spanner": { - "retry_codes": { - "retry_policy_1_codes": ["UNAVAILABLE"], - "no_retry_codes": [], - "retry_policy_3_codes": ["UNAVAILABLE"], - "retry_policy_2_codes": ["UNAVAILABLE"], - "no_retry_1_codes": [], - }, - "retry_params": { - "retry_policy_1_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000, - }, - "retry_policy_3_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000, - }, - "retry_policy_2_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 60000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 60000, - "total_timeout_millis": 60000, - }, - "no_retry_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 0, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 0, - "total_timeout_millis": 0, - }, - "no_retry_1_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000, - }, - }, - "methods": { - "CreateSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "BatchCreateSessions": { - "timeout_millis": 60000, - "retry_codes_name": "retry_policy_2_codes", - "retry_params_name": "retry_policy_2_params", - }, - "GetSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "ListSessions": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "DeleteSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "ExecuteSql": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "ExecuteStreamingSql": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", - }, - "ExecuteBatchDml": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "Read": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "StreamingRead": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params", - }, - "BeginTransaction": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "Commit": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params", - }, - "Rollback": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "PartitionQuery": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - "PartitionRead": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params", - }, - }, + "interfaces": { + "google.spanner.v1.Spanner": { + "retry_codes": { + "retry_policy_1_codes": [ + "UNAVAILABLE" + ], + "no_retry_codes": [], + "retry_policy_3_codes": [ + "UNAVAILABLE" + ], + "retry_policy_2_codes": [ + "UNAVAILABLE" + ], + "no_retry_1_codes": [] + }, + "retry_params": { + "retry_policy_1_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000 + }, + "retry_policy_3_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000 + }, + "retry_policy_2_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 60000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 60000, + "total_timeout_millis": 60000 + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0 + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000 } + }, + "methods": { + "CreateSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "BatchCreateSessions": { + "timeout_millis": 60000, + "retry_codes_name": "retry_policy_2_codes", + "retry_params_name": "retry_policy_2_params" + }, + "GetSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "ListSessions": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "DeleteSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "ExecuteSql": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "ExecuteStreamingSql": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "ExecuteBatchDml": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "Read": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "StreamingRead": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params" + }, + "BeginTransaction": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "Commit": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params" + }, + "Rollback": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "PartitionQuery": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + }, + "PartitionRead": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params" + } + } } + } } 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 7cb2cb2ef2..0c4af899db 100644 --- a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py +++ b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py @@ -24,7 +24,7 @@ _GRPC_KEEPALIVE_MS = 2 * 60 * 1000 -_SPANNER_GRPC_CONFIG = "spanner.grpc.config" +_SPANNER_GRPC_CONFIG = 'spanner.grpc.config' class SpannerGrpcTransport(object): @@ -35,17 +35,15 @@ class SpannerGrpcTransport(object): which can be used to take advantage of advanced features of gRPC. """ - # The scopes needed to make gRPC calls to all of the methods defined # in this service. _OAUTH_SCOPES = ( - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/spanner.data", + 'https://www.googleapis.com/auth/cloud-platform', + 'https://www.googleapis.com/auth/spanner.data', ) - def __init__( - self, channel=None, credentials=None, address="spanner.googleapis.com:443" - ): + def __init__(self, channel=None, credentials=None, + address='spanner.googleapis.com:443'): """Instantiate the transport class. Args: @@ -63,7 +61,8 @@ def __init__( # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - "The `channel` and `credentials` arguments are mutually " "exclusive." + 'The `channel` and `credentials` arguments are mutually ' + 'exclusive.', ) # Create the channel. @@ -72,8 +71,8 @@ def __init__( address=address, credentials=credentials, options={ - "grpc.max_send_message_length": -1, - "grpc.max_receive_message_length": -1, + 'grpc.max_send_message_length': -1, + 'grpc.max_receive_message_length': -1, "grpc.keepalive_time_ms": _GRPC_KEEPALIVE_MS, }.items(), ) @@ -82,12 +81,17 @@ def __init__( # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. - self._stubs = {"spanner_stub": spanner_pb2_grpc.SpannerStub(channel)} + self._stubs = { + 'spanner_stub': spanner_pb2_grpc.SpannerStub(channel), + } + @classmethod def create_channel( - cls, address="spanner.googleapis.com:443", credentials=None, **kwargs - ): + cls, + address='spanner.googleapis.com:443', + credentials=None, + **kwargs): """Create and return a gRPC channel object. Args: @@ -104,14 +108,16 @@ def create_channel( grpc.Channel: A gRPC channel object. """ grpc_gcp_config = grpc_gcp.api_config_from_text_pb( - pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG) - ) + pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG)) options = [(grpc_gcp.API_CONFIG_CHANNEL_ARG, grpc_gcp_config)] - if "options" in kwargs: - options.extend(kwargs["options"]) - kwargs["options"] = options + if 'options' in kwargs: + options.extend(kwargs['options']) + kwargs['options'] = options return google.api_core.grpc_helpers.create_channel( - address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs + address, + credentials=credentials, + scopes=cls._OAUTH_SCOPES, + **kwargs ) @property @@ -150,7 +156,7 @@ def create_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].CreateSession + return self._stubs['spanner_stub'].CreateSession @property def batch_create_sessions(self): @@ -166,7 +172,7 @@ def batch_create_sessions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].BatchCreateSessions + return self._stubs['spanner_stub'].BatchCreateSessions @property def get_session(self): @@ -180,7 +186,7 @@ def get_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].GetSession + return self._stubs['spanner_stub'].GetSession @property def list_sessions(self): @@ -193,7 +199,7 @@ def list_sessions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].ListSessions + return self._stubs['spanner_stub'].ListSessions @property def delete_session(self): @@ -208,7 +214,7 @@ def delete_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].DeleteSession + return self._stubs['spanner_stub'].DeleteSession @property def execute_sql(self): @@ -231,7 +237,7 @@ def execute_sql(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].ExecuteSql + return self._stubs['spanner_stub'].ExecuteSql @property def execute_streaming_sql(self): @@ -247,7 +253,7 @@ def execute_streaming_sql(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].ExecuteStreamingSql + return self._stubs['spanner_stub'].ExecuteStreamingSql @property def execute_batch_dml(self): @@ -270,7 +276,7 @@ def execute_batch_dml(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].ExecuteBatchDml + return self._stubs['spanner_stub'].ExecuteBatchDml @property def read(self): @@ -294,7 +300,7 @@ def read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].Read + return self._stubs['spanner_stub'].Read @property def streaming_read(self): @@ -310,7 +316,7 @@ def streaming_read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].StreamingRead + return self._stubs['spanner_stub'].StreamingRead @property def begin_transaction(self): @@ -325,7 +331,7 @@ def begin_transaction(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].BeginTransaction + return self._stubs['spanner_stub'].BeginTransaction @property def commit(self): @@ -345,7 +351,7 @@ def commit(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].Commit + return self._stubs['spanner_stub'].Commit @property def rollback(self): @@ -364,7 +370,7 @@ def rollback(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].Rollback + return self._stubs['spanner_stub'].Rollback @property def partition_query(self): @@ -387,7 +393,7 @@ def partition_query(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].PartitionQuery + return self._stubs['spanner_stub'].PartitionQuery @property def partition_read(self): @@ -412,4 +418,4 @@ def partition_read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs["spanner_stub"].PartitionRead + return self._stubs['spanner_stub'].PartitionRead \ No newline at end of file diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index 0f0dba9787..edee917819 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -6,7 +6,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -17,263 +16,153 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1", - create_key=_descriptor._internal_create_key, - 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\xaf\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', - dependencies=[ - google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002\032Google::Cloud::Spanner::V1', + create_key=_descriptor._internal_create_key, + 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\xaf\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' + , + dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) + + _KEYRANGE = _descriptor.Descriptor( - name="KeyRange", - full_name="google.spanner.v1.KeyRange", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="start_closed", - full_name="google.spanner.v1.KeyRange.start_closed", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="start_open", - full_name="google.spanner.v1.KeyRange.start_open", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="end_closed", - full_name="google.spanner.v1.KeyRange.end_closed", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="end_open", - full_name="google.spanner.v1.KeyRange.end_open", - index=3, - number=4, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name="start_key_type", - full_name="google.spanner.v1.KeyRange.start_key_type", - index=0, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[], - ), - _descriptor.OneofDescriptor( - name="end_key_type", - full_name="google.spanner.v1.KeyRange.end_key_type", - index=1, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[], - ), - ], - serialized_start=124, - serialized_end=368, + name='KeyRange', + full_name='google.spanner.v1.KeyRange', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='start_closed', full_name='google.spanner.v1.KeyRange.start_closed', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='start_open', full_name='google.spanner.v1.KeyRange.start_open', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='end_closed', full_name='google.spanner.v1.KeyRange.end_closed', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='end_open', full_name='google.spanner.v1.KeyRange.end_open', index=3, + number=4, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name='start_key_type', full_name='google.spanner.v1.KeyRange.start_key_type', + index=0, containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[]), + _descriptor.OneofDescriptor( + name='end_key_type', full_name='google.spanner.v1.KeyRange.end_key_type', + index=1, containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[]), + ], + serialized_start=124, + serialized_end=368, ) _KEYSET = _descriptor.Descriptor( - name="KeySet", - full_name="google.spanner.v1.KeySet", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="keys", - full_name="google.spanner.v1.KeySet.keys", - index=0, - number=1, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="ranges", - full_name="google.spanner.v1.KeySet.ranges", - index=1, - number=2, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="all", - full_name="google.spanner.v1.KeySet.all", - index=2, - number=3, - type=8, - cpp_type=7, - label=1, - has_default_value=False, - default_value=False, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=370, - serialized_end=478, + name='KeySet', + full_name='google.spanner.v1.KeySet', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='keys', full_name='google.spanner.v1.KeySet.keys', index=0, + number=1, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='ranges', full_name='google.spanner.v1.KeySet.ranges', index=1, + number=2, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='all', full_name='google.spanner.v1.KeySet.all', index=2, + number=3, type=8, cpp_type=7, label=1, + has_default_value=False, default_value=False, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=370, + serialized_end=478, ) -_KEYRANGE.fields_by_name[ - "start_closed" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name[ - "start_open" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name[ - "end_closed" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name[ - "end_open" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.oneofs_by_name["start_key_type"].fields.append( - _KEYRANGE.fields_by_name["start_closed"] -) -_KEYRANGE.fields_by_name["start_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[ - "start_key_type" -] -_KEYRANGE.oneofs_by_name["start_key_type"].fields.append( - _KEYRANGE.fields_by_name["start_open"] -) -_KEYRANGE.fields_by_name["start_open"].containing_oneof = _KEYRANGE.oneofs_by_name[ - "start_key_type" -] -_KEYRANGE.oneofs_by_name["end_key_type"].fields.append( - _KEYRANGE.fields_by_name["end_closed"] -) -_KEYRANGE.fields_by_name["end_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[ - "end_key_type" -] -_KEYRANGE.oneofs_by_name["end_key_type"].fields.append( - _KEYRANGE.fields_by_name["end_open"] -) -_KEYRANGE.fields_by_name["end_open"].containing_oneof = _KEYRANGE.oneofs_by_name[ - "end_key_type" -] -_KEYSET.fields_by_name[ - "keys" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYSET.fields_by_name["ranges"].message_type = _KEYRANGE -DESCRIPTOR.message_types_by_name["KeyRange"] = _KEYRANGE -DESCRIPTOR.message_types_by_name["KeySet"] = _KEYSET +_KEYRANGE.fields_by_name['start_closed'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name['start_open'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name['end_closed'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name['end_open'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.oneofs_by_name['start_key_type'].fields.append( + _KEYRANGE.fields_by_name['start_closed']) +_KEYRANGE.fields_by_name['start_closed'].containing_oneof = _KEYRANGE.oneofs_by_name['start_key_type'] +_KEYRANGE.oneofs_by_name['start_key_type'].fields.append( + _KEYRANGE.fields_by_name['start_open']) +_KEYRANGE.fields_by_name['start_open'].containing_oneof = _KEYRANGE.oneofs_by_name['start_key_type'] +_KEYRANGE.oneofs_by_name['end_key_type'].fields.append( + _KEYRANGE.fields_by_name['end_closed']) +_KEYRANGE.fields_by_name['end_closed'].containing_oneof = _KEYRANGE.oneofs_by_name['end_key_type'] +_KEYRANGE.oneofs_by_name['end_key_type'].fields.append( + _KEYRANGE.fields_by_name['end_open']) +_KEYRANGE.fields_by_name['end_open'].containing_oneof = _KEYRANGE.oneofs_by_name['end_key_type'] +_KEYSET.fields_by_name['keys'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYSET.fields_by_name['ranges'].message_type = _KEYRANGE +DESCRIPTOR.message_types_by_name['KeyRange'] = _KEYRANGE +DESCRIPTOR.message_types_by_name['KeySet'] = _KEYSET _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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. A range has +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. 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. Keys are represented by lists, where the ith value in the list corresponds to @@ -336,18 +225,15 @@ If the end is open, then the range excludes rows whose first ``len(end_open)`` key columns exactly match ``end_open``. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.KeyRange) - }, -) + # @@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 +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. If the same key is specified multiple times in the set (for example if two ranges, two @@ -371,9 +257,8 @@ Note that any keys specified in ``keys`` or ``ranges`` are only yielded once. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) + }) _sym_db.RegisterMessage(KeySet) diff --git a/google/cloud/spanner_v1/proto/keys_pb2_grpc.py b/google/cloud/spanner_v1/proto/keys_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/keys_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + diff --git a/google/cloud/spanner_v1/proto/mutation_pb2.py b/google/cloud/spanner_v1/proto/mutation_pb2.py index 4719d77a50..6c79c6f2d1 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2.py @@ -6,345 +6,210 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 -from google.cloud.spanner_v1.proto import ( - keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2, -) +from google.cloud.spanner_v1.proto import keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2 from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1", - create_key=_descriptor._internal_create_key, - 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\xb3\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', - dependencies=[ - google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR, - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002\032Google::Cloud::Spanner::V1', + create_key=_descriptor._internal_create_key, + 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\xb3\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' + , + dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) + + _MUTATION_WRITE = _descriptor.Descriptor( - name="Write", - full_name="google.spanner.v1.Mutation.Write", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="table", - full_name="google.spanner.v1.Mutation.Write.table", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="columns", - full_name="google.spanner.v1.Mutation.Write.columns", - index=1, - number=2, - type=9, - cpp_type=9, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="values", - full_name="google.spanner.v1.Mutation.Write.values", - index=2, - number=3, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=459, - serialized_end=542, + name='Write', + full_name='google.spanner.v1.Mutation.Write', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='table', full_name='google.spanner.v1.Mutation.Write.table', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='columns', full_name='google.spanner.v1.Mutation.Write.columns', index=1, + number=2, type=9, cpp_type=9, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='values', full_name='google.spanner.v1.Mutation.Write.values', index=2, + number=3, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=459, + serialized_end=542, ) _MUTATION_DELETE = _descriptor.Descriptor( - name="Delete", - full_name="google.spanner.v1.Mutation.Delete", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="table", - full_name="google.spanner.v1.Mutation.Delete.table", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="key_set", - full_name="google.spanner.v1.Mutation.Delete.key_set", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=544, - serialized_end=611, + name='Delete', + full_name='google.spanner.v1.Mutation.Delete', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='table', full_name='google.spanner.v1.Mutation.Delete.table', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='key_set', full_name='google.spanner.v1.Mutation.Delete.key_set', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=544, + serialized_end=611, ) _MUTATION = _descriptor.Descriptor( - name="Mutation", - full_name="google.spanner.v1.Mutation", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="insert", - full_name="google.spanner.v1.Mutation.insert", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="update", - full_name="google.spanner.v1.Mutation.update", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="insert_or_update", - full_name="google.spanner.v1.Mutation.insert_or_update", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="replace", - full_name="google.spanner.v1.Mutation.replace", - index=3, - number=4, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="delete", - full_name="google.spanner.v1.Mutation.delete", - index=4, - number=5, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[_MUTATION_WRITE, _MUTATION_DELETE], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name="operation", - full_name="google.spanner.v1.Mutation.operation", - index=0, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[], - ) - ], - serialized_start=170, - serialized_end=624, + name='Mutation', + full_name='google.spanner.v1.Mutation', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='insert', full_name='google.spanner.v1.Mutation.insert', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='update', full_name='google.spanner.v1.Mutation.update', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='insert_or_update', full_name='google.spanner.v1.Mutation.insert_or_update', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='replace', full_name='google.spanner.v1.Mutation.replace', index=3, + number=4, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='delete', full_name='google.spanner.v1.Mutation.delete', index=4, + number=5, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[_MUTATION_WRITE, _MUTATION_DELETE, ], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name='operation', full_name='google.spanner.v1.Mutation.operation', + index=0, containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[]), + ], + serialized_start=170, + serialized_end=624, ) -_MUTATION_WRITE.fields_by_name[ - "values" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_MUTATION_WRITE.fields_by_name['values'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE _MUTATION_WRITE.containing_type = _MUTATION -_MUTATION_DELETE.fields_by_name[ - "key_set" -].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET +_MUTATION_DELETE.fields_by_name['key_set'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET _MUTATION_DELETE.containing_type = _MUTATION -_MUTATION.fields_by_name["insert"].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name["update"].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name["insert_or_update"].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name["replace"].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name["delete"].message_type = _MUTATION_DELETE -_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["insert"]) -_MUTATION.fields_by_name["insert"].containing_oneof = _MUTATION.oneofs_by_name[ - "operation" -] -_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["update"]) -_MUTATION.fields_by_name["update"].containing_oneof = _MUTATION.oneofs_by_name[ - "operation" -] -_MUTATION.oneofs_by_name["operation"].fields.append( - _MUTATION.fields_by_name["insert_or_update"] -) -_MUTATION.fields_by_name[ - "insert_or_update" -].containing_oneof = _MUTATION.oneofs_by_name["operation"] -_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["replace"]) -_MUTATION.fields_by_name["replace"].containing_oneof = _MUTATION.oneofs_by_name[ - "operation" -] -_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["delete"]) -_MUTATION.fields_by_name["delete"].containing_oneof = _MUTATION.oneofs_by_name[ - "operation" -] -DESCRIPTOR.message_types_by_name["Mutation"] = _MUTATION +_MUTATION.fields_by_name['insert'].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name['update'].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name['insert_or_update'].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name['replace'].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name['delete'].message_type = _MUTATION_DELETE +_MUTATION.oneofs_by_name['operation'].fields.append( + _MUTATION.fields_by_name['insert']) +_MUTATION.fields_by_name['insert'].containing_oneof = _MUTATION.oneofs_by_name['operation'] +_MUTATION.oneofs_by_name['operation'].fields.append( + _MUTATION.fields_by_name['update']) +_MUTATION.fields_by_name['update'].containing_oneof = _MUTATION.oneofs_by_name['operation'] +_MUTATION.oneofs_by_name['operation'].fields.append( + _MUTATION.fields_by_name['insert_or_update']) +_MUTATION.fields_by_name['insert_or_update'].containing_oneof = _MUTATION.oneofs_by_name['operation'] +_MUTATION.oneofs_by_name['operation'].fields.append( + _MUTATION.fields_by_name['replace']) +_MUTATION.fields_by_name['replace'].containing_oneof = _MUTATION.oneofs_by_name['operation'] +_MUTATION.oneofs_by_name['operation'].fields.append( + _MUTATION.fields_by_name['delete']) +_MUTATION.fields_by_name['delete'].containing_oneof = _MUTATION.oneofs_by_name['operation'] +DESCRIPTOR.message_types_by_name['Mutation'] = _MUTATION _sym_db.RegisterFileDescriptor(DESCRIPTOR) -Mutation = _reflection.GeneratedProtocolMessageType( - "Mutation", - (_message.Message,), - { - "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], +Mutation = _reflection.GeneratedProtocolMessageType('Mutation', (_message.Message,), { + + '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], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and [replace][google.spanner.v1.Mutation.replace] operations. @@ -371,16 +236,15 @@ Individual values in each list are encoded as described [here][google.spanner.v1.TypeCode]. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) - }, - ), - "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] operations. + # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) + }) + , + + '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] operations. Attributes: table: @@ -394,12 +258,13 @@ 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. Mutations can be + # @@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. Mutations can be applied to a Cloud Spanner database by sending them in a [Commit][google.spanner.v1.Spanner.Commit] call. @@ -436,9 +301,8 @@ Delete rows from a table. Succeeds whether or not the named rows were present. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) + }) _sym_db.RegisterMessage(Mutation) _sym_db.RegisterMessage(Mutation.Write) _sym_db.RegisterMessage(Mutation.Delete) diff --git a/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py b/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2.py b/google/cloud/spanner_v1/proto/query_plan_pb2.py index 747fe73e93..462ddd326e 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2.py @@ -6,7 +6,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -17,486 +16,297 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1", - create_key=_descriptor._internal_create_key, - 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\xb4\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', - dependencies=[ - google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002\032Google::Cloud::Spanner::V1', + create_key=_descriptor._internal_create_key, + 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\xb4\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' + , + dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) + _PLANNODE_KIND = _descriptor.EnumDescriptor( - name="Kind", - full_name="google.spanner.v1.PlanNode.Kind", - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name="KIND_UNSPECIFIED", - index=0, - number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="RELATIONAL", - index=1, - number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - _descriptor.EnumValueDescriptor( - name="SCALAR", - index=2, - number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key, - ), - ], - containing_type=None, - serialized_options=None, - serialized_start=706, - serialized_end=762, + name='Kind', + full_name='google.spanner.v1.PlanNode.Kind', + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name='KIND_UNSPECIFIED', index=0, number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='RELATIONAL', index=1, number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + _descriptor.EnumValueDescriptor( + name='SCALAR', index=2, number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key), + ], + containing_type=None, + serialized_options=None, + serialized_start=706, + serialized_end=762, ) _sym_db.RegisterEnumDescriptor(_PLANNODE_KIND) _PLANNODE_CHILDLINK = _descriptor.Descriptor( - name="ChildLink", - full_name="google.spanner.v1.PlanNode.ChildLink", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="child_index", - full_name="google.spanner.v1.PlanNode.ChildLink.child_index", - index=0, - number=1, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="type", - full_name="google.spanner.v1.PlanNode.ChildLink.type", - index=1, - number=2, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="variable", - full_name="google.spanner.v1.PlanNode.ChildLink.variable", - index=2, - number=3, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=459, - serialized_end=523, + name='ChildLink', + full_name='google.spanner.v1.PlanNode.ChildLink', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='child_index', full_name='google.spanner.v1.PlanNode.ChildLink.child_index', index=0, + number=1, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='type', full_name='google.spanner.v1.PlanNode.ChildLink.type', index=1, + number=2, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='variable', full_name='google.spanner.v1.PlanNode.ChildLink.variable', index=2, + number=3, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=459, + serialized_end=523, ) _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY = _descriptor.Descriptor( - name="SubqueriesEntry", - full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="key", - full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.key", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="value", - full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.value", - index=1, - number=2, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=b"8\001", - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=655, - serialized_end=704, + name='SubqueriesEntry', + full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='key', full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.key', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='value', full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.value', index=1, + number=2, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=b'8\001', + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=655, + serialized_end=704, ) _PLANNODE_SHORTREPRESENTATION = _descriptor.Descriptor( - name="ShortRepresentation", - full_name="google.spanner.v1.PlanNode.ShortRepresentation", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="description", - full_name="google.spanner.v1.PlanNode.ShortRepresentation.description", - index=0, - number=1, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="subqueries", - full_name="google.spanner.v1.PlanNode.ShortRepresentation.subqueries", - index=1, - number=2, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=526, - serialized_end=704, + name='ShortRepresentation', + full_name='google.spanner.v1.PlanNode.ShortRepresentation', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='description', full_name='google.spanner.v1.PlanNode.ShortRepresentation.description', index=0, + number=1, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='subqueries', full_name='google.spanner.v1.PlanNode.ShortRepresentation.subqueries', index=1, + number=2, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, ], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=526, + serialized_end=704, ) _PLANNODE = _descriptor.Descriptor( - name="PlanNode", - full_name="google.spanner.v1.PlanNode", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="index", - full_name="google.spanner.v1.PlanNode.index", - index=0, - number=1, - type=5, - cpp_type=1, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="kind", - full_name="google.spanner.v1.PlanNode.kind", - index=1, - number=2, - type=14, - cpp_type=8, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="display_name", - full_name="google.spanner.v1.PlanNode.display_name", - index=2, - number=3, - type=9, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"".decode("utf-8"), - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="child_links", - full_name="google.spanner.v1.PlanNode.child_links", - index=3, - number=4, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="short_representation", - full_name="google.spanner.v1.PlanNode.short_representation", - index=4, - number=5, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="metadata", - full_name="google.spanner.v1.PlanNode.metadata", - index=5, - number=6, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="execution_stats", - full_name="google.spanner.v1.PlanNode.execution_stats", - index=6, - number=7, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[_PLANNODE_CHILDLINK, _PLANNODE_SHORTREPRESENTATION], - enum_types=[_PLANNODE_KIND], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=130, - serialized_end=762, + name='PlanNode', + full_name='google.spanner.v1.PlanNode', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='index', full_name='google.spanner.v1.PlanNode.index', index=0, + number=1, type=5, cpp_type=1, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='kind', full_name='google.spanner.v1.PlanNode.kind', index=1, + number=2, type=14, cpp_type=8, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='display_name', full_name='google.spanner.v1.PlanNode.display_name', index=2, + number=3, type=9, cpp_type=9, label=1, + has_default_value=False, default_value=b"".decode('utf-8'), + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='child_links', full_name='google.spanner.v1.PlanNode.child_links', index=3, + number=4, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='short_representation', full_name='google.spanner.v1.PlanNode.short_representation', index=4, + number=5, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='metadata', full_name='google.spanner.v1.PlanNode.metadata', index=5, + number=6, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='execution_stats', full_name='google.spanner.v1.PlanNode.execution_stats', index=6, + number=7, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[_PLANNODE_CHILDLINK, _PLANNODE_SHORTREPRESENTATION, ], + enum_types=[ + _PLANNODE_KIND, + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=130, + serialized_end=762, ) _QUERYPLAN = _descriptor.Descriptor( - name="QueryPlan", - full_name="google.spanner.v1.QueryPlan", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="plan_nodes", - full_name="google.spanner.v1.QueryPlan.plan_nodes", - index=0, - number=1, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ) - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=764, - serialized_end=824, + name='QueryPlan', + full_name='google.spanner.v1.QueryPlan', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='plan_nodes', full_name='google.spanner.v1.QueryPlan.plan_nodes', index=0, + number=1, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=764, + serialized_end=824, ) _PLANNODE_CHILDLINK.containing_type = _PLANNODE -_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY.containing_type = ( - _PLANNODE_SHORTREPRESENTATION -) -_PLANNODE_SHORTREPRESENTATION.fields_by_name[ - "subqueries" -].message_type = _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY +_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY.containing_type = _PLANNODE_SHORTREPRESENTATION +_PLANNODE_SHORTREPRESENTATION.fields_by_name['subqueries'].message_type = _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY _PLANNODE_SHORTREPRESENTATION.containing_type = _PLANNODE -_PLANNODE.fields_by_name["kind"].enum_type = _PLANNODE_KIND -_PLANNODE.fields_by_name["child_links"].message_type = _PLANNODE_CHILDLINK -_PLANNODE.fields_by_name[ - "short_representation" -].message_type = _PLANNODE_SHORTREPRESENTATION -_PLANNODE.fields_by_name[ - "metadata" -].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT -_PLANNODE.fields_by_name[ - "execution_stats" -].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_PLANNODE.fields_by_name['kind'].enum_type = _PLANNODE_KIND +_PLANNODE.fields_by_name['child_links'].message_type = _PLANNODE_CHILDLINK +_PLANNODE.fields_by_name['short_representation'].message_type = _PLANNODE_SHORTREPRESENTATION +_PLANNODE.fields_by_name['metadata'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_PLANNODE.fields_by_name['execution_stats'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT _PLANNODE_KIND.containing_type = _PLANNODE -_QUERYPLAN.fields_by_name["plan_nodes"].message_type = _PLANNODE -DESCRIPTOR.message_types_by_name["PlanNode"] = _PLANNODE -DESCRIPTOR.message_types_by_name["QueryPlan"] = _QUERYPLAN +_QUERYPLAN.fields_by_name['plan_nodes'].message_type = _PLANNODE +DESCRIPTOR.message_types_by_name['PlanNode'] = _PLANNODE +DESCRIPTOR.message_types_by_name['QueryPlan'] = _QUERYPLAN _sym_db.RegisterFileDescriptor(DESCRIPTOR) -PlanNode = _reflection.GeneratedProtocolMessageType( - "PlanNode", - (_message.Message,), - { - "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 appearing in a +PlanNode = _reflection.GeneratedProtocolMessageType('PlanNode', (_message.Message,), { + + '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 appearing in a [PlanNode][google.spanner.v1.PlanNode]. Attributes: @@ -518,25 +328,22 @@ operator. The corresponding ``variable`` fields will be set to the variable names assigned to the columns. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) - }, - ), - "ShortRepresentation": _reflection.GeneratedProtocolMessageType( - "ShortRepresentation", - (_message.Message,), - { - "SubqueriesEntry": _reflection.GeneratedProtocolMessageType( - "SubqueriesEntry", - (_message.Message,), - { - "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 + # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) + }) + , + + 'ShortRepresentation' : _reflection.GeneratedProtocolMessageType('ShortRepresentation', (_message.Message,), { + + 'SubqueriesEntry' : _reflection.GeneratedProtocolMessageType('SubqueriesEntry', (_message.Message,), { + '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]. Attributes: @@ -550,12 +357,13 @@ subtree rooted at this node. The referenced ``SCALAR`` 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 + # @@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]. Attributes: @@ -589,21 +397,18 @@ returned as a result of a profile query. For example, number of executions, number of rows/time per execution etc. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) + }) _sym_db.RegisterMessage(PlanNode) _sym_db.RegisterMessage(PlanNode.ChildLink) _sym_db.RegisterMessage(PlanNode.ShortRepresentation) _sym_db.RegisterMessage(PlanNode.ShortRepresentation.SubqueriesEntry) -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 plan. +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 plan. Attributes: plan_nodes: @@ -612,9 +417,8 @@ [PlanNode][google.spanner.v1.PlanNode]’s ``id`` corresponds to its index in ``plan_nodes``. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) + }) _sym_db.RegisterMessage(QueryPlan) diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py b/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + diff --git a/google/cloud/spanner_v1/proto/result_set_pb2.py b/google/cloud/spanner_v1/proto/result_set_pb2.py index d9d53e3659..8e1257f955 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2.py @@ -6,455 +6,260 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 -from google.cloud.spanner_v1.proto import ( - query_plan_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2, -) -from google.cloud.spanner_v1.proto import ( - transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2, -) -from google.cloud.spanner_v1.proto import ( - type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2, -) +from google.cloud.spanner_v1.proto import query_plan_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2 +from google.cloud.spanner_v1.proto import transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2 +from google.cloud.spanner_v1.proto import type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2 from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1", - create_key=_descriptor._internal_create_key, - 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\xb7\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\\V1\xea\x02\x1aGoogle::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, - google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR, - google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR, - google_dot_api_dot_annotations__pb2.DESCRIPTOR, - ], -) + 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\352\002\032Google::Cloud::Spanner::V1', + create_key=_descriptor._internal_create_key, + 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\xb7\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\\V1\xea\x02\x1aGoogle::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,google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR,google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) + + _RESULTSET = _descriptor.Descriptor( - name="ResultSet", - full_name="google.spanner.v1.ResultSet", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="metadata", - full_name="google.spanner.v1.ResultSet.metadata", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="rows", - full_name="google.spanner.v1.ResultSet.rows", - index=1, - number=2, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="stats", - full_name="google.spanner.v1.ResultSet.stats", - index=2, - number=3, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=269, - serialized_end=428, + name='ResultSet', + full_name='google.spanner.v1.ResultSet', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='metadata', full_name='google.spanner.v1.ResultSet.metadata', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='rows', full_name='google.spanner.v1.ResultSet.rows', index=1, + number=2, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='stats', full_name='google.spanner.v1.ResultSet.stats', index=2, + number=3, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=269, + serialized_end=428, ) _PARTIALRESULTSET = _descriptor.Descriptor( - name="PartialResultSet", - full_name="google.spanner.v1.PartialResultSet", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="metadata", - full_name="google.spanner.v1.PartialResultSet.metadata", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="values", - full_name="google.spanner.v1.PartialResultSet.values", - index=1, - number=2, - type=11, - cpp_type=10, - label=3, - has_default_value=False, - default_value=[], - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="chunked_value", - full_name="google.spanner.v1.PartialResultSet.chunked_value", - index=2, - number=3, - type=8, - cpp_type=7, - label=1, - has_default_value=False, - default_value=False, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="resume_token", - full_name="google.spanner.v1.PartialResultSet.resume_token", - index=3, - number=4, - type=12, - cpp_type=9, - label=1, - has_default_value=False, - default_value=b"", - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="stats", - full_name="google.spanner.v1.PartialResultSet.stats", - index=4, - number=5, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=431, - serialized_end=640, + name='PartialResultSet', + full_name='google.spanner.v1.PartialResultSet', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='metadata', full_name='google.spanner.v1.PartialResultSet.metadata', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='values', full_name='google.spanner.v1.PartialResultSet.values', index=1, + number=2, type=11, cpp_type=10, label=3, + has_default_value=False, default_value=[], + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='chunked_value', full_name='google.spanner.v1.PartialResultSet.chunked_value', index=2, + number=3, type=8, cpp_type=7, label=1, + has_default_value=False, default_value=False, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='resume_token', full_name='google.spanner.v1.PartialResultSet.resume_token', index=3, + number=4, type=12, cpp_type=9, label=1, + has_default_value=False, default_value=b"", + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='stats', full_name='google.spanner.v1.PartialResultSet.stats', index=4, + number=5, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=431, + serialized_end=640, ) _RESULTSETMETADATA = _descriptor.Descriptor( - name="ResultSetMetadata", - full_name="google.spanner.v1.ResultSetMetadata", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="row_type", - full_name="google.spanner.v1.ResultSetMetadata.row_type", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="transaction", - full_name="google.spanner.v1.ResultSetMetadata.transaction", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[], - serialized_start=642, - serialized_end=763, + name='ResultSetMetadata', + full_name='google.spanner.v1.ResultSetMetadata', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='row_type', full_name='google.spanner.v1.ResultSetMetadata.row_type', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='transaction', full_name='google.spanner.v1.ResultSetMetadata.transaction', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + ], + serialized_start=642, + serialized_end=763, ) _RESULTSETSTATS = _descriptor.Descriptor( - name="ResultSetStats", - full_name="google.spanner.v1.ResultSetStats", - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name="query_plan", - full_name="google.spanner.v1.ResultSetStats.query_plan", - index=0, - number=1, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="query_stats", - full_name="google.spanner.v1.ResultSetStats.query_stats", - index=1, - number=2, - type=11, - cpp_type=10, - label=1, - has_default_value=False, - default_value=None, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="row_count_exact", - full_name="google.spanner.v1.ResultSetStats.row_count_exact", - index=2, - number=3, - type=3, - cpp_type=2, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - _descriptor.FieldDescriptor( - name="row_count_lower_bound", - full_name="google.spanner.v1.ResultSetStats.row_count_lower_bound", - index=3, - number=4, - type=3, - cpp_type=2, - label=1, - has_default_value=False, - default_value=0, - message_type=None, - enum_type=None, - containing_type=None, - is_extension=False, - extension_scope=None, - serialized_options=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - ), - ], - extensions=[], - nested_types=[], - enum_types=[], - serialized_options=None, - is_extendable=False, - syntax="proto3", - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name="row_count", - full_name="google.spanner.v1.ResultSetStats.row_count", - index=0, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[], - ) - ], - serialized_start=766, - serialized_end=951, + name='ResultSetStats', + full_name='google.spanner.v1.ResultSetStats', + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name='query_plan', full_name='google.spanner.v1.ResultSetStats.query_plan', index=0, + number=1, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='query_stats', full_name='google.spanner.v1.ResultSetStats.query_stats', index=1, + number=2, type=11, cpp_type=10, label=1, + has_default_value=False, default_value=None, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='row_count_exact', full_name='google.spanner.v1.ResultSetStats.row_count_exact', index=2, + number=3, type=3, cpp_type=2, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + _descriptor.FieldDescriptor( + name='row_count_lower_bound', full_name='google.spanner.v1.ResultSetStats.row_count_lower_bound', index=3, + number=4, type=3, cpp_type=2, label=1, + has_default_value=False, default_value=0, + message_type=None, enum_type=None, containing_type=None, + is_extension=False, extension_scope=None, + serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), + ], + extensions=[ + ], + nested_types=[], + enum_types=[ + ], + serialized_options=None, + is_extendable=False, + syntax='proto3', + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name='row_count', full_name='google.spanner.v1.ResultSetStats.row_count', + index=0, containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[]), + ], + serialized_start=766, + serialized_end=951, ) -_RESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA -_RESULTSET.fields_by_name[ - "rows" -].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_RESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS -_PARTIALRESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA -_PARTIALRESULTSET.fields_by_name[ - "values" -].message_type = google_dot_protobuf_dot_struct__pb2._VALUE -_PARTIALRESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS -_RESULTSETMETADATA.fields_by_name[ - "row_type" -].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._STRUCTTYPE -_RESULTSETMETADATA.fields_by_name[ - "transaction" -].message_type = ( - google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION -) -_RESULTSETSTATS.fields_by_name[ - "query_plan" -].message_type = ( - google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2._QUERYPLAN -) -_RESULTSETSTATS.fields_by_name[ - "query_stats" -].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT -_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append( - _RESULTSETSTATS.fields_by_name["row_count_exact"] -) -_RESULTSETSTATS.fields_by_name[ - "row_count_exact" -].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"] -_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append( - _RESULTSETSTATS.fields_by_name["row_count_lower_bound"] -) -_RESULTSETSTATS.fields_by_name[ - "row_count_lower_bound" -].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"] -DESCRIPTOR.message_types_by_name["ResultSet"] = _RESULTSET -DESCRIPTOR.message_types_by_name["PartialResultSet"] = _PARTIALRESULTSET -DESCRIPTOR.message_types_by_name["ResultSetMetadata"] = _RESULTSETMETADATA -DESCRIPTOR.message_types_by_name["ResultSetStats"] = _RESULTSETSTATS +_RESULTSET.fields_by_name['metadata'].message_type = _RESULTSETMETADATA +_RESULTSET.fields_by_name['rows'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_RESULTSET.fields_by_name['stats'].message_type = _RESULTSETSTATS +_PARTIALRESULTSET.fields_by_name['metadata'].message_type = _RESULTSETMETADATA +_PARTIALRESULTSET.fields_by_name['values'].message_type = google_dot_protobuf_dot_struct__pb2._VALUE +_PARTIALRESULTSET.fields_by_name['stats'].message_type = _RESULTSETSTATS +_RESULTSETMETADATA.fields_by_name['row_type'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._STRUCTTYPE +_RESULTSETMETADATA.fields_by_name['transaction'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION +_RESULTSETSTATS.fields_by_name['query_plan'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2._QUERYPLAN +_RESULTSETSTATS.fields_by_name['query_stats'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_RESULTSETSTATS.oneofs_by_name['row_count'].fields.append( + _RESULTSETSTATS.fields_by_name['row_count_exact']) +_RESULTSETSTATS.fields_by_name['row_count_exact'].containing_oneof = _RESULTSETSTATS.oneofs_by_name['row_count'] +_RESULTSETSTATS.oneofs_by_name['row_count'].fields.append( + _RESULTSETSTATS.fields_by_name['row_count_lower_bound']) +_RESULTSETSTATS.fields_by_name['row_count_lower_bound'].containing_oneof = _RESULTSETSTATS.oneofs_by_name['row_count'] +DESCRIPTOR.message_types_by_name['ResultSet'] = _RESULTSET +DESCRIPTOR.message_types_by_name['PartialResultSet'] = _PARTIALRESULTSET +DESCRIPTOR.message_types_by_name['ResultSetMetadata'] = _RESULTSETMETADATA +DESCRIPTOR.message_types_by_name['ResultSetStats'] = _RESULTSETSTATS _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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 +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 [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. Attributes: @@ -479,18 +284,15 @@ not be populated, based on the [ExecuteSqlRequest.query_mode][ google.spanner.v1.ExecuteSqlRequest.query_mode]. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSet) - }, -) + # @@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. Streaming reads +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. Streaming reads and SQL queries better tolerate large result sets, large rows, and large values, but are a little trickier to consume. @@ -564,18 +366,15 @@ 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) - }, -) + # @@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] or +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] or [PartialResultSet][google.spanner.v1.PartialResultSet]. Attributes: @@ -590,18 +389,15 @@ 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) - }, -) + # @@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 [ResultSet][google.spanner.v1.ResultSet] +ResultSetStats = _reflection.GeneratedProtocolMessageType('ResultSetStats', (_message.Message,), { + '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]. Attributes: @@ -623,9 +419,8 @@ Partitioned DML does not offer exactly-once semantics, so it returns a lower bound of the rows modified. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) - }, -) + # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) + }) _sym_db.RegisterMessage(ResultSetStats) diff --git a/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py b/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py index 8a9393943b..2daafffebf 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py @@ -1,3 +1,4 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc + diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index 995420df80..4d6082b959 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -6,7 +6,6 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database - # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -20,2409 +19,1381 @@ from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 -from google.cloud.spanner_v1.proto import ( - keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2, -) -from google.cloud.spanner_v1.proto import ( - mutation_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2, -) -from google.cloud.spanner_v1.proto import ( - result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2, -) -from google.cloud.spanner_v1.proto import ( - transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2, -) -from google.cloud.spanner_v1.proto import ( - type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2, -) +from google.cloud.spanner_v1.proto import keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2 +from google.cloud.spanner_v1.proto import mutation_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2 +from google.cloud.spanner_v1.proto import result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2 +from google.cloud.spanner_v1.proto import transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2 +from google.cloud.spanner_v1.proto import type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::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\x94\x02\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\x02\x1aGoogle::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\x94\x02\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\x02\x1aGoogle::Cloud::Spanner::V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12 Date: Wed, 5 Aug 2020 08:51:42 -0700 Subject: [PATCH 3/9] Revert "feat(python-library): changes to docs job (#700)" This reverts commit f07cb4446192952f19be3056957f56d180586055. Source-Author: Bu Sun Kim <8822365+busunkim96@users.noreply.github.com> Source-Date: Wed Jul 29 17:33:57 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: ee7506d15daa3873accfff9430eff7e3953f0248 Source-Link: https://github.com/googleapis/synthtool/commit/ee7506d15daa3873accfff9430eff7e3953f0248 --- .../gapic/database_admin_client.py | 736 +-- .../gapic/database_admin_client_config.py | 292 +- .../spanner_admin_database_v1/gapic/enums.py | 4 +- .../database_admin_grpc_transport.py | 70 +- .../proto/backup_pb2.py | 1662 ++++--- .../proto/backup_pb2_grpc.py | 1 - .../proto/common_pb2.py | 167 +- .../proto/common_pb2_grpc.py | 1 - .../proto/spanner_database_admin_pb2.py | 2768 +++++++---- .../proto/spanner_database_admin_pb2_grpc.py | 952 ++-- .../spanner_admin_instance_v1/gapic/enums.py | 3 +- .../gapic/instance_admin_client.py | 453 +- .../gapic/instance_admin_client_config.py | 222 +- .../instance_admin_grpc_transport.py | 56 +- .../proto/spanner_instance_admin_pb2.py | 2454 +++++---- .../proto/spanner_instance_admin_pb2_grpc.py | 563 ++- google/cloud/spanner_v1/gapic/enums.py | 5 +- .../cloud/spanner_v1/gapic/spanner_client.py | 683 +-- .../spanner_v1/gapic/spanner_client_config.py | 272 +- .../transports/spanner_grpc_transport.py | 74 +- google/cloud/spanner_v1/proto/keys_pb2.py | 405 +- .../cloud/spanner_v1/proto/keys_pb2_grpc.py | 1 - google/cloud/spanner_v1/proto/mutation_pb2.py | 530 +- .../spanner_v1/proto/mutation_pb2_grpc.py | 1 - .../cloud/spanner_v1/proto/query_plan_pb2.py | 786 +-- .../spanner_v1/proto/query_plan_pb2_grpc.py | 1 - .../cloud/spanner_v1/proto/result_set_pb2.py | 701 ++- .../spanner_v1/proto/result_set_pb2_grpc.py | 1 - google/cloud/spanner_v1/proto/spanner_pb2.py | 4363 +++++++++++------ .../spanner_v1/proto/spanner_pb2_grpc.py | 842 ++-- .../cloud/spanner_v1/proto/transaction_pb2.py | 914 ++-- .../spanner_v1/proto/transaction_pb2_grpc.py | 1 - google/cloud/spanner_v1/proto/type_pb2.py | 530 +- .../cloud/spanner_v1/proto/type_pb2_grpc.py | 1 - synth.metadata | 4 +- .../gapic/v1/test_database_admin_client_v1.py | 369 +- .../gapic/v1/test_instance_admin_client_v1.py | 245 +- tests/unit/gapic/v1/test_spanner_client_v1.py | 316 +- 38 files changed, 13031 insertions(+), 8418 deletions(-) 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 50e25d10c0..dc11cb0283 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 @@ -36,7 +36,9 @@ from google.cloud.spanner_admin_database_v1.gapic import database_admin_client_config from google.cloud.spanner_admin_database_v1.gapic import enums -from google.cloud.spanner_admin_database_v1.gapic.transports import database_admin_grpc_transport +from google.cloud.spanner_admin_database_v1.gapic.transports import ( + database_admin_grpc_transport, +) from google.cloud.spanner_admin_database_v1.proto import backup_pb2 from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2 from google.cloud.spanner_admin_database_v1.proto import spanner_database_admin_pb2_grpc @@ -48,10 +50,7 @@ from google.protobuf import field_mask_pb2 - -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution( - 'google-cloud-spanner', -).version +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version class DatabaseAdminClient(object): @@ -64,13 +63,12 @@ class DatabaseAdminClient(object): database and to restore from an existing backup. """ - SERVICE_ADDRESS = 'spanner.googleapis.com:443' + SERVICE_ADDRESS = "spanner.googleapis.com:443" """The default address of the service.""" # The name of the interface for this client. This is the key used to # find the method configuration in the client_config dictionary. - _INTERFACE_NAME = 'google.spanner.admin.database.v1.DatabaseAdmin' - + _INTERFACE_NAME = "google.spanner.admin.database.v1.DatabaseAdmin" @classmethod def from_service_account_file(cls, filename, *args, **kwargs): @@ -86,19 +84,17 @@ def from_service_account_file(cls, filename, *args, **kwargs): Returns: DatabaseAdminClient: The constructed client. """ - credentials = service_account.Credentials.from_service_account_file( - filename) - kwargs['credentials'] = credentials + credentials = service_account.Credentials.from_service_account_file(filename) + kwargs["credentials"] = credentials return cls(*args, **kwargs) from_service_account_json = from_service_account_file - @classmethod def backup_path(cls, project, instance, backup): """Return a fully-qualified backup string.""" return google.api_core.path_template.expand( - 'projects/{project}/instances/{instance}/backups/{backup}', + "projects/{project}/instances/{instance}/backups/{backup}", project=project, instance=instance, backup=backup, @@ -108,7 +104,7 @@ def backup_path(cls, project, instance, backup): def database_path(cls, project, instance, database): """Return a fully-qualified database string.""" return google.api_core.path_template.expand( - 'projects/{project}/instances/{instance}/databases/{database}', + "projects/{project}/instances/{instance}/databases/{database}", project=project, instance=instance, database=database, @@ -118,13 +114,20 @@ def database_path(cls, project, instance, database): def instance_path(cls, project, instance): """Return a fully-qualified instance string.""" return google.api_core.path_template.expand( - 'projects/{project}/instances/{instance}', + "projects/{project}/instances/{instance}", project=project, instance=instance, ) - def __init__(self, transport=None, channel=None, credentials=None, - client_config=None, client_info=None, client_options=None): + def __init__( + self, + transport=None, + channel=None, + credentials=None, + client_config=None, + client_info=None, + client_options=None, + ): """Constructor. Args: @@ -160,20 +163,27 @@ def __init__(self, transport=None, channel=None, credentials=None, """ # Raise deprecation warnings for things we want to go away. if client_config is not None: - warnings.warn('The `client_config` argument is deprecated.', - PendingDeprecationWarning, stacklevel=2) + warnings.warn( + "The `client_config` argument is deprecated.", + PendingDeprecationWarning, + stacklevel=2, + ) else: client_config = database_admin_client_config.config if channel: - warnings.warn('The `channel` argument is deprecated; use ' - '`transport` instead.', - PendingDeprecationWarning, stacklevel=2) + warnings.warn( + "The `channel` argument is deprecated; use " "`transport` instead.", + PendingDeprecationWarning, + stacklevel=2, + ) api_endpoint = self.SERVICE_ADDRESS if client_options: if type(client_options) == dict: - client_options = google.api_core.client_options.from_dict(client_options) + client_options = google.api_core.client_options.from_dict( + client_options + ) if client_options.api_endpoint: api_endpoint = client_options.api_endpoint @@ -190,20 +200,18 @@ def __init__(self, transport=None, channel=None, credentials=None, else: if credentials: raise ValueError( - 'Received both a transport instance and ' - 'credentials; these are mutually exclusive.' + "Received both a transport instance and " + "credentials; these are mutually exclusive." ) self.transport = transport else: self.transport = database_admin_grpc_transport.DatabaseAdminGrpcTransport( - address=api_endpoint, - channel=channel, - credentials=credentials, + address=api_endpoint, channel=channel, credentials=credentials ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION, + gapic_version=_GAPIC_LIBRARY_VERSION ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -214,7 +222,7 @@ def __init__(self, transport=None, channel=None, credentials=None, # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config['interfaces'][self._INTERFACE_NAME], + client_config["interfaces"][self._INTERFACE_NAME] ) # Save a dictionary of cached API call functions. @@ -225,13 +233,14 @@ def __init__(self, transport=None, channel=None, credentials=None, # Service calls def create_database( - self, - parent, - create_statement, - extra_statements=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + create_statement, + extra_statements=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Creates a new Cloud Spanner database and starts to prepare it for serving. The returned ``long-running operation`` will have a name of the @@ -293,11 +302,13 @@ def create_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'create_database' not in self._inner_api_calls: - self._inner_api_calls['create_database'] = google.api_core.gapic_v1.method.wrap_method( + if "create_database" not in self._inner_api_calls: + self._inner_api_calls[ + "create_database" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_database, - default_retry=self._method_configs['CreateDatabase'].retry, - default_timeout=self._method_configs['CreateDatabase'].timeout, + default_retry=self._method_configs["CreateDatabase"].retry, + default_timeout=self._method_configs["CreateDatabase"].timeout, client_info=self._client_info, ) @@ -310,14 +321,18 @@ def create_database( metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - operation = self._inner_api_calls['create_database'](request, retry=retry, timeout=timeout, metadata=metadata) + operation = self._inner_api_calls["create_database"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -326,13 +341,14 @@ def create_database( ) def update_database_ddl( - self, - database, - statements, - operation_id=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + statements, + operation_id=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns, indexes, etc. The returned @@ -400,31 +416,35 @@ def update_database_ddl( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'update_database_ddl' not in self._inner_api_calls: - self._inner_api_calls['update_database_ddl'] = google.api_core.gapic_v1.method.wrap_method( + if "update_database_ddl" not in self._inner_api_calls: + self._inner_api_calls[ + "update_database_ddl" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.update_database_ddl, - default_retry=self._method_configs['UpdateDatabaseDdl'].retry, - default_timeout=self._method_configs['UpdateDatabaseDdl'].timeout, + default_retry=self._method_configs["UpdateDatabaseDdl"].retry, + default_timeout=self._method_configs["UpdateDatabaseDdl"].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.UpdateDatabaseDdlRequest( - database=database, - statements=statements, - operation_id=operation_id, + database=database, statements=statements, operation_id=operation_id ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - operation = self._inner_api_calls['update_database_ddl'](request, retry=retry, timeout=timeout, metadata=metadata) + operation = self._inner_api_calls["update_database_ddl"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -433,13 +453,14 @@ def update_database_ddl( ) def create_backup( - self, - parent, - backup_id, - backup, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + backup_id, + backup, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Starts creating a new Cloud Spanner Backup. The returned backup ``long-running operation`` will have a name of the format @@ -508,31 +529,35 @@ def create_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'create_backup' not in self._inner_api_calls: - self._inner_api_calls['create_backup'] = google.api_core.gapic_v1.method.wrap_method( + if "create_backup" not in self._inner_api_calls: + self._inner_api_calls[ + "create_backup" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_backup, - default_retry=self._method_configs['CreateBackup'].retry, - default_timeout=self._method_configs['CreateBackup'].timeout, + default_retry=self._method_configs["CreateBackup"].retry, + default_timeout=self._method_configs["CreateBackup"].timeout, client_info=self._client_info, ) request = backup_pb2.CreateBackupRequest( - parent=parent, - backup_id=backup_id, - backup=backup, + parent=parent, backup_id=backup_id, backup=backup ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - operation = self._inner_api_calls['create_backup'](request, retry=retry, timeout=timeout, metadata=metadata) + operation = self._inner_api_calls["create_backup"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -541,13 +566,14 @@ def create_backup( ) def restore_database( - self, - parent, - database_id, - backup=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + database_id, + backup=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Create a new database by restoring from a completed backup. The new database must be in the same project and in an instance with the same @@ -615,37 +641,39 @@ def restore_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'restore_database' not in self._inner_api_calls: - self._inner_api_calls['restore_database'] = google.api_core.gapic_v1.method.wrap_method( + if "restore_database" not in self._inner_api_calls: + self._inner_api_calls[ + "restore_database" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.restore_database, - default_retry=self._method_configs['RestoreDatabase'].retry, - default_timeout=self._method_configs['RestoreDatabase'].timeout, + default_retry=self._method_configs["RestoreDatabase"].retry, + default_timeout=self._method_configs["RestoreDatabase"].timeout, client_info=self._client_info, ) # Sanity check: We have some fields which are mutually exclusive; # raise ValueError if more than one is sent. - google.api_core.protobuf_helpers.check_oneof( - backup=backup, - ) + google.api_core.protobuf_helpers.check_oneof(backup=backup) request = spanner_database_admin_pb2.RestoreDatabaseRequest( - parent=parent, - database_id=database_id, - backup=backup, + parent=parent, database_id=database_id, backup=backup ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - operation = self._inner_api_calls['restore_database'](request, retry=retry, timeout=timeout, metadata=metadata) + operation = self._inner_api_calls["restore_database"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) return google.api_core.operation.from_gapic( operation, self.transport._operations_client, @@ -654,12 +682,13 @@ def restore_database( ) def list_databases( - self, - parent, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Lists Cloud Spanner databases. @@ -715,45 +744,54 @@ def list_databases( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'list_databases' not in self._inner_api_calls: - self._inner_api_calls['list_databases'] = google.api_core.gapic_v1.method.wrap_method( + if "list_databases" not in self._inner_api_calls: + self._inner_api_calls[ + "list_databases" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_databases, - default_retry=self._method_configs['ListDatabases'].retry, - default_timeout=self._method_configs['ListDatabases'].timeout, + default_retry=self._method_configs["ListDatabases"].retry, + default_timeout=self._method_configs["ListDatabases"].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.ListDatabasesRequest( - parent=parent, - page_size=page_size, + parent=parent, page_size=page_size ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial(self._inner_api_calls['list_databases'], retry=retry, timeout=timeout, metadata=metadata), + method=functools.partial( + self._inner_api_calls["list_databases"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), request=request, - items_field='databases', - request_token_field='page_token', - response_token_field='next_page_token', + items_field="databases", + request_token_field="page_token", + response_token_field="next_page_token", ) return iterator def get_database( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Gets the state of a Cloud Spanner database. @@ -789,36 +827,41 @@ def get_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'get_database' not in self._inner_api_calls: - self._inner_api_calls['get_database'] = google.api_core.gapic_v1.method.wrap_method( + if "get_database" not in self._inner_api_calls: + self._inner_api_calls[ + "get_database" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_database, - default_retry=self._method_configs['GetDatabase'].retry, - default_timeout=self._method_configs['GetDatabase'].timeout, + default_retry=self._method_configs["GetDatabase"].retry, + default_timeout=self._method_configs["GetDatabase"].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.GetDatabaseRequest( - name=name, - ) + request = spanner_database_admin_pb2.GetDatabaseRequest(name=name) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('name', name)] + routing_header = [("name", name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['get_database'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["get_database"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def drop_database( - self, - database, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Drops (aka deletes) a Cloud Spanner database. Completed backups for the database will be retained according to their ``expire_time``. @@ -851,36 +894,41 @@ def drop_database( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'drop_database' not in self._inner_api_calls: - self._inner_api_calls['drop_database'] = google.api_core.gapic_v1.method.wrap_method( + if "drop_database" not in self._inner_api_calls: + self._inner_api_calls[ + "drop_database" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.drop_database, - default_retry=self._method_configs['DropDatabase'].retry, - default_timeout=self._method_configs['DropDatabase'].timeout, + default_retry=self._method_configs["DropDatabase"].retry, + default_timeout=self._method_configs["DropDatabase"].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.DropDatabaseRequest( - database=database, - ) + request = spanner_database_admin_pb2.DropDatabaseRequest(database=database) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - self._inner_api_calls['drop_database'](request, retry=retry, timeout=timeout, metadata=metadata) + self._inner_api_calls["drop_database"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def get_database_ddl( - self, - database, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Returns the schema of a Cloud Spanner database as a list of formatted DDL statements. This method does not show pending schema @@ -917,37 +965,42 @@ def get_database_ddl( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'get_database_ddl' not in self._inner_api_calls: - self._inner_api_calls['get_database_ddl'] = google.api_core.gapic_v1.method.wrap_method( + if "get_database_ddl" not in self._inner_api_calls: + self._inner_api_calls[ + "get_database_ddl" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_database_ddl, - default_retry=self._method_configs['GetDatabaseDdl'].retry, - default_timeout=self._method_configs['GetDatabaseDdl'].timeout, + default_retry=self._method_configs["GetDatabaseDdl"].retry, + default_timeout=self._method_configs["GetDatabaseDdl"].timeout, client_info=self._client_info, ) - request = spanner_database_admin_pb2.GetDatabaseDdlRequest( - database=database, - ) + request = spanner_database_admin_pb2.GetDatabaseDdlRequest(database=database) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['get_database_ddl'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["get_database_ddl"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def set_iam_policy( - self, - resource, - policy, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + resource, + policy, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Sets the access control policy on a database or backup resource. Replaces any existing policy. @@ -999,38 +1052,42 @@ def set_iam_policy( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'set_iam_policy' not in self._inner_api_calls: - self._inner_api_calls['set_iam_policy'] = google.api_core.gapic_v1.method.wrap_method( + if "set_iam_policy" not in self._inner_api_calls: + self._inner_api_calls[ + "set_iam_policy" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.set_iam_policy, - default_retry=self._method_configs['SetIamPolicy'].retry, - default_timeout=self._method_configs['SetIamPolicy'].timeout, + default_retry=self._method_configs["SetIamPolicy"].retry, + default_timeout=self._method_configs["SetIamPolicy"].timeout, client_info=self._client_info, ) - request = iam_policy_pb2.SetIamPolicyRequest( - resource=resource, - policy=policy, - ) + request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('resource', resource)] + routing_header = [("resource", resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['set_iam_policy'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["set_iam_policy"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def get_iam_policy( - self, - resource, - options_=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + resource, + options_=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Gets the access control policy for a database or backup resource. Returns an empty policy if a database or backup exists but does not have @@ -1078,38 +1135,44 @@ def get_iam_policy( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'get_iam_policy' not in self._inner_api_calls: - self._inner_api_calls['get_iam_policy'] = google.api_core.gapic_v1.method.wrap_method( + if "get_iam_policy" not in self._inner_api_calls: + self._inner_api_calls[ + "get_iam_policy" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_iam_policy, - default_retry=self._method_configs['GetIamPolicy'].retry, - default_timeout=self._method_configs['GetIamPolicy'].timeout, + default_retry=self._method_configs["GetIamPolicy"].retry, + default_timeout=self._method_configs["GetIamPolicy"].timeout, client_info=self._client_info, ) request = iam_policy_pb2.GetIamPolicyRequest( - resource=resource, - options=options_, + resource=resource, options=options_ ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('resource', resource)] + routing_header = [("resource", resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['get_iam_policy'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["get_iam_policy"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def test_iam_permissions( - self, - resource, - permissions, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + resource, + permissions, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Returns permissions that the caller has on the specified database or backup resource. @@ -1161,37 +1224,43 @@ def test_iam_permissions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'test_iam_permissions' not in self._inner_api_calls: - self._inner_api_calls['test_iam_permissions'] = google.api_core.gapic_v1.method.wrap_method( + if "test_iam_permissions" not in self._inner_api_calls: + self._inner_api_calls[ + "test_iam_permissions" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.test_iam_permissions, - default_retry=self._method_configs['TestIamPermissions'].retry, - default_timeout=self._method_configs['TestIamPermissions'].timeout, + default_retry=self._method_configs["TestIamPermissions"].retry, + default_timeout=self._method_configs["TestIamPermissions"].timeout, client_info=self._client_info, ) request = iam_policy_pb2.TestIamPermissionsRequest( - resource=resource, - permissions=permissions, + resource=resource, permissions=permissions ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('resource', resource)] + routing_header = [("resource", resource)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['test_iam_permissions'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["test_iam_permissions"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def get_backup( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Gets metadata on a pending or completed ``Backup``. @@ -1227,37 +1296,42 @@ def get_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'get_backup' not in self._inner_api_calls: - self._inner_api_calls['get_backup'] = google.api_core.gapic_v1.method.wrap_method( + if "get_backup" not in self._inner_api_calls: + self._inner_api_calls[ + "get_backup" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_backup, - default_retry=self._method_configs['GetBackup'].retry, - default_timeout=self._method_configs['GetBackup'].timeout, + default_retry=self._method_configs["GetBackup"].retry, + default_timeout=self._method_configs["GetBackup"].timeout, client_info=self._client_info, ) - request = backup_pb2.GetBackupRequest( - name=name, - ) + request = backup_pb2.GetBackupRequest(name=name) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('name', name)] + routing_header = [("name", name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['get_backup'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["get_backup"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def update_backup( - self, - backup, - update_mask, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + backup, + update_mask, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Updates a pending or completed ``Backup``. @@ -1311,37 +1385,41 @@ def update_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'update_backup' not in self._inner_api_calls: - self._inner_api_calls['update_backup'] = google.api_core.gapic_v1.method.wrap_method( + if "update_backup" not in self._inner_api_calls: + self._inner_api_calls[ + "update_backup" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.update_backup, - default_retry=self._method_configs['UpdateBackup'].retry, - default_timeout=self._method_configs['UpdateBackup'].timeout, + default_retry=self._method_configs["UpdateBackup"].retry, + default_timeout=self._method_configs["UpdateBackup"].timeout, client_info=self._client_info, ) - request = backup_pb2.UpdateBackupRequest( - backup=backup, - update_mask=update_mask, - ) + request = backup_pb2.UpdateBackupRequest(backup=backup, update_mask=update_mask) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('backup.name', backup.name)] + routing_header = [("backup.name", backup.name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['update_backup'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["update_backup"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def delete_backup( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Deletes a pending or completed ``Backup``. @@ -1374,38 +1452,43 @@ def delete_backup( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'delete_backup' not in self._inner_api_calls: - self._inner_api_calls['delete_backup'] = google.api_core.gapic_v1.method.wrap_method( + if "delete_backup" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_backup" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.delete_backup, - default_retry=self._method_configs['DeleteBackup'].retry, - default_timeout=self._method_configs['DeleteBackup'].timeout, + default_retry=self._method_configs["DeleteBackup"].retry, + default_timeout=self._method_configs["DeleteBackup"].timeout, client_info=self._client_info, ) - request = backup_pb2.DeleteBackupRequest( - name=name, - ) + request = backup_pb2.DeleteBackupRequest(name=name) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('name', name)] + routing_header = [("name", name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - self._inner_api_calls['delete_backup'](request, retry=retry, timeout=timeout, metadata=metadata) + self._inner_api_calls["delete_backup"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def list_backups( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Lists completed and pending backups. Backups returned are ordered by ``create_time`` in descending order, starting from the most recent @@ -1496,48 +1579,56 @@ def list_backups( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'list_backups' not in self._inner_api_calls: - self._inner_api_calls['list_backups'] = google.api_core.gapic_v1.method.wrap_method( + if "list_backups" not in self._inner_api_calls: + self._inner_api_calls[ + "list_backups" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_backups, - default_retry=self._method_configs['ListBackups'].retry, - default_timeout=self._method_configs['ListBackups'].timeout, + default_retry=self._method_configs["ListBackups"].retry, + default_timeout=self._method_configs["ListBackups"].timeout, client_info=self._client_info, ) request = backup_pb2.ListBackupsRequest( - parent=parent, - filter=filter_, - page_size=page_size, + parent=parent, filter=filter_, page_size=page_size ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial(self._inner_api_calls['list_backups'], retry=retry, timeout=timeout, metadata=metadata), + method=functools.partial( + self._inner_api_calls["list_backups"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), request=request, - items_field='backups', - request_token_field='page_token', - response_token_field='next_page_token', + items_field="backups", + request_token_field="page_token", + response_token_field="next_page_token", ) return iterator def list_database_operations( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Lists database ``longrunning-operations``. A database operation has a name of the form @@ -1639,48 +1730,56 @@ def list_database_operations( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'list_database_operations' not in self._inner_api_calls: - self._inner_api_calls['list_database_operations'] = google.api_core.gapic_v1.method.wrap_method( + if "list_database_operations" not in self._inner_api_calls: + self._inner_api_calls[ + "list_database_operations" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_database_operations, - default_retry=self._method_configs['ListDatabaseOperations'].retry, - default_timeout=self._method_configs['ListDatabaseOperations'].timeout, + default_retry=self._method_configs["ListDatabaseOperations"].retry, + default_timeout=self._method_configs["ListDatabaseOperations"].timeout, client_info=self._client_info, ) request = spanner_database_admin_pb2.ListDatabaseOperationsRequest( - parent=parent, - filter=filter_, - page_size=page_size, + parent=parent, filter=filter_, page_size=page_size ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial(self._inner_api_calls['list_database_operations'], retry=retry, timeout=timeout, metadata=metadata), + method=functools.partial( + self._inner_api_calls["list_database_operations"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), request=request, - items_field='operations', - request_token_field='page_token', - response_token_field='next_page_token', + items_field="operations", + request_token_field="page_token", + response_token_field="next_page_token", ) return iterator def list_backup_operations( - self, - parent, - filter_=None, - page_size=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + parent, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Lists the backup ``long-running operations`` in the given instance. A backup operation has a name of the form @@ -1782,36 +1881,43 @@ def list_backup_operations( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'list_backup_operations' not in self._inner_api_calls: - self._inner_api_calls['list_backup_operations'] = google.api_core.gapic_v1.method.wrap_method( + if "list_backup_operations" not in self._inner_api_calls: + self._inner_api_calls[ + "list_backup_operations" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_backup_operations, - default_retry=self._method_configs['ListBackupOperations'].retry, - default_timeout=self._method_configs['ListBackupOperations'].timeout, + default_retry=self._method_configs["ListBackupOperations"].retry, + default_timeout=self._method_configs["ListBackupOperations"].timeout, client_info=self._client_info, ) request = backup_pb2.ListBackupOperationsRequest( - parent=parent, - filter=filter_, - page_size=page_size, + parent=parent, filter=filter_, page_size=page_size ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('parent', parent)] + routing_header = [("parent", parent)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial(self._inner_api_calls['list_backup_operations'], retry=retry, timeout=timeout, metadata=metadata), + method=functools.partial( + self._inner_api_calls["list_backup_operations"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), request=request, - items_field='operations', - request_token_field='page_token', - response_token_field='next_page_token', + items_field="operations", + request_token_field="page_token", + response_token_field="next_page_token", ) return iterator 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 a987f180ad..936fa54ef9 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 @@ -1,153 +1,147 @@ config = { - "interfaces": { - "google.spanner.admin.database.v1.DatabaseAdmin": { - "retry_codes": { - "retry_policy_1_codes": [ - "UNAVAILABLE", - "DEADLINE_EXCEEDED" - ], - "no_retry_2_codes": [], - "no_retry_codes": [], - "retry_policy_2_codes": [ - "UNAVAILABLE", - "DEADLINE_EXCEEDED" - ], - "no_retry_1_codes": [] - }, - "retry_params": { - "retry_policy_1_params": { - "initial_retry_delay_millis": 1000, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000 - }, - "retry_policy_2_params": { - "initial_retry_delay_millis": 1000, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000 - }, - "no_retry_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 0, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 0, - "total_timeout_millis": 0 - }, - "no_retry_1_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000 - }, - "no_retry_2_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000 + "interfaces": { + "google.spanner.admin.database.v1.DatabaseAdmin": { + "retry_codes": { + "retry_policy_1_codes": ["UNAVAILABLE", "DEADLINE_EXCEEDED"], + "no_retry_2_codes": [], + "no_retry_codes": [], + "retry_policy_2_codes": ["UNAVAILABLE", "DEADLINE_EXCEEDED"], + "no_retry_1_codes": [], + }, + "retry_params": { + "retry_policy_1_params": { + "initial_retry_delay_millis": 1000, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000, + }, + "retry_policy_2_params": { + "initial_retry_delay_millis": 1000, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000, + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0, + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000, + }, + "no_retry_2_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000, + }, + }, + "methods": { + "CreateDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", + }, + "UpdateDatabaseDdl": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "CreateBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", + }, + "RestoreDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", + }, + "ListDatabases": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "GetDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "DropDatabase": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "GetDatabaseDdl": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "SetIamPolicy": { + "timeout_millis": 30000, + "retry_codes_name": "no_retry_2_codes", + "retry_params_name": "no_retry_2_params", + }, + "GetIamPolicy": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_2_codes", + "retry_params_name": "retry_policy_2_params", + }, + "TestIamPermissions": { + "timeout_millis": 30000, + "retry_codes_name": "no_retry_2_codes", + "retry_params_name": "no_retry_2_params", + }, + "GetBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "UpdateBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "DeleteBackup": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "ListBackups": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "ListDatabaseOperations": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "ListBackupOperations": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + }, } - }, - "methods": { - "CreateDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params" - }, - "UpdateDatabaseDdl": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "CreateBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params" - }, - "RestoreDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params" - }, - "ListDatabases": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "GetDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "DropDatabase": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "GetDatabaseDdl": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "SetIamPolicy": { - "timeout_millis": 30000, - "retry_codes_name": "no_retry_2_codes", - "retry_params_name": "no_retry_2_params" - }, - "GetIamPolicy": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_2_codes", - "retry_params_name": "retry_policy_2_params" - }, - "TestIamPermissions": { - "timeout_millis": 30000, - "retry_codes_name": "no_retry_2_codes", - "retry_params_name": "no_retry_2_params" - }, - "GetBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "UpdateBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "DeleteBackup": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "ListBackups": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "ListDatabaseOperations": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "ListBackupOperations": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - } - } } - } } diff --git a/google/cloud/spanner_admin_database_v1/gapic/enums.py b/google/cloud/spanner_admin_database_v1/gapic/enums.py index ecc74f33dc..575cb3a8f7 100644 --- a/google/cloud/spanner_admin_database_v1/gapic/enums.py +++ b/google/cloud/spanner_admin_database_v1/gapic/enums.py @@ -27,6 +27,7 @@ class RestoreSourceType(enum.IntEnum): TYPE_UNSPECIFIED (int): No restore associated. BACKUP (int): A backup was used as the source of the restore. """ + TYPE_UNSPECIFIED = 0 BACKUP = 1 @@ -42,6 +43,7 @@ class State(enum.IntEnum): may fail with ``FAILED_PRECONDITION`` in this state. READY (int): The backup is complete and ready for use. """ + STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 @@ -65,8 +67,8 @@ class State(enum.IntEnum): complete, the full performance of the database will be restored, and the database will transition to ``READY`` state. """ + STATE_UNSPECIFIED = 0 CREATING = 1 READY = 2 READY_OPTIMIZING = 3 - \ No newline at end of file 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 8c6452d41f..f2fb755668 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 @@ -29,15 +29,17 @@ class DatabaseAdminGrpcTransport(object): which can be used to take advantage of advanced features of gRPC. """ + # The scopes needed to make gRPC calls to all of the methods defined # in this service. _OAUTH_SCOPES = ( - 'https://www.googleapis.com/auth/cloud-platform', - 'https://www.googleapis.com/auth/spanner.admin', + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.admin", ) - def __init__(self, channel=None, credentials=None, - address='spanner.googleapis.com:443'): + def __init__( + self, channel=None, credentials=None, address="spanner.googleapis.com:443" + ): """Instantiate the transport class. Args: @@ -55,8 +57,7 @@ def __init__(self, channel=None, credentials=None, # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - 'The `channel` and `credentials` arguments are mutually ' - 'exclusive.', + "The `channel` and `credentials` arguments are mutually " "exclusive." ) # Create the channel. @@ -65,8 +66,8 @@ def __init__(self, channel=None, credentials=None, address=address, credentials=credentials, options={ - 'grpc.max_send_message_length': -1, - 'grpc.max_receive_message_length': -1, + "grpc.max_send_message_length": -1, + "grpc.max_receive_message_length": -1, }.items(), ) @@ -75,20 +76,22 @@ def __init__(self, channel=None, credentials=None, # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. self._stubs = { - 'database_admin_stub': spanner_database_admin_pb2_grpc.DatabaseAdminStub(channel), + "database_admin_stub": spanner_database_admin_pb2_grpc.DatabaseAdminStub( + channel + ) } # Because this API includes a method that returns a # long-running operation (proto: google.longrunning.Operation), # instantiate an LRO client. - self._operations_client = google.api_core.operations_v1.OperationsClient(channel) + self._operations_client = google.api_core.operations_v1.OperationsClient( + channel + ) @classmethod def create_channel( - cls, - address='spanner.googleapis.com:443', - credentials=None, - **kwargs): + cls, address="spanner.googleapis.com:443", credentials=None, **kwargs + ): """Create and return a gRPC channel object. Args: @@ -105,10 +108,7 @@ def create_channel( grpc.Channel: A gRPC channel object. """ return google.api_core.grpc_helpers.create_channel( - address, - credentials=credentials, - scopes=cls._OAUTH_SCOPES, - **kwargs + address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs ) @property @@ -136,7 +136,7 @@ def create_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].CreateDatabase + return self._stubs["database_admin_stub"].CreateDatabase @property def update_database_ddl(self): @@ -154,7 +154,7 @@ def update_database_ddl(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].UpdateDatabaseDdl + return self._stubs["database_admin_stub"].UpdateDatabaseDdl @property def create_backup(self): @@ -175,7 +175,7 @@ def create_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].CreateBackup + return self._stubs["database_admin_stub"].CreateBackup @property def restore_database(self): @@ -200,7 +200,7 @@ def restore_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].RestoreDatabase + return self._stubs["database_admin_stub"].RestoreDatabase @property def list_databases(self): @@ -213,7 +213,7 @@ def list_databases(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].ListDatabases + return self._stubs["database_admin_stub"].ListDatabases @property def get_database(self): @@ -226,7 +226,7 @@ def get_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].GetDatabase + return self._stubs["database_admin_stub"].GetDatabase @property def drop_database(self): @@ -240,7 +240,7 @@ def drop_database(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].DropDatabase + return self._stubs["database_admin_stub"].DropDatabase @property def get_database_ddl(self): @@ -255,7 +255,7 @@ def get_database_ddl(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].GetDatabaseDdl + return self._stubs["database_admin_stub"].GetDatabaseDdl @property def set_iam_policy(self): @@ -273,7 +273,7 @@ def set_iam_policy(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].SetIamPolicy + return self._stubs["database_admin_stub"].SetIamPolicy @property def get_iam_policy(self): @@ -292,7 +292,7 @@ def get_iam_policy(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].GetIamPolicy + return self._stubs["database_admin_stub"].GetIamPolicy @property def test_iam_permissions(self): @@ -313,7 +313,7 @@ def test_iam_permissions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].TestIamPermissions + return self._stubs["database_admin_stub"].TestIamPermissions @property def get_backup(self): @@ -326,7 +326,7 @@ def get_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].GetBackup + return self._stubs["database_admin_stub"].GetBackup @property def update_backup(self): @@ -339,7 +339,7 @@ def update_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].UpdateBackup + return self._stubs["database_admin_stub"].UpdateBackup @property def delete_backup(self): @@ -352,7 +352,7 @@ def delete_backup(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].DeleteBackup + return self._stubs["database_admin_stub"].DeleteBackup @property def list_backups(self): @@ -367,7 +367,7 @@ def list_backups(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].ListBackups + return self._stubs["database_admin_stub"].ListBackups @property def list_database_operations(self): @@ -386,7 +386,7 @@ def list_database_operations(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].ListDatabaseOperations + return self._stubs["database_admin_stub"].ListDatabaseOperations @property def list_backup_operations(self): @@ -407,4 +407,4 @@ def list_backup_operations(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['database_admin_stub'].ListBackupOperations \ No newline at end of file + return self._stubs["database_admin_stub"].ListBackupOperations 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 af4b7e5029..707412b7da 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2.py @@ -6,6 +6,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -13,592 +14,996 @@ from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 -from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 +from google.longrunning import ( + operations_pb2 as google_dot_longrunning_dot_operations__pb2, +) 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 +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, +) 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', - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1', - create_key=_descriptor._internal_create_key, - 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\xff\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\\V1\xea\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_api_dot_annotations__pb2.DESCRIPTOR,]) - + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1", + create_key=_descriptor._internal_create_key, + 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\xff\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\\V1\xea\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_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _BACKUP_STATE = _descriptor.EnumDescriptor( - name='State', - full_name='google.spanner.admin.database.v1.Backup.State', - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name='STATE_UNSPECIFIED', index=0, number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='CREATING', index=1, number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='READY', index=2, number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - ], - containing_type=None, - serialized_options=None, - serialized_start=661, - serialized_end=716, + name="State", + full_name="google.spanner.admin.database.v1.Backup.State", + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name="STATE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="CREATING", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="READY", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=661, + serialized_end=716, ) _sym_db.RegisterEnumDescriptor(_BACKUP_STATE) _BACKUP = _descriptor.Descriptor( - name='Backup', - full_name='google.spanner.admin.database.v1.Backup', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='database', full_name='google.spanner.admin.database.v1.Backup.database', index=0, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='expire_time', full_name='google.spanner.admin.database.v1.Backup.expire_time', index=1, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='name', full_name='google.spanner.admin.database.v1.Backup.name', index=2, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='create_time', full_name='google.spanner.admin.database.v1.Backup.create_time', index=3, - number=4, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='size_bytes', full_name='google.spanner.admin.database.v1.Backup.size_bytes', index=4, - number=5, type=3, cpp_type=2, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='state', full_name='google.spanner.admin.database.v1.Backup.state', index=5, - number=6, type=14, cpp_type=8, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='referencing_databases', full_name='google.spanner.admin.database.v1.Backup.referencing_databases', index=6, - number=7, type=9, cpp_type=9, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - _BACKUP_STATE, - ], - serialized_options=b'\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}', - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=349, - serialized_end=810, + name="Backup", + full_name="google.spanner.admin.database.v1.Backup", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="database", + full_name="google.spanner.admin.database.v1.Backup.database", + index=0, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="expire_time", + full_name="google.spanner.admin.database.v1.Backup.expire_time", + index=1, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="name", + full_name="google.spanner.admin.database.v1.Backup.name", + index=2, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="create_time", + full_name="google.spanner.admin.database.v1.Backup.create_time", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="size_bytes", + full_name="google.spanner.admin.database.v1.Backup.size_bytes", + index=4, + number=5, + type=3, + cpp_type=2, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="state", + full_name="google.spanner.admin.database.v1.Backup.state", + index=5, + number=6, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="referencing_databases", + full_name="google.spanner.admin.database.v1.Backup.referencing_databases", + index=6, + number=7, + type=9, + cpp_type=9, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\003", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[_BACKUP_STATE], + serialized_options=b"\352AY\n\035spanner.googleapis.com/Backup\0228projects/{project}/instances/{instance}/backups/{backup}", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=349, + serialized_end=810, ) _CREATEBACKUPREQUEST = _descriptor.Descriptor( - name='CreateBackupRequest', - full_name='google.spanner.admin.database.v1.CreateBackupRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='parent', full_name='google.spanner.admin.database.v1.CreateBackupRequest.parent', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='backup_id', full_name='google.spanner.admin.database.v1.CreateBackupRequest.backup_id', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='backup', full_name='google.spanner.admin.database.v1.CreateBackupRequest.backup', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=813, - serialized_end=978, + name="CreateBackupRequest", + full_name="google.spanner.admin.database.v1.CreateBackupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.spanner.admin.database.v1.CreateBackupRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="backup_id", + full_name="google.spanner.admin.database.v1.CreateBackupRequest.backup_id", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="backup", + full_name="google.spanner.admin.database.v1.CreateBackupRequest.backup", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=813, + serialized_end=978, ) _CREATEBACKUPMETADATA = _descriptor.Descriptor( - name='CreateBackupMetadata', - full_name='google.spanner.admin.database.v1.CreateBackupMetadata', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='name', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.name', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='database', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.database', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='progress', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.progress', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='cancel_time', full_name='google.spanner.admin.database.v1.CreateBackupMetadata.cancel_time', index=3, - number=4, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=981, - serialized_end=1155, + name="CreateBackupMetadata", + full_name="google.spanner.admin.database.v1.CreateBackupMetadata", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.spanner.admin.database.v1.CreateBackupMetadata.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="database", + full_name="google.spanner.admin.database.v1.CreateBackupMetadata.database", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="progress", + full_name="google.spanner.admin.database.v1.CreateBackupMetadata.progress", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="cancel_time", + full_name="google.spanner.admin.database.v1.CreateBackupMetadata.cancel_time", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=981, + serialized_end=1155, ) _UPDATEBACKUPREQUEST = _descriptor.Descriptor( - name='UpdateBackupRequest', - full_name='google.spanner.admin.database.v1.UpdateBackupRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='backup', full_name='google.spanner.admin.database.v1.UpdateBackupRequest.backup', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='update_mask', full_name='google.spanner.admin.database.v1.UpdateBackupRequest.update_mask', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\002', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1158, - serialized_end=1296, + name="UpdateBackupRequest", + full_name="google.spanner.admin.database.v1.UpdateBackupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="backup", + full_name="google.spanner.admin.database.v1.UpdateBackupRequest.backup", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="update_mask", + full_name="google.spanner.admin.database.v1.UpdateBackupRequest.update_mask", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\002", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1158, + serialized_end=1296, ) _GETBACKUPREQUEST = _descriptor.Descriptor( - name='GetBackupRequest', - full_name='google.spanner.admin.database.v1.GetBackupRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='name', full_name='google.spanner.admin.database.v1.GetBackupRequest.name', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1298, - serialized_end=1369, + name="GetBackupRequest", + full_name="google.spanner.admin.database.v1.GetBackupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.spanner.admin.database.v1.GetBackupRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1298, + serialized_end=1369, ) _DELETEBACKUPREQUEST = _descriptor.Descriptor( - name='DeleteBackupRequest', - full_name='google.spanner.admin.database.v1.DeleteBackupRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='name', full_name='google.spanner.admin.database.v1.DeleteBackupRequest.name', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1371, - serialized_end=1445, + name="DeleteBackupRequest", + full_name="google.spanner.admin.database.v1.DeleteBackupRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="name", + full_name="google.spanner.admin.database.v1.DeleteBackupRequest.name", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1371, + serialized_end=1445, ) _LISTBACKUPSREQUEST = _descriptor.Descriptor( - name='ListBackupsRequest', - full_name='google.spanner.admin.database.v1.ListBackupsRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='parent', full_name='google.spanner.admin.database.v1.ListBackupsRequest.parent', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='filter', full_name='google.spanner.admin.database.v1.ListBackupsRequest.filter', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='page_size', full_name='google.spanner.admin.database.v1.ListBackupsRequest.page_size', index=2, - number=3, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='page_token', full_name='google.spanner.admin.database.v1.ListBackupsRequest.page_token', index=3, - number=4, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1448, - serialized_end=1580, + name="ListBackupsRequest", + full_name="google.spanner.admin.database.v1.ListBackupsRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.spanner.admin.database.v1.ListBackupsRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="filter", + full_name="google.spanner.admin.database.v1.ListBackupsRequest.filter", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.spanner.admin.database.v1.ListBackupsRequest.page_size", + index=2, + number=3, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.spanner.admin.database.v1.ListBackupsRequest.page_token", + index=3, + number=4, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1448, + serialized_end=1580, ) _LISTBACKUPSRESPONSE = _descriptor.Descriptor( - name='ListBackupsResponse', - full_name='google.spanner.admin.database.v1.ListBackupsResponse', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='backups', full_name='google.spanner.admin.database.v1.ListBackupsResponse.backups', index=0, - number=1, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='next_page_token', full_name='google.spanner.admin.database.v1.ListBackupsResponse.next_page_token', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1582, - serialized_end=1687, + name="ListBackupsResponse", + full_name="google.spanner.admin.database.v1.ListBackupsResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="backups", + full_name="google.spanner.admin.database.v1.ListBackupsResponse.backups", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.spanner.admin.database.v1.ListBackupsResponse.next_page_token", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1582, + serialized_end=1687, ) _LISTBACKUPOPERATIONSREQUEST = _descriptor.Descriptor( - name='ListBackupOperationsRequest', - full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='parent', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.parent', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='filter', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.filter', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='page_size', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.page_size', index=2, - number=3, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='page_token', full_name='google.spanner.admin.database.v1.ListBackupOperationsRequest.page_token', index=3, - number=4, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1690, - serialized_end=1831, + name="ListBackupOperationsRequest", + full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="parent", + full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.parent", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + 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", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="filter", + full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.filter", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="page_size", + full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.page_size", + index=2, + number=3, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="page_token", + full_name="google.spanner.admin.database.v1.ListBackupOperationsRequest.page_token", + index=3, + number=4, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1690, + serialized_end=1831, ) _LISTBACKUPOPERATIONSRESPONSE = _descriptor.Descriptor( - name='ListBackupOperationsResponse', - full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='operations', full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse.operations', index=0, - number=1, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='next_page_token', full_name='google.spanner.admin.database.v1.ListBackupOperationsResponse.next_page_token', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1833, - serialized_end=1939, + name="ListBackupOperationsResponse", + full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="operations", + full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse.operations", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="next_page_token", + full_name="google.spanner.admin.database.v1.ListBackupOperationsResponse.next_page_token", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1833, + serialized_end=1939, ) _BACKUPINFO = _descriptor.Descriptor( - name='BackupInfo', - full_name='google.spanner.admin.database.v1.BackupInfo', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='backup', full_name='google.spanner.admin.database.v1.BackupInfo.backup', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='create_time', full_name='google.spanner.admin.database.v1.BackupInfo.create_time', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='source_database', full_name='google.spanner.admin.database.v1.BackupInfo.source_database', index=2, - number=3, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=1941, - serialized_end=2043, + name="BackupInfo", + full_name="google.spanner.admin.database.v1.BackupInfo", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="backup", + full_name="google.spanner.admin.database.v1.BackupInfo.backup", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="create_time", + full_name="google.spanner.admin.database.v1.BackupInfo.create_time", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="source_database", + full_name="google.spanner.admin.database.v1.BackupInfo.source_database", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=1941, + serialized_end=2043, ) -_BACKUP.fields_by_name['expire_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_BACKUP.fields_by_name['create_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_BACKUP.fields_by_name['state'].enum_type = _BACKUP_STATE +_BACKUP.fields_by_name[ + "expire_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_BACKUP.fields_by_name[ + "create_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_BACKUP.fields_by_name["state"].enum_type = _BACKUP_STATE _BACKUP_STATE.containing_type = _BACKUP -_CREATEBACKUPREQUEST.fields_by_name['backup'].message_type = _BACKUP -_CREATEBACKUPMETADATA.fields_by_name['progress'].message_type = google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS -_CREATEBACKUPMETADATA.fields_by_name['cancel_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_UPDATEBACKUPREQUEST.fields_by_name['backup'].message_type = _BACKUP -_UPDATEBACKUPREQUEST.fields_by_name['update_mask'].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK -_LISTBACKUPSRESPONSE.fields_by_name['backups'].message_type = _BACKUP -_LISTBACKUPOPERATIONSRESPONSE.fields_by_name['operations'].message_type = google_dot_longrunning_dot_operations__pb2._OPERATION -_BACKUPINFO.fields_by_name['create_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -DESCRIPTOR.message_types_by_name['Backup'] = _BACKUP -DESCRIPTOR.message_types_by_name['CreateBackupRequest'] = _CREATEBACKUPREQUEST -DESCRIPTOR.message_types_by_name['CreateBackupMetadata'] = _CREATEBACKUPMETADATA -DESCRIPTOR.message_types_by_name['UpdateBackupRequest'] = _UPDATEBACKUPREQUEST -DESCRIPTOR.message_types_by_name['GetBackupRequest'] = _GETBACKUPREQUEST -DESCRIPTOR.message_types_by_name['DeleteBackupRequest'] = _DELETEBACKUPREQUEST -DESCRIPTOR.message_types_by_name['ListBackupsRequest'] = _LISTBACKUPSREQUEST -DESCRIPTOR.message_types_by_name['ListBackupsResponse'] = _LISTBACKUPSRESPONSE -DESCRIPTOR.message_types_by_name['ListBackupOperationsRequest'] = _LISTBACKUPOPERATIONSREQUEST -DESCRIPTOR.message_types_by_name['ListBackupOperationsResponse'] = _LISTBACKUPOPERATIONSRESPONSE -DESCRIPTOR.message_types_by_name['BackupInfo'] = _BACKUPINFO +_CREATEBACKUPREQUEST.fields_by_name["backup"].message_type = _BACKUP +_CREATEBACKUPMETADATA.fields_by_name[ + "progress" +].message_type = ( + google_dot_cloud_dot_spanner__admin__database__v1_dot_proto_dot_common__pb2._OPERATIONPROGRESS +) +_CREATEBACKUPMETADATA.fields_by_name[ + "cancel_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_UPDATEBACKUPREQUEST.fields_by_name["backup"].message_type = _BACKUP +_UPDATEBACKUPREQUEST.fields_by_name[ + "update_mask" +].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK +_LISTBACKUPSRESPONSE.fields_by_name["backups"].message_type = _BACKUP +_LISTBACKUPOPERATIONSRESPONSE.fields_by_name[ + "operations" +].message_type = google_dot_longrunning_dot_operations__pb2._OPERATION +_BACKUPINFO.fields_by_name[ + "create_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +DESCRIPTOR.message_types_by_name["Backup"] = _BACKUP +DESCRIPTOR.message_types_by_name["CreateBackupRequest"] = _CREATEBACKUPREQUEST +DESCRIPTOR.message_types_by_name["CreateBackupMetadata"] = _CREATEBACKUPMETADATA +DESCRIPTOR.message_types_by_name["UpdateBackupRequest"] = _UPDATEBACKUPREQUEST +DESCRIPTOR.message_types_by_name["GetBackupRequest"] = _GETBACKUPREQUEST +DESCRIPTOR.message_types_by_name["DeleteBackupRequest"] = _DELETEBACKUPREQUEST +DESCRIPTOR.message_types_by_name["ListBackupsRequest"] = _LISTBACKUPSREQUEST +DESCRIPTOR.message_types_by_name["ListBackupsResponse"] = _LISTBACKUPSRESPONSE +DESCRIPTOR.message_types_by_name[ + "ListBackupOperationsRequest" +] = _LISTBACKUPOPERATIONSREQUEST +DESCRIPTOR.message_types_by_name[ + "ListBackupOperationsResponse" +] = _LISTBACKUPOPERATIONSRESPONSE +DESCRIPTOR.message_types_by_name["BackupInfo"] = _BACKUPINFO _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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. +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. Attributes: database: @@ -647,15 +1052,18 @@ being deleted. When a restored database from the backup enters the ``READY`` state, the reference to the backup is removed. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.Backup) - }) + # @@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 [CreateBackup][google.spanner.admin.database.v1.Databa +CreateBackupRequest = _reflection.GeneratedProtocolMessageType( + "CreateBackupRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [CreateBackup][google.spanner.admin.database.v1.Databa seAdmin.CreateBackup]. Attributes: @@ -674,15 +1082,18 @@ backup: Required. The backup to create. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupRequest) - }) + # @@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 [CreateBackup][google.span +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 [CreateBackup][google.span ner.admin.database.v1.DatabaseAdmin.CreateBackup]. Attributes: @@ -708,15 +1119,18 @@ [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to ``Code.CANCELLED``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.CreateBackupMetadata) - }) + # @@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 [UpdateBackup][google.spanner.admin.database.v1.Databa +UpdateBackupRequest = _reflection.GeneratedProtocolMessageType( + "UpdateBackupRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [UpdateBackup][google.spanner.admin.database.v1.Databa seAdmin.UpdateBackup]. Attributes: @@ -733,15 +1147,18 @@ prevents any future fields from being erased accidentally by clients that do not know about them. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateBackupRequest) - }) + # @@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 +GetBackupRequest = _reflection.GeneratedProtocolMessageType( + "GetBackupRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup]. Attributes: @@ -749,15 +1166,18 @@ Required. Name of the backup. Values are of the form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetBackupRequest) - }) + # @@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 [DeleteBackup][google.spanner.admin.database.v1.Databa +DeleteBackupRequest = _reflection.GeneratedProtocolMessageType( + "DeleteBackupRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETEBACKUPREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [DeleteBackup][google.spanner.admin.database.v1.Databa seAdmin.DeleteBackup]. Attributes: @@ -765,15 +1185,18 @@ Required. Name of the backup to delete. Values are of the form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DeleteBackupRequest) - }) + # @@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 [ListBackups][google.spanner.admin.database.v1.Databas +ListBackupsRequest = _reflection.GeneratedProtocolMessageType( + "ListBackupsRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTBACKUPSREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [ListBackups][google.spanner.admin.database.v1.Databas eAdmin.ListBackups]. Attributes: @@ -818,15 +1241,18 @@ .admin.database.v1.ListBackupsResponse] to the same ``parent`` and with the same ``filter``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsRequest) - }) + # @@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 [ListBackups][google.spanner.admin.database.v1.Databa +ListBackupsResponse = _reflection.GeneratedProtocolMessageType( + "ListBackupsResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTBACKUPSRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The response for [ListBackups][google.spanner.admin.database.v1.Databa seAdmin.ListBackups]. Attributes: @@ -839,15 +1265,18 @@ ][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups] call to fetch more of the matching backups. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupsResponse) - }) + # @@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 [ListBackupOperations][google.spanner.admin.database.v +ListBackupOperationsRequest = _reflection.GeneratedProtocolMessageType( + "ListBackupOperationsRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTBACKUPOPERATIONSREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """The request for [ListBackupOperations][google.spanner.admin.database.v 1.DatabaseAdmin.ListBackupOperations]. Attributes: @@ -899,15 +1328,18 @@ 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) - }) + # @@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 [ListBackupOperations][google.spanner.admin.database. +ListBackupOperationsResponse = _reflection.GeneratedProtocolMessageType( + "ListBackupOperationsResponse", + (_message.Message,), + { + "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: @@ -927,15 +1359,18 @@ perations][google.spanner.admin.database.v1.DatabaseAdmin.List BackupOperations] call to fetch more of the matching metadata. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListBackupOperationsResponse) - }) + # @@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. +BackupInfo = _reflection.GeneratedProtocolMessageType( + "BackupInfo", + (_message.Message,), + { + "DESCRIPTOR": _BACKUPINFO, + "__module__": "google.cloud.spanner_admin_database_v1.proto.backup_pb2", + "__doc__": """Information about a backup. Attributes: backup: @@ -947,25 +1382,26 @@ source_database: Name of the database the backup was created from. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) - }) + # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.BackupInfo) + }, +) _sym_db.RegisterMessage(BackupInfo) DESCRIPTOR._options = None -_BACKUP.fields_by_name['database']._options = None -_BACKUP.fields_by_name['create_time']._options = None -_BACKUP.fields_by_name['size_bytes']._options = None -_BACKUP.fields_by_name['state']._options = None -_BACKUP.fields_by_name['referencing_databases']._options = None +_BACKUP.fields_by_name["database"]._options = None +_BACKUP.fields_by_name["create_time"]._options = None +_BACKUP.fields_by_name["size_bytes"]._options = None +_BACKUP.fields_by_name["state"]._options = None +_BACKUP.fields_by_name["referencing_databases"]._options = None _BACKUP._options = None -_CREATEBACKUPREQUEST.fields_by_name['parent']._options = None -_CREATEBACKUPREQUEST.fields_by_name['backup_id']._options = None -_CREATEBACKUPREQUEST.fields_by_name['backup']._options = None -_UPDATEBACKUPREQUEST.fields_by_name['backup']._options = None -_UPDATEBACKUPREQUEST.fields_by_name['update_mask']._options = None -_GETBACKUPREQUEST.fields_by_name['name']._options = None -_DELETEBACKUPREQUEST.fields_by_name['name']._options = None -_LISTBACKUPSREQUEST.fields_by_name['parent']._options = None -_LISTBACKUPOPERATIONSREQUEST.fields_by_name['parent']._options = None +_CREATEBACKUPREQUEST.fields_by_name["parent"]._options = None +_CREATEBACKUPREQUEST.fields_by_name["backup_id"]._options = None +_CREATEBACKUPREQUEST.fields_by_name["backup"]._options = None +_UPDATEBACKUPREQUEST.fields_by_name["backup"]._options = None +_UPDATEBACKUPREQUEST.fields_by_name["update_mask"]._options = None +_GETBACKUPREQUEST.fields_by_name["name"]._options = None +_DELETEBACKUPREQUEST.fields_by_name["name"]._options = None +_LISTBACKUPSREQUEST.fields_by_name["parent"]._options = None +_LISTBACKUPOPERATIONSREQUEST.fields_by_name["parent"]._options = None # @@protoc_insertion_point(module_scope) diff --git a/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py b/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py +++ b/google/cloud/spanner_admin_database_v1/proto/backup_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - 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 1e3d6b0ff4..b4e89476eb 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2.py @@ -6,6 +6,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -17,73 +18,114 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1', - create_key=_descriptor._internal_create_key, - 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\xff\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\\V1\xea\x02+Google::Cloud::Spanner::Admin::Database::V1b\x06proto3' - , - dependencies=[google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) - - + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1", + create_key=_descriptor._internal_create_key, + 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\xff\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\\V1\xea\x02+Google::Cloud::Spanner::Admin::Database::V1b\x06proto3', + dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _OPERATIONPROGRESS = _descriptor.Descriptor( - name='OperationProgress', - full_name='google.spanner.admin.database.v1.OperationProgress', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='progress_percent', full_name='google.spanner.admin.database.v1.OperationProgress.progress_percent', index=0, - number=1, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='start_time', full_name='google.spanner.admin.database.v1.OperationProgress.start_time', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='end_time', full_name='google.spanner.admin.database.v1.OperationProgress.end_time', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=192, - serialized_end=331, + name="OperationProgress", + full_name="google.spanner.admin.database.v1.OperationProgress", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="progress_percent", + full_name="google.spanner.admin.database.v1.OperationProgress.progress_percent", + index=0, + number=1, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="start_time", + full_name="google.spanner.admin.database.v1.OperationProgress.start_time", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="end_time", + full_name="google.spanner.admin.database.v1.OperationProgress.end_time", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=192, + serialized_end=331, ) -_OPERATIONPROGRESS.fields_by_name['start_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -_OPERATIONPROGRESS.fields_by_name['end_time'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP -DESCRIPTOR.message_types_by_name['OperationProgress'] = _OPERATIONPROGRESS +_OPERATIONPROGRESS.fields_by_name[ + "start_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +_OPERATIONPROGRESS.fields_by_name[ + "end_time" +].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP +DESCRIPTOR.message_types_by_name["OperationProgress"] = _OPERATIONPROGRESS _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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 +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 running operation. Attributes: @@ -96,8 +138,9 @@ If set, the time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OperationProgress) - }) + # @@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/common_pb2_grpc.py b/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py +++ b/google/cloud/spanner_admin_database_v1/proto/common_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - 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 60fd5db2f1..fa8d83ede0 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 @@ -7,6 +7,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -18,45 +19,69 @@ from google.api import resource_pb2 as google_dot_api_dot_resource__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 -from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 +from google.longrunning import ( + operations_pb2 as google_dot_longrunning_dot_operations__pb2, +) 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 -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 +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, +) +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, +) DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002+Google::Cloud::Spanner::Admin::Database::V1\352AJ\n\037spanner.googleapis.com/Instance\022\'projects/{project}/instances/{instance}', - create_key=_descriptor._internal_create_key, - 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\xda\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\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,google_dot_api_dot_field__behavior__pb2.DESCRIPTOR,google_dot_api_dot_resource__pb2.DESCRIPTOR,google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR,google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR,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,]) + 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\352\002+Google::Cloud::Spanner::Admin::Database::V1\352AJ\n\037spanner.googleapis.com/Instance\022'projects/{project}/instances/{instance}", + create_key=_descriptor._internal_create_key, + 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\xda\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\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, + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, + google_dot_api_dot_resource__pb2.DESCRIPTOR, + google_dot_iam_dot_v1_dot_iam__policy__pb2.DESCRIPTOR, + google_dot_iam_dot_v1_dot_policy__pb2.DESCRIPTOR, + 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, + ], +) _RESTORESOURCETYPE = _descriptor.EnumDescriptor( - name='RestoreSourceType', - full_name='google.spanner.admin.database.v1.RestoreSourceType', - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name='TYPE_UNSPECIFIED', index=0, number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='BACKUP', index=1, number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - ], - containing_type=None, - serialized_options=None, - serialized_start=3044, - serialized_end=3097, + name="RestoreSourceType", + full_name="google.spanner.admin.database.v1.RestoreSourceType", + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name="TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="BACKUP", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=3044, + serialized_end=3097, ) _sym_db.RegisterEnumDescriptor(_RESTORESOURCETYPE) @@ -66,823 +91,1342 @@ _DATABASE_STATE = _descriptor.EnumDescriptor( - name='State', - full_name='google.spanner.admin.database.v1.Database.State', - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name='STATE_UNSPECIFIED', index=0, number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='CREATING', index=1, number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='READY', index=2, number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='READY_OPTIMIZING', index=3, number=3, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - ], - containing_type=None, - serialized_options=None, - serialized_start=907, - serialized_end=984, + name="State", + full_name="google.spanner.admin.database.v1.Database.State", + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name="STATE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="CREATING", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="READY", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="READY_OPTIMIZING", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=907, + serialized_end=984, ) _sym_db.RegisterEnumDescriptor(_DATABASE_STATE) _RESTOREINFO = _descriptor.Descriptor( - name='RestoreInfo', - full_name='google.spanner.admin.database.v1.RestoreInfo', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='source_type', full_name='google.spanner.admin.database.v1.RestoreInfo.source_type', index=0, - number=1, type=14, cpp_type=8, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='backup_info', full_name='google.spanner.admin.database.v1.RestoreInfo.backup_info', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name='source_info', full_name='google.spanner.admin.database.v1.RestoreInfo.source_info', - index=0, containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[]), - ], - serialized_start=504, - serialized_end=675, + name="RestoreInfo", + full_name="google.spanner.admin.database.v1.RestoreInfo", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="source_type", + full_name="google.spanner.admin.database.v1.RestoreInfo.source_type", + index=0, + number=1, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="backup_info", + full_name="google.spanner.admin.database.v1.RestoreInfo.backup_info", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="source_info", + full_name="google.spanner.admin.database.v1.RestoreInfo.source_info", + index=0, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[], + ) + ], + serialized_start=504, + serialized_end=675, ) _DATABASE = _descriptor.Descriptor( - name='Database', - full_name='google.spanner.admin.database.v1.Database', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='name', full_name='google.spanner.admin.database.v1.Database.name', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, 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', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='state', full_name='google.spanner.admin.database.v1.Database.state', index=1, - number=2, type=14, cpp_type=8, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='create_time', full_name='google.spanner.admin.database.v1.Database.create_time', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='restore_info', full_name='google.spanner.admin.database.v1.Database.restore_info', index=3, - number=4, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=b'\340A\003', file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - _DATABASE_STATE, - ], - serialized_options=b'\352A_\n\037spanner.googleapis.com/Database\022/instances//databases/< database>``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseRequest) - }) + # @@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 but not +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 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 @@ -1075,15 +1640,18 @@ .spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns ``ALREADY_EXISTS``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlRequest) - }) + # @@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 [UpdateDatabaseDdl][google +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 [UpdateDatabaseDdl][google .spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]. Attributes: @@ -1097,45 +1665,54 @@ succeeded so far, where ``commit_timestamps[i]`` is the commit timestamp for the statement ``statements[i]``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata) - }) + # @@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 [DropDatabase][google.spanner.admin.database.v1.Databa +DropDatabaseRequest = _reflection.GeneratedProtocolMessageType( + "DropDatabaseRequest", + (_message.Message,), + { + "DESCRIPTOR": _DROPDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [DropDatabase][google.spanner.admin.database.v1.Databa seAdmin.DropDatabase]. Attributes: database: Required. The database to be dropped. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.DropDatabaseRequest) - }) + # @@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 [GetDatabaseDdl][google.spanner.admin.database.v1.Data +GetDatabaseDdlRequest = _reflection.GeneratedProtocolMessageType( + "GetDatabaseDdlRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETDATABASEDDLREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [GetDatabaseDdl][google.spanner.admin.database.v1.Data baseAdmin.GetDatabaseDdl]. Attributes: database: Required. The database whose schema we wish to get. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlRequest) - }) + # @@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 [GetDatabaseDdl][google.spanner.admin.database.v1.Dat +GetDatabaseDdlResponse = _reflection.GeneratedProtocolMessageType( + "GetDatabaseDdlResponse", + (_message.Message,), + { + "DESCRIPTOR": _GETDATABASEDDLRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The response for [GetDatabaseDdl][google.spanner.admin.database.v1.Dat abaseAdmin.GetDatabaseDdl]. Attributes: @@ -1143,15 +1720,18 @@ A list of formatted DDL statements defining the schema of the database specified in the request. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.GetDatabaseDdlResponse) - }) + # @@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 [ListDatabaseOperations][google.spanner.admin.database +ListDatabaseOperationsRequest = _reflection.GeneratedProtocolMessageType( + "ListDatabaseOperationsRequest", + (_message.Message,), + { + "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]. Attributes: @@ -1207,15 +1787,18 @@ sResponse] to the same ``parent`` and with the same ``filter``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsRequest) - }) + # @@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 [ListDatabaseOperations][google.spanner.admin.databas +ListDatabaseOperationsResponse = _reflection.GeneratedProtocolMessageType( + "ListDatabaseOperationsResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTDATABASEOPERATIONSRESPONSE, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The response for [ListDatabaseOperations][google.spanner.admin.databas e.v1.DatabaseAdmin.ListDatabaseOperations]. Attributes: @@ -1231,15 +1814,18 @@ stDatabaseOperations] call to fetch more of the matching metadata. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.ListDatabaseOperationsResponse) - }) + # @@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 [RestoreDatabase][google.spanner.admin.database.v1.Dat +RestoreDatabaseRequest = _reflection.GeneratedProtocolMessageType( + "RestoreDatabaseRequest", + (_message.Message,), + { + "DESCRIPTOR": _RESTOREDATABASEREQUEST, + "__module__": "google.cloud.spanner_admin_database_v1.proto.spanner_database_admin_pb2", + "__doc__": """The request for [RestoreDatabase][google.spanner.admin.database.v1.Dat abaseAdmin.RestoreDatabase]. Attributes: @@ -1262,15 +1848,18 @@ form ``projects//instances//backups/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseRequest) - }) + # @@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 [RestoreDatab +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 [RestoreDatab ase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]. Attributes: @@ -1316,15 +1905,18 @@ completes successfully. This operation will not be created if the restore was not successful. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.RestoreDatabaseMetadata) - }) + # @@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 the +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 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 @@ -1336,216 +1928,218 @@ progress: The progress of the post-restore optimizations. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) - }) + # @@protoc_insertion_point(class_scope:google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata) + }, +) _sym_db.RegisterMessage(OptimizeRestoredDatabaseMetadata) DESCRIPTOR._options = None -_DATABASE.fields_by_name['name']._options = None -_DATABASE.fields_by_name['state']._options = None -_DATABASE.fields_by_name['create_time']._options = None -_DATABASE.fields_by_name['restore_info']._options = None +_DATABASE.fields_by_name["name"]._options = None +_DATABASE.fields_by_name["state"]._options = None +_DATABASE.fields_by_name["create_time"]._options = None +_DATABASE.fields_by_name["restore_info"]._options = None _DATABASE._options = None -_LISTDATABASESREQUEST.fields_by_name['parent']._options = None -_CREATEDATABASEREQUEST.fields_by_name['parent']._options = None -_CREATEDATABASEREQUEST.fields_by_name['create_statement']._options = None -_CREATEDATABASEREQUEST.fields_by_name['extra_statements']._options = None -_CREATEDATABASEMETADATA.fields_by_name['database']._options = None -_GETDATABASEREQUEST.fields_by_name['name']._options = None -_UPDATEDATABASEDDLREQUEST.fields_by_name['database']._options = None -_UPDATEDATABASEDDLREQUEST.fields_by_name['statements']._options = None -_UPDATEDATABASEDDLMETADATA.fields_by_name['database']._options = None -_DROPDATABASEREQUEST.fields_by_name['database']._options = None -_GETDATABASEDDLREQUEST.fields_by_name['database']._options = None -_LISTDATABASEOPERATIONSREQUEST.fields_by_name['parent']._options = None -_RESTOREDATABASEREQUEST.fields_by_name['parent']._options = None -_RESTOREDATABASEREQUEST.fields_by_name['database_id']._options = None -_RESTOREDATABASEREQUEST.fields_by_name['backup']._options = None +_LISTDATABASESREQUEST.fields_by_name["parent"]._options = None +_CREATEDATABASEREQUEST.fields_by_name["parent"]._options = None +_CREATEDATABASEREQUEST.fields_by_name["create_statement"]._options = None +_CREATEDATABASEREQUEST.fields_by_name["extra_statements"]._options = None +_CREATEDATABASEMETADATA.fields_by_name["database"]._options = None +_GETDATABASEREQUEST.fields_by_name["name"]._options = None +_UPDATEDATABASEDDLREQUEST.fields_by_name["database"]._options = None +_UPDATEDATABASEDDLREQUEST.fields_by_name["statements"]._options = None +_UPDATEDATABASEDDLMETADATA.fields_by_name["database"]._options = None +_DROPDATABASEREQUEST.fields_by_name["database"]._options = None +_GETDATABASEDDLREQUEST.fields_by_name["database"]._options = None +_LISTDATABASEOPERATIONSREQUEST.fields_by_name["parent"]._options = None +_RESTOREDATABASEREQUEST.fields_by_name["parent"]._options = None +_RESTOREDATABASEREQUEST.fields_by_name["database_id"]._options = None +_RESTOREDATABASEREQUEST.fields_by_name["backup"]._options = None _DATABASEADMIN = _descriptor.ServiceDescriptor( - name='DatabaseAdmin', - 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', - create_key=_descriptor._internal_create_key, - serialized_start=3100, - serialized_end=7087, - methods=[ - _descriptor.MethodDescriptor( - name='ListDatabases', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases', + name="DatabaseAdmin", + full_name="google.spanner.admin.database.v1.DatabaseAdmin", + file=DESCRIPTOR, index=0, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='CreateDatabase', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase', - index=1, - 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"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='GetDatabase', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase', - index=2, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='UpdateDatabaseDdl', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl', - index=3, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='DropDatabase', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase', - index=4, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='GetDatabaseDdl', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl', - index=5, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='SetIamPolicy', - full_name='google.spanner.admin.database.v1.DatabaseAdmin.SetIamPolicy', - index=6, - 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/*}:getIamPolicy:\001*ZA\"/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy:\001*ZA"/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy:\001*ZA"`__ for more details. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ReplicaInfo) - }) + # @@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. Configurations +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. Configurations define the geographic placement of nodes and their replication. Attributes: @@ -853,22 +1383,27 @@ The geographic placement of nodes in this instance configuration and their replication properties. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) - }) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.InstanceConfig) + }, +) _sym_db.RegisterMessage(InstanceConfig) -Instance = _reflection.GeneratedProtocolMessageType('Instance', (_message.Message,), { - - 'LabelsEntry' : _reflection.GeneratedProtocolMessageType('LabelsEntry', (_message.Message,), { - '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 databases can be +Instance = _reflection.GeneratedProtocolMessageType( + "Instance", + (_message.Message,), + { + "LabelsEntry": _reflection.GeneratedProtocolMessageType( + "LabelsEntry", + (_message.Message,), + { + "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 databases can be hosted. Attributes: @@ -927,16 +1462,19 @@ endpoint_uris: Deprecated. This field is not populated. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) - }) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance) + }, +) _sym_db.RegisterMessage(Instance) _sym_db.RegisterMessage(Instance.LabelsEntry) -ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType('ListInstanceConfigsRequest', (_message.Message,), { - 'DESCRIPTOR' : _LISTINSTANCECONFIGSREQUEST, - '__module__' : 'google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2' - , - '__doc__': """The request for [ListInstanceConfigs][google.spanner.admin.instance.v1 +ListInstanceConfigsRequest = _reflection.GeneratedProtocolMessageType( + "ListInstanceConfigsRequest", + (_message.Message,), + { + "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]. Attributes: @@ -955,15 +1493,18 @@ ][google.spanner.admin.instance.v1.ListInstanceConfigsResponse ]. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsRequest) - }) + # @@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 [ListInstanceConfigs][google.spanner.admin.instance.v +ListInstanceConfigsResponse = _reflection.GeneratedProtocolMessageType( + "ListInstanceConfigsResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTINSTANCECONFIGSRESPONSE, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The response for [ListInstanceConfigs][google.spanner.admin.instance.v 1.InstanceAdmin.ListInstanceConfigs]. Attributes: @@ -975,15 +1516,18 @@ nstanceConfigs] call to fetch more of the matching instance configurations. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstanceConfigsResponse) - }) + # @@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 [GetInstanceConfigRequest][google.spanner.admin.instan +GetInstanceConfigRequest = _reflection.GeneratedProtocolMessageType( + "GetInstanceConfigRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETINSTANCECONFIGREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [GetInstanceConfigRequest][google.spanner.admin.instan ce.v1.InstanceAdmin.GetInstanceConfig]. Attributes: @@ -992,15 +1536,18 @@ Values are of the form ``projects//instanceConfigs/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceConfigRequest) - }) + # @@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 [GetInstance][google.spanner.admin.instance.v1.Instanc +GetInstanceRequest = _reflection.GeneratedProtocolMessageType( + "GetInstanceRequest", + (_message.Message,), + { + "DESCRIPTOR": _GETINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [GetInstance][google.spanner.admin.instance.v1.Instanc eAdmin.GetInstance]. Attributes: @@ -1014,15 +1561,18 @@ [Instance][google.spanner.admin.instance.v1.Instance] fields are returned. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest) - }) + # @@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 [CreateInstance][google.spanner.admin.instance.v1.Inst +CreateInstanceRequest = _reflection.GeneratedProtocolMessageType( + "CreateInstanceRequest", + (_message.Message,), + { + "DESCRIPTOR": _CREATEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [CreateInstance][google.spanner.admin.instance.v1.Inst anceAdmin.CreateInstance]. Attributes: @@ -1037,15 +1587,18 @@ Required. The instance to create. The name may be omitted, but if specified must be ``/instances/``. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceRequest) - }) + # @@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 [ListInstances][google.spanner.admin.instance.v1.Insta +ListInstancesRequest = _reflection.GeneratedProtocolMessageType( + "ListInstancesRequest", + (_message.Message,), + { + "DESCRIPTOR": _LISTINSTANCESREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [ListInstances][google.spanner.admin.instance.v1.Insta nceAdmin.ListInstances]. Attributes: @@ -1076,15 +1629,18 @@ 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) - }) + # @@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 [ListInstances][google.spanner.admin.instance.v1.Inst +ListInstancesResponse = _reflection.GeneratedProtocolMessageType( + "ListInstancesResponse", + (_message.Message,), + { + "DESCRIPTOR": _LISTINSTANCESRESPONSE, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The response for [ListInstances][google.spanner.admin.instance.v1.Inst anceAdmin.ListInstances]. Attributes: @@ -1095,15 +1651,18 @@ es][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanc es] call to fetch more of the matching instances. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.ListInstancesResponse) - }) + # @@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 [UpdateInstance][google.spanner.admin.instance.v1.Inst +UpdateInstanceRequest = _reflection.GeneratedProtocolMessageType( + "UpdateInstanceRequest", + (_message.Message,), + { + "DESCRIPTOR": _UPDATEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [UpdateInstance][google.spanner.admin.instance.v1.Inst anceAdmin.UpdateInstance]. Attributes: @@ -1121,15 +1680,18 @@ being erased accidentally by clients that do not know about them. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest) - }) + # @@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 [DeleteInstance][google.spanner.admin.instance.v1.Inst +DeleteInstanceRequest = _reflection.GeneratedProtocolMessageType( + "DeleteInstanceRequest", + (_message.Message,), + { + "DESCRIPTOR": _DELETEINSTANCEREQUEST, + "__module__": "google.cloud.spanner_admin_instance_v1.proto.spanner_instance_admin_pb2", + "__doc__": """The request for [DeleteInstance][google.spanner.admin.instance.v1.Inst anceAdmin.DeleteInstance]. Attributes: @@ -1137,15 +1699,18 @@ Required. The name of the instance to be deleted. Values are of the form ``projects//instances/`` """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.DeleteInstanceRequest) - }) + # @@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 [CreateInstance][google.sp +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 [CreateInstance][google.sp anner.admin.instance.v1.InstanceAdmin.CreateInstance]. Attributes: @@ -1162,15 +1727,18 @@ The time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.CreateInstanceMetadata) - }) + # @@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 [UpdateInstance][google.sp +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 [UpdateInstance][google.sp anner.admin.instance.v1.InstanceAdmin.UpdateInstance]. Attributes: @@ -1187,140 +1755,142 @@ The time at which this operation failed or was completed successfully. """, - # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) - }) + # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceMetadata) + }, +) _sym_db.RegisterMessage(UpdateInstanceMetadata) DESCRIPTOR._options = None _INSTANCECONFIG._options = None _INSTANCE_LABELSENTRY._options = None -_INSTANCE.fields_by_name['config']._options = None +_INSTANCE.fields_by_name["config"]._options = None _INSTANCE._options = None -_LISTINSTANCECONFIGSREQUEST.fields_by_name['parent']._options = None -_GETINSTANCECONFIGREQUEST.fields_by_name['name']._options = None -_GETINSTANCEREQUEST.fields_by_name['name']._options = None -_CREATEINSTANCEREQUEST.fields_by_name['parent']._options = None -_CREATEINSTANCEREQUEST.fields_by_name['instance_id']._options = None -_CREATEINSTANCEREQUEST.fields_by_name['instance']._options = None -_LISTINSTANCESREQUEST.fields_by_name['parent']._options = None -_UPDATEINSTANCEREQUEST.fields_by_name['instance']._options = None -_UPDATEINSTANCEREQUEST.fields_by_name['field_mask']._options = None -_DELETEINSTANCEREQUEST.fields_by_name['name']._options = None +_LISTINSTANCECONFIGSREQUEST.fields_by_name["parent"]._options = None +_GETINSTANCECONFIGREQUEST.fields_by_name["name"]._options = None +_GETINSTANCEREQUEST.fields_by_name["name"]._options = None +_CREATEINSTANCEREQUEST.fields_by_name["parent"]._options = None +_CREATEINSTANCEREQUEST.fields_by_name["instance_id"]._options = None +_CREATEINSTANCEREQUEST.fields_by_name["instance"]._options = None +_LISTINSTANCESREQUEST.fields_by_name["parent"]._options = None +_UPDATEINSTANCEREQUEST.fields_by_name["instance"]._options = None +_UPDATEINSTANCEREQUEST.fields_by_name["field_mask"]._options = None +_DELETEINSTANCEREQUEST.fields_by_name["name"]._options = None _INSTANCEADMIN = _descriptor.ServiceDescriptor( - name='InstanceAdmin', - 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', - create_key=_descriptor._internal_create_key, - serialized_start=2957, - serialized_end=5068, - methods=[ - _descriptor.MethodDescriptor( - name='ListInstanceConfigs', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs', + name="InstanceAdmin", + full_name="google.spanner.admin.instance.v1.InstanceAdmin", + file=DESCRIPTOR, index=0, - containing_service=None, - input_type=_LISTINSTANCECONFIGSREQUEST, - output_type=_LISTINSTANCECONFIGSRESPONSE, - serialized_options=b'\202\323\344\223\002)\022\'/v1/{parent=projects/*}/instanceConfigs\332A\006parent', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='GetInstanceConfig', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig', - index=1, - containing_service=None, - input_type=_GETINSTANCECONFIGREQUEST, - output_type=_INSTANCECONFIG, - serialized_options=b'\202\323\344\223\002)\022\'/v1/{name=projects/*/instanceConfigs/*}\332A\004name', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='ListInstances', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.ListInstances', - index=2, - containing_service=None, - input_type=_LISTINSTANCESREQUEST, - output_type=_LISTINSTANCESRESPONSE, - serialized_options=b'\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='GetInstance', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetInstance', - index=3, - containing_service=None, - input_type=_GETINSTANCEREQUEST, - output_type=_INSTANCE, - serialized_options=b'\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='CreateInstance', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance', - index=4, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='UpdateInstance', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance', - index=5, - 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"\312A\026spanner.googleapis.com\322A\\https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.admin", create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='DeleteInstance', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance', - index=6, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='SetIamPolicy', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy', - index=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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='GetIamPolicy', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy', - index=8, - 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', - create_key=_descriptor._internal_create_key, - ), - _descriptor.MethodDescriptor( - name='TestIamPermissions', - full_name='google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions', - index=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', - create_key=_descriptor._internal_create_key, - ), -]) + serialized_start=2957, + serialized_end=5068, + methods=[ + _descriptor.MethodDescriptor( + name="ListInstanceConfigs", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs", + index=0, + containing_service=None, + input_type=_LISTINSTANCECONFIGSREQUEST, + output_type=_LISTINSTANCECONFIGSRESPONSE, + serialized_options=b"\202\323\344\223\002)\022'/v1/{parent=projects/*}/instanceConfigs\332A\006parent", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="GetInstanceConfig", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstanceConfig", + index=1, + containing_service=None, + input_type=_GETINSTANCECONFIGREQUEST, + output_type=_INSTANCECONFIG, + serialized_options=b"\202\323\344\223\002)\022'/v1/{name=projects/*/instanceConfigs/*}\332A\004name", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="ListInstances", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.ListInstances", + index=2, + containing_service=None, + input_type=_LISTINSTANCESREQUEST, + output_type=_LISTINSTANCESRESPONSE, + serialized_options=b"\202\323\344\223\002#\022!/v1/{parent=projects/*}/instances\332A\006parent", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="GetInstance", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetInstance", + index=3, + containing_service=None, + input_type=_GETINSTANCEREQUEST, + output_type=_INSTANCE, + serialized_options=b"\202\323\344\223\002#\022!/v1/{name=projects/*/instances/*}\332A\004name", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="CreateInstance", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance", + index=4, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="UpdateInstance", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance", + index=5, + 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", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="DeleteInstance", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance", + index=6, + 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", + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="SetIamPolicy", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.SetIamPolicy", + index=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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="GetIamPolicy", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.GetIamPolicy", + index=8, + 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', + create_key=_descriptor._internal_create_key, + ), + _descriptor.MethodDescriptor( + name="TestIamPermissions", + full_name="google.spanner.admin.instance.v1.InstanceAdmin.TestIamPermissions", + index=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', + create_key=_descriptor._internal_create_key, + ), + ], +) _sym_db.RegisterServiceDescriptor(_INSTANCEADMIN) -DESCRIPTOR.services_by_name['InstanceAdmin'] = _INSTANCEADMIN +DESCRIPTOR.services_by_name["InstanceAdmin"] = _INSTANCEADMIN # @@protoc_insertion_point(module_scope) 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 3164d8b188..29964606bd 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,10 +2,14 @@ """Client and server classes corresponding to protobuf-defined services.""" 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 +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, +) 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 -from google.longrunning import operations_pb2 as google_dot_longrunning_dot_operations__pb2 +from google.longrunning import ( + operations_pb2 as google_dot_longrunning_dot_operations__pb2, +) from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 @@ -40,55 +44,55 @@ def __init__(self, channel): channel: A grpc.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, - ) + "/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, + ) 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, - ) + "/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, + ) 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, - ) + "/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, + ) 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, - ) + "/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, + ) 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, - response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, - ) + "/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, + 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, - response_deserializer=google_dot_longrunning_dot_operations__pb2.Operation.FromString, - ) + "/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, + 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, - response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, - ) + "/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, + response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString, + ) self.SetIamPolicy = channel.unary_unary( - '/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy', - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - ) + "/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) self.GetIamPolicy = channel.unary_unary( - '/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy', - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - ) + "/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + ) self.TestIamPermissions = channel.unary_unary( - '/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions', - request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, - response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, - ) + "/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions", + request_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + response_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + ) class InstanceAdminServicer(object): @@ -119,29 +123,29 @@ def ListInstanceConfigs(self, request, context): """Lists the supported instance configurations for a given project. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def GetInstanceConfig(self, request, context): """Gets information about a particular instance configuration. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def ListInstances(self, request, context): """Lists all instances in the given project. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def GetInstance(self, request, context): """Gets information about a particular instance. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def CreateInstance(self, request, context): """Creates an instance and begins preparing it to begin serving. The @@ -180,8 +184,8 @@ def CreateInstance(self, request, context): [Instance][google.spanner.admin.instance.v1.Instance], if successful. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def UpdateInstance(self, request, context): """Updates an instance, and begins allocating or releasing resources @@ -226,8 +230,8 @@ def UpdateInstance(self, request, context): resource [name][google.spanner.admin.instance.v1.Instance.name]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def DeleteInstance(self, request, context): """Deletes an instance. @@ -243,8 +247,8 @@ def DeleteInstance(self, request, context): is permanently deleted. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def SetIamPolicy(self, request, context): """Sets the access control policy on an instance resource. Replaces any @@ -254,8 +258,8 @@ def SetIamPolicy(self, request, context): [resource][google.iam.v1.SetIamPolicyRequest.resource]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def GetIamPolicy(self, request, context): """Gets the access control policy for an instance resource. Returns an empty @@ -265,8 +269,8 @@ def GetIamPolicy(self, request, context): [resource][google.iam.v1.GetIamPolicyRequest.resource]. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") def TestIamPermissions(self, request, context): """Returns permissions that the caller has on the specified instance resource. @@ -277,69 +281,70 @@ def TestIamPermissions(self, request, context): empty set of permissions. """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) - context.set_details('Method not implemented!') - raise NotImplementedError('Method not implemented!') + context.set_details("Method not implemented!") + raise NotImplementedError("Method not implemented!") 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, - ), - '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, - ), - '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, - ), - '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, - ), - '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, - 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, - 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, - response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, - ), - 'SetIamPolicy': grpc.unary_unary_rpc_method_handler( - servicer.SetIamPolicy, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, - ), - 'GetIamPolicy': grpc.unary_unary_rpc_method_handler( - servicer.GetIamPolicy, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, - ), - 'TestIamPermissions': grpc.unary_unary_rpc_method_handler( - servicer.TestIamPermissions, - request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString, - response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString, - ), + "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, + ), + "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, + ), + "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, + ), + "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, + ), + "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, + 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, + 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, + response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString, + ), + "SetIamPolicy": grpc.unary_unary_rpc_method_handler( + servicer.SetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + "GetIamPolicy": grpc.unary_unary_rpc_method_handler( + servicer.GetIamPolicy, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_policy__pb2.Policy.SerializeToString, + ), + "TestIamPermissions": grpc.unary_unary_rpc_method_handler( + servicer.TestIamPermissions, + request_deserializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.FromString, + response_serializer=google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.SerializeToString, + ), } generic_handler = grpc.method_handlers_generic_handler( - 'google.spanner.admin.instance.v1.InstanceAdmin', rpc_method_handlers) + "google.spanner.admin.instance.v1.InstanceAdmin", rpc_method_handlers + ) server.add_generic_rpc_handlers((generic_handler,)) - # This class is part of an EXPERIMENTAL API. +# This class is part of an EXPERIMENTAL API. class InstanceAdmin(object): """Cloud Spanner Instance Admin API @@ -365,161 +370,271 @@ class InstanceAdmin(object): """ @staticmethod - def ListInstanceConfigs(request, + def ListInstanceConfigs( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs', + "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstanceConfigs", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstanceConfigsResponse.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def GetInstanceConfig(request, + def GetInstanceConfig( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig', + "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstanceConfig", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceConfigRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.InstanceConfig.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def ListInstances(request, + def ListInstances( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances', + "/google.spanner.admin.instance.v1.InstanceAdmin/ListInstances", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.ListInstancesResponse.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def GetInstance(request, + def GetInstance( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance', + "/google.spanner.admin.instance.v1.InstanceAdmin/GetInstance", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.GetInstanceRequest.SerializeToString, google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.Instance.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def CreateInstance(request, + def CreateInstance( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance', + "/google.spanner.admin.instance.v1.InstanceAdmin/CreateInstance", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.CreateInstanceRequest.SerializeToString, google_dot_longrunning_dot_operations__pb2.Operation.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def UpdateInstance(request, + def UpdateInstance( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance', + "/google.spanner.admin.instance.v1.InstanceAdmin/UpdateInstance", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.UpdateInstanceRequest.SerializeToString, google_dot_longrunning_dot_operations__pb2.Operation.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def DeleteInstance(request, + def DeleteInstance( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance', + "/google.spanner.admin.instance.v1.InstanceAdmin/DeleteInstance", google_dot_cloud_dot_spanner__admin__instance__v1_dot_proto_dot_spanner__instance__admin__pb2.DeleteInstanceRequest.SerializeToString, google_dot_protobuf_dot_empty__pb2.Empty.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def SetIamPolicy(request, + def SetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy', + "/google.spanner.admin.instance.v1.InstanceAdmin/SetIamPolicy", google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def GetIamPolicy(request, + def GetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy', + "/google.spanner.admin.instance.v1.InstanceAdmin/GetIamPolicy", google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) @staticmethod - def TestIamPermissions(request, + def TestIamPermissions( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, target, - options=(), - channel_credentials=None, - call_credentials=None, - compression=None, - wait_for_ready=None, - timeout=None, - metadata=None): - return grpc.experimental.unary_unary(request, target, '/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions', + "/google.spanner.admin.instance.v1.InstanceAdmin/TestIamPermissions", google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, - options, channel_credentials, - call_credentials, compression, wait_for_ready, timeout, metadata) + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) diff --git a/google/cloud/spanner_v1/gapic/enums.py b/google/cloud/spanner_v1/gapic/enums.py index 3ba143c433..3d4a941849 100644 --- a/google/cloud/spanner_v1/gapic/enums.py +++ b/google/cloud/spanner_v1/gapic/enums.py @@ -29,6 +29,7 @@ class NullValue(enum.IntEnum): Attributes: NULL_VALUE (int): Null value. """ + NULL_VALUE = 0 @@ -73,6 +74,7 @@ class TypeCode(enum.IntEnum): \``+-\ ``.Digits[ExponentIndicator[+-]Digits]`` (ExponentIndicator is \`"e"\` or \`"E"`) """ + TYPE_CODE_UNSPECIFIED = 0 BOOL = 1 INT64 = 2 @@ -98,6 +100,7 @@ class QueryMode(enum.IntEnum): PROFILE (int): This mode returns both the query plan and the execution statistics along with the results. """ + NORMAL = 0 PLAN = 1 PROFILE = 2 @@ -120,7 +123,7 @@ class Kind(enum.IntEnum): arithmetic operators appearing inside predicate expressions or references to column names. """ + KIND_UNSPECIFIED = 0 RELATIONAL = 1 SCALAR = 2 - \ No newline at end of file diff --git a/google/cloud/spanner_v1/gapic/spanner_client.py b/google/cloud/spanner_v1/gapic/spanner_client.py index bc6c543f56..c0454761a0 100644 --- a/google/cloud/spanner_v1/gapic/spanner_client.py +++ b/google/cloud/spanner_v1/gapic/spanner_client.py @@ -45,10 +45,7 @@ from google.protobuf import struct_pb2 - -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution( - 'google-cloud-spanner', -).version +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-spanner").version class SpannerClient(object): @@ -59,13 +56,12 @@ class SpannerClient(object): transactions on data stored in Cloud Spanner databases. """ - SERVICE_ADDRESS = 'spanner.googleapis.com:443' + SERVICE_ADDRESS = "spanner.googleapis.com:443" """The default address of the service.""" # The name of the interface for this client. This is the key used to # find the method configuration in the client_config dictionary. - _INTERFACE_NAME = 'google.spanner.v1.Spanner' - + _INTERFACE_NAME = "google.spanner.v1.Spanner" @classmethod def from_service_account_file(cls, filename, *args, **kwargs): @@ -81,19 +77,17 @@ def from_service_account_file(cls, filename, *args, **kwargs): Returns: SpannerClient: The constructed client. """ - credentials = service_account.Credentials.from_service_account_file( - filename) - kwargs['credentials'] = credentials + credentials = service_account.Credentials.from_service_account_file(filename) + kwargs["credentials"] = credentials return cls(*args, **kwargs) from_service_account_json = from_service_account_file - @classmethod def database_path(cls, project, instance, database): """Return a fully-qualified database string.""" return google.api_core.path_template.expand( - 'projects/{project}/instances/{instance}/databases/{database}', + "projects/{project}/instances/{instance}/databases/{database}", project=project, instance=instance, database=database, @@ -103,15 +97,22 @@ def database_path(cls, project, instance, database): def session_path(cls, project, instance, database, session): """Return a fully-qualified session string.""" return google.api_core.path_template.expand( - 'projects/{project}/instances/{instance}/databases/{database}/sessions/{session}', + "projects/{project}/instances/{instance}/databases/{database}/sessions/{session}", project=project, instance=instance, database=database, session=session, ) - def __init__(self, transport=None, channel=None, credentials=None, - client_config=None, client_info=None, client_options=None): + def __init__( + self, + transport=None, + channel=None, + credentials=None, + client_config=None, + client_info=None, + client_options=None, + ): """Constructor. Args: @@ -147,20 +148,27 @@ def __init__(self, transport=None, channel=None, credentials=None, """ # Raise deprecation warnings for things we want to go away. if client_config is not None: - warnings.warn('The `client_config` argument is deprecated.', - PendingDeprecationWarning, stacklevel=2) + warnings.warn( + "The `client_config` argument is deprecated.", + PendingDeprecationWarning, + stacklevel=2, + ) else: client_config = spanner_client_config.config if channel: - warnings.warn('The `channel` argument is deprecated; use ' - '`transport` instead.', - PendingDeprecationWarning, stacklevel=2) + warnings.warn( + "The `channel` argument is deprecated; use " "`transport` instead.", + PendingDeprecationWarning, + stacklevel=2, + ) api_endpoint = self.SERVICE_ADDRESS if client_options: if type(client_options) == dict: - client_options = google.api_core.client_options.from_dict(client_options) + client_options = google.api_core.client_options.from_dict( + client_options + ) if client_options.api_endpoint: api_endpoint = client_options.api_endpoint @@ -177,20 +185,18 @@ def __init__(self, transport=None, channel=None, credentials=None, else: if credentials: raise ValueError( - 'Received both a transport instance and ' - 'credentials; these are mutually exclusive.' + "Received both a transport instance and " + "credentials; these are mutually exclusive." ) self.transport = transport else: self.transport = spanner_grpc_transport.SpannerGrpcTransport( - address=api_endpoint, - channel=channel, - credentials=credentials, + address=api_endpoint, channel=channel, credentials=credentials ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION, + gapic_version=_GAPIC_LIBRARY_VERSION ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -201,7 +207,7 @@ def __init__(self, transport=None, channel=None, credentials=None, # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config['interfaces'][self._INTERFACE_NAME], + client_config["interfaces"][self._INTERFACE_NAME] ) # Save a dictionary of cached API call functions. @@ -212,12 +218,13 @@ def __init__(self, transport=None, channel=None, credentials=None, # Service calls def create_session( - self, - database, - session=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + session=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Creates a new session. A session can be used to perform transactions that read and/or modify data in a Cloud Spanner database. Sessions are @@ -272,39 +279,43 @@ def create_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'create_session' not in self._inner_api_calls: - self._inner_api_calls['create_session'] = google.api_core.gapic_v1.method.wrap_method( + if "create_session" not in self._inner_api_calls: + self._inner_api_calls[ + "create_session" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.create_session, - default_retry=self._method_configs['CreateSession'].retry, - default_timeout=self._method_configs['CreateSession'].timeout, + default_retry=self._method_configs["CreateSession"].retry, + default_timeout=self._method_configs["CreateSession"].timeout, client_info=self._client_info, ) - request = spanner_pb2.CreateSessionRequest( - database=database, - session=session, - ) + request = spanner_pb2.CreateSessionRequest(database=database, session=session) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['create_session'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["create_session"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def batch_create_sessions( - self, - database, - session_count, - session_template=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + session_count, + session_template=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Creates multiple new sessions. @@ -353,11 +364,13 @@ def batch_create_sessions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'batch_create_sessions' not in self._inner_api_calls: - self._inner_api_calls['batch_create_sessions'] = google.api_core.gapic_v1.method.wrap_method( + if "batch_create_sessions" not in self._inner_api_calls: + self._inner_api_calls[ + "batch_create_sessions" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.batch_create_sessions, - default_retry=self._method_configs['BatchCreateSessions'].retry, - default_timeout=self._method_configs['BatchCreateSessions'].timeout, + default_retry=self._method_configs["BatchCreateSessions"].retry, + default_timeout=self._method_configs["BatchCreateSessions"].timeout, client_info=self._client_info, ) @@ -370,21 +383,26 @@ def batch_create_sessions( metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['batch_create_sessions'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["batch_create_sessions"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def get_session( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Gets a session. Returns ``NOT_FOUND`` if the session does not exist. This is mainly useful for determining whether a session is still alive. @@ -420,38 +438,43 @@ def get_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'get_session' not in self._inner_api_calls: - self._inner_api_calls['get_session'] = google.api_core.gapic_v1.method.wrap_method( + if "get_session" not in self._inner_api_calls: + self._inner_api_calls[ + "get_session" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.get_session, - default_retry=self._method_configs['GetSession'].retry, - default_timeout=self._method_configs['GetSession'].timeout, + default_retry=self._method_configs["GetSession"].retry, + default_timeout=self._method_configs["GetSession"].timeout, client_info=self._client_info, ) - request = spanner_pb2.GetSessionRequest( - name=name, - ) + request = spanner_pb2.GetSessionRequest(name=name) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('name', name)] + routing_header = [("name", name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['get_session'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["get_session"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def list_sessions( - self, - database, - page_size=None, - filter_=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + database, + page_size=None, + filter_=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Lists all sessions in a given database. @@ -516,46 +539,54 @@ def list_sessions( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'list_sessions' not in self._inner_api_calls: - self._inner_api_calls['list_sessions'] = google.api_core.gapic_v1.method.wrap_method( + if "list_sessions" not in self._inner_api_calls: + self._inner_api_calls[ + "list_sessions" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.list_sessions, - default_retry=self._method_configs['ListSessions'].retry, - default_timeout=self._method_configs['ListSessions'].timeout, + default_retry=self._method_configs["ListSessions"].retry, + default_timeout=self._method_configs["ListSessions"].timeout, client_info=self._client_info, ) request = spanner_pb2.ListSessionsRequest( - database=database, - page_size=page_size, - filter=filter_, + database=database, page_size=page_size, filter=filter_ ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('database', database)] + routing_header = [("database", database)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) iterator = google.api_core.page_iterator.GRPCIterator( client=None, - method=functools.partial(self._inner_api_calls['list_sessions'], retry=retry, timeout=timeout, metadata=metadata), + method=functools.partial( + self._inner_api_calls["list_sessions"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), request=request, - items_field='sessions', - request_token_field='page_token', - response_token_field='next_page_token', + items_field="sessions", + request_token_field="page_token", + response_token_field="next_page_token", ) return iterator def delete_session( - self, - name, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + name, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Ends a session, releasing server resources associated with it. This will asynchronously trigger cancellation of any operations that are running with @@ -589,45 +620,50 @@ def delete_session( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'delete_session' not in self._inner_api_calls: - self._inner_api_calls['delete_session'] = google.api_core.gapic_v1.method.wrap_method( + if "delete_session" not in self._inner_api_calls: + self._inner_api_calls[ + "delete_session" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.delete_session, - default_retry=self._method_configs['DeleteSession'].retry, - default_timeout=self._method_configs['DeleteSession'].timeout, + default_retry=self._method_configs["DeleteSession"].retry, + default_timeout=self._method_configs["DeleteSession"].timeout, client_info=self._client_info, ) - request = spanner_pb2.DeleteSessionRequest( - name=name, - ) + request = spanner_pb2.DeleteSessionRequest(name=name) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('name', name)] + routing_header = [("name", name)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - self._inner_api_calls['delete_session'](request, retry=retry, timeout=timeout, metadata=metadata) + self._inner_api_calls["delete_session"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def execute_sql( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - resume_token=None, - query_mode=None, - partition_token=None, - seqno=None, - query_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + resume_token=None, + query_mode=None, + partition_token=None, + seqno=None, + query_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + 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 @@ -742,11 +778,13 @@ def execute_sql( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'execute_sql' not in self._inner_api_calls: - self._inner_api_calls['execute_sql'] = google.api_core.gapic_v1.method.wrap_method( + if "execute_sql" not in self._inner_api_calls: + self._inner_api_calls[ + "execute_sql" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_sql, - default_retry=self._method_configs['ExecuteSql'].retry, - default_timeout=self._method_configs['ExecuteSql'].timeout, + default_retry=self._method_configs["ExecuteSql"].retry, + default_timeout=self._method_configs["ExecuteSql"].timeout, client_info=self._client_info, ) @@ -766,30 +804,35 @@ def execute_sql( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['execute_sql'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["execute_sql"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def execute_streaming_sql( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - resume_token=None, - query_mode=None, - partition_token=None, - seqno=None, - query_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + resume_token=None, + query_mode=None, + partition_token=None, + seqno=None, + query_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Like ``ExecuteSql``, except returns the result set as a stream. Unlike ``ExecuteSql``, there is no limit on the size of the returned @@ -899,11 +942,13 @@ def execute_streaming_sql( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'execute_streaming_sql' not in self._inner_api_calls: - self._inner_api_calls['execute_streaming_sql'] = google.api_core.gapic_v1.method.wrap_method( + if "execute_streaming_sql" not in self._inner_api_calls: + self._inner_api_calls[ + "execute_streaming_sql" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_streaming_sql, - default_retry=self._method_configs['ExecuteStreamingSql'].retry, - default_timeout=self._method_configs['ExecuteStreamingSql'].timeout, + default_retry=self._method_configs["ExecuteStreamingSql"].retry, + default_timeout=self._method_configs["ExecuteStreamingSql"].timeout, client_info=self._client_info, ) @@ -923,24 +968,29 @@ def execute_streaming_sql( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['execute_streaming_sql'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["execute_streaming_sql"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def execute_batch_dml( - self, - session, - transaction, - statements, - seqno, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + transaction, + statements, + seqno, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Executes a batch of SQL DML statements. This method allows many statements to be run with lower latency than submitting them @@ -1020,47 +1070,51 @@ def execute_batch_dml( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'execute_batch_dml' not in self._inner_api_calls: - self._inner_api_calls['execute_batch_dml'] = google.api_core.gapic_v1.method.wrap_method( + if "execute_batch_dml" not in self._inner_api_calls: + self._inner_api_calls[ + "execute_batch_dml" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.execute_batch_dml, - default_retry=self._method_configs['ExecuteBatchDml'].retry, - default_timeout=self._method_configs['ExecuteBatchDml'].timeout, + default_retry=self._method_configs["ExecuteBatchDml"].retry, + default_timeout=self._method_configs["ExecuteBatchDml"].timeout, client_info=self._client_info, ) request = spanner_pb2.ExecuteBatchDmlRequest( - session=session, - transaction=transaction, - statements=statements, - seqno=seqno, + session=session, transaction=transaction, statements=statements, seqno=seqno ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['execute_batch_dml'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["execute_batch_dml"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def read( - self, - session, - table, - columns, - key_set, - transaction=None, - index=None, - limit=None, - resume_token=None, - partition_token=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + table, + columns, + key_set, + transaction=None, + index=None, + limit=None, + resume_token=None, + partition_token=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ``ExecuteSql``. This method cannot @@ -1153,11 +1207,11 @@ def read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'read' not in self._inner_api_calls: - self._inner_api_calls['read'] = google.api_core.gapic_v1.method.wrap_method( + if "read" not in self._inner_api_calls: + self._inner_api_calls["read"] = google.api_core.gapic_v1.method.wrap_method( self.transport.read, - default_retry=self._method_configs['Read'].retry, - default_timeout=self._method_configs['Read'].timeout, + default_retry=self._method_configs["Read"].retry, + default_timeout=self._method_configs["Read"].timeout, client_info=self._client_info, ) @@ -1176,29 +1230,34 @@ def read( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['read'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["read"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def streaming_read( - self, - session, - table, - columns, - key_set, - transaction=None, - index=None, - limit=None, - resume_token=None, - partition_token=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + table, + columns, + key_set, + transaction=None, + index=None, + limit=None, + resume_token=None, + partition_token=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Like ``Read``, except returns the result set as a stream. Unlike ``Read``, there is no limit on the size of the returned result set. @@ -1285,11 +1344,13 @@ def streaming_read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'streaming_read' not in self._inner_api_calls: - self._inner_api_calls['streaming_read'] = google.api_core.gapic_v1.method.wrap_method( + if "streaming_read" not in self._inner_api_calls: + self._inner_api_calls[ + "streaming_read" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.streaming_read, - default_retry=self._method_configs['StreamingRead'].retry, - default_timeout=self._method_configs['StreamingRead'].timeout, + default_retry=self._method_configs["StreamingRead"].retry, + default_timeout=self._method_configs["StreamingRead"].timeout, client_info=self._client_info, ) @@ -1308,22 +1369,27 @@ def streaming_read( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['streaming_read'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["streaming_read"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def begin_transaction( - self, - session, - options_, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + options_, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Begins a new transaction. This step can often be skipped: ``Read``, ``ExecuteSql`` and ``Commit`` can begin a new transaction as a @@ -1367,40 +1433,44 @@ def begin_transaction( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'begin_transaction' not in self._inner_api_calls: - self._inner_api_calls['begin_transaction'] = google.api_core.gapic_v1.method.wrap_method( + if "begin_transaction" not in self._inner_api_calls: + self._inner_api_calls[ + "begin_transaction" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.begin_transaction, - default_retry=self._method_configs['BeginTransaction'].retry, - default_timeout=self._method_configs['BeginTransaction'].timeout, + default_retry=self._method_configs["BeginTransaction"].retry, + default_timeout=self._method_configs["BeginTransaction"].timeout, client_info=self._client_info, ) - request = spanner_pb2.BeginTransactionRequest( - session=session, - options=options_, - ) + request = spanner_pb2.BeginTransactionRequest(session=session, options=options_) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['begin_transaction'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["begin_transaction"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def commit( - self, - session, - transaction_id=None, - single_use_transaction=None, - mutations=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + transaction_id=None, + single_use_transaction=None, + mutations=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Commits a transaction. The request includes the mutations to be applied to rows in the database. @@ -1459,19 +1529,20 @@ def commit( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'commit' not in self._inner_api_calls: - self._inner_api_calls['commit'] = google.api_core.gapic_v1.method.wrap_method( + if "commit" not in self._inner_api_calls: + self._inner_api_calls[ + "commit" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.commit, - default_retry=self._method_configs['Commit'].retry, - default_timeout=self._method_configs['Commit'].timeout, + default_retry=self._method_configs["Commit"].retry, + default_timeout=self._method_configs["Commit"].timeout, client_info=self._client_info, ) # Sanity check: We have some fields which are mutually exclusive; # raise ValueError if more than one is sent. google.api_core.protobuf_helpers.check_oneof( - transaction_id=transaction_id, - single_use_transaction=single_use_transaction, + transaction_id=transaction_id, single_use_transaction=single_use_transaction ) request = spanner_pb2.CommitRequest( @@ -1484,22 +1555,27 @@ def commit( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['commit'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["commit"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def rollback( - self, - session, - transaction_id, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + transaction_id, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Rolls back a transaction, releasing any locks it holds. It is a good idea to call this for any transaction that includes one or more ``Read`` @@ -1541,42 +1617,48 @@ def rollback( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'rollback' not in self._inner_api_calls: - self._inner_api_calls['rollback'] = google.api_core.gapic_v1.method.wrap_method( + if "rollback" not in self._inner_api_calls: + self._inner_api_calls[ + "rollback" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.rollback, - default_retry=self._method_configs['Rollback'].retry, - default_timeout=self._method_configs['Rollback'].timeout, + default_retry=self._method_configs["Rollback"].retry, + default_timeout=self._method_configs["Rollback"].timeout, client_info=self._client_info, ) request = spanner_pb2.RollbackRequest( - session=session, - transaction_id=transaction_id, + session=session, transaction_id=transaction_id ) if metadata is None: metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - self._inner_api_calls['rollback'](request, retry=retry, timeout=timeout, metadata=metadata) + self._inner_api_calls["rollback"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def partition_query( - self, - session, - sql, - transaction=None, - params=None, - param_types=None, - partition_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + sql, + transaction=None, + params=None, + param_types=None, + partition_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + 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 @@ -1669,11 +1751,13 @@ def partition_query( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'partition_query' not in self._inner_api_calls: - self._inner_api_calls['partition_query'] = google.api_core.gapic_v1.method.wrap_method( + if "partition_query" not in self._inner_api_calls: + self._inner_api_calls[ + "partition_query" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.partition_query, - default_retry=self._method_configs['PartitionQuery'].retry, - default_timeout=self._method_configs['PartitionQuery'].timeout, + default_retry=self._method_configs["PartitionQuery"].retry, + default_timeout=self._method_configs["PartitionQuery"].timeout, client_info=self._client_info, ) @@ -1689,27 +1773,32 @@ def partition_query( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['partition_query'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["partition_query"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) def partition_read( - self, - session, - table, - key_set, - transaction=None, - index=None, - columns=None, - partition_options=None, - retry=google.api_core.gapic_v1.method.DEFAULT, - timeout=google.api_core.gapic_v1.method.DEFAULT, - metadata=None): + self, + session, + table, + key_set, + transaction=None, + index=None, + columns=None, + partition_options=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): """ Creates a set of partition tokens that can be used to execute a read operation in parallel. Each of the returned partition tokens can be used @@ -1787,11 +1876,13 @@ def partition_read( ValueError: If the parameters are invalid. """ # Wrap the transport method to add retry and timeout logic. - if 'partition_read' not in self._inner_api_calls: - self._inner_api_calls['partition_read'] = google.api_core.gapic_v1.method.wrap_method( + if "partition_read" not in self._inner_api_calls: + self._inner_api_calls[ + "partition_read" + ] = google.api_core.gapic_v1.method.wrap_method( self.transport.partition_read, - default_retry=self._method_configs['PartitionRead'].retry, - default_timeout=self._method_configs['PartitionRead'].timeout, + default_retry=self._method_configs["PartitionRead"].retry, + default_timeout=self._method_configs["PartitionRead"].timeout, client_info=self._client_info, ) @@ -1808,11 +1899,15 @@ def partition_read( metadata = [] metadata = list(metadata) try: - routing_header = [('session', session)] + routing_header = [("session", session)] except AttributeError: pass else: - routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata(routing_header) + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) metadata.append(routing_metadata) - return self._inner_api_calls['partition_read'](request, retry=retry, timeout=timeout, metadata=metadata) + return self._inner_api_calls["partition_read"]( + request, retry=retry, timeout=timeout, metadata=metadata + ) diff --git a/google/cloud/spanner_v1/gapic/spanner_client_config.py b/google/cloud/spanner_v1/gapic/spanner_client_config.py index ca2d1856ba..458ea6d731 100644 --- a/google/cloud/spanner_v1/gapic/spanner_client_config.py +++ b/google/cloud/spanner_v1/gapic/spanner_client_config.py @@ -1,143 +1,137 @@ config = { - "interfaces": { - "google.spanner.v1.Spanner": { - "retry_codes": { - "retry_policy_1_codes": [ - "UNAVAILABLE" - ], - "no_retry_codes": [], - "retry_policy_3_codes": [ - "UNAVAILABLE" - ], - "retry_policy_2_codes": [ - "UNAVAILABLE" - ], - "no_retry_1_codes": [] - }, - "retry_params": { - "retry_policy_1_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000 - }, - "retry_policy_3_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 30000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 30000, - "total_timeout_millis": 30000 - }, - "retry_policy_2_params": { - "initial_retry_delay_millis": 250, - "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 32000, - "initial_rpc_timeout_millis": 60000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 60000, - "total_timeout_millis": 60000 - }, - "no_retry_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 0, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 0, - "total_timeout_millis": 0 - }, - "no_retry_1_params": { - "initial_retry_delay_millis": 0, - "retry_delay_multiplier": 0.0, - "max_retry_delay_millis": 0, - "initial_rpc_timeout_millis": 3600000, - "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 3600000, - "total_timeout_millis": 3600000 + "interfaces": { + "google.spanner.v1.Spanner": { + "retry_codes": { + "retry_policy_1_codes": ["UNAVAILABLE"], + "no_retry_codes": [], + "retry_policy_3_codes": ["UNAVAILABLE"], + "retry_policy_2_codes": ["UNAVAILABLE"], + "no_retry_1_codes": [], + }, + "retry_params": { + "retry_policy_1_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000, + }, + "retry_policy_3_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 30000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 30000, + "total_timeout_millis": 30000, + }, + "retry_policy_2_params": { + "initial_retry_delay_millis": 250, + "retry_delay_multiplier": 1.3, + "max_retry_delay_millis": 32000, + "initial_rpc_timeout_millis": 60000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 60000, + "total_timeout_millis": 60000, + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0, + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 3600000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 3600000, + "total_timeout_millis": 3600000, + }, + }, + "methods": { + "CreateSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "BatchCreateSessions": { + "timeout_millis": 60000, + "retry_codes_name": "retry_policy_2_codes", + "retry_params_name": "retry_policy_2_params", + }, + "GetSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "ListSessions": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "DeleteSession": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "ExecuteSql": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "ExecuteStreamingSql": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", + }, + "ExecuteBatchDml": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "Read": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "StreamingRead": { + "timeout_millis": 3600000, + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", + }, + "BeginTransaction": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "Commit": { + "timeout_millis": 3600000, + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", + }, + "Rollback": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "PartitionQuery": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + "PartitionRead": { + "timeout_millis": 30000, + "retry_codes_name": "retry_policy_3_codes", + "retry_params_name": "retry_policy_3_params", + }, + }, } - }, - "methods": { - "CreateSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "BatchCreateSessions": { - "timeout_millis": 60000, - "retry_codes_name": "retry_policy_2_codes", - "retry_params_name": "retry_policy_2_params" - }, - "GetSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "ListSessions": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "DeleteSession": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "ExecuteSql": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "ExecuteStreamingSql": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params" - }, - "ExecuteBatchDml": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "Read": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "StreamingRead": { - "timeout_millis": 3600000, - "retry_codes_name": "no_retry_1_codes", - "retry_params_name": "no_retry_1_params" - }, - "BeginTransaction": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "Commit": { - "timeout_millis": 3600000, - "retry_codes_name": "retry_policy_1_codes", - "retry_params_name": "retry_policy_1_params" - }, - "Rollback": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "PartitionQuery": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - }, - "PartitionRead": { - "timeout_millis": 30000, - "retry_codes_name": "retry_policy_3_codes", - "retry_params_name": "retry_policy_3_params" - } - } } - } } 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 0c4af899db..7cb2cb2ef2 100644 --- a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py +++ b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py @@ -24,7 +24,7 @@ _GRPC_KEEPALIVE_MS = 2 * 60 * 1000 -_SPANNER_GRPC_CONFIG = 'spanner.grpc.config' +_SPANNER_GRPC_CONFIG = "spanner.grpc.config" class SpannerGrpcTransport(object): @@ -35,15 +35,17 @@ class SpannerGrpcTransport(object): which can be used to take advantage of advanced features of gRPC. """ + # The scopes needed to make gRPC calls to all of the methods defined # in this service. _OAUTH_SCOPES = ( - 'https://www.googleapis.com/auth/cloud-platform', - 'https://www.googleapis.com/auth/spanner.data', + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/spanner.data", ) - def __init__(self, channel=None, credentials=None, - address='spanner.googleapis.com:443'): + def __init__( + self, channel=None, credentials=None, address="spanner.googleapis.com:443" + ): """Instantiate the transport class. Args: @@ -61,8 +63,7 @@ def __init__(self, channel=None, credentials=None, # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - 'The `channel` and `credentials` arguments are mutually ' - 'exclusive.', + "The `channel` and `credentials` arguments are mutually " "exclusive." ) # Create the channel. @@ -71,8 +72,8 @@ def __init__(self, channel=None, credentials=None, address=address, credentials=credentials, options={ - 'grpc.max_send_message_length': -1, - 'grpc.max_receive_message_length': -1, + "grpc.max_send_message_length": -1, + "grpc.max_receive_message_length": -1, "grpc.keepalive_time_ms": _GRPC_KEEPALIVE_MS, }.items(), ) @@ -81,17 +82,12 @@ def __init__(self, channel=None, credentials=None, # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. - self._stubs = { - 'spanner_stub': spanner_pb2_grpc.SpannerStub(channel), - } - + self._stubs = {"spanner_stub": spanner_pb2_grpc.SpannerStub(channel)} @classmethod def create_channel( - cls, - address='spanner.googleapis.com:443', - credentials=None, - **kwargs): + cls, address="spanner.googleapis.com:443", credentials=None, **kwargs + ): """Create and return a gRPC channel object. Args: @@ -108,16 +104,14 @@ def create_channel( grpc.Channel: A gRPC channel object. """ grpc_gcp_config = grpc_gcp.api_config_from_text_pb( - pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG)) + pkg_resources.resource_string(__name__, _SPANNER_GRPC_CONFIG) + ) options = [(grpc_gcp.API_CONFIG_CHANNEL_ARG, grpc_gcp_config)] - if 'options' in kwargs: - options.extend(kwargs['options']) - kwargs['options'] = options + if "options" in kwargs: + options.extend(kwargs["options"]) + kwargs["options"] = options return google.api_core.grpc_helpers.create_channel( - address, - credentials=credentials, - scopes=cls._OAUTH_SCOPES, - **kwargs + address, credentials=credentials, scopes=cls._OAUTH_SCOPES, **kwargs ) @property @@ -156,7 +150,7 @@ def create_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].CreateSession + return self._stubs["spanner_stub"].CreateSession @property def batch_create_sessions(self): @@ -172,7 +166,7 @@ def batch_create_sessions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].BatchCreateSessions + return self._stubs["spanner_stub"].BatchCreateSessions @property def get_session(self): @@ -186,7 +180,7 @@ def get_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].GetSession + return self._stubs["spanner_stub"].GetSession @property def list_sessions(self): @@ -199,7 +193,7 @@ def list_sessions(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].ListSessions + return self._stubs["spanner_stub"].ListSessions @property def delete_session(self): @@ -214,7 +208,7 @@ def delete_session(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].DeleteSession + return self._stubs["spanner_stub"].DeleteSession @property def execute_sql(self): @@ -237,7 +231,7 @@ def execute_sql(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].ExecuteSql + return self._stubs["spanner_stub"].ExecuteSql @property def execute_streaming_sql(self): @@ -253,7 +247,7 @@ def execute_streaming_sql(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].ExecuteStreamingSql + return self._stubs["spanner_stub"].ExecuteStreamingSql @property def execute_batch_dml(self): @@ -276,7 +270,7 @@ def execute_batch_dml(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].ExecuteBatchDml + return self._stubs["spanner_stub"].ExecuteBatchDml @property def read(self): @@ -300,7 +294,7 @@ def read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].Read + return self._stubs["spanner_stub"].Read @property def streaming_read(self): @@ -316,7 +310,7 @@ def streaming_read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].StreamingRead + return self._stubs["spanner_stub"].StreamingRead @property def begin_transaction(self): @@ -331,7 +325,7 @@ def begin_transaction(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].BeginTransaction + return self._stubs["spanner_stub"].BeginTransaction @property def commit(self): @@ -351,7 +345,7 @@ def commit(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].Commit + return self._stubs["spanner_stub"].Commit @property def rollback(self): @@ -370,7 +364,7 @@ def rollback(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].Rollback + return self._stubs["spanner_stub"].Rollback @property def partition_query(self): @@ -393,7 +387,7 @@ def partition_query(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].PartitionQuery + return self._stubs["spanner_stub"].PartitionQuery @property def partition_read(self): @@ -418,4 +412,4 @@ def partition_read(self): deserialized request object and returns a deserialized response object. """ - return self._stubs['spanner_stub'].PartitionRead \ No newline at end of file + return self._stubs["spanner_stub"].PartitionRead diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index edee917819..0f0dba9787 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -6,6 +6,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -16,153 +17,263 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1', - create_key=_descriptor._internal_create_key, - 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\xaf\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' - , - dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) - - + 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\352\002\032Google::Cloud::Spanner::V1", + create_key=_descriptor._internal_create_key, + 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\xaf\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', + dependencies=[ + google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _KEYRANGE = _descriptor.Descriptor( - name='KeyRange', - full_name='google.spanner.v1.KeyRange', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='start_closed', full_name='google.spanner.v1.KeyRange.start_closed', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='start_open', full_name='google.spanner.v1.KeyRange.start_open', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='end_closed', full_name='google.spanner.v1.KeyRange.end_closed', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='end_open', full_name='google.spanner.v1.KeyRange.end_open', index=3, - number=4, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name='start_key_type', full_name='google.spanner.v1.KeyRange.start_key_type', - index=0, containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[]), - _descriptor.OneofDescriptor( - name='end_key_type', full_name='google.spanner.v1.KeyRange.end_key_type', - index=1, containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[]), - ], - serialized_start=124, - serialized_end=368, + name="KeyRange", + full_name="google.spanner.v1.KeyRange", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="start_closed", + full_name="google.spanner.v1.KeyRange.start_closed", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="start_open", + full_name="google.spanner.v1.KeyRange.start_open", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="end_closed", + full_name="google.spanner.v1.KeyRange.end_closed", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="end_open", + full_name="google.spanner.v1.KeyRange.end_open", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="start_key_type", + full_name="google.spanner.v1.KeyRange.start_key_type", + index=0, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[], + ), + _descriptor.OneofDescriptor( + name="end_key_type", + full_name="google.spanner.v1.KeyRange.end_key_type", + index=1, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[], + ), + ], + serialized_start=124, + serialized_end=368, ) _KEYSET = _descriptor.Descriptor( - name='KeySet', - full_name='google.spanner.v1.KeySet', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='keys', full_name='google.spanner.v1.KeySet.keys', index=0, - number=1, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='ranges', full_name='google.spanner.v1.KeySet.ranges', index=1, - number=2, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='all', full_name='google.spanner.v1.KeySet.all', index=2, - number=3, type=8, cpp_type=7, label=1, - has_default_value=False, default_value=False, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=370, - serialized_end=478, + name="KeySet", + full_name="google.spanner.v1.KeySet", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="keys", + full_name="google.spanner.v1.KeySet.keys", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="ranges", + full_name="google.spanner.v1.KeySet.ranges", + index=1, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="all", + full_name="google.spanner.v1.KeySet.all", + index=2, + number=3, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=370, + serialized_end=478, ) -_KEYRANGE.fields_by_name['start_closed'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name['start_open'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name['end_closed'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.fields_by_name['end_open'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYRANGE.oneofs_by_name['start_key_type'].fields.append( - _KEYRANGE.fields_by_name['start_closed']) -_KEYRANGE.fields_by_name['start_closed'].containing_oneof = _KEYRANGE.oneofs_by_name['start_key_type'] -_KEYRANGE.oneofs_by_name['start_key_type'].fields.append( - _KEYRANGE.fields_by_name['start_open']) -_KEYRANGE.fields_by_name['start_open'].containing_oneof = _KEYRANGE.oneofs_by_name['start_key_type'] -_KEYRANGE.oneofs_by_name['end_key_type'].fields.append( - _KEYRANGE.fields_by_name['end_closed']) -_KEYRANGE.fields_by_name['end_closed'].containing_oneof = _KEYRANGE.oneofs_by_name['end_key_type'] -_KEYRANGE.oneofs_by_name['end_key_type'].fields.append( - _KEYRANGE.fields_by_name['end_open']) -_KEYRANGE.fields_by_name['end_open'].containing_oneof = _KEYRANGE.oneofs_by_name['end_key_type'] -_KEYSET.fields_by_name['keys'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_KEYSET.fields_by_name['ranges'].message_type = _KEYRANGE -DESCRIPTOR.message_types_by_name['KeyRange'] = _KEYRANGE -DESCRIPTOR.message_types_by_name['KeySet'] = _KEYSET +_KEYRANGE.fields_by_name[ + "start_closed" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name[ + "start_open" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name[ + "end_closed" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.fields_by_name[ + "end_open" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYRANGE.oneofs_by_name["start_key_type"].fields.append( + _KEYRANGE.fields_by_name["start_closed"] +) +_KEYRANGE.fields_by_name["start_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[ + "start_key_type" +] +_KEYRANGE.oneofs_by_name["start_key_type"].fields.append( + _KEYRANGE.fields_by_name["start_open"] +) +_KEYRANGE.fields_by_name["start_open"].containing_oneof = _KEYRANGE.oneofs_by_name[ + "start_key_type" +] +_KEYRANGE.oneofs_by_name["end_key_type"].fields.append( + _KEYRANGE.fields_by_name["end_closed"] +) +_KEYRANGE.fields_by_name["end_closed"].containing_oneof = _KEYRANGE.oneofs_by_name[ + "end_key_type" +] +_KEYRANGE.oneofs_by_name["end_key_type"].fields.append( + _KEYRANGE.fields_by_name["end_open"] +) +_KEYRANGE.fields_by_name["end_open"].containing_oneof = _KEYRANGE.oneofs_by_name[ + "end_key_type" +] +_KEYSET.fields_by_name[ + "keys" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_KEYSET.fields_by_name["ranges"].message_type = _KEYRANGE +DESCRIPTOR.message_types_by_name["KeyRange"] = _KEYRANGE +DESCRIPTOR.message_types_by_name["KeySet"] = _KEYSET _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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. A range has +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. 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. Keys are represented by lists, where the ith value in the list corresponds to @@ -225,15 +336,18 @@ If the end is open, then the range excludes rows whose first ``len(end_open)`` key columns exactly match ``end_open``. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.KeyRange) - }) + # @@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 +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. If the same key is specified multiple times in the set (for example if two ranges, two @@ -257,8 +371,9 @@ Note that any keys specified in ``keys`` or ``ranges`` are only yielded once. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) - }) + # @@protoc_insertion_point(class_scope:google.spanner.v1.KeySet) + }, +) _sym_db.RegisterMessage(KeySet) diff --git a/google/cloud/spanner_v1/proto/keys_pb2_grpc.py b/google/cloud/spanner_v1/proto/keys_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/keys_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - diff --git a/google/cloud/spanner_v1/proto/mutation_pb2.py b/google/cloud/spanner_v1/proto/mutation_pb2.py index 6c79c6f2d1..4719d77a50 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2.py @@ -6,210 +6,345 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 -from google.cloud.spanner_v1.proto import keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2 +from google.cloud.spanner_v1.proto import ( + keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2, +) from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1', - create_key=_descriptor._internal_create_key, - 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\xb3\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' - , - dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) - - + 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\352\002\032Google::Cloud::Spanner::V1", + create_key=_descriptor._internal_create_key, + 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\xb3\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', + dependencies=[ + google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _MUTATION_WRITE = _descriptor.Descriptor( - name='Write', - full_name='google.spanner.v1.Mutation.Write', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='table', full_name='google.spanner.v1.Mutation.Write.table', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='columns', full_name='google.spanner.v1.Mutation.Write.columns', index=1, - number=2, type=9, cpp_type=9, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='values', full_name='google.spanner.v1.Mutation.Write.values', index=2, - number=3, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=459, - serialized_end=542, + name="Write", + full_name="google.spanner.v1.Mutation.Write", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="table", + full_name="google.spanner.v1.Mutation.Write.table", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="columns", + full_name="google.spanner.v1.Mutation.Write.columns", + index=1, + number=2, + type=9, + cpp_type=9, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="values", + full_name="google.spanner.v1.Mutation.Write.values", + index=2, + number=3, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=459, + serialized_end=542, ) _MUTATION_DELETE = _descriptor.Descriptor( - name='Delete', - full_name='google.spanner.v1.Mutation.Delete', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='table', full_name='google.spanner.v1.Mutation.Delete.table', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='key_set', full_name='google.spanner.v1.Mutation.Delete.key_set', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=544, - serialized_end=611, + name="Delete", + full_name="google.spanner.v1.Mutation.Delete", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="table", + full_name="google.spanner.v1.Mutation.Delete.table", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="key_set", + full_name="google.spanner.v1.Mutation.Delete.key_set", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=544, + serialized_end=611, ) _MUTATION = _descriptor.Descriptor( - name='Mutation', - full_name='google.spanner.v1.Mutation', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='insert', full_name='google.spanner.v1.Mutation.insert', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='update', full_name='google.spanner.v1.Mutation.update', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='insert_or_update', full_name='google.spanner.v1.Mutation.insert_or_update', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='replace', full_name='google.spanner.v1.Mutation.replace', index=3, - number=4, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='delete', full_name='google.spanner.v1.Mutation.delete', index=4, - number=5, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[_MUTATION_WRITE, _MUTATION_DELETE, ], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name='operation', full_name='google.spanner.v1.Mutation.operation', - index=0, containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[]), - ], - serialized_start=170, - serialized_end=624, + name="Mutation", + full_name="google.spanner.v1.Mutation", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="insert", + full_name="google.spanner.v1.Mutation.insert", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="update", + full_name="google.spanner.v1.Mutation.update", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="insert_or_update", + full_name="google.spanner.v1.Mutation.insert_or_update", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="replace", + full_name="google.spanner.v1.Mutation.replace", + index=3, + number=4, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="delete", + full_name="google.spanner.v1.Mutation.delete", + index=4, + number=5, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[_MUTATION_WRITE, _MUTATION_DELETE], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="operation", + full_name="google.spanner.v1.Mutation.operation", + index=0, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[], + ) + ], + serialized_start=170, + serialized_end=624, ) -_MUTATION_WRITE.fields_by_name['values'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_MUTATION_WRITE.fields_by_name[ + "values" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE _MUTATION_WRITE.containing_type = _MUTATION -_MUTATION_DELETE.fields_by_name['key_set'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET +_MUTATION_DELETE.fields_by_name[ + "key_set" +].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2._KEYSET _MUTATION_DELETE.containing_type = _MUTATION -_MUTATION.fields_by_name['insert'].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name['update'].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name['insert_or_update'].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name['replace'].message_type = _MUTATION_WRITE -_MUTATION.fields_by_name['delete'].message_type = _MUTATION_DELETE -_MUTATION.oneofs_by_name['operation'].fields.append( - _MUTATION.fields_by_name['insert']) -_MUTATION.fields_by_name['insert'].containing_oneof = _MUTATION.oneofs_by_name['operation'] -_MUTATION.oneofs_by_name['operation'].fields.append( - _MUTATION.fields_by_name['update']) -_MUTATION.fields_by_name['update'].containing_oneof = _MUTATION.oneofs_by_name['operation'] -_MUTATION.oneofs_by_name['operation'].fields.append( - _MUTATION.fields_by_name['insert_or_update']) -_MUTATION.fields_by_name['insert_or_update'].containing_oneof = _MUTATION.oneofs_by_name['operation'] -_MUTATION.oneofs_by_name['operation'].fields.append( - _MUTATION.fields_by_name['replace']) -_MUTATION.fields_by_name['replace'].containing_oneof = _MUTATION.oneofs_by_name['operation'] -_MUTATION.oneofs_by_name['operation'].fields.append( - _MUTATION.fields_by_name['delete']) -_MUTATION.fields_by_name['delete'].containing_oneof = _MUTATION.oneofs_by_name['operation'] -DESCRIPTOR.message_types_by_name['Mutation'] = _MUTATION +_MUTATION.fields_by_name["insert"].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name["update"].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name["insert_or_update"].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name["replace"].message_type = _MUTATION_WRITE +_MUTATION.fields_by_name["delete"].message_type = _MUTATION_DELETE +_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["insert"]) +_MUTATION.fields_by_name["insert"].containing_oneof = _MUTATION.oneofs_by_name[ + "operation" +] +_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["update"]) +_MUTATION.fields_by_name["update"].containing_oneof = _MUTATION.oneofs_by_name[ + "operation" +] +_MUTATION.oneofs_by_name["operation"].fields.append( + _MUTATION.fields_by_name["insert_or_update"] +) +_MUTATION.fields_by_name[ + "insert_or_update" +].containing_oneof = _MUTATION.oneofs_by_name["operation"] +_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["replace"]) +_MUTATION.fields_by_name["replace"].containing_oneof = _MUTATION.oneofs_by_name[ + "operation" +] +_MUTATION.oneofs_by_name["operation"].fields.append(_MUTATION.fields_by_name["delete"]) +_MUTATION.fields_by_name["delete"].containing_oneof = _MUTATION.oneofs_by_name[ + "operation" +] +DESCRIPTOR.message_types_by_name["Mutation"] = _MUTATION _sym_db.RegisterFileDescriptor(DESCRIPTOR) -Mutation = _reflection.GeneratedProtocolMessageType('Mutation', (_message.Message,), { - - '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], +Mutation = _reflection.GeneratedProtocolMessageType( + "Mutation", + (_message.Message,), + { + "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], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and [replace][google.spanner.v1.Mutation.replace] operations. @@ -236,15 +371,16 @@ Individual values in each list are encoded as described [here][google.spanner.v1.TypeCode]. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) - }) - , - - '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] operations. + # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Write) + }, + ), + "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] operations. Attributes: table: @@ -258,13 +394,12 @@ 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. Mutations can be + # @@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. Mutations can be applied to a Cloud Spanner database by sending them in a [Commit][google.spanner.v1.Spanner.Commit] call. @@ -301,8 +436,9 @@ Delete rows from a table. Succeeds whether or not the named rows were present. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) - }) + # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation) + }, +) _sym_db.RegisterMessage(Mutation) _sym_db.RegisterMessage(Mutation.Write) _sym_db.RegisterMessage(Mutation.Delete) diff --git a/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py b/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/mutation_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2.py b/google/cloud/spanner_v1/proto/query_plan_pb2.py index 462ddd326e..747fe73e93 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2.py @@ -6,6 +6,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -16,297 +17,486 @@ DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1', - create_key=_descriptor._internal_create_key, - 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\xb4\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3' - , - dependencies=[google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) - + 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\352\002\032Google::Cloud::Spanner::V1", + create_key=_descriptor._internal_create_key, + 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\xb4\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\\V1\xea\x02\x1aGoogle::Cloud::Spanner::V1b\x06proto3', + dependencies=[ + google_dot_protobuf_dot_struct__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _PLANNODE_KIND = _descriptor.EnumDescriptor( - name='Kind', - full_name='google.spanner.v1.PlanNode.Kind', - filename=None, - file=DESCRIPTOR, - create_key=_descriptor._internal_create_key, - values=[ - _descriptor.EnumValueDescriptor( - name='KIND_UNSPECIFIED', index=0, number=0, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='RELATIONAL', index=1, number=1, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - _descriptor.EnumValueDescriptor( - name='SCALAR', index=2, number=2, - serialized_options=None, - type=None, - create_key=_descriptor._internal_create_key), - ], - containing_type=None, - serialized_options=None, - serialized_start=706, - serialized_end=762, + name="Kind", + full_name="google.spanner.v1.PlanNode.Kind", + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name="KIND_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="RELATIONAL", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="SCALAR", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=706, + serialized_end=762, ) _sym_db.RegisterEnumDescriptor(_PLANNODE_KIND) _PLANNODE_CHILDLINK = _descriptor.Descriptor( - name='ChildLink', - full_name='google.spanner.v1.PlanNode.ChildLink', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='child_index', full_name='google.spanner.v1.PlanNode.ChildLink.child_index', index=0, - number=1, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='type', full_name='google.spanner.v1.PlanNode.ChildLink.type', index=1, - number=2, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='variable', full_name='google.spanner.v1.PlanNode.ChildLink.variable', index=2, - number=3, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=459, - serialized_end=523, + name="ChildLink", + full_name="google.spanner.v1.PlanNode.ChildLink", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="child_index", + full_name="google.spanner.v1.PlanNode.ChildLink.child_index", + index=0, + number=1, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="type", + full_name="google.spanner.v1.PlanNode.ChildLink.type", + index=1, + number=2, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="variable", + full_name="google.spanner.v1.PlanNode.ChildLink.variable", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=459, + serialized_end=523, ) _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY = _descriptor.Descriptor( - name='SubqueriesEntry', - full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='key', full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.key', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='value', full_name='google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.value', index=1, - number=2, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=b'8\001', - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=655, - serialized_end=704, + name="SubqueriesEntry", + full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="key", + full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.key", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="value", + full_name="google.spanner.v1.PlanNode.ShortRepresentation.SubqueriesEntry.value", + index=1, + number=2, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=b"8\001", + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=655, + serialized_end=704, ) _PLANNODE_SHORTREPRESENTATION = _descriptor.Descriptor( - name='ShortRepresentation', - full_name='google.spanner.v1.PlanNode.ShortRepresentation', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='description', full_name='google.spanner.v1.PlanNode.ShortRepresentation.description', index=0, - number=1, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='subqueries', full_name='google.spanner.v1.PlanNode.ShortRepresentation.subqueries', index=1, - number=2, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY, ], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=526, - serialized_end=704, + name="ShortRepresentation", + full_name="google.spanner.v1.PlanNode.ShortRepresentation", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="description", + full_name="google.spanner.v1.PlanNode.ShortRepresentation.description", + index=0, + number=1, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="subqueries", + full_name="google.spanner.v1.PlanNode.ShortRepresentation.subqueries", + index=1, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=526, + serialized_end=704, ) _PLANNODE = _descriptor.Descriptor( - name='PlanNode', - full_name='google.spanner.v1.PlanNode', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='index', full_name='google.spanner.v1.PlanNode.index', index=0, - number=1, type=5, cpp_type=1, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='kind', full_name='google.spanner.v1.PlanNode.kind', index=1, - number=2, type=14, cpp_type=8, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='display_name', full_name='google.spanner.v1.PlanNode.display_name', index=2, - number=3, type=9, cpp_type=9, label=1, - has_default_value=False, default_value=b"".decode('utf-8'), - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='child_links', full_name='google.spanner.v1.PlanNode.child_links', index=3, - number=4, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='short_representation', full_name='google.spanner.v1.PlanNode.short_representation', index=4, - number=5, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='metadata', full_name='google.spanner.v1.PlanNode.metadata', index=5, - number=6, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='execution_stats', full_name='google.spanner.v1.PlanNode.execution_stats', index=6, - number=7, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[_PLANNODE_CHILDLINK, _PLANNODE_SHORTREPRESENTATION, ], - enum_types=[ - _PLANNODE_KIND, - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=130, - serialized_end=762, + name="PlanNode", + full_name="google.spanner.v1.PlanNode", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="index", + full_name="google.spanner.v1.PlanNode.index", + index=0, + number=1, + type=5, + cpp_type=1, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="kind", + full_name="google.spanner.v1.PlanNode.kind", + index=1, + number=2, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="display_name", + full_name="google.spanner.v1.PlanNode.display_name", + index=2, + number=3, + type=9, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"".decode("utf-8"), + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="child_links", + full_name="google.spanner.v1.PlanNode.child_links", + index=3, + number=4, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="short_representation", + full_name="google.spanner.v1.PlanNode.short_representation", + index=4, + number=5, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="metadata", + full_name="google.spanner.v1.PlanNode.metadata", + index=5, + number=6, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="execution_stats", + full_name="google.spanner.v1.PlanNode.execution_stats", + index=6, + number=7, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[_PLANNODE_CHILDLINK, _PLANNODE_SHORTREPRESENTATION], + enum_types=[_PLANNODE_KIND], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=130, + serialized_end=762, ) _QUERYPLAN = _descriptor.Descriptor( - name='QueryPlan', - full_name='google.spanner.v1.QueryPlan', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='plan_nodes', full_name='google.spanner.v1.QueryPlan.plan_nodes', index=0, - number=1, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=764, - serialized_end=824, + name="QueryPlan", + full_name="google.spanner.v1.QueryPlan", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="plan_nodes", + full_name="google.spanner.v1.QueryPlan.plan_nodes", + index=0, + number=1, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ) + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=764, + serialized_end=824, ) _PLANNODE_CHILDLINK.containing_type = _PLANNODE -_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY.containing_type = _PLANNODE_SHORTREPRESENTATION -_PLANNODE_SHORTREPRESENTATION.fields_by_name['subqueries'].message_type = _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY +_PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY.containing_type = ( + _PLANNODE_SHORTREPRESENTATION +) +_PLANNODE_SHORTREPRESENTATION.fields_by_name[ + "subqueries" +].message_type = _PLANNODE_SHORTREPRESENTATION_SUBQUERIESENTRY _PLANNODE_SHORTREPRESENTATION.containing_type = _PLANNODE -_PLANNODE.fields_by_name['kind'].enum_type = _PLANNODE_KIND -_PLANNODE.fields_by_name['child_links'].message_type = _PLANNODE_CHILDLINK -_PLANNODE.fields_by_name['short_representation'].message_type = _PLANNODE_SHORTREPRESENTATION -_PLANNODE.fields_by_name['metadata'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT -_PLANNODE.fields_by_name['execution_stats'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_PLANNODE.fields_by_name["kind"].enum_type = _PLANNODE_KIND +_PLANNODE.fields_by_name["child_links"].message_type = _PLANNODE_CHILDLINK +_PLANNODE.fields_by_name[ + "short_representation" +].message_type = _PLANNODE_SHORTREPRESENTATION +_PLANNODE.fields_by_name[ + "metadata" +].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_PLANNODE.fields_by_name[ + "execution_stats" +].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT _PLANNODE_KIND.containing_type = _PLANNODE -_QUERYPLAN.fields_by_name['plan_nodes'].message_type = _PLANNODE -DESCRIPTOR.message_types_by_name['PlanNode'] = _PLANNODE -DESCRIPTOR.message_types_by_name['QueryPlan'] = _QUERYPLAN +_QUERYPLAN.fields_by_name["plan_nodes"].message_type = _PLANNODE +DESCRIPTOR.message_types_by_name["PlanNode"] = _PLANNODE +DESCRIPTOR.message_types_by_name["QueryPlan"] = _QUERYPLAN _sym_db.RegisterFileDescriptor(DESCRIPTOR) -PlanNode = _reflection.GeneratedProtocolMessageType('PlanNode', (_message.Message,), { - - '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 appearing in a +PlanNode = _reflection.GeneratedProtocolMessageType( + "PlanNode", + (_message.Message,), + { + "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 appearing in a [PlanNode][google.spanner.v1.PlanNode]. Attributes: @@ -328,22 +518,25 @@ operator. The corresponding ``variable`` fields will be set to the variable names assigned to the columns. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) - }) - , - - 'ShortRepresentation' : _reflection.GeneratedProtocolMessageType('ShortRepresentation', (_message.Message,), { - - 'SubqueriesEntry' : _reflection.GeneratedProtocolMessageType('SubqueriesEntry', (_message.Message,), { - '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 + # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode.ChildLink) + }, + ), + "ShortRepresentation": _reflection.GeneratedProtocolMessageType( + "ShortRepresentation", + (_message.Message,), + { + "SubqueriesEntry": _reflection.GeneratedProtocolMessageType( + "SubqueriesEntry", + (_message.Message,), + { + "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]. Attributes: @@ -357,13 +550,12 @@ subtree rooted at this node. The referenced ``SCALAR`` 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 + # @@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]. Attributes: @@ -397,18 +589,21 @@ returned as a result of a profile query. For example, number of executions, number of rows/time per execution etc. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) - }) + # @@protoc_insertion_point(class_scope:google.spanner.v1.PlanNode) + }, +) _sym_db.RegisterMessage(PlanNode) _sym_db.RegisterMessage(PlanNode.ChildLink) _sym_db.RegisterMessage(PlanNode.ShortRepresentation) _sym_db.RegisterMessage(PlanNode.ShortRepresentation.SubqueriesEntry) -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 plan. +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 plan. Attributes: plan_nodes: @@ -417,8 +612,9 @@ [PlanNode][google.spanner.v1.PlanNode]’s ``id`` corresponds to its index in ``plan_nodes``. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) - }) + # @@protoc_insertion_point(class_scope:google.spanner.v1.QueryPlan) + }, +) _sym_db.RegisterMessage(QueryPlan) diff --git a/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py b/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/query_plan_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - diff --git a/google/cloud/spanner_v1/proto/result_set_pb2.py b/google/cloud/spanner_v1/proto/result_set_pb2.py index 8e1257f955..d9d53e3659 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2.py @@ -6,260 +6,455 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 -from google.cloud.spanner_v1.proto import query_plan_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2 -from google.cloud.spanner_v1.proto import transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2 -from google.cloud.spanner_v1.proto import type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2 +from google.cloud.spanner_v1.proto import ( + query_plan_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2, +) +from google.cloud.spanner_v1.proto import ( + transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2, +) +from google.cloud.spanner_v1.proto import ( + type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2, +) from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::Cloud::Spanner::V1', - create_key=_descriptor._internal_create_key, - 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\xb7\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\\V1\xea\x02\x1aGoogle::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,google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR,google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR,google_dot_api_dot_annotations__pb2.DESCRIPTOR,]) - - + 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\352\002\032Google::Cloud::Spanner::V1", + create_key=_descriptor._internal_create_key, + 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\xb7\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\\V1\xea\x02\x1aGoogle::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, + google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2.DESCRIPTOR, + google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2.DESCRIPTOR, + google_dot_api_dot_annotations__pb2.DESCRIPTOR, + ], +) _RESULTSET = _descriptor.Descriptor( - name='ResultSet', - full_name='google.spanner.v1.ResultSet', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='metadata', full_name='google.spanner.v1.ResultSet.metadata', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='rows', full_name='google.spanner.v1.ResultSet.rows', index=1, - number=2, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='stats', full_name='google.spanner.v1.ResultSet.stats', index=2, - number=3, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=269, - serialized_end=428, + name="ResultSet", + full_name="google.spanner.v1.ResultSet", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="metadata", + full_name="google.spanner.v1.ResultSet.metadata", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="rows", + full_name="google.spanner.v1.ResultSet.rows", + index=1, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="stats", + full_name="google.spanner.v1.ResultSet.stats", + index=2, + number=3, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=269, + serialized_end=428, ) _PARTIALRESULTSET = _descriptor.Descriptor( - name='PartialResultSet', - full_name='google.spanner.v1.PartialResultSet', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='metadata', full_name='google.spanner.v1.PartialResultSet.metadata', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='values', full_name='google.spanner.v1.PartialResultSet.values', index=1, - number=2, type=11, cpp_type=10, label=3, - has_default_value=False, default_value=[], - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='chunked_value', full_name='google.spanner.v1.PartialResultSet.chunked_value', index=2, - number=3, type=8, cpp_type=7, label=1, - has_default_value=False, default_value=False, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='resume_token', full_name='google.spanner.v1.PartialResultSet.resume_token', index=3, - number=4, type=12, cpp_type=9, label=1, - has_default_value=False, default_value=b"", - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='stats', full_name='google.spanner.v1.PartialResultSet.stats', index=4, - number=5, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=431, - serialized_end=640, + name="PartialResultSet", + full_name="google.spanner.v1.PartialResultSet", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="metadata", + full_name="google.spanner.v1.PartialResultSet.metadata", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="values", + full_name="google.spanner.v1.PartialResultSet.values", + index=1, + number=2, + type=11, + cpp_type=10, + label=3, + has_default_value=False, + default_value=[], + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="chunked_value", + full_name="google.spanner.v1.PartialResultSet.chunked_value", + index=2, + number=3, + type=8, + cpp_type=7, + label=1, + has_default_value=False, + default_value=False, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="resume_token", + full_name="google.spanner.v1.PartialResultSet.resume_token", + index=3, + number=4, + type=12, + cpp_type=9, + label=1, + has_default_value=False, + default_value=b"", + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="stats", + full_name="google.spanner.v1.PartialResultSet.stats", + index=4, + number=5, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=431, + serialized_end=640, ) _RESULTSETMETADATA = _descriptor.Descriptor( - name='ResultSetMetadata', - full_name='google.spanner.v1.ResultSetMetadata', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='row_type', full_name='google.spanner.v1.ResultSetMetadata.row_type', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='transaction', full_name='google.spanner.v1.ResultSetMetadata.transaction', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - ], - serialized_start=642, - serialized_end=763, + name="ResultSetMetadata", + full_name="google.spanner.v1.ResultSetMetadata", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="row_type", + full_name="google.spanner.v1.ResultSetMetadata.row_type", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="transaction", + full_name="google.spanner.v1.ResultSetMetadata.transaction", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[], + serialized_start=642, + serialized_end=763, ) _RESULTSETSTATS = _descriptor.Descriptor( - name='ResultSetStats', - full_name='google.spanner.v1.ResultSetStats', - filename=None, - file=DESCRIPTOR, - containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[ - _descriptor.FieldDescriptor( - name='query_plan', full_name='google.spanner.v1.ResultSetStats.query_plan', index=0, - number=1, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='query_stats', full_name='google.spanner.v1.ResultSetStats.query_stats', index=1, - number=2, type=11, cpp_type=10, label=1, - has_default_value=False, default_value=None, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='row_count_exact', full_name='google.spanner.v1.ResultSetStats.row_count_exact', index=2, - number=3, type=3, cpp_type=2, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - _descriptor.FieldDescriptor( - name='row_count_lower_bound', full_name='google.spanner.v1.ResultSetStats.row_count_lower_bound', index=3, - number=4, type=3, cpp_type=2, label=1, - has_default_value=False, default_value=0, - message_type=None, enum_type=None, containing_type=None, - is_extension=False, extension_scope=None, - serialized_options=None, file=DESCRIPTOR, create_key=_descriptor._internal_create_key), - ], - extensions=[ - ], - nested_types=[], - enum_types=[ - ], - serialized_options=None, - is_extendable=False, - syntax='proto3', - extension_ranges=[], - oneofs=[ - _descriptor.OneofDescriptor( - name='row_count', full_name='google.spanner.v1.ResultSetStats.row_count', - index=0, containing_type=None, - create_key=_descriptor._internal_create_key, - fields=[]), - ], - serialized_start=766, - serialized_end=951, + name="ResultSetStats", + full_name="google.spanner.v1.ResultSetStats", + filename=None, + file=DESCRIPTOR, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[ + _descriptor.FieldDescriptor( + name="query_plan", + full_name="google.spanner.v1.ResultSetStats.query_plan", + index=0, + number=1, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="query_stats", + full_name="google.spanner.v1.ResultSetStats.query_stats", + index=1, + number=2, + type=11, + cpp_type=10, + label=1, + has_default_value=False, + default_value=None, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="row_count_exact", + full_name="google.spanner.v1.ResultSetStats.row_count_exact", + index=2, + number=3, + type=3, + cpp_type=2, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="row_count_lower_bound", + full_name="google.spanner.v1.ResultSetStats.row_count_lower_bound", + index=3, + number=4, + type=3, + cpp_type=2, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + ], + extensions=[], + nested_types=[], + enum_types=[], + serialized_options=None, + is_extendable=False, + syntax="proto3", + extension_ranges=[], + oneofs=[ + _descriptor.OneofDescriptor( + name="row_count", + full_name="google.spanner.v1.ResultSetStats.row_count", + index=0, + containing_type=None, + create_key=_descriptor._internal_create_key, + fields=[], + ) + ], + serialized_start=766, + serialized_end=951, ) -_RESULTSET.fields_by_name['metadata'].message_type = _RESULTSETMETADATA -_RESULTSET.fields_by_name['rows'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE -_RESULTSET.fields_by_name['stats'].message_type = _RESULTSETSTATS -_PARTIALRESULTSET.fields_by_name['metadata'].message_type = _RESULTSETMETADATA -_PARTIALRESULTSET.fields_by_name['values'].message_type = google_dot_protobuf_dot_struct__pb2._VALUE -_PARTIALRESULTSET.fields_by_name['stats'].message_type = _RESULTSETSTATS -_RESULTSETMETADATA.fields_by_name['row_type'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._STRUCTTYPE -_RESULTSETMETADATA.fields_by_name['transaction'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION -_RESULTSETSTATS.fields_by_name['query_plan'].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2._QUERYPLAN -_RESULTSETSTATS.fields_by_name['query_stats'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT -_RESULTSETSTATS.oneofs_by_name['row_count'].fields.append( - _RESULTSETSTATS.fields_by_name['row_count_exact']) -_RESULTSETSTATS.fields_by_name['row_count_exact'].containing_oneof = _RESULTSETSTATS.oneofs_by_name['row_count'] -_RESULTSETSTATS.oneofs_by_name['row_count'].fields.append( - _RESULTSETSTATS.fields_by_name['row_count_lower_bound']) -_RESULTSETSTATS.fields_by_name['row_count_lower_bound'].containing_oneof = _RESULTSETSTATS.oneofs_by_name['row_count'] -DESCRIPTOR.message_types_by_name['ResultSet'] = _RESULTSET -DESCRIPTOR.message_types_by_name['PartialResultSet'] = _PARTIALRESULTSET -DESCRIPTOR.message_types_by_name['ResultSetMetadata'] = _RESULTSETMETADATA -DESCRIPTOR.message_types_by_name['ResultSetStats'] = _RESULTSETSTATS +_RESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA +_RESULTSET.fields_by_name[ + "rows" +].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE +_RESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS +_PARTIALRESULTSET.fields_by_name["metadata"].message_type = _RESULTSETMETADATA +_PARTIALRESULTSET.fields_by_name[ + "values" +].message_type = google_dot_protobuf_dot_struct__pb2._VALUE +_PARTIALRESULTSET.fields_by_name["stats"].message_type = _RESULTSETSTATS +_RESULTSETMETADATA.fields_by_name[ + "row_type" +].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._STRUCTTYPE +_RESULTSETMETADATA.fields_by_name[ + "transaction" +].message_type = ( + google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2._TRANSACTION +) +_RESULTSETSTATS.fields_by_name[ + "query_plan" +].message_type = ( + google_dot_cloud_dot_spanner__v1_dot_proto_dot_query__plan__pb2._QUERYPLAN +) +_RESULTSETSTATS.fields_by_name[ + "query_stats" +].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT +_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append( + _RESULTSETSTATS.fields_by_name["row_count_exact"] +) +_RESULTSETSTATS.fields_by_name[ + "row_count_exact" +].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"] +_RESULTSETSTATS.oneofs_by_name["row_count"].fields.append( + _RESULTSETSTATS.fields_by_name["row_count_lower_bound"] +) +_RESULTSETSTATS.fields_by_name[ + "row_count_lower_bound" +].containing_oneof = _RESULTSETSTATS.oneofs_by_name["row_count"] +DESCRIPTOR.message_types_by_name["ResultSet"] = _RESULTSET +DESCRIPTOR.message_types_by_name["PartialResultSet"] = _PARTIALRESULTSET +DESCRIPTOR.message_types_by_name["ResultSetMetadata"] = _RESULTSETMETADATA +DESCRIPTOR.message_types_by_name["ResultSetStats"] = _RESULTSETSTATS _sym_db.RegisterFileDescriptor(DESCRIPTOR) -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 +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 [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql]. Attributes: @@ -284,15 +479,18 @@ not be populated, based on the [ExecuteSqlRequest.query_mode][ google.spanner.v1.ExecuteSqlRequest.query_mode]. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSet) - }) + # @@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. Streaming reads +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. Streaming reads and SQL queries better tolerate large result sets, large rows, and large values, but are a little trickier to consume. @@ -366,15 +564,18 @@ 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) - }) + # @@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] or +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] or [PartialResultSet][google.spanner.v1.PartialResultSet]. Attributes: @@ -389,15 +590,18 @@ 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) - }) + # @@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 [ResultSet][google.spanner.v1.ResultSet] +ResultSetStats = _reflection.GeneratedProtocolMessageType( + "ResultSetStats", + (_message.Message,), + { + "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]. Attributes: @@ -419,8 +623,9 @@ Partitioned DML does not offer exactly-once semantics, so it returns a lower bound of the rows modified. """, - # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) - }) + # @@protoc_insertion_point(class_scope:google.spanner.v1.ResultSetStats) + }, +) _sym_db.RegisterMessage(ResultSetStats) diff --git a/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py b/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py index 2daafffebf..8a9393943b 100644 --- a/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py +++ b/google/cloud/spanner_v1/proto/result_set_pb2_grpc.py @@ -1,4 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! """Client and server classes corresponding to protobuf-defined services.""" import grpc - diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index 4d6082b959..995420df80 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -6,6 +6,7 @@ from google.protobuf import message as _message from google.protobuf import reflection as _reflection from google.protobuf import symbol_database as _symbol_database + # @@protoc_insertion_point(imports) _sym_db = _symbol_database.Default() @@ -19,1381 +20,2409 @@ from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2 from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 from google.rpc import status_pb2 as google_dot_rpc_dot_status__pb2 -from google.cloud.spanner_v1.proto import keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2 -from google.cloud.spanner_v1.proto import mutation_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2 -from google.cloud.spanner_v1.proto import result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2 -from google.cloud.spanner_v1.proto import transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2 -from google.cloud.spanner_v1.proto import type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2 +from google.cloud.spanner_v1.proto import ( + keys_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_keys__pb2, +) +from google.cloud.spanner_v1.proto import ( + mutation_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_mutation__pb2, +) +from google.cloud.spanner_v1.proto import ( + result_set_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_result__set__pb2, +) +from google.cloud.spanner_v1.proto import ( + transaction_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_transaction__pb2, +) +from google.cloud.spanner_v1.proto import ( + type_pb2 as google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2, +) DESCRIPTOR = _descriptor.FileDescriptor( - 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\352\002\032Google::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\x94\x02\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\x02\x1aGoogle::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\x94\x02\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\x02\x1aGoogle::Cloud::Spanner::V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12 Date: Wed, 5 Aug 2020 08:51:43 -0700 Subject: [PATCH 4/9] feat(python-library): changes to docs job * feat(python-library): changes to docs job * migrate to Trampoline V2 * add docs-presubmit job * create docfx yaml files and upload them to another bucket * remove redundant envvars * add a failing test first * fix TemplateSyntaxError: Missing end of comment tag * serving_path is not needed any more * use `raw` to make jinja happy Source-Author: Takashi Matsuo Source-Date: Thu Jul 30 12:44:02 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: 5dfda5621df45b71b6e88544ebbb53b1a8c90214 Source-Link: https://github.com/googleapis/synthtool/commit/5dfda5621df45b71b6e88544ebbb53b1a8c90214 --- .gitignore | 3 +- .kokoro/docker/docs/Dockerfile | 98 ++++++ .kokoro/docker/docs/fetch_gpg_keys.sh | 45 +++ .kokoro/docs/common.cfg | 17 + .kokoro/docs/docs-presubmit.cfg | 17 + .kokoro/publish-docs.sh | 21 +- .kokoro/trampoline_v2.sh | 487 ++++++++++++++++++++++++++ .trampolinerc | 51 +++ docs/conf.py | 3 + synth.metadata | 4 +- 10 files changed, 742 insertions(+), 4 deletions(-) create mode 100644 .kokoro/docker/docs/Dockerfile create mode 100755 .kokoro/docker/docs/fetch_gpg_keys.sh create mode 100644 .kokoro/docs/docs-presubmit.cfg create mode 100755 .kokoro/trampoline_v2.sh create mode 100644 .trampolinerc diff --git a/.gitignore b/.gitignore index b87e1ed580..b9daa52f11 100644 --- a/.gitignore +++ b/.gitignore @@ -46,6 +46,7 @@ pip-log.txt # Built documentation docs/_build bigquery/docs/generated +docs.metadata # Virtual environment env/ @@ -57,4 +58,4 @@ system_tests/local_test_setup # Make sure a generated file isn't accidentally committed. pylintrc -pylintrc.test \ No newline at end of file +pylintrc.test diff --git a/.kokoro/docker/docs/Dockerfile b/.kokoro/docker/docs/Dockerfile new file mode 100644 index 0000000000..412b0b56a9 --- /dev/null +++ b/.kokoro/docker/docs/Dockerfile @@ -0,0 +1,98 @@ +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +from ubuntu:20.04 + +ENV DEBIAN_FRONTEND noninteractive + +# Ensure local Python is preferred over distribution Python. +ENV PATH /usr/local/bin:$PATH + +# Install dependencies. +RUN apt-get update \ + && apt-get install -y --no-install-recommends \ + apt-transport-https \ + build-essential \ + ca-certificates \ + curl \ + dirmngr \ + git \ + gpg-agent \ + graphviz \ + libbz2-dev \ + libdb5.3-dev \ + libexpat1-dev \ + libffi-dev \ + liblzma-dev \ + libreadline-dev \ + libsnappy-dev \ + libssl-dev \ + libsqlite3-dev \ + portaudio19-dev \ + redis-server \ + software-properties-common \ + ssh \ + sudo \ + tcl \ + tcl-dev \ + tk \ + tk-dev \ + uuid-dev \ + wget \ + zlib1g-dev \ + && add-apt-repository universe \ + && apt-get update \ + && apt-get -y install jq \ + && apt-get clean autoclean \ + && apt-get autoremove -y \ + && rm -rf /var/lib/apt/lists/* \ + && rm -f /var/cache/apt/archives/*.deb + + +COPY fetch_gpg_keys.sh /tmp +# Install the desired versions of Python. +RUN set -ex \ + && export GNUPGHOME="$(mktemp -d)" \ + && echo "disable-ipv6" >> "${GNUPGHOME}/dirmngr.conf" \ + && /tmp/fetch_gpg_keys.sh \ + && for PYTHON_VERSION in 3.7.8 3.8.5; do \ + wget --no-check-certificate -O python-${PYTHON_VERSION}.tar.xz "https://www.python.org/ftp/python/${PYTHON_VERSION%%[a-z]*}/Python-$PYTHON_VERSION.tar.xz" \ + && wget --no-check-certificate -O python-${PYTHON_VERSION}.tar.xz.asc "https://www.python.org/ftp/python/${PYTHON_VERSION%%[a-z]*}/Python-$PYTHON_VERSION.tar.xz.asc" \ + && gpg --batch --verify python-${PYTHON_VERSION}.tar.xz.asc python-${PYTHON_VERSION}.tar.xz \ + && rm -r python-${PYTHON_VERSION}.tar.xz.asc \ + && mkdir -p /usr/src/python-${PYTHON_VERSION} \ + && tar -xJC /usr/src/python-${PYTHON_VERSION} --strip-components=1 -f python-${PYTHON_VERSION}.tar.xz \ + && rm python-${PYTHON_VERSION}.tar.xz \ + && cd /usr/src/python-${PYTHON_VERSION} \ + && ./configure \ + --enable-shared \ + # This works only on Python 2.7 and throws a warning on every other + # version, but seems otherwise harmless. + --enable-unicode=ucs4 \ + --with-system-ffi \ + --without-ensurepip \ + && make -j$(nproc) \ + && make install \ + && ldconfig \ + ; done \ + && rm -rf "${GNUPGHOME}" \ + && rm -rf /usr/src/python* \ + && rm -rf ~/.cache/ + +RUN wget -O /tmp/get-pip.py 'https://bootstrap.pypa.io/get-pip.py' \ + && python3.7 /tmp/get-pip.py \ + && python3.8 /tmp/get-pip.py \ + && rm /tmp/get-pip.py + +CMD ["python3.7"] diff --git a/.kokoro/docker/docs/fetch_gpg_keys.sh b/.kokoro/docker/docs/fetch_gpg_keys.sh new file mode 100755 index 0000000000..d653dd868e --- /dev/null +++ b/.kokoro/docker/docs/fetch_gpg_keys.sh @@ -0,0 +1,45 @@ +#!/bin/bash +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# A script to fetch gpg keys with retry. +# Avoid jinja parsing the file. +# + +function retry { + if [[ "${#}" -le 1 ]]; then + echo "Usage: ${0} retry_count commands.." + exit 1 + fi + local retries=${1} + local command="${@:2}" + until [[ "${retries}" -le 0 ]]; do + $command && return 0 + if [[ $? -ne 0 ]]; then + echo "command failed, retrying" + ((retries--)) + fi + done + return 1 +} + +# 3.6.9, 3.7.5 (Ned Deily) +retry 3 gpg --keyserver ha.pool.sks-keyservers.net --recv-keys \ + 0D96DF4D4110E5C43FBFB17F2D347EA6AA65421D + +# 3.8.0 (Łukasz Langa) +retry 3 gpg --keyserver ha.pool.sks-keyservers.net --recv-keys \ + E3FF2839C048B25C084DEBE9B26995E310250568 + +# diff --git a/.kokoro/docs/common.cfg b/.kokoro/docs/common.cfg index 7bc873e976..d8574ef57e 100644 --- a/.kokoro/docs/common.cfg +++ b/.kokoro/docs/common.cfg @@ -28,6 +28,23 @@ env_vars: { value: "docs-staging" } +env_vars: { + key: "V2_STAGING_BUCKET" + value: "docs-staging-v2-staging" +} + +# It will upload the docker image after successful builds. +env_vars: { + key: "TRAMPOLINE_IMAGE_UPLOAD" + value: "true" +} + +# It will always build the docker image. +env_vars: { + key: "TRAMPOLINE_DOCKERFILE" + value: ".kokoro/docker/docs/Dockerfile" +} + # Fetch the token needed for reporting release status to GitHub before_action { fetch_keystore { diff --git a/.kokoro/docs/docs-presubmit.cfg b/.kokoro/docs/docs-presubmit.cfg new file mode 100644 index 0000000000..1118107829 --- /dev/null +++ b/.kokoro/docs/docs-presubmit.cfg @@ -0,0 +1,17 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "STAGING_BUCKET" + value: "gcloud-python-test" +} + +env_vars: { + key: "V2_STAGING_BUCKET" + value: "gcloud-python-test" +} + +# We only upload the image in the main `docs` build. +env_vars: { + key: "TRAMPOLINE_IMAGE_UPLOAD" + value: "false" +} diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index 92506af8f8..fc90727585 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -52,4 +52,23 @@ python3 -m docuploader create-metadata \ cat docs.metadata # upload docs -python3 -m docuploader upload docs/_build/html --metadata-file docs.metadata --staging-bucket docs-staging +python3 -m docuploader upload docs/_build/html --metadata-file docs.metadata --staging-bucket "${STAGING_BUCKET}" + + +# docfx yaml files +nox -s docfx + +# create metadata. +python3 -m docuploader create-metadata \ + --name=$(jq --raw-output '.name // empty' .repo-metadata.json) \ + --version=$(python3 setup.py --version) \ + --language=$(jq --raw-output '.language // empty' .repo-metadata.json) \ + --distribution-name=$(python3 setup.py --name) \ + --product-page=$(jq --raw-output '.product_documentation // empty' .repo-metadata.json) \ + --github-repository=$(jq --raw-output '.repo // empty' .repo-metadata.json) \ + --issue-tracker=$(jq --raw-output '.issue_tracker // empty' .repo-metadata.json) + +cat docs.metadata + +# upload docs +python3 -m docuploader upload docs/_build/html/docfx_yaml --metadata-file docs.metadata --destination-prefix docfx --staging-bucket "${V2_STAGING_BUCKET}" diff --git a/.kokoro/trampoline_v2.sh b/.kokoro/trampoline_v2.sh new file mode 100755 index 0000000000..719bcd5ba8 --- /dev/null +++ b/.kokoro/trampoline_v2.sh @@ -0,0 +1,487 @@ +#!/usr/bin/env bash +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# trampoline_v2.sh +# +# This script does 3 things. +# +# 1. Prepare the Docker image for the test +# 2. Run the Docker with appropriate flags to run the test +# 3. Upload the newly built Docker image +# +# in a way that is somewhat compatible with trampoline_v1. +# +# To run this script, first download few files from gcs to /dev/shm. +# (/dev/shm is passed into the container as KOKORO_GFILE_DIR). +# +# gsutil cp gs://cloud-devrel-kokoro-resources/python-docs-samples/secrets_viewer_service_account.json /dev/shm +# gsutil cp gs://cloud-devrel-kokoro-resources/python-docs-samples/automl_secrets.txt /dev/shm +# +# Then run the script. +# .kokoro/trampoline_v2.sh +# +# These environment variables are required: +# TRAMPOLINE_IMAGE: The docker image to use. +# TRAMPOLINE_DOCKERFILE: The location of the Dockerfile. +# +# You can optionally change these environment variables: +# TRAMPOLINE_IMAGE_UPLOAD: +# (true|false): Whether to upload the Docker image after the +# successful builds. +# TRAMPOLINE_BUILD_FILE: The script to run in the docker container. +# TRAMPOLINE_WORKSPACE: The workspace path in the docker container. +# Defaults to /workspace. +# Potentially there are some repo specific envvars in .trampolinerc in +# the project root. + + +set -euo pipefail + +TRAMPOLINE_VERSION="2.0.5" + +if command -v tput >/dev/null && [[ -n "${TERM:-}" ]]; then + readonly IO_COLOR_RED="$(tput setaf 1)" + readonly IO_COLOR_GREEN="$(tput setaf 2)" + readonly IO_COLOR_YELLOW="$(tput setaf 3)" + readonly IO_COLOR_RESET="$(tput sgr0)" +else + readonly IO_COLOR_RED="" + readonly IO_COLOR_GREEN="" + readonly IO_COLOR_YELLOW="" + readonly IO_COLOR_RESET="" +fi + +function function_exists { + [ $(LC_ALL=C type -t $1)"" == "function" ] +} + +# Logs a message using the given color. The first argument must be one +# of the IO_COLOR_* variables defined above, such as +# "${IO_COLOR_YELLOW}". The remaining arguments will be logged in the +# given color. The log message will also have an RFC-3339 timestamp +# prepended (in UTC). You can disable the color output by setting +# TERM=vt100. +function log_impl() { + local color="$1" + shift + local timestamp="$(date -u "+%Y-%m-%dT%H:%M:%SZ")" + echo "================================================================" + echo "${color}${timestamp}:" "$@" "${IO_COLOR_RESET}" + echo "================================================================" +} + +# Logs the given message with normal coloring and a timestamp. +function log() { + log_impl "${IO_COLOR_RESET}" "$@" +} + +# Logs the given message in green with a timestamp. +function log_green() { + log_impl "${IO_COLOR_GREEN}" "$@" +} + +# Logs the given message in yellow with a timestamp. +function log_yellow() { + log_impl "${IO_COLOR_YELLOW}" "$@" +} + +# Logs the given message in red with a timestamp. +function log_red() { + log_impl "${IO_COLOR_RED}" "$@" +} + +readonly tmpdir=$(mktemp -d -t ci-XXXXXXXX) +readonly tmphome="${tmpdir}/h" +mkdir -p "${tmphome}" + +function cleanup() { + rm -rf "${tmpdir}" +} +trap cleanup EXIT + +RUNNING_IN_CI="${RUNNING_IN_CI:-false}" + +# The workspace in the container, defaults to /workspace. +TRAMPOLINE_WORKSPACE="${TRAMPOLINE_WORKSPACE:-/workspace}" + +pass_down_envvars=( + # TRAMPOLINE_V2 variables. + # Tells scripts whether they are running as part of CI or not. + "RUNNING_IN_CI" + # Indicates which CI system we're in. + "TRAMPOLINE_CI" + # Indicates the version of the script. + "TRAMPOLINE_VERSION" +) + +log_yellow "Building with Trampoline ${TRAMPOLINE_VERSION}" + +# Detect which CI systems we're in. If we're in any of the CI systems +# we support, `RUNNING_IN_CI` will be true and `TRAMPOLINE_CI` will be +# the name of the CI system. Both envvars will be passing down to the +# container for telling which CI system we're in. +if [[ -n "${KOKORO_BUILD_ID:-}" ]]; then + # descriptive env var for indicating it's on CI. + RUNNING_IN_CI="true" + TRAMPOLINE_CI="kokoro" + if [[ "${TRAMPOLINE_USE_LEGACY_SERVICE_ACCOUNT:-}" == "true" ]]; then + if [[ ! -f "${KOKORO_GFILE_DIR}/kokoro-trampoline.service-account.json" ]]; then + log_red "${KOKORO_GFILE_DIR}/kokoro-trampoline.service-account.json does not exist. Did you forget to mount cloud-devrel-kokoro-resources/trampoline? Aborting." + exit 1 + fi + # This service account will be activated later. + TRAMPOLINE_SERVICE_ACCOUNT="${KOKORO_GFILE_DIR}/kokoro-trampoline.service-account.json" + else + if [[ "${TRAMPOLINE_VERBOSE:-}" == "true" ]]; then + gcloud auth list + fi + log_yellow "Configuring Container Registry access" + gcloud auth configure-docker --quiet + fi + pass_down_envvars+=( + # KOKORO dynamic variables. + "KOKORO_BUILD_NUMBER" + "KOKORO_BUILD_ID" + "KOKORO_JOB_NAME" + "KOKORO_GIT_COMMIT" + "KOKORO_GITHUB_COMMIT" + "KOKORO_GITHUB_PULL_REQUEST_NUMBER" + "KOKORO_GITHUB_PULL_REQUEST_COMMIT" + # For Build Cop Bot + "KOKORO_GITHUB_COMMIT_URL" + "KOKORO_GITHUB_PULL_REQUEST_URL" + ) +elif [[ "${TRAVIS:-}" == "true" ]]; then + RUNNING_IN_CI="true" + TRAMPOLINE_CI="travis" + pass_down_envvars+=( + "TRAVIS_BRANCH" + "TRAVIS_BUILD_ID" + "TRAVIS_BUILD_NUMBER" + "TRAVIS_BUILD_WEB_URL" + "TRAVIS_COMMIT" + "TRAVIS_COMMIT_MESSAGE" + "TRAVIS_COMMIT_RANGE" + "TRAVIS_JOB_NAME" + "TRAVIS_JOB_NUMBER" + "TRAVIS_JOB_WEB_URL" + "TRAVIS_PULL_REQUEST" + "TRAVIS_PULL_REQUEST_BRANCH" + "TRAVIS_PULL_REQUEST_SHA" + "TRAVIS_PULL_REQUEST_SLUG" + "TRAVIS_REPO_SLUG" + "TRAVIS_SECURE_ENV_VARS" + "TRAVIS_TAG" + ) +elif [[ -n "${GITHUB_RUN_ID:-}" ]]; then + RUNNING_IN_CI="true" + TRAMPOLINE_CI="github-workflow" + pass_down_envvars+=( + "GITHUB_WORKFLOW" + "GITHUB_RUN_ID" + "GITHUB_RUN_NUMBER" + "GITHUB_ACTION" + "GITHUB_ACTIONS" + "GITHUB_ACTOR" + "GITHUB_REPOSITORY" + "GITHUB_EVENT_NAME" + "GITHUB_EVENT_PATH" + "GITHUB_SHA" + "GITHUB_REF" + "GITHUB_HEAD_REF" + "GITHUB_BASE_REF" + ) +elif [[ "${CIRCLECI:-}" == "true" ]]; then + RUNNING_IN_CI="true" + TRAMPOLINE_CI="circleci" + pass_down_envvars+=( + "CIRCLE_BRANCH" + "CIRCLE_BUILD_NUM" + "CIRCLE_BUILD_URL" + "CIRCLE_COMPARE_URL" + "CIRCLE_JOB" + "CIRCLE_NODE_INDEX" + "CIRCLE_NODE_TOTAL" + "CIRCLE_PREVIOUS_BUILD_NUM" + "CIRCLE_PROJECT_REPONAME" + "CIRCLE_PROJECT_USERNAME" + "CIRCLE_REPOSITORY_URL" + "CIRCLE_SHA1" + "CIRCLE_STAGE" + "CIRCLE_USERNAME" + "CIRCLE_WORKFLOW_ID" + "CIRCLE_WORKFLOW_JOB_ID" + "CIRCLE_WORKFLOW_UPSTREAM_JOB_IDS" + "CIRCLE_WORKFLOW_WORKSPACE_ID" + ) +fi + +# Configure the service account for pulling the docker image. +function repo_root() { + local dir="$1" + while [[ ! -d "${dir}/.git" ]]; do + dir="$(dirname "$dir")" + done + echo "${dir}" +} + +# Detect the project root. In CI builds, we assume the script is in +# the git tree and traverse from there, otherwise, traverse from `pwd` +# to find `.git` directory. +if [[ "${RUNNING_IN_CI:-}" == "true" ]]; then + PROGRAM_PATH="$(realpath "$0")" + PROGRAM_DIR="$(dirname "${PROGRAM_PATH}")" + PROJECT_ROOT="$(repo_root "${PROGRAM_DIR}")" +else + PROJECT_ROOT="$(repo_root $(pwd))" +fi + +log_yellow "Changing to the project root: ${PROJECT_ROOT}." +cd "${PROJECT_ROOT}" + +# To support relative path for `TRAMPOLINE_SERVICE_ACCOUNT`, we need +# to use this environment variable in `PROJECT_ROOT`. +if [[ -n "${TRAMPOLINE_SERVICE_ACCOUNT:-}" ]]; then + + mkdir -p "${tmpdir}/gcloud" + gcloud_config_dir="${tmpdir}/gcloud" + + log_yellow "Using isolated gcloud config: ${gcloud_config_dir}." + export CLOUDSDK_CONFIG="${gcloud_config_dir}" + + log_yellow "Using ${TRAMPOLINE_SERVICE_ACCOUNT} for authentication." + gcloud auth activate-service-account \ + --key-file "${TRAMPOLINE_SERVICE_ACCOUNT}" + log_yellow "Configuring Container Registry access" + gcloud auth configure-docker --quiet +fi + +required_envvars=( + # The basic trampoline configurations. + "TRAMPOLINE_IMAGE" + "TRAMPOLINE_BUILD_FILE" +) + +if [[ -f "${PROJECT_ROOT}/.trampolinerc" ]]; then + source "${PROJECT_ROOT}/.trampolinerc" +fi + +log_yellow "Checking environment variables." +for e in "${required_envvars[@]}" +do + if [[ -z "${!e:-}" ]]; then + log "Missing ${e} env var. Aborting." + exit 1 + fi +done + +# We want to support legacy style TRAMPOLINE_BUILD_FILE used with V1 +# script: e.g. "github/repo-name/.kokoro/run_tests.sh" +TRAMPOLINE_BUILD_FILE="${TRAMPOLINE_BUILD_FILE#github/*/}" +log_yellow "Using TRAMPOLINE_BUILD_FILE: ${TRAMPOLINE_BUILD_FILE}" + +# ignore error on docker operations and test execution +set +e + +log_yellow "Preparing Docker image." +# We only download the docker image in CI builds. +if [[ "${RUNNING_IN_CI:-}" == "true" ]]; then + # Download the docker image specified by `TRAMPOLINE_IMAGE` + + # We may want to add --max-concurrent-downloads flag. + + log_yellow "Start pulling the Docker image: ${TRAMPOLINE_IMAGE}." + if docker pull "${TRAMPOLINE_IMAGE}"; then + log_green "Finished pulling the Docker image: ${TRAMPOLINE_IMAGE}." + has_image="true" + else + log_red "Failed pulling the Docker image: ${TRAMPOLINE_IMAGE}." + has_image="false" + fi +else + # For local run, check if we have the image. + if docker images "${TRAMPOLINE_IMAGE}:latest" | grep "${TRAMPOLINE_IMAGE}"; then + has_image="true" + else + has_image="false" + fi +fi + + +# The default user for a Docker container has uid 0 (root). To avoid +# creating root-owned files in the build directory we tell docker to +# use the current user ID. +user_uid="$(id -u)" +user_gid="$(id -g)" +user_name="$(id -un)" + +# To allow docker in docker, we add the user to the docker group in +# the host os. +docker_gid=$(cut -d: -f3 < <(getent group docker)) + +update_cache="false" +if [[ "${TRAMPOLINE_DOCKERFILE:-none}" != "none" ]]; then + # Build the Docker image from the source. + context_dir=$(dirname "${TRAMPOLINE_DOCKERFILE}") + docker_build_flags=( + "-f" "${TRAMPOLINE_DOCKERFILE}" + "-t" "${TRAMPOLINE_IMAGE}" + "--build-arg" "UID=${user_uid}" + "--build-arg" "USERNAME=${user_name}" + ) + if [[ "${has_image}" == "true" ]]; then + docker_build_flags+=("--cache-from" "${TRAMPOLINE_IMAGE}") + fi + + log_yellow "Start building the docker image." + if [[ "${TRAMPOLINE_VERBOSE:-false}" == "true" ]]; then + echo "docker build" "${docker_build_flags[@]}" "${context_dir}" + fi + + # ON CI systems, we want to suppress docker build logs, only + # output the logs when it fails. + if [[ "${RUNNING_IN_CI:-}" == "true" ]]; then + if docker build "${docker_build_flags[@]}" "${context_dir}" \ + > "${tmpdir}/docker_build.log" 2>&1; then + if [[ "${TRAMPOLINE_VERBOSE:-}" == "true" ]]; then + cat "${tmpdir}/docker_build.log" + fi + + log_green "Finished building the docker image." + update_cache="true" + else + log_red "Failed to build the Docker image, aborting." + log_yellow "Dumping the build logs:" + cat "${tmpdir}/docker_build.log" + exit 1 + fi + else + if docker build "${docker_build_flags[@]}" "${context_dir}"; then + log_green "Finished building the docker image." + update_cache="true" + else + log_red "Failed to build the Docker image, aborting." + exit 1 + fi + fi +else + if [[ "${has_image}" != "true" ]]; then + log_red "We do not have ${TRAMPOLINE_IMAGE} locally, aborting." + exit 1 + fi +fi + +# We use an array for the flags so they are easier to document. +docker_flags=( + # Remove the container after it exists. + "--rm" + + # Use the host network. + "--network=host" + + # Run in priviledged mode. We are not using docker for sandboxing or + # isolation, just for packaging our dev tools. + "--privileged" + + # Run the docker script with the user id. Because the docker image gets to + # write in ${PWD} you typically want this to be your user id. + # To allow docker in docker, we need to use docker gid on the host. + "--user" "${user_uid}:${docker_gid}" + + # Pass down the USER. + "--env" "USER=${user_name}" + + # Mount the project directory inside the Docker container. + "--volume" "${PROJECT_ROOT}:${TRAMPOLINE_WORKSPACE}" + "--workdir" "${TRAMPOLINE_WORKSPACE}" + "--env" "PROJECT_ROOT=${TRAMPOLINE_WORKSPACE}" + + # Mount the temporary home directory. + "--volume" "${tmphome}:/h" + "--env" "HOME=/h" + + # Allow docker in docker. + "--volume" "/var/run/docker.sock:/var/run/docker.sock" + + # Mount the /tmp so that docker in docker can mount the files + # there correctly. + "--volume" "/tmp:/tmp" + # Pass down the KOKORO_GFILE_DIR and KOKORO_KEYSTORE_DIR + # TODO(tmatsuo): This part is not portable. + "--env" "TRAMPOLINE_SECRET_DIR=/secrets" + "--volume" "${KOKORO_GFILE_DIR:-/dev/shm}:/secrets/gfile" + "--env" "KOKORO_GFILE_DIR=/secrets/gfile" + "--volume" "${KOKORO_KEYSTORE_DIR:-/dev/shm}:/secrets/keystore" + "--env" "KOKORO_KEYSTORE_DIR=/secrets/keystore" +) + +# Add an option for nicer output if the build gets a tty. +if [[ -t 0 ]]; then + docker_flags+=("-it") +fi + +# Passing down env vars +for e in "${pass_down_envvars[@]}" +do + if [[ -n "${!e:-}" ]]; then + docker_flags+=("--env" "${e}=${!e}") + fi +done + +# If arguments are given, all arguments will become the commands run +# in the container, otherwise run TRAMPOLINE_BUILD_FILE. +if [[ $# -ge 1 ]]; then + log_yellow "Running the given commands '" "${@:1}" "' in the container." + readonly commands=("${@:1}") + if [[ "${TRAMPOLINE_VERBOSE:-}" == "true" ]]; then + echo docker run "${docker_flags[@]}" "${TRAMPOLINE_IMAGE}" "${commands[@]}" + fi + docker run "${docker_flags[@]}" "${TRAMPOLINE_IMAGE}" "${commands[@]}" +else + log_yellow "Running the tests in a Docker container." + docker_flags+=("--entrypoint=${TRAMPOLINE_BUILD_FILE}") + if [[ "${TRAMPOLINE_VERBOSE:-}" == "true" ]]; then + echo docker run "${docker_flags[@]}" "${TRAMPOLINE_IMAGE}" + fi + docker run "${docker_flags[@]}" "${TRAMPOLINE_IMAGE}" +fi + + +test_retval=$? + +if [[ ${test_retval} -eq 0 ]]; then + log_green "Build finished with ${test_retval}" +else + log_red "Build finished with ${test_retval}" +fi + +# Only upload it when the test passes. +if [[ "${update_cache}" == "true" ]] && \ + [[ $test_retval == 0 ]] && \ + [[ "${TRAMPOLINE_IMAGE_UPLOAD:-false}" == "true" ]]; then + log_yellow "Uploading the Docker image." + if docker push "${TRAMPOLINE_IMAGE}"; then + log_green "Finished uploading the Docker image." + else + log_red "Failed uploading the Docker image." + fi + # Call trampoline_after_upload_hook if it's defined. + if function_exists trampoline_after_upload_hook; then + trampoline_after_upload_hook + fi + +fi + +exit "${test_retval}" diff --git a/.trampolinerc b/.trampolinerc new file mode 100644 index 0000000000..995ee29111 --- /dev/null +++ b/.trampolinerc @@ -0,0 +1,51 @@ +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +# Template for .trampolinerc + +# Add required env vars here. +required_envvars+=( + "STAGING_BUCKET" + "V2_STAGING_BUCKET" +) + +# Add env vars which are passed down into the container here. +pass_down_envvars+=( + "STAGING_BUCKET" + "V2_STAGING_BUCKET" +) + +# Prevent unintentional override on the default image. +if [[ "${TRAMPOLINE_IMAGE_UPLOAD:-false}" == "true" ]] && \ + [[ -z "${TRAMPOLINE_IMAGE:-}" ]]; then + echo "Please set TRAMPOLINE_IMAGE if you want to upload the Docker image." + exit 1 +fi + +# Define the default value if it makes sense. +if [[ -z "${TRAMPOLINE_IMAGE_UPLOAD:-}" ]]; then + TRAMPOLINE_IMAGE_UPLOAD="" +fi + +if [[ -z "${TRAMPOLINE_IMAGE:-}" ]]; then + TRAMPOLINE_IMAGE="" +fi + +if [[ -z "${TRAMPOLINE_DOCKERFILE:-}" ]]; then + TRAMPOLINE_DOCKERFILE="" +fi + +if [[ -z "${TRAMPOLINE_BUILD_FILE:-}" ]]; then + TRAMPOLINE_BUILD_FILE="" +fi diff --git a/docs/conf.py b/docs/conf.py index a4390abf94..66710606a7 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -20,6 +20,9 @@ # documentation root, use os.path.abspath to make it absolute, like shown here. sys.path.insert(0, os.path.abspath("..")) +# For plugins that can not read conf.py. +sys.path.insert(0, os.path.abspath(".")) + __version__ = "" # -- General configuration ------------------------------------------------ diff --git a/synth.metadata b/synth.metadata index d2b748c0b9..aa4f2e2855 100644 --- a/synth.metadata +++ b/synth.metadata @@ -19,14 +19,14 @@ "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "ee7506d15daa3873accfff9430eff7e3953f0248" + "sha": "5dfda5621df45b71b6e88544ebbb53b1a8c90214" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "ee7506d15daa3873accfff9430eff7e3953f0248" + "sha": "5dfda5621df45b71b6e88544ebbb53b1a8c90214" } } ], From 84f601d529288a94b4834898cde3df0fd3780e3d Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 08:52:23 -0700 Subject: [PATCH 5/9] fix(python-library): add missing changes Source-Author: Takashi Matsuo Source-Date: Thu Jul 30 18:26:35 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: 39b527a39f5cd56d4882b3874fc08eed4756cebe Source-Link: https://github.com/googleapis/synthtool/commit/39b527a39f5cd56d4882b3874fc08eed4756cebe --- .kokoro/docs/common.cfg | 4 ++-- .kokoro/publish-docs.sh | 18 ++++-------------- synth.metadata | 4 ++-- 3 files changed, 8 insertions(+), 18 deletions(-) diff --git a/.kokoro/docs/common.cfg b/.kokoro/docs/common.cfg index d8574ef57e..ddb827fc6a 100644 --- a/.kokoro/docs/common.cfg +++ b/.kokoro/docs/common.cfg @@ -11,12 +11,12 @@ action { gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline" # Use the trampoline script to run in docker. -build_file: "python-spanner/.kokoro/trampoline.sh" +build_file: "python-spanner/.kokoro/trampoline_v2.sh" # Configure the docker image for kokoro-trampoline. env_vars: { key: "TRAMPOLINE_IMAGE" - value: "gcr.io/cloud-devrel-kokoro-resources/python-multi" + value: "gcr.io/cloud-devrel-kokoro-resources/python-lib-docs" } env_vars: { key: "TRAMPOLINE_BUILD_FILE" diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index fc90727585..8acb14e802 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -18,26 +18,16 @@ set -eo pipefail # Disable buffering, so that the logs stream through. export PYTHONUNBUFFERED=1 -cd github/python-spanner - -# Remove old nox -python3.6 -m pip uninstall --yes --quiet nox-automation +export PATH="${HOME}/.local/bin:${PATH}" # Install nox -python3.6 -m pip install --upgrade --quiet nox -python3.6 -m nox --version +python3 -m pip install --user --upgrade --quiet nox +python3 -m nox --version # build docs nox -s docs -python3 -m pip install gcp-docuploader - -# install a json parser -sudo apt-get update -sudo apt-get -y install software-properties-common -sudo add-apt-repository universe -sudo apt-get update -sudo apt-get -y install jq +python3 -m pip install --user gcp-docuploader # create metadata python3 -m docuploader create-metadata \ diff --git a/synth.metadata b/synth.metadata index aa4f2e2855..475d411ef5 100644 --- a/synth.metadata +++ b/synth.metadata @@ -19,14 +19,14 @@ "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "5dfda5621df45b71b6e88544ebbb53b1a8c90214" + "sha": "39b527a39f5cd56d4882b3874fc08eed4756cebe" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "5dfda5621df45b71b6e88544ebbb53b1a8c90214" + "sha": "39b527a39f5cd56d4882b3874fc08eed4756cebe" } } ], From e0c5d0892446787c3d25f5e5e91fcde88000fb31 Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 08:52:50 -0700 Subject: [PATCH 6/9] chore(py_library): add split_system_tests Source-Author: Takashi Matsuo Source-Date: Fri Jul 31 16:17:13 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669 Source-Link: https://github.com/googleapis/synthtool/commit/bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669 --- .kokoro/build.sh | 8 +++++++- synth.metadata | 4 ++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/.kokoro/build.sh b/.kokoro/build.sh index 93529591ba..a847a74a4f 100755 --- a/.kokoro/build.sh +++ b/.kokoro/build.sh @@ -39,4 +39,10 @@ python3.6 -m pip uninstall --yes --quiet nox-automation python3.6 -m pip install --upgrade --quiet nox python3.6 -m nox --version -python3.6 -m nox +# If NOX_SESSION is set, it only runs the specified session, +# otherwise run all the sessions. +if [[ -n "${NOX_SESSION:-}" ]]; then + python3.6 -m nox -s "${NOX_SESSION:-}" +else + python3.6 -m nox +fi diff --git a/synth.metadata b/synth.metadata index 475d411ef5..8539d11e20 100644 --- a/synth.metadata +++ b/synth.metadata @@ -19,14 +19,14 @@ "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "39b527a39f5cd56d4882b3874fc08eed4756cebe" + "sha": "bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "39b527a39f5cd56d4882b3874fc08eed4756cebe" + "sha": "bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669" } } ], From 40eb23e26a1d05c66e58d7d937378a0f9b5988db Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Wed, 5 Aug 2020 08:53:03 -0700 Subject: [PATCH 7/9] chore(py_library): add some excludes in docs/conf.py This should fix build failures in python-bigquery. Example: https://github.com/googleapis/python-bigquery/pull/205 * also add a comment Source-Author: Takashi Matsuo Source-Date: Mon Aug 3 15:08:00 2020 -0700 Source-Repo: googleapis/synthtool Source-Sha: 4f8f5dc24af79694887385015294e4dbb214c352 Source-Link: https://github.com/googleapis/synthtool/commit/4f8f5dc24af79694887385015294e4dbb214c352 --- docs/conf.py | 8 +++++++- synth.metadata | 4 ++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 66710606a7..9eee0015d1 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -21,6 +21,7 @@ sys.path.insert(0, os.path.abspath("..")) # For plugins that can not read conf.py. +# See also: https://github.com/docascode/sphinx-docfx-yaml/issues/85 sys.path.insert(0, os.path.abspath(".")) __version__ = "" @@ -93,7 +94,12 @@ # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. -exclude_patterns = ["_build"] +exclude_patterns = [ + "_build", + "samples/AUTHORING_GUIDE.md", + "samples/CONTRIBUTING.md", + "samples/snippets/README.rst", +] # The reST default role (used for this markup: `text`) to use for all # documents. diff --git a/synth.metadata b/synth.metadata index 8539d11e20..14a9cac219 100644 --- a/synth.metadata +++ b/synth.metadata @@ -19,14 +19,14 @@ "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669" + "sha": "4f8f5dc24af79694887385015294e4dbb214c352" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "bfcdbe0da977b2de6c1c0471bb6dc2f1e13bf669" + "sha": "4f8f5dc24af79694887385015294e4dbb214c352" } } ], From f64b28606da906b2305b01b4f11c778dbe967388 Mon Sep 17 00:00:00 2001 From: larkee Date: Thu, 6 Aug 2020 15:57:33 +1000 Subject: [PATCH 8/9] docs: revert unneeded docs changes --- .../proto/spanner_database_admin_pb2.py | 18 +- .../proto/spanner_instance_admin_pb2.py | 24 +- google/cloud/spanner_v1/proto/keys_pb2.py | 2 +- google/cloud/spanner_v1/proto/spanner_pb2.py | 19 +- .../cloud/spanner_v1/proto/transaction_pb2.py | 445 +++++++++++------- 5 files changed, 302 insertions(+), 206 deletions(-) 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 fa8d83ede0..f0accdbecd 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 @@ -1489,10 +1489,10 @@ Number of databases to be returned in the 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.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) }, @@ -1780,11 +1780,11 @@ Number of operations to be returned in the 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.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) 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 ae72e014de..8d086520e5 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 @@ -1487,11 +1487,11 @@ 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) }, @@ -1610,10 +1610,10 @@ Number of instances to be returned in the 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.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 @@ -1668,9 +1668,9 @@ 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 diff --git a/google/cloud/spanner_v1/proto/keys_pb2.py b/google/cloud/spanner_v1/proto/keys_pb2.py index 0f0dba9787..8481775d4b 100644 --- a/google/cloud/spanner_v1/proto/keys_pb2.py +++ b/google/cloud/spanner_v1/proto/keys_pb2.py @@ -347,7 +347,7 @@ { "DESCRIPTOR": _KEYSET, "__module__": "google.cloud.spanner_v1.proto.keys_pb2", - "__doc__": """\ ``KeySet`` defines a collection of Cloud Spanner keys and/or key + "__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 diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py index 995420df80..a48a12ca59 100644 --- a/google/cloud/spanner_v1/proto/spanner_pb2.py +++ b/google/cloud/spanner_v1/proto/spanner_pb2.py @@ -3088,9 +3088,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 @@ -3102,16 +3102,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. diff --git a/google/cloud/spanner_v1/proto/transaction_pb2.py b/google/cloud/spanner_v1/proto/transaction_pb2.py index 44596d1111..865a2446ad 100644 --- a/google/cloud/spanner_v1/proto/transaction_pb2.py +++ b/google/cloud/spanner_v1/proto/transaction_pb2.py @@ -644,34 +644,50 @@ ), "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 re-used for the next transaction. It is not necessary - to create a new session for each transaction. Transaction Modes - Cloud Spanner supports three transaction modes: 1. - Locking read-write. This type of transaction is the only way to write - data into Cloud Spanner. These transactions rely on pessimistic - locking and, if necessary, two-phase commit. Locking read-write - transactions may abort, requiring the application to retry. 2. - Snapshot read-only. This transaction type provides guaranteed - consistency across several reads, but does not allow writes. Snapshot - read-only transactions can be configured to read at timestamps in the - past. Snapshot read-only transactions do not need to be committed. 3. - Partitioned DML. This type of transaction is used to execute a single - Partitioned DML statement. Partitioned DML partitions the key space - and runs the DML statement over each partition in parallel using - separate, internal transactions that commit independently. - Partitioned DML transactions do not need to be committed. For - transactions that only read, snapshot read-only transactions provide - simpler semantics and are almost always faster. In particular, read- - only transactions do not take locks, so they do not conflict with - read-write transactions. As a consequence of not taking locks, they - also do not abort, so retry loops are not needed. Transactions may - only read/write data in a single database. They may, however, - read/write data in different tables within that database. Locking - Read-Write Transactions Locking - transactions may be used to atomically read-modify-write data anywhere - in a database. This type of transaction is externally consistent. + "__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 + re-used for the next transaction. It is not necessary to create a new + session for each transaction. + + Transaction Modes + + + Cloud Spanner supports three transaction modes: + + 1. Locking read-write. This type of transaction is the only way to write + data into Cloud Spanner. These transactions rely on pessimistic + locking and, if necessary, two-phase commit. Locking read-write + transactions may abort, requiring the application to retry. + + 2. Snapshot read-only. This transaction type provides guaranteed + consistency across several reads, but does not allow writes. Snapshot + read-only transactions can be configured to read at timestamps in the + past. Snapshot read-only transactions do not need to be committed. + + 3. Partitioned DML. This type of transaction is used to execute a single + Partitioned DML statement. Partitioned DML partitions the key space + and runs the DML statement over each partition in parallel using + separate, internal transactions that commit independently. + Partitioned DML transactions do not need to be committed. + + For transactions that only read, snapshot read-only transactions provide + simpler semantics and are almost always faster. In particular, read-only + transactions do not take locks, so they do not conflict with read-write + transactions. As a consequence of not taking locks, they also do not + abort, so retry loops are not needed. + + Transactions may only read/write data in a single database. They may, + however, read/write data in different tables within that database. + + Locking Read-Write Transactions + + + Locking transactions may be used to atomically read-modify-write data + anywhere in a database. This type of transaction is externally + consistent. + Clients should attempt to minimize the amount of time a transaction is active. Faster transactions commit with higher probability and cause less contention. Cloud Spanner attempts to keep read locks active as @@ -679,160 +695,238 @@ 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. Conceptually, a read-write - transaction consists of zero or more reads or SQL statements followed - by [Commit][google.spanner.v1.Spanner.Commit]. At any time before - [Commit][google.spanner.v1.Spanner.Commit], the client can send a - [Rollback][google.spanner.v1.Spanner.Rollback] request to abort the - transaction. Semantics Cloud Spanner can commit the - transaction if all read locks it acquired are still valid at commit - time, and it is able to acquire write locks for all writes. Cloud - Spanner can abort the transaction for any reason. If a commit attempt - returns ``ABORTED``, Cloud Spanner guarantees that 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 Cloud Spanner - locks for any sort of mutual exclusion other than between Cloud - Spanner transactions themselves. Retrying Aborted Transactions - 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 with each consecutive - abort, meaning that each attempt has a slightly better chance of - success than the previous. Under some circumstances (e.g., many - transactions attempting to modify the same row(s)), a transaction can - abort many times in a short period before successfully committing. - Thus, it is not a good idea to cap the number of retries a transaction - can attempt; instead, it is better to limit the total amount of wall - time spent retrying. Idle Transactions A - transaction is considered idle if it has no outstanding reads or SQL + 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]. + At any time before [Commit][google.spanner.v1.Spanner.Commit], the + client can send a [Rollback][google.spanner.v1.Spanner.Rollback] request + to abort the transaction. + + Semantics + + + Cloud Spanner can commit the transaction if all read locks it acquired + are still valid at commit time, and it is able to acquire write locks + for all writes. Cloud Spanner can abort the transaction for any reason. + If a commit attempt returns ``ABORTED``, Cloud Spanner guarantees that + 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 + Cloud Spanner locks for any sort of mutual exclusion other than between + Cloud Spanner transactions themselves. + + Retrying Aborted Transactions + + + 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 + with each consecutive abort, meaning that each attempt has a slightly + better chance of success than the previous. + + Under some circumstances (e.g., many transactions attempting to modify + the same row(s)), a transaction can abort many times in a short period + before successfully committing. Thus, it is not a good idea to cap the + number of retries a transaction can attempt; instead, it is better to + limit the total amount of wall time spent retrying. + + Idle Transactions + + + 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 with error ``ABORTED``. If this behavior is undesirable, - periodically executing a simple SQL query in the transaction (e.g., - ``SELECT 1``) prevents the transaction from becoming idle. Snapshot - Read-Only Transactions Snapshot read- - only transactions provides a simpler method than locking read-write - transactions for doing several consistent reads. However, this type of - transaction does not support writes. Snapshot transactions do not - take locks. Instead, they work by choosing a Cloud Spanner timestamp, - then executing all reads at that timestamp. Since they do not acquire - locks, they do not block concurrent read-write transactions. Unlike - locking read-write transactions, snapshot read-only transactions never - abort. They can fail if the chosen read timestamp is garbage + 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 + with error ``ABORTED``. + + If this behavior is undesirable, periodically executing a simple SQL + query in the transaction (e.g., ``SELECT 1``) prevents the transaction + from becoming idle. + + Snapshot Read-Only Transactions + + + Snapshot read-only transactions provides a simpler method than locking + read-write transactions for doing several consistent reads. However, + this type of transaction does not support writes. + + Snapshot transactions do not take locks. Instead, they work by choosing + a Cloud Spanner timestamp, then executing all reads at that timestamp. + Since they do not acquire locks, they do not block concurrent read-write + transactions. + + Unlike locking read-write transactions, snapshot read-only transactions + never abort. They can fail if the chosen read timestamp is garbage collected; however, the default garbage collection policy is generous enough that most applications do not need to worry about this in - practice. Snapshot read-only transactions do not need to call + practice. + + Snapshot read-only transactions do not need to call [Commit][google.spanner.v1.Spanner.Commit] or [Rollback][google.spanner.v1.Spanner.Rollback] (and in fact are not - permitted to do so). To execute a snapshot transaction, the client - specifies a timestamp bound, which tells Cloud Spanner how to choose a - read timestamp. The types of timestamp bound are: - Strong (the - default). - Bounded staleness. - Exact staleness. If the Cloud - Spanner database to be read is geographically distributed, stale read- - only transactions can execute more quickly than strong or read-write - transaction, because they are able to execute far from the leader - replica. Each type of timestamp bound is discussed in detail below. - Strong 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 transaction. Strong reads are not repeatable: two - consecutive strong read-only transactions might return inconsistent - results if there are concurrent writes. If consistency across reads is - required, the reads should be executed within a transaction or at an - exact read timestamp. See [TransactionOptions.ReadOnly.strong][google - .spanner.v1.TransactionOptions.ReadOnly.strong]. Exact Staleness - These timestamp bounds execute reads at a user- - specified timestamp. Reads at a timestamp are guaranteed to see a - consistent prefix of the global transaction history: they observe - modifications done by all transactions with a commit timestamp <= the - read timestamp, and observe none of the modifications done by - transactions with a larger commit timestamp. They will block until all - conflicting transactions that may be assigned commit timestamps <= the - read timestamp have finished. 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 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 [Transactio - nOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions - .ReadOnly.read_timestamp] and [TransactionOptions.ReadOnly.exact_stale - ness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness]. - Bounded Staleness Bounded staleness modes allow - Cloud Spanner to pick the read timestamp, subject to a user-provided - staleness bound. Cloud Spanner chooses the 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 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 thus return - inconsistent results. Boundedly stale reads execute in two phases: - the first phase negotiates a timestamp among all replicas needed to - serve the read. In the second phase, reads are executed at the - negotiated timestamp. As a result of the two phase execution, bounded - staleness reads are usually a little slower than comparable exact - staleness reads. However, they are typically able to return fresher - results, and are more likely to execute at the closest replica. + permitted to do so). + + To execute a snapshot transaction, the client specifies a timestamp + bound, which tells Cloud Spanner how to choose a read timestamp. + + The types of timestamp bound are: + + - Strong (the default). + - Bounded staleness. + - Exact staleness. + + If the Cloud Spanner database to be read is geographically distributed, + stale read-only transactions can execute more quickly than strong or + read-write transaction, because they are able to execute far from the + leader replica. + + Each type of timestamp bound is discussed in detail below. + + Strong + + + 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 + transaction. + + Strong reads are not repeatable: two consecutive strong read-only + transactions might return inconsistent results if there are concurrent + writes. If consistency across reads is required, the reads should be + executed within a transaction or at an exact read timestamp. + + See + [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong]. + + Exact Staleness + + + These timestamp bounds execute reads at a user-specified timestamp. + Reads at a timestamp are guaranteed to see a consistent prefix of the + global transaction history: they observe modifications done by all + transactions with a commit timestamp <= the read timestamp, and observe + none of the modifications done by transactions with a larger commit + timestamp. They will block until all conflicting transactions that may + be assigned commit timestamps <= the read timestamp have finished. + + 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 + 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] + and + [TransactionOptions.ReadOnly.exact\_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact\_staleness]. + + Bounded Staleness + + + Bounded staleness modes allow Cloud Spanner to pick the read timestamp, + subject to a user-provided staleness bound. Cloud Spanner chooses the + 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 + 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 + thus return inconsistent results. + + Boundedly stale reads execute in two phases: the first phase negotiates + a timestamp among all replicas needed to serve the read. In the second + phase, reads are executed at the negotiated timestamp. + + As a result of the two phase execution, bounded staleness reads are + usually a little slower than comparable exact staleness reads. However, + they are typically able to return fresher results, and are more likely + to execute at the closest replica. + Because the timestamp negotiation requires up-front knowledge of which rows will be read, it can only be used with single-use read-only - transactions. See [TransactionOptions.ReadOnly.max_staleness][google. - spanner.v1.TransactionOptions.ReadOnly.max_staleness] and [Transaction - Options.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOpti - ons.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 one hour - old. Because of this, Cloud Spanner cannot perform reads at read - timestamps more than one hour in the past. This restriction also + transactions. + + See + [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]. + + 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 + 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 too old while executing. Reads and SQL queries with too-old read - timestamps fail with the error ``FAILED_PRECONDITION``. Partitioned - DML Transactions Partitioned DML - transactions are used to execute DML statements with a different - execution strategy that provides different, and often better, + timestamps fail with the error ``FAILED_PRECONDITION``. + + Partitioned DML Transactions + + + Partitioned DML transactions are used to execute DML statements with a + different execution strategy that provides different, and often better, scalability properties for large, table-wide operations than DML in a ReadWrite transaction. Smaller scoped statements, such as an OLTP - workload, should prefer using ReadWrite transactions. Partitioned DML - partitions the keyspace and runs the DML statement on each partition - in separate, internal transactions. These transactions commit - automatically when complete, and run independently from one another. + workload, should prefer using ReadWrite transactions. + + Partitioned DML partitions the keyspace and runs the DML statement on + each partition in separate, internal transactions. These transactions + commit automatically when complete, and run independently from one + another. + To reduce lock contention, this execution strategy only acquires read locks on rows that match the WHERE clause of the statement. - Additionally, the smaller per-partition transactions hold locks for - less time. That said, Partitioned DML is not a drop-in replacement - for standard DML used in ReadWrite transactions. - The DML statement - must be fully-partitionable. Specifically, the statement must be - expressible as the union of many statements which each access only - a single row of the table. - The statement is not applied atomically - to all rows of the table. Rather, the statement is applied - atomically to partitions of the table, in independent transactions. - Secondary index rows are updated atomically with the base table - rows. - Partitioned DML does not guarantee exactly-once execution - semantics against a partition. The statement will be applied at - least once to each partition. It is strongly recommended that the - DML statement should be idempotent to avoid unexpected results. For - instance, it is potentially dangerous to run a statement such as - ``UPDATE table SET column = column + 1`` as it could be run multiple - times against some rows. - The partitions are committed - automatically - there is no support for Commit or Rollback. If the - call returns an error, or if the client issuing the ExecuteSql call - dies, it is possible that some rows had the statement executed on - them successfully. It is also possible that statement was never - executed against other rows. - Partitioned DML transactions may only - contain the execution of a single DML statement via ExecuteSql or - ExecuteStreamingSql. - If any error is encountered during the - execution of the partitioned DML operation (for instance, a UNIQUE - INDEX violation, division by zero, or a value that cannot be stored - due to schema constraints), then the operation is stopped at that - point and an error is returned. It is possible that at this point, - some partitions have been committed (or even committed multiple - times), and other partitions have not been run at all. Given the - above, Partitioned DML is good fit for large, database-wide, + Additionally, the smaller per-partition transactions hold locks for less + time. + + That said, Partitioned DML is not a drop-in replacement for standard DML + used in ReadWrite transactions. + + - The DML statement must be fully-partitionable. Specifically, the + statement must be expressible as the union of many statements which + each access only a single row of the table. + + - The statement is not applied atomically to all rows of the table. + Rather, the statement is applied atomically to partitions of the + table, in independent transactions. Secondary index rows are updated + atomically with the base table rows. + + - Partitioned DML does not guarantee exactly-once execution semantics + against a partition. The statement will be applied at least once to + each partition. It is strongly recommended that the DML statement + should be idempotent to avoid unexpected results. For instance, it is + potentially dangerous to run a statement such as + ``UPDATE table SET column = column + 1`` as it could be run multiple + times against some rows. + + - The partitions are committed automatically - there is no support for + Commit or Rollback. If the call returns an error, or if the client + issuing the ExecuteSql call dies, it is possible that some rows had + the statement executed on them successfully. It is also possible that + statement was never executed against other rows. + + - Partitioned DML transactions may only contain the execution of a + single DML statement via ExecuteSql or ExecuteStreamingSql. + + - If any error is encountered during the execution of the partitioned + DML operation (for instance, a UNIQUE INDEX violation, division by + zero, or a value that cannot be stored due to schema constraints), + then the operation is stopped at that point and an error is returned. + It is possible that at this point, some partitions have been + committed (or even committed multiple times), and other partitions + have not been run at all. + + Given the above, Partitioned DML is good fit for large, database-wide, operations that are idempotent, such as deleting old rows from a very large table. @@ -883,10 +977,10 @@ 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) }, @@ -901,8 +995,9 @@ "__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. See - [TransactionOptions][google.spanner.v1.TransactionOptions] for more + [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] call runs. + + See [TransactionOptions][google.spanner.v1.TransactionOptions] for more information about transactions. Attributes: From 98c0babec36d0e3a9d3cc8bd4788d5c92ada3c68 Mon Sep 17 00:00:00 2001 From: larkee Date: Fri, 7 Aug 2020 11:51:30 +1000 Subject: [PATCH 9/9] ci: add missing nox session for docs-presubmit --- noxfile.py | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/noxfile.py b/noxfile.py index 91de61a9de..231bd42f9c 100644 --- a/noxfile.py +++ b/noxfile.py @@ -171,3 +171,36 @@ def docs(session): os.path.join("docs", ""), os.path.join("docs", "_build", "html", ""), ) + + +@nox.session(python="3.7") +def docfx(session): + """Build the docfx yaml files for this library.""" + + session.install("-e", ".") + session.install("sphinx", "alabaster", "recommonmark", "sphinx-docfx-yaml") + + shutil.rmtree(os.path.join("docs", "_build"), ignore_errors=True) + session.run( + "sphinx-build", + "-T", # show full traceback on exception + "-N", # no colors + "-D", + ( + "extensions=sphinx.ext.autodoc," + "sphinx.ext.autosummary," + "docfx_yaml.extension," + "sphinx.ext.intersphinx," + "sphinx.ext.coverage," + "sphinx.ext.napoleon," + "sphinx.ext.todo," + "sphinx.ext.viewcode," + "recommonmark" + ), + "-b", + "html", + "-d", + os.path.join("docs", "_build", "doctrees", ""), + os.path.join("docs", ""), + os.path.join("docs", "_build", "html", ""), + )