@googleapis/spanner 7.4.1 → 7.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/v1.d.ts CHANGED
@@ -72,10 +72,45 @@ export declare namespace spanner_v1 {
72
72
  scans: Resource$Scans;
73
73
  constructor(options: GlobalOptions, google?: GoogleConfigurable);
74
74
  }
75
+ /**
76
+ * The request for AddSplitPoints.
77
+ */
78
+ export interface Schema$AddSplitPointsRequest {
79
+ /**
80
+ * Optional. A user-supplied tag associated with the split points. For example, "intital_data_load", "special_event_1". Defaults to "CloudAddSplitPointsAPI" if not specified. The length of the tag must not exceed 50 characters,else will be trimmed. Only valid UTF8 characters are allowed.
81
+ */
82
+ initiator?: string | null;
83
+ /**
84
+ * Required. The split points to add.
85
+ */
86
+ splitPoints?: Schema$SplitPoints[];
87
+ }
88
+ /**
89
+ * The response for AddSplitPoints.
90
+ */
91
+ export interface Schema$AddSplitPointsResponse {
92
+ }
93
+ /**
94
+ * AsymmetricAutoscalingOption specifies the scaling of replicas identified by the given selection.
95
+ */
96
+ export interface Schema$AsymmetricAutoscalingOption {
97
+ /**
98
+ * Optional. Overrides applied to the top-level autoscaling configuration for the selected replicas.
99
+ */
100
+ overrides?: Schema$AutoscalingConfigOverrides;
101
+ /**
102
+ * Required. Selects the replicas to which this AsymmetricAutoscalingOption applies. Only read-only replicas are supported.
103
+ */
104
+ replicaSelection?: Schema$InstanceReplicaSelection;
105
+ }
75
106
  /**
76
107
  * Autoscaling configuration for an instance.
77
108
  */
78
109
  export interface Schema$AutoscalingConfig {
110
+ /**
111
+ * Optional. Optional asymmetric autoscaling options. Replicas matching the replica selection criteria will be autoscaled independently from other replicas. The autoscaler will scale the replicas based on the utilization of replicas identified by the replica selection. Replica selections should not overlap with each other. Other replicas (those do not match any replica selection) will be autoscaled together and will have the same compute capacity allocated to them.
112
+ */
113
+ asymmetricAutoscalingOptions?: Schema$AsymmetricAutoscalingOption[];
79
114
  /**
80
115
  * Required. Autoscaling limits for an instance.
81
116
  */
@@ -85,6 +120,19 @@ export declare namespace spanner_v1 {
85
120
  */
86
121
  autoscalingTargets?: Schema$AutoscalingTargets;
87
122
  }
123
+ /**
124
+ * Overrides the top-level autoscaling configuration for the replicas identified by `replica_selection`. All fields in this message are optional. Any unspecified fields will use the corresponding values from the top-level autoscaling configuration.
125
+ */
126
+ export interface Schema$AutoscalingConfigOverrides {
127
+ /**
128
+ * Optional. If specified, overrides the min/max limit in the top-level autoscaling configuration for the selected replicas.
129
+ */
130
+ autoscalingLimits?: Schema$AutoscalingLimits;
131
+ /**
132
+ * Optional. If specified, overrides the autoscaling target high_priority_cpu_utilization_percent in the top-level autoscaling configuration for the selected replicas.
133
+ */
134
+ autoscalingTargetHighPriorityCpuUtilizationPercent?: number | null;
135
+ }
88
136
  /**
89
137
  * The autoscaling limits for the instance. Users can define the minimum and maximum compute capacity allocated to the instance, and the autoscaler will only scale within that range. Users can either use nodes or processing units to specify the limits, but should use the same unit to set both the min_limit and max_limit.
90
138
  */
@@ -144,7 +192,7 @@ export declare namespace spanner_v1 {
144
192
  */
145
193
  encryptionInfo?: Schema$EncryptionInfo;
146
194
  /**
147
- * Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status' field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.
195
+ * Output only. The encryption information for the backup, whether it is protected by one or more KMS keys. The information includes all Cloud KMS key versions used to encrypt the backup. The `encryption_status` field inside of each `EncryptionInfo` is not populated. At least one of the key versions must be available for the backup to be restored. If a key version is revoked in the middle of a restore, the restore behavior is undefined.
148
196
  */
149
197
  encryptionInformation?: Schema$EncryptionInfo[];
150
198
  /**
@@ -218,7 +266,7 @@ export declare namespace spanner_v1 {
218
266
  versionTime?: string | null;
219
267
  }
220
268
  /**
221
- * BackupSchedule expresses the automated backup creation specification for a Spanner database. Next ID: 10
269
+ * BackupSchedule expresses the automated backup creation specification for a Spanner database.
222
270
  */
223
271
  export interface Schema$BackupSchedule {
224
272
  /**
@@ -319,6 +367,10 @@ export declare namespace spanner_v1 {
319
367
  * The request for BeginTransaction.
320
368
  */
321
369
  export interface Schema$BeginTransactionRequest {
370
+ /**
371
+ * Optional. Required for read-write transactions on a multiplexed session that commit mutations but do not perform any reads or queries. Clients should randomly select one of the mutations from the mutation set and send it as a part of this request.
372
+ */
373
+ mutationKey?: Schema$Mutation;
322
374
  /**
323
375
  * Required. Options for the new transaction.
324
376
  */
@@ -408,6 +460,10 @@ export declare namespace spanner_v1 {
408
460
  * The mutations to be executed when this transaction commits. All mutations are applied atomically, in the order they appear in this list.
409
461
  */
410
462
  mutations?: Schema$Mutation[];
463
+ /**
464
+ * Optional. If the read-write transaction was executed on a multiplexed session, the precommit token with the highest sequence number received in this transaction attempt, should be included here. Failing to do so will result in a FailedPrecondition error.
465
+ */
466
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
411
467
  /**
412
468
  * Common options for this request.
413
469
  */
@@ -437,6 +493,10 @@ export declare namespace spanner_v1 {
437
493
  * The Cloud Spanner timestamp at which the transaction committed.
438
494
  */
439
495
  commitTimestamp?: string | null;
496
+ /**
497
+ * If specified, transaction has not committed yet. Clients must retry the commit with the new precommit token.
498
+ */
499
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
440
500
  }
441
501
  /**
442
502
  * Additional statistics about a commit.
@@ -481,7 +541,7 @@ export declare namespace spanner_v1 {
481
541
  */
482
542
  kmsKeyName?: string | null;
483
543
  /**
484
- * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. Kms keys specified can be in any order. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.
544
+ * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. KMS keys specified can be in any order. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
485
545
  */
486
546
  kmsKeyNames?: string[] | null;
487
547
  }
@@ -540,7 +600,7 @@ export declare namespace spanner_v1 {
540
600
  */
541
601
  kmsKeyName?: string | null;
542
602
  /**
543
- * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.
603
+ * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
544
604
  */
545
605
  kmsKeyNames?: string[] | null;
546
606
  }
@@ -617,7 +677,7 @@ export declare namespace spanner_v1 {
617
677
  progress?: Schema$InstanceOperationProgress;
618
678
  }
619
679
  /**
620
- * The request for CreateInstanceConfigRequest.
680
+ * The request for CreateInstanceConfig.
621
681
  */
622
682
  export interface Schema$CreateInstanceConfigRequest {
623
683
  /**
@@ -723,7 +783,7 @@ export declare namespace spanner_v1 {
723
783
  */
724
784
  creationWindow?: string | null;
725
785
  /**
726
- * Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timzeone. The backup will contain an externally consistent copy of the database at the version time. Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.
786
+ * Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timezone. The backup will contain an externally consistent copy of the database at the version time. Full backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours past midnight in UTC. * `0 x/4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past midnight in UTC.
727
787
  */
728
788
  text?: string | null;
729
789
  /**
@@ -760,7 +820,7 @@ export declare namespace spanner_v1 {
760
820
  */
761
821
  encryptionConfig?: Schema$EncryptionConfig;
762
822
  /**
763
- * Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status' field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.
823
+ * Output only. For databases that are using customer managed encryption, this field contains the encryption information for the database, such as all Cloud KMS key versions that are in use. The `encryption_status` field inside of each `EncryptionInfo` is not populated. For databases that are using Google default or other types of encryption, this field is empty. This field is propagated lazily from the backend. There might be a delay from when a key version is being used and when it appears in this field.
764
824
  */
765
825
  encryptionInfo?: Schema$EncryptionInfo[];
766
826
  /**
@@ -897,7 +957,7 @@ export declare namespace spanner_v1 {
897
957
  */
898
958
  kmsKeyName?: string | null;
899
959
  /**
900
- * Specifies the KMS configuration for the one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configs, specify a single regional location KMS key. * For multi-regional database instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For a database instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.
960
+ * Specifies the KMS configuration for one or more keys used to encrypt the database. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
901
961
  */
902
962
  kmsKeyNames?: string[] | null;
903
963
  }
@@ -931,6 +991,10 @@ export declare namespace spanner_v1 {
931
991
  * The request for ExecuteBatchDml.
932
992
  */
933
993
  export interface Schema$ExecuteBatchDmlRequest {
994
+ /**
995
+ * Optional. If set to true, this request marks the end of the transaction. The transaction should be committed or aborted after these statements execute, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. Setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of statements should not be assumed until a subsequent Commit call completes successfully.
996
+ */
997
+ lastStatements?: boolean | null;
934
998
  /**
935
999
  * Common options for this request.
936
1000
  */
@@ -952,6 +1016,10 @@ export declare namespace spanner_v1 {
952
1016
  * The response for ExecuteBatchDml. Contains a list of ResultSet messages, one for each DML statement that has successfully executed, in the same order as the statements in the request. If a statement fails, the status in the response body identifies the cause of the failure. To check for DML statements that failed, use the following approach: 1. Check the status in the response message. The google.rpc.Code enum value `OK` indicates that all statements were executed successfully. 2. If the status was not `OK`, check the number of result sets in the response. If the response contains `N` ResultSet messages, then statement `N+1` in the request failed. Example 1: * Request: 5 DML statements, all executed successfully. * Response: 5 ResultSet messages, with the status `OK`. Example 2: * Request: 5 DML statements. The third statement has a syntax error. * Response: 2 ResultSet messages, and a syntax error (`INVALID_ARGUMENT`) status. The number of ResultSet messages indicates that the third statement failed, and the fourth and fifth statements were not executed.
953
1017
  */
954
1018
  export interface Schema$ExecuteBatchDmlResponse {
1019
+ /**
1020
+ * Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
1021
+ */
1022
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
955
1023
  /**
956
1024
  * One ResultSet for each statement in the request that ran successfully, in the same order as the statements in the request. Each ResultSet does not contain any rows. The ResultSetStats in each ResultSet contain the number of rows modified by the statement. Only the first ResultSet in the response contains valid ResultSetMetadata.
957
1025
  */
@@ -973,6 +1041,10 @@ export declare namespace spanner_v1 {
973
1041
  * Directed read options for this request.
974
1042
  */
975
1043
  directedReadOptions?: Schema$DirectedReadOptions;
1044
+ /**
1045
+ * Optional. If set to true, this statement marks the end of the transaction. The transaction should be committed or aborted after this statement executes, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. For DML statements, setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of a DML statement should not be assumed until a subsequent Commit call completes successfully.
1046
+ */
1047
+ lastStatement?: boolean | null;
976
1048
  /**
977
1049
  * Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names must conform to the naming requirements of identifiers as specified at https://cloud.google.com/spanner/docs/lexical#identifiers. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `"WHERE id \> @msg_id AND id < @msg_id + 100"` It is an error to execute a SQL statement with unbound parameters.
978
1050
  */
@@ -1174,6 +1246,10 @@ export declare namespace spanner_v1 {
1174
1246
  * Output only. The time at which the instance was created.
1175
1247
  */
1176
1248
  createTime?: string | null;
1249
+ /**
1250
+ * Optional. Controls the default backup schedule behavior for new databases within the instance. By default, a backup schedule is created automatically when a new database is created in a new instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances` response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner doesn't create a default backup schedule for new databases in the instance.
1251
+ */
1252
+ defaultBackupScheduleType?: string | null;
1177
1253
  /**
1178
1254
  * Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and between 4 and 30 characters in length.
1179
1255
  */
@@ -1212,6 +1288,10 @@ export declare namespace spanner_v1 {
1212
1288
  * The number of processing units allocated to this instance. At most, one of either `processing_units` or `node_count` should be present in the message. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance. If autoscaling is enabled, `processing_units` is treated as an `OUTPUT_ONLY` field and reflects the current number of processing units allocated to the instance. This might be zero in API responses for instances that are not yet in the `READY` state. For more information, see [Compute capacity, nodes and processing units](https://cloud.google.com/spanner/docs/compute-capacity).
1213
1289
  */
1214
1290
  processingUnits?: number | null;
1291
+ /**
1292
+ * Output only. Lists the compute capacity per ReplicaSelection. A replica selection identifies a set of replicas with common properties. Replicas identified by a ReplicaSelection are scaled with the same compute capacity.
1293
+ */
1294
+ replicaComputeCapacity?: Schema$ReplicaComputeCapacity[];
1215
1295
  /**
1216
1296
  * Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`.
1217
1297
  */
@@ -1350,6 +1430,24 @@ export declare namespace spanner_v1 {
1350
1430
  */
1351
1431
  updateTime?: string | null;
1352
1432
  }
1433
+ /**
1434
+ * ReplicaSelection identifies replicas with common properties.
1435
+ */
1436
+ export interface Schema$InstanceReplicaSelection {
1437
+ /**
1438
+ * Required. Name of the location of the replicas (e.g., "us-central1").
1439
+ */
1440
+ location?: string | null;
1441
+ }
1442
+ /**
1443
+ * A split key.
1444
+ */
1445
+ export interface Schema$Key {
1446
+ /**
1447
+ * Required. The column values making up the split key.
1448
+ */
1449
+ keyParts?: any[] | null;
1450
+ }
1353
1451
  /**
1354
1452
  * 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 the ith component of the table or index primary key. Individual values are encoded as described here. For example, consider the following table definition: CREATE TABLE UserEvents ( UserName STRING(MAX), EventDate STRING(10) ) PRIMARY KEY(UserName, EventDate); The following keys name rows in this table: "Bob", "2014-09-23" Since the `UserEvents` table's `PRIMARY KEY` clause names two columns, each `UserEvents` key has two elements; the first is the `UserName`, and the second is the `EventDate`. Key ranges with multiple components are interpreted lexicographically by component using the table or index key's declared sort order. For example, the following range returns all events for user `"Bob"` that occurred in the year 2015: "start_closed": ["Bob", "2015-01-01"] "end_closed": ["Bob", "2015-12-31"] Start and end keys can omit trailing key components. This affects the inclusion and exclusion of rows that exactly match the provided key components: if the key is closed, then rows that exactly match the provided components are included; if the key is open, then rows that exactly match are not included. For example, the following range includes all events for `"Bob"` that occurred during and after the year 2000: "start_closed": ["Bob", "2000-01-01"] "end_closed": ["Bob"] The next example retrieves all events for `"Bob"`: "start_closed": ["Bob"] "end_closed": ["Bob"] To retrieve events before the year 2000: "start_closed": ["Bob"] "end_open": ["Bob", "2000-01-01"] The following range includes all rows in the table: "start_closed": [] "end_closed": [] This range returns all users whose `UserName` begins with any character from A to C: "start_closed": ["A"] "end_open": ["D"] This range returns all users whose `UserName` begins with B: "start_closed": ["B"] "end_open": ["C"] Key ranges honor column sort order. For example, suppose a table is defined as follows: CREATE TABLE DescendingSortedTable { Key INT64, ... ) PRIMARY KEY(Key DESC); The following range retrieves all rows with key values between 1 and 100 inclusive: "start_closed": ["100"] "end_closed": ["1"] Note that 100 is passed as the start, and 1 is passed as the end, because `Key` is a descending column in the schema.
1355
1453
  */
@@ -1739,6 +1837,19 @@ export declare namespace spanner_v1 {
1739
1837
  */
1740
1838
  targetConfig?: string | null;
1741
1839
  }
1840
+ /**
1841
+ * When a read-write transaction is executed on a multiplexed session, this precommit token is sent back to the client as a part of the [Transaction] message in the BeginTransaction response and also as a part of the [ResultSet] and [PartialResultSet] responses.
1842
+ */
1843
+ export interface Schema$MultiplexedSessionPrecommitToken {
1844
+ /**
1845
+ * Opaque precommit token.
1846
+ */
1847
+ precommitToken?: string | null;
1848
+ /**
1849
+ * An incrementing seq number is generated on every precommit token that is returned. Clients should remember the precommit token with the highest sequence number from the current transaction attempt.
1850
+ */
1851
+ seqNum?: number | null;
1852
+ }
1742
1853
  /**
1743
1854
  * A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a Commit call.
1744
1855
  */
@@ -1844,6 +1955,10 @@ export declare namespace spanner_v1 {
1844
1955
  * Metadata about the result set, such as row type information. Only present in the first response.
1845
1956
  */
1846
1957
  metadata?: Schema$ResultSetMetadata;
1958
+ /**
1959
+ * Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
1960
+ */
1961
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
1847
1962
  /**
1848
1963
  * Streaming calls might be interrupted for a variety of reasons, such as TCP connection loss. If this occurs, the stream of results can be resumed by re-sending the original request and including `resume_token`. Note that executing any other transaction in the same session invalidates the token.
1849
1964
  */
@@ -2065,7 +2180,7 @@ export declare namespace spanner_v1 {
2065
2180
  */
2066
2181
  planNodes?: Schema$PlanNode[];
2067
2182
  /**
2068
- * Optional. The advices/recommendations for a query. Currently this field will be serving index recommendations for a query.
2183
+ * Optional. The advise/recommendations for a query. Currently this field will be serving index recommendations for a query.
2069
2184
  */
2070
2185
  queryAdvice?: Schema$QueryAdvisorResult;
2071
2186
  }
@@ -2193,11 +2308,32 @@ export declare namespace spanner_v1 {
2193
2308
  * Message type to initiate a read-write transaction. Currently this transaction type has no options.
2194
2309
  */
2195
2310
  export interface Schema$ReadWrite {
2311
+ /**
2312
+ * Optional. Clients should pass the transaction ID of the previous transaction attempt that was aborted if this transaction is being executed on a multiplexed session.
2313
+ */
2314
+ multiplexedSessionPreviousTransactionId?: string | null;
2196
2315
  /**
2197
2316
  * Read lock mode for the transaction.
2198
2317
  */
2199
2318
  readLockMode?: string | null;
2200
2319
  }
2320
+ /**
2321
+ * ReplicaComputeCapacity describes the amount of server resources that are allocated to each replica identified by the replica selection.
2322
+ */
2323
+ export interface Schema$ReplicaComputeCapacity {
2324
+ /**
2325
+ * The number of nodes allocated to each replica. This may be zero in API responses for instances that are not yet in state `READY`.
2326
+ */
2327
+ nodeCount?: number | null;
2328
+ /**
2329
+ * The number of processing units allocated to each replica. This may be zero in API responses for instances that are not yet in state `READY`.
2330
+ */
2331
+ processingUnits?: number | null;
2332
+ /**
2333
+ * Required. Identifies replicas by specified properties. All replicas in the selection have the same amount of compute capacity.
2334
+ */
2335
+ replicaSelection?: Schema$InstanceReplicaSelection;
2336
+ }
2201
2337
  export interface Schema$ReplicaInfo {
2202
2338
  /**
2203
2339
  * If true, this location is designated as the default leader location where leader replicas are placed. See the [region types documentation](https://cloud.google.com/spanner/docs/instances#region_types) for more details.
@@ -2255,7 +2391,7 @@ export declare namespace spanner_v1 {
2255
2391
  */
2256
2392
  kmsKeyName?: string | null;
2257
2393
  /**
2258
- * Optional. Specifies the KMS configuration for the one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the database instance configuration. Some examples: * For single region database instance configurations, specify a single regional location KMS key. * For multi-regional database instance configurations of type `GOOGLE_MANAGED`, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For a database instance configuration of type `USER_MANAGED`, please specify only regional location KMS keys to cover each region in the instance configuration. Multi-regional location KMS keys are not supported for USER_MANAGED instance configurations.
2394
+ * Optional. Specifies the KMS configuration for one or more keys used to encrypt the database. Values have the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the database's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
2259
2395
  */
2260
2396
  kmsKeyNames?: string[] | null;
2261
2397
  }
@@ -2326,6 +2462,10 @@ export declare namespace spanner_v1 {
2326
2462
  * Metadata about the result set, such as row type information.
2327
2463
  */
2328
2464
  metadata?: Schema$ResultSetMetadata;
2465
+ /**
2466
+ * Optional. A precommit token will be included if the read-write transaction is on a multiplexed session. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
2467
+ */
2468
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
2329
2469
  /**
2330
2470
  * Each element in `rows` is a row whose format is defined by metadata.row_type. The ith element in each row matches the ith field in metadata.row_type. Elements are encoded based on type as described here.
2331
2471
  */
@@ -2492,6 +2632,27 @@ export declare namespace spanner_v1 {
2492
2632
  */
2493
2633
  servingLocation?: string | null;
2494
2634
  }
2635
+ /**
2636
+ * The split points of a table/index.
2637
+ */
2638
+ export interface Schema$SplitPoints {
2639
+ /**
2640
+ * Optional. The expiration timestamp of the split points. A timestamp in the past means immediate expiration. The maximum value can be 30 days in the future. Defaults to 10 days in the future if not specified.
2641
+ */
2642
+ expireTime?: string | null;
2643
+ /**
2644
+ * The index to split. If specified, the `table` field must refer to the index's base table.
2645
+ */
2646
+ index?: string | null;
2647
+ /**
2648
+ * Required. The list of split keys, i.e., the split boundaries.
2649
+ */
2650
+ keys?: Schema$Key[];
2651
+ /**
2652
+ * The table to split.
2653
+ */
2654
+ table?: string | null;
2655
+ }
2495
2656
  /**
2496
2657
  * A single DML statement.
2497
2658
  */
@@ -2567,6 +2728,10 @@ export declare namespace spanner_v1 {
2567
2728
  * `id` may be used to identify the transaction in subsequent Read, ExecuteSql, Commit, or Rollback calls. Single-use read-only transactions do not have IDs, because single-use transactions do not support multiple requests.
2568
2729
  */
2569
2730
  id?: string | null;
2731
+ /**
2732
+ * A precommit token will be included in the response of a BeginTransaction request if the read-write transaction is on a multiplexed session and a mutation_key was specified in the BeginTransaction. The precommit token with the highest sequence number from this transaction attempt should be passed to the Commit request for this transaction.
2733
+ */
2734
+ precommitToken?: Schema$MultiplexedSessionPrecommitToken;
2570
2735
  /**
2571
2736
  * For snapshot read-only transactions, the read timestamp chosen for the transaction. Not returned by default: see TransactionOptions.ReadOnly.return_read_timestamp. A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds. Example: `"2014-10-02T15:01:23.045123456Z"`.
2572
2737
  */
@@ -2669,7 +2834,7 @@ export declare namespace spanner_v1 {
2669
2834
  */
2670
2835
  export interface Schema$UpdateDatabaseDdlRequest {
2671
2836
  /**
2672
- * If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the name of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.
2837
+ * If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the `name` of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.
2673
2838
  */
2674
2839
  operationId?: string | null;
2675
2840
  /**
@@ -2729,7 +2894,7 @@ export declare namespace spanner_v1 {
2729
2894
  progress?: Schema$InstanceOperationProgress;
2730
2895
  }
2731
2896
  /**
2732
- * The request for UpdateInstanceConfigRequest.
2897
+ * The request for UpdateInstanceConfig.
2733
2898
  */
2734
2899
  export interface Schema$UpdateInstanceConfigRequest {
2735
2900
  /**
@@ -3053,7 +3218,7 @@ export declare namespace spanner_v1 {
3053
3218
  context: APIRequestContext;
3054
3219
  constructor(context: APIRequestContext);
3055
3220
  /**
3056
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
3221
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
3057
3222
  *
3058
3223
  * @param params - Parameters for request
3059
3224
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3154,7 +3319,7 @@ export declare namespace spanner_v1 {
3154
3319
  context: APIRequestContext;
3155
3320
  constructor(context: APIRequestContext);
3156
3321
  /**
3157
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
3322
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
3158
3323
  *
3159
3324
  * @param params - Parameters for request
3160
3325
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3578,7 +3743,7 @@ export declare namespace spanner_v1 {
3578
3743
  get(params: Params$Resource$Projects$Instances$Backups$Get, callback: BodyResponseCallback<Schema$Backup>): void;
3579
3744
  get(callback: BodyResponseCallback<Schema$Backup>): void;
3580
3745
  /**
3581
- * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.
3746
+ * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.
3582
3747
  *
3583
3748
  * @param params - Parameters for request
3584
3749
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3620,7 +3785,7 @@ export declare namespace spanner_v1 {
3620
3785
  patch(params: Params$Resource$Projects$Instances$Backups$Patch, callback: BodyResponseCallback<Schema$Backup>): void;
3621
3786
  patch(callback: BodyResponseCallback<Schema$Backup>): void;
3622
3787
  /**
3623
- * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.
3788
+ * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.
3624
3789
  *
3625
3790
  * @param params - Parameters for request
3626
3791
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3634,7 +3799,7 @@ export declare namespace spanner_v1 {
3634
3799
  setIamPolicy(params: Params$Resource$Projects$Instances$Backups$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
3635
3800
  setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
3636
3801
  /**
3637
- * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.
3802
+ * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.
3638
3803
  *
3639
3804
  * @param params - Parameters for request
3640
3805
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3672,7 +3837,7 @@ export declare namespace spanner_v1 {
3672
3837
  */
3673
3838
  'encryptionConfig.kmsKeyName'?: string;
3674
3839
  /**
3675
- * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by kms_key_names must fully cover all regions of the backup's instance configuration. Some examples: * For single region instance configs, specify a single regional location KMS key. * For multi-regional instance configs of type GOOGLE_MANAGED, either specify a multi-regional location KMS key or multiple regional location KMS keys that cover all regions in the instance config. * For an instance config of type USER_MANAGED, please specify only regional location KMS keys to cover each region in the instance config. Multi-regional location KMS keys are not supported for USER_MANAGED instance configs.
3840
+ * Optional. Specifies the KMS configuration for the one or more keys used to protect the backup. Values are of the form `projects//locations//keyRings//cryptoKeys/`. The keys referenced by `kms_key_names` must fully cover all regions of the backup's instance configuration. Some examples: * For regional (single-region) instance configurations, specify a regional location KMS key. * For multi-region instance configurations of type `GOOGLE_MANAGED`, either specify a multi-region location KMS key or multiple regional location KMS keys that cover all regions in the instance configuration. * For an instance configuration of type `USER_MANAGED`, specify only regional location KMS keys to cover each region in the instance configuration. Multi-region location KMS keys aren't supported for `USER_MANAGED` type instance configurations.
3676
3841
  */
3677
3842
  'encryptionConfig.kmsKeyNames'?: string[];
3678
3843
  /**
@@ -3762,7 +3927,7 @@ export declare namespace spanner_v1 {
3762
3927
  context: APIRequestContext;
3763
3928
  constructor(context: APIRequestContext);
3764
3929
  /**
3765
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
3930
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
3766
3931
  *
3767
3932
  * @param params - Parameters for request
3768
3933
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3874,7 +4039,7 @@ export declare namespace spanner_v1 {
3874
4039
  }
3875
4040
  export interface Params$Resource$Projects$Instances$Databaseoperations$List extends StandardParameters {
3876
4041
  /**
3877
- * An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `\>`, `<=`, `\>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \ `(metadata.source_type:BACKUP) AND` \ `(metadata.backup_info.backup:backup_howl) AND` \ `(metadata.name:restored_howl) AND` \ `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains "backup_howl". * The restored database's name contains "restored_howl". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.
4042
+ * An expression that filters the list of returned operations. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `\>`, `<=`, `\>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the operation are eligible for filtering: * `name` - The name of the long-running operation * `done` - False if the operation is in progress, else true. * `metadata.@type` - the type of metadata. For example, the type string for RestoreDatabaseMetadata is `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`. * `metadata.` - any field in metadata.value. `metadata.@type` must be specified first, if filtering on metadata fields. * `error` - Error associated with the long-running operation. * `response.@type` - the type of response. * `response.` - any field in response.value. You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic. However, you can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `done:true` - The operation is complete. * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` \ `(metadata.source_type:BACKUP) AND` \ `(metadata.backup_info.backup:backup_howl) AND` \ `(metadata.name:restored_howl) AND` \ `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` \ `(error:*)` - Return operations where: * The operation's metadata type is RestoreDatabaseMetadata. * The database is restored from a backup. * The backup name contains "backup_howl". * The restored database's name contains "restored_howl". * The operation started before 2018-03-28T14:50:00Z. * The operation resulted in an error.
3878
4043
  */
3879
4044
  filter?: string;
3880
4045
  /**
@@ -3897,6 +4062,20 @@ export declare namespace spanner_v1 {
3897
4062
  operations: Resource$Projects$Instances$Databases$Operations;
3898
4063
  sessions: Resource$Projects$Instances$Databases$Sessions;
3899
4064
  constructor(context: APIRequestContext);
4065
+ /**
4066
+ * Adds split points to specified tables, indexes of a database.
4067
+ *
4068
+ * @param params - Parameters for request
4069
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
4070
+ * @param callback - Optional callback that handles the response.
4071
+ * @returns A promise if used with async/await, or void if used with a callback.
4072
+ */
4073
+ addSplitPoints(params: Params$Resource$Projects$Instances$Databases$Addsplitpoints, options: StreamMethodOptions): GaxiosPromise<Readable>;
4074
+ addSplitPoints(params?: Params$Resource$Projects$Instances$Databases$Addsplitpoints, options?: MethodOptions): GaxiosPromise<Schema$AddSplitPointsResponse>;
4075
+ addSplitPoints(params: Params$Resource$Projects$Instances$Databases$Addsplitpoints, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
4076
+ addSplitPoints(params: Params$Resource$Projects$Instances$Databases$Addsplitpoints, options: MethodOptions | BodyResponseCallback<Schema$AddSplitPointsResponse>, callback: BodyResponseCallback<Schema$AddSplitPointsResponse>): void;
4077
+ addSplitPoints(params: Params$Resource$Projects$Instances$Databases$Addsplitpoints, callback: BodyResponseCallback<Schema$AddSplitPointsResponse>): void;
4078
+ addSplitPoints(callback: BodyResponseCallback<Schema$AddSplitPointsResponse>): void;
3900
4079
  /**
3901
4080
  * `ChangeQuorum` is strictly restricted to databases that use dual-region instance configurations. Initiates a background operation to change the quorum of a database from dual-region mode to single-region mode or vice versa. The returned long-running operation has a name of the format `projects//instances//databases//operations/` and can be used to track execution of the `ChangeQuorum`. The metadata field type is ChangeQuorumMetadata. Authorization requires `spanner.databases.changequorum` permission on the resource database.
3902
4081
  *
@@ -3968,7 +4147,7 @@ export declare namespace spanner_v1 {
3968
4147
  getDdl(params: Params$Resource$Projects$Instances$Databases$Getddl, callback: BodyResponseCallback<Schema$GetDatabaseDdlResponse>): void;
3969
4148
  getDdl(callback: BodyResponseCallback<Schema$GetDatabaseDdlResponse>): void;
3970
4149
  /**
3971
- * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.
4150
+ * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.
3972
4151
  *
3973
4152
  * @param params - Parameters for request
3974
4153
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4038,7 +4217,7 @@ export declare namespace spanner_v1 {
4038
4217
  restore(params: Params$Resource$Projects$Instances$Databases$Restore, callback: BodyResponseCallback<Schema$Operation>): void;
4039
4218
  restore(callback: BodyResponseCallback<Schema$Operation>): void;
4040
4219
  /**
4041
- * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.
4220
+ * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.
4042
4221
  *
4043
4222
  * @param params - Parameters for request
4044
4223
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4052,7 +4231,7 @@ export declare namespace spanner_v1 {
4052
4231
  setIamPolicy(params: Params$Resource$Projects$Instances$Databases$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
4053
4232
  setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
4054
4233
  /**
4055
- * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.
4234
+ * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.
4056
4235
  *
4057
4236
  * @param params - Parameters for request
4058
4237
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4080,6 +4259,16 @@ export declare namespace spanner_v1 {
4080
4259
  updateDdl(params: Params$Resource$Projects$Instances$Databases$Updateddl, callback: BodyResponseCallback<Schema$Operation>): void;
4081
4260
  updateDdl(callback: BodyResponseCallback<Schema$Operation>): void;
4082
4261
  }
4262
+ export interface Params$Resource$Projects$Instances$Databases$Addsplitpoints extends StandardParameters {
4263
+ /**
4264
+ * Required. The database on whose tables/indexes split points are to be added. Values are of the form `projects//instances//databases/`.
4265
+ */
4266
+ database?: string;
4267
+ /**
4268
+ * Request body metadata
4269
+ */
4270
+ requestBody?: Schema$AddSplitPointsRequest;
4271
+ }
4083
4272
  export interface Params$Resource$Projects$Instances$Databases$Changequorum extends StandardParameters {
4084
4273
  /**
4085
4274
  * Required. Name of the database in which to apply `ChangeQuorum`. Values are of the form `projects//instances//databases/`.
@@ -4260,7 +4449,7 @@ export declare namespace spanner_v1 {
4260
4449
  get(params: Params$Resource$Projects$Instances$Databases$Backupschedules$Get, callback: BodyResponseCallback<Schema$BackupSchedule>): void;
4261
4450
  get(callback: BodyResponseCallback<Schema$BackupSchedule>): void;
4262
4451
  /**
4263
- * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource.
4452
+ * 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 a policy set. Authorization requires `spanner.databases.getIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.getIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.getIamPolicy` permission on resource.
4264
4453
  *
4265
4454
  * @param params - Parameters for request
4266
4455
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4302,7 +4491,7 @@ export declare namespace spanner_v1 {
4302
4491
  patch(params: Params$Resource$Projects$Instances$Databases$Backupschedules$Patch, callback: BodyResponseCallback<Schema$BackupSchedule>): void;
4303
4492
  patch(callback: BodyResponseCallback<Schema$BackupSchedule>): void;
4304
4493
  /**
4305
- * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource.
4494
+ * Sets the access control policy on a database or backup resource. Replaces any existing policy. Authorization requires `spanner.databases.setIamPolicy` permission on resource. For backups, authorization requires `spanner.backups.setIamPolicy` permission on resource. For backup schedules, authorization requires `spanner.backupSchedules.setIamPolicy` permission on resource.
4306
4495
  *
4307
4496
  * @param params - Parameters for request
4308
4497
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4316,7 +4505,7 @@ export declare namespace spanner_v1 {
4316
4505
  setIamPolicy(params: Params$Resource$Projects$Instances$Databases$Backupschedules$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
4317
4506
  setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
4318
4507
  /**
4319
- * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.
4508
+ * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.
4320
4509
  *
4321
4510
  * @param params - Parameters for request
4322
4511
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4432,7 +4621,7 @@ export declare namespace spanner_v1 {
4432
4621
  list(params: Params$Resource$Projects$Instances$Databases$Databaseroles$List, callback: BodyResponseCallback<Schema$ListDatabaseRolesResponse>): void;
4433
4622
  list(callback: BodyResponseCallback<Schema$ListDatabaseRolesResponse>): void;
4434
4623
  /**
4435
- * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance.
4624
+ * Returns permissions that the caller has on the specified database or backup resource. Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has `spanner.databases.list` permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has `spanner.backups.list` permission on the containing instance. Calling this method on a backup schedule that does not exist will result in a NOT_FOUND error if the user has `spanner.backupSchedules.list` permission on the containing database.
4436
4625
  *
4437
4626
  * @param params - Parameters for request
4438
4627
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4474,7 +4663,7 @@ export declare namespace spanner_v1 {
4474
4663
  context: APIRequestContext;
4475
4664
  constructor(context: APIRequestContext);
4476
4665
  /**
4477
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
4666
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
4478
4667
  *
4479
4668
  * @param params - Parameters for request
4480
4669
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4668,7 +4857,7 @@ export declare namespace spanner_v1 {
4668
4857
  executeBatchDml(params: Params$Resource$Projects$Instances$Databases$Sessions$Executebatchdml, callback: BodyResponseCallback<Schema$ExecuteBatchDmlResponse>): void;
4669
4858
  executeBatchDml(callback: BodyResponseCallback<Schema$ExecuteBatchDmlResponse>): void;
4670
4859
  /**
4671
- * Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead.
4860
+ * Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
4672
4861
  *
4673
4862
  * @param params - Parameters for request
4674
4863
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4682,7 +4871,7 @@ export declare namespace spanner_v1 {
4682
4871
  executeSql(params: Params$Resource$Projects$Instances$Databases$Sessions$Executesql, callback: BodyResponseCallback<Schema$ResultSet>): void;
4683
4872
  executeSql(callback: BodyResponseCallback<Schema$ResultSet>): void;
4684
4873
  /**
4685
- * Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB.
4874
+ * Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
4686
4875
  *
4687
4876
  * @param params - Parameters for request
4688
4877
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4978,7 +5167,7 @@ export declare namespace spanner_v1 {
4978
5167
  */
4979
5168
  filter?: string;
4980
5169
  /**
4981
- * Optional. Deadline used while retrieving metadata for instance partition operations. Instance partitions whose operation metadata cannot be retrieved within this deadline will be added to unreachable in ListInstancePartitionOperationsResponse.
5170
+ * Optional. Deadline used while retrieving metadata for instance partition operations. Instance partitions whose operation metadata cannot be retrieved within this deadline will be added to unreachable_instance_partitions in ListInstancePartitionOperationsResponse.
4982
5171
  */
4983
5172
  instancePartitionDeadline?: string;
4984
5173
  /**
@@ -5127,7 +5316,7 @@ export declare namespace spanner_v1 {
5127
5316
  context: APIRequestContext;
5128
5317
  constructor(context: APIRequestContext);
5129
5318
  /**
5130
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
5319
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
5131
5320
  *
5132
5321
  * @param params - Parameters for request
5133
5322
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5223,7 +5412,7 @@ export declare namespace spanner_v1 {
5223
5412
  context: APIRequestContext;
5224
5413
  constructor(context: APIRequestContext);
5225
5414
  /**
5226
- * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.
5415
+ * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
5227
5416
  *
5228
5417
  * @param params - Parameters for request
5229
5418
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.