google-apis-spanner_v1 0.2.0 → 0.7.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c691986d397c3d14116d3e6feb75191a64935d454f738f138f3cd5eb298278fb
4
- data.tar.gz: 249c23193582a4420af547ca7a0e0bb4f4e8fc884bc80783a6eebf3acdf601eb
3
+ metadata.gz: 968ad8bc1d63f27fa28ed1ca706bda5a5f416d19850ab1fe57dc43b5f4456b66
4
+ data.tar.gz: 5cce24c7792a710d4ba6ee22b4e0761aae41b5c1a8b223e371d0f4eea012a722
5
5
  SHA512:
6
- metadata.gz: 40e59ff7dff5cc84138d0e2f4914e630cc4b1f9a693b8bef24a6f50eb8f7d1073c31f819a3c7d89eb36e2ff952a9aae5d3eea6ec9835367d9ef4ef13f427a384
7
- data.tar.gz: 3b48ef1c5c75b29e9a6fa511aebe07ac2fbbc3b0014a7a1bbd01b0ed9dac24022563d4dafae8f0d526af631984c55e909c961e2c1d2cfa4c32d1c067ec999573
6
+ metadata.gz: 3b86bb700283b586fbacd97cd1441fed2e100d13d567f33e7209dcf9b4cacad76b245bc7420c12dba4111c72f95535e8982cf4268d0ccf5dad50fbb145f602b5
7
+ data.tar.gz: 25d611a12f3ababdd4e000a273c4339f85c54d904de5413bebbf2a50ed93d3c29f4e245f0c3b162aaaef876380d483f8bc40464bf6da5a6e751fc7968e0a24d0
data/CHANGELOG.md CHANGED
@@ -1,5 +1,26 @@
1
1
  # Release history for google-apis-spanner_v1
2
2
 
3
+ ### v0.7.0 (2021-03-26)
4
+
5
+ * Regenerated from discovery document revision 20210318
6
+
7
+ ### v0.6.0 (2021-03-13)
8
+
9
+ * Regenerated from discovery document revision 20210309
10
+ * Regenerated using generator version 0.2.0
11
+
12
+ ### v0.5.0 (2021-03-04)
13
+
14
+ * Unspecified changes
15
+
16
+ ### v0.4.0 (2021-02-24)
17
+
18
+ * Regenerated from discovery document revision 20210217
19
+
20
+ ### v0.3.0 (2021-02-13)
21
+
22
+ * Regenerated from discovery document revision 20210206
23
+
3
24
  ### v0.2.0 (2021-01-28)
4
25
 
5
26
  * Regenerated from discovery document revision 20210123
@@ -40,6 +40,11 @@ module Google
40
40
  # @return [String]
41
41
  attr_accessor :database
42
42
 
43
+ # Encryption information for a Cloud Spanner database or backup.
44
+ # Corresponds to the JSON property `encryptionInfo`
45
+ # @return [Google::Apis::SpannerV1::EncryptionInfo]
46
+ attr_accessor :encryption_info
47
+
43
48
  # Required for the CreateBackup operation. The expiration time of the backup,
44
49
  # with microseconds granularity that must be at least 6 hours and at most 366
45
50
  # days from the time the CreateBackup request is processed. Once the `
@@ -95,6 +100,7 @@ module Google
95
100
  def update!(**args)
96
101
  @create_time = args[:create_time] if args.key?(:create_time)
97
102
  @database = args[:database] if args.key?(:database)
103
+ @encryption_info = args[:encryption_info] if args.key?(:encryption_info)
98
104
  @expire_time = args[:expire_time] if args.key?(:expire_time)
99
105
  @name = args[:name] if args.key?(:name)
100
106
  @referencing_databases = args[:referencing_databases] if args.key?(:referencing_databases)
@@ -228,7 +234,7 @@ module Google
228
234
  # inactivity at the client may cause Cloud Spanner to release a transaction's
229
235
  # locks and abort it. Conceptually, a read-write transaction consists of zero or
230
236
  # more reads or SQL statements followed by Commit. At any time before Commit,
231
- # the client can send a Rollback request to abort the transaction. ### Semantics
237
+ # the client can send a Rollback request to abort the transaction. ## Semantics
232
238
  # Cloud Spanner can commit the transaction if all read locks it acquired are
233
239
  # still valid at commit time, and it is able to acquire write locks for all
234
240
  # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -236,7 +242,7 @@ module Google
236
242
  # not modified any user data in Cloud Spanner. Unless the transaction commits,
237
243
  # Cloud Spanner makes no guarantees about how long the transaction's locks were
238
244
  # held for. It is an error to use Cloud Spanner locks for any sort of mutual
239
- # exclusion other than between Cloud Spanner transactions themselves. ###
245
+ # exclusion other than between Cloud Spanner transactions themselves. ##
240
246
  # Retrying Aborted Transactions When a transaction aborts, the application can
241
247
  # choose to retry the whole transaction again. To maximize the chances of
242
248
  # successfully committing the retry, the client should execute the retry in the
@@ -247,7 +253,7 @@ module Google
247
253
  # can abort many times in a short period before successfully committing. Thus,
248
254
  # it is not a good idea to cap the number of retries a transaction can attempt;
249
255
  # instead, it is better to limit the total amount of wall time spent retrying. ##
250
- # # Idle Transactions A transaction is considered idle if it has no outstanding
256
+ # Idle Transactions A transaction is considered idle if it has no outstanding
251
257
  # reads or SQL queries and has not started a read or SQL query within the last
252
258
  # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
253
259
  # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -271,7 +277,7 @@ module Google
271
277
  # is geographically distributed, stale read-only transactions can execute more
272
278
  # quickly than strong or read-write transaction, because they are able to
273
279
  # execute far from the leader replica. Each type of timestamp bound is discussed
274
- # in detail below. ### Strong Strong reads are guaranteed to see the effects of
280
+ # in detail below. ## Strong Strong reads are guaranteed to see the effects of
275
281
  # all transactions that have committed before the start of the read. Furthermore,
276
282
  # all rows yielded by a single read are consistent with each other -- if any
277
283
  # part of the read observes a transaction, all parts of the read see the
@@ -279,7 +285,7 @@ module Google
279
285
  # transactions might return inconsistent results if there are concurrent writes.
280
286
  # If consistency across reads is required, the reads should be executed within a
281
287
  # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
282
- # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
288
+ # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
283
289
  # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
284
290
  # prefix of the global transaction history: they observe modifications done by
285
291
  # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -291,7 +297,7 @@ module Google
291
297
  # to pick a timestamp. As a result, they execute slightly faster than the
292
298
  # equivalent boundedly stale concurrency modes. On the other hand, boundedly
293
299
  # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
294
- # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
300
+ # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
295
301
  # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
296
302
  # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
297
303
  # the newest timestamp within the staleness bound that allows execution of the
@@ -309,7 +315,7 @@ module Google
309
315
  # timestamp negotiation requires up-front knowledge of which rows will be read,
310
316
  # it can only be used with single-use read-only transactions. See
311
317
  # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
312
- # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
318
+ # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
313
319
  # Spanner continuously garbage collects deleted and overwritten data in the
314
320
  # background to reclaim storage space. This process is known as "version GC". By
315
321
  # default, version GC reclaims versions after they are one hour old. Because of
@@ -358,6 +364,11 @@ module Google
358
364
  # @return [Google::Apis::SpannerV1::TransactionOptions]
359
365
  attr_accessor :options
360
366
 
367
+ # Common request options for various APIs.
368
+ # Corresponds to the JSON property `requestOptions`
369
+ # @return [Google::Apis::SpannerV1::RequestOptions]
370
+ attr_accessor :request_options
371
+
361
372
  def initialize(**args)
362
373
  update!(**args)
363
374
  end
@@ -365,6 +376,7 @@ module Google
365
376
  # Update properties of this object
366
377
  def update!(**args)
367
378
  @options = args[:options] if args.key?(:options)
379
+ @request_options = args[:request_options] if args.key?(:request_options)
368
380
  end
369
381
  end
370
382
 
@@ -488,6 +500,11 @@ module Google
488
500
  # @return [Array<Google::Apis::SpannerV1::Mutation>]
489
501
  attr_accessor :mutations
490
502
 
503
+ # Common request options for various APIs.
504
+ # Corresponds to the JSON property `requestOptions`
505
+ # @return [Google::Apis::SpannerV1::RequestOptions]
506
+ attr_accessor :request_options
507
+
491
508
  # If `true`, then statistics related to the transaction will be included in the
492
509
  # CommitResponse. Default value is `false`.
493
510
  # Corresponds to the JSON property `returnCommitStats`
@@ -528,7 +545,7 @@ module Google
528
545
  # inactivity at the client may cause Cloud Spanner to release a transaction's
529
546
  # locks and abort it. Conceptually, a read-write transaction consists of zero or
530
547
  # more reads or SQL statements followed by Commit. At any time before Commit,
531
- # the client can send a Rollback request to abort the transaction. ### Semantics
548
+ # the client can send a Rollback request to abort the transaction. ## Semantics
532
549
  # Cloud Spanner can commit the transaction if all read locks it acquired are
533
550
  # still valid at commit time, and it is able to acquire write locks for all
534
551
  # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -536,7 +553,7 @@ module Google
536
553
  # not modified any user data in Cloud Spanner. Unless the transaction commits,
537
554
  # Cloud Spanner makes no guarantees about how long the transaction's locks were
538
555
  # held for. It is an error to use Cloud Spanner locks for any sort of mutual
539
- # exclusion other than between Cloud Spanner transactions themselves. ###
556
+ # exclusion other than between Cloud Spanner transactions themselves. ##
540
557
  # Retrying Aborted Transactions When a transaction aborts, the application can
541
558
  # choose to retry the whole transaction again. To maximize the chances of
542
559
  # successfully committing the retry, the client should execute the retry in the
@@ -547,7 +564,7 @@ module Google
547
564
  # can abort many times in a short period before successfully committing. Thus,
548
565
  # it is not a good idea to cap the number of retries a transaction can attempt;
549
566
  # instead, it is better to limit the total amount of wall time spent retrying. ##
550
- # # Idle Transactions A transaction is considered idle if it has no outstanding
567
+ # Idle Transactions A transaction is considered idle if it has no outstanding
551
568
  # reads or SQL queries and has not started a read or SQL query within the last
552
569
  # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
553
570
  # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -571,7 +588,7 @@ module Google
571
588
  # is geographically distributed, stale read-only transactions can execute more
572
589
  # quickly than strong or read-write transaction, because they are able to
573
590
  # execute far from the leader replica. Each type of timestamp bound is discussed
574
- # in detail below. ### Strong Strong reads are guaranteed to see the effects of
591
+ # in detail below. ## Strong Strong reads are guaranteed to see the effects of
575
592
  # all transactions that have committed before the start of the read. Furthermore,
576
593
  # all rows yielded by a single read are consistent with each other -- if any
577
594
  # part of the read observes a transaction, all parts of the read see the
@@ -579,7 +596,7 @@ module Google
579
596
  # transactions might return inconsistent results if there are concurrent writes.
580
597
  # If consistency across reads is required, the reads should be executed within a
581
598
  # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
582
- # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
599
+ # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
583
600
  # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
584
601
  # prefix of the global transaction history: they observe modifications done by
585
602
  # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -591,7 +608,7 @@ module Google
591
608
  # to pick a timestamp. As a result, they execute slightly faster than the
592
609
  # equivalent boundedly stale concurrency modes. On the other hand, boundedly
593
610
  # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
594
- # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
611
+ # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
595
612
  # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
596
613
  # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
597
614
  # the newest timestamp within the staleness bound that allows execution of the
@@ -609,7 +626,7 @@ module Google
609
626
  # timestamp negotiation requires up-front knowledge of which rows will be read,
610
627
  # it can only be used with single-use read-only transactions. See
611
628
  # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
612
- # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
629
+ # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
613
630
  # Spanner continuously garbage collects deleted and overwritten data in the
614
631
  # background to reclaim storage space. This process is known as "version GC". By
615
632
  # default, version GC reclaims versions after they are one hour old. Because of
@@ -671,6 +688,7 @@ module Google
671
688
  # Update properties of this object
672
689
  def update!(**args)
673
690
  @mutations = args[:mutations] if args.key?(:mutations)
691
+ @request_options = args[:request_options] if args.key?(:request_options)
674
692
  @return_commit_stats = args[:return_commit_stats] if args.key?(:return_commit_stats)
675
693
  @single_use_transaction = args[:single_use_transaction] if args.key?(:single_use_transaction)
676
694
  @transaction_id = args[:transaction_id] if args.key?(:transaction_id)
@@ -805,6 +823,11 @@ module Google
805
823
  # @return [String]
806
824
  attr_accessor :create_statement
807
825
 
826
+ # Encryption configuration for a Cloud Spanner database.
827
+ # Corresponds to the JSON property `encryptionConfig`
828
+ # @return [Google::Apis::SpannerV1::EncryptionConfig]
829
+ attr_accessor :encryption_config
830
+
808
831
  # Optional. A list of DDL statements to run inside the newly created database.
809
832
  # Statements can create tables, indexes, etc. These statements execute
810
833
  # atomically with the creation of the database: if there is an error in any
@@ -820,6 +843,7 @@ module Google
820
843
  # Update properties of this object
821
844
  def update!(**args)
822
845
  @create_statement = args[:create_statement] if args.key?(:create_statement)
846
+ @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
823
847
  @extra_statements = args[:extra_statements] if args.key?(:extra_statements)
824
848
  end
825
849
  end
@@ -918,11 +942,29 @@ module Google
918
942
  attr_accessor :create_time
919
943
 
920
944
  # Output only. Earliest timestamp at which older versions of the data can be
921
- # read.
945
+ # read. This value is continuously updated by Cloud Spanner and becomes stale
946
+ # the moment it is queried. If you are using this value to recover data, make
947
+ # sure to account for the time from the moment when the value is queried to the
948
+ # moment when you initiate the recovery.
922
949
  # Corresponds to the JSON property `earliestVersionTime`
923
950
  # @return [String]
924
951
  attr_accessor :earliest_version_time
925
952
 
953
+ # Encryption configuration for a Cloud Spanner database.
954
+ # Corresponds to the JSON property `encryptionConfig`
955
+ # @return [Google::Apis::SpannerV1::EncryptionConfig]
956
+ attr_accessor :encryption_config
957
+
958
+ # Output only. For databases that are using customer managed encryption, this
959
+ # field contains the encryption information for the database, such as encryption
960
+ # state and the Cloud KMS key versions that are in use. For databases that are
961
+ # using Google default or other types of encryption, this field is empty. This
962
+ # field is propagated lazily from the backend. There might be a delay from when
963
+ # a key version is being used and when it appears in this field.
964
+ # Corresponds to the JSON property `encryptionInfo`
965
+ # @return [Array<Google::Apis::SpannerV1::EncryptionInfo>]
966
+ attr_accessor :encryption_info
967
+
926
968
  # Required. The name of the database. Values are of the form `projects//
927
969
  # instances//databases/`, where `` is as specified in the `CREATE DATABASE`
928
970
  # statement. This name can be passed to other API methods to identify the
@@ -942,7 +984,7 @@ module Google
942
984
  attr_accessor :state
943
985
 
944
986
  # Output only. The period in which Cloud Spanner retains all versions of data
945
- # for the database. This is same as the value of version_retention_period
987
+ # for the database. This is the same as the value of version_retention_period
946
988
  # database option set using UpdateDatabaseDdl. Defaults to 1 hour, if not set.
947
989
  # Corresponds to the JSON property `versionRetentionPeriod`
948
990
  # @return [String]
@@ -956,6 +998,8 @@ module Google
956
998
  def update!(**args)
957
999
  @create_time = args[:create_time] if args.key?(:create_time)
958
1000
  @earliest_version_time = args[:earliest_version_time] if args.key?(:earliest_version_time)
1001
+ @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
1002
+ @encryption_info = args[:encryption_info] if args.key?(:encryption_info)
959
1003
  @name = args[:name] if args.key?(:name)
960
1004
  @restore_info = args[:restore_info] if args.key?(:restore_info)
961
1005
  @state = args[:state] if args.key?(:state)
@@ -1009,10 +1053,72 @@ module Google
1009
1053
  end
1010
1054
  end
1011
1055
 
1056
+ # Encryption configuration for a Cloud Spanner database.
1057
+ class EncryptionConfig
1058
+ include Google::Apis::Core::Hashable
1059
+
1060
+ # The Cloud KMS key to be used for encrypting and decrypting the database.
1061
+ # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
1062
+ # Corresponds to the JSON property `kmsKeyName`
1063
+ # @return [String]
1064
+ attr_accessor :kms_key_name
1065
+
1066
+ def initialize(**args)
1067
+ update!(**args)
1068
+ end
1069
+
1070
+ # Update properties of this object
1071
+ def update!(**args)
1072
+ @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
1073
+ end
1074
+ end
1075
+
1076
+ # Encryption information for a Cloud Spanner database or backup.
1077
+ class EncryptionInfo
1078
+ include Google::Apis::Core::Hashable
1079
+
1080
+ # The `Status` type defines a logical error model that is suitable for different
1081
+ # programming environments, including REST APIs and RPC APIs. It is used by [
1082
+ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
1083
+ # data: error code, error message, and error details. You can find out more
1084
+ # about this error model and how to work with it in the [API Design Guide](https:
1085
+ # //cloud.google.com/apis/design/errors).
1086
+ # Corresponds to the JSON property `encryptionStatus`
1087
+ # @return [Google::Apis::SpannerV1::Status]
1088
+ attr_accessor :encryption_status
1089
+
1090
+ # Output only. The type of encryption.
1091
+ # Corresponds to the JSON property `encryptionType`
1092
+ # @return [String]
1093
+ attr_accessor :encryption_type
1094
+
1095
+ # Output only. A Cloud KMS key version that is being used to protect the
1096
+ # database or backup.
1097
+ # Corresponds to the JSON property `kmsKeyVersion`
1098
+ # @return [String]
1099
+ attr_accessor :kms_key_version
1100
+
1101
+ def initialize(**args)
1102
+ update!(**args)
1103
+ end
1104
+
1105
+ # Update properties of this object
1106
+ def update!(**args)
1107
+ @encryption_status = args[:encryption_status] if args.key?(:encryption_status)
1108
+ @encryption_type = args[:encryption_type] if args.key?(:encryption_type)
1109
+ @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
1110
+ end
1111
+ end
1112
+
1012
1113
  # The request for ExecuteBatchDml.
1013
1114
  class ExecuteBatchDmlRequest
1014
1115
  include Google::Apis::Core::Hashable
1015
1116
 
1117
+ # Common request options for various APIs.
1118
+ # Corresponds to the JSON property `requestOptions`
1119
+ # @return [Google::Apis::SpannerV1::RequestOptions]
1120
+ attr_accessor :request_options
1121
+
1016
1122
  # Required. A per-transaction sequence number used to identify this request.
1017
1123
  # This field makes each request idempotent such that if the request is received
1018
1124
  # multiple times, at most one will succeed. The sequence number must be
@@ -1045,6 +1151,7 @@ module Google
1045
1151
 
1046
1152
  # Update properties of this object
1047
1153
  def update!(**args)
1154
+ @request_options = args[:request_options] if args.key?(:request_options)
1048
1155
  @seqno = args[:seqno] if args.key?(:seqno)
1049
1156
  @statements = args[:statements] if args.key?(:statements)
1050
1157
  @transaction = args[:transaction] if args.key?(:transaction)
@@ -1143,6 +1250,11 @@ module Google
1143
1250
  # @return [Google::Apis::SpannerV1::QueryOptions]
1144
1251
  attr_accessor :query_options
1145
1252
 
1253
+ # Common request options for various APIs.
1254
+ # Corresponds to the JSON property `requestOptions`
1255
+ # @return [Google::Apis::SpannerV1::RequestOptions]
1256
+ attr_accessor :request_options
1257
+
1146
1258
  # If this request is resuming a previously interrupted SQL statement execution, `
1147
1259
  # resume_token` should be copied from the last PartialResultSet yielded before
1148
1260
  # the interruption. Doing this enables the new SQL statement execution to resume
@@ -1186,6 +1298,7 @@ module Google
1186
1298
  @partition_token = args[:partition_token] if args.key?(:partition_token)
1187
1299
  @query_mode = args[:query_mode] if args.key?(:query_mode)
1188
1300
  @query_options = args[:query_options] if args.key?(:query_options)
1301
+ @request_options = args[:request_options] if args.key?(:request_options)
1189
1302
  @resume_token = args[:resume_token] if args.key?(:resume_token)
1190
1303
  @seqno = args[:seqno] if args.key?(:seqno)
1191
1304
  @sql = args[:sql] if args.key?(:sql)
@@ -2404,18 +2517,34 @@ module Google
2404
2517
  class QueryOptions
2405
2518
  include Google::Apis::Core::Hashable
2406
2519
 
2520
+ # An option to control the selection of optimizer statistics package. This
2521
+ # parameter allows individual queries to use a different query optimizer
2522
+ # statistics package. Specifying `latest` as a value instructs Cloud Spanner to
2523
+ # use the latest generated statistics package. If not specified, Cloud Spanner
2524
+ # uses the statistics package set at the database level options, or the latest
2525
+ # package if the database option is not set. The statistics package requested by
2526
+ # the query has to be exempt from garbage collection. This can be achieved with
2527
+ # the following DDL statement: ``` ALTER STATISTICS SET OPTIONS (allow_gc=false)
2528
+ # ``` The list of available statistics packages can be queried from `
2529
+ # INFORMATION_SCHEMA.SPANNER_STATISTICS`. Executing a SQL statement with an
2530
+ # invalid optimizer statistics package or with a statistics package that allows
2531
+ # garbage collection fails with an `INVALID_ARGUMENT` error.
2532
+ # Corresponds to the JSON property `optimizerStatisticsPackage`
2533
+ # @return [String]
2534
+ attr_accessor :optimizer_statistics_package
2535
+
2407
2536
  # An option to control the selection of optimizer version. This parameter allows
2408
- # individual queries to pick different query optimizer versions. Specifying "
2409
- # latest" as a value instructs Cloud Spanner to use the latest supported query
2410
- # optimizer version. If not specified, Cloud Spanner uses optimizer version set
2411
- # at the database level options. Any other positive integer (from the list of
2412
- # supported optimizer versions) overrides the default optimizer version for
2537
+ # individual queries to pick different query optimizer versions. Specifying `
2538
+ # latest` as a value instructs Cloud Spanner to use the latest supported query
2539
+ # optimizer version. If not specified, Cloud Spanner uses the optimizer version
2540
+ # set at the database level options. Any other positive integer (from the list
2541
+ # of supported optimizer versions) overrides the default optimizer version for
2413
2542
  # query execution. The list of supported optimizer versions can be queried from
2414
2543
  # SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement with an
2415
- # invalid optimizer version will fail with a syntax error (`INVALID_ARGUMENT`)
2416
- # status. See https://cloud.google.com/spanner/docs/query-optimizer/manage-query-
2417
- # optimizer for more information on managing the query optimizer. The `
2418
- # optimizer_version` statement hint has precedence over this setting.
2544
+ # invalid optimizer version fails with an `INVALID_ARGUMENT` error. See https://
2545
+ # cloud.google.com/spanner/docs/query-optimizer/manage-query-optimizer for more
2546
+ # information on managing the query optimizer. The `optimizer_version` statement
2547
+ # hint has precedence over this setting.
2419
2548
  # Corresponds to the JSON property `optimizerVersion`
2420
2549
  # @return [String]
2421
2550
  attr_accessor :optimizer_version
@@ -2426,6 +2555,7 @@ module Google
2426
2555
 
2427
2556
  # Update properties of this object
2428
2557
  def update!(**args)
2558
+ @optimizer_statistics_package = args[:optimizer_statistics_package] if args.key?(:optimizer_statistics_package)
2429
2559
  @optimizer_version = args[:optimizer_version] if args.key?(:optimizer_version)
2430
2560
  end
2431
2561
  end
@@ -2568,6 +2698,11 @@ module Google
2568
2698
  # @return [String]
2569
2699
  attr_accessor :partition_token
2570
2700
 
2701
+ # Common request options for various APIs.
2702
+ # Corresponds to the JSON property `requestOptions`
2703
+ # @return [Google::Apis::SpannerV1::RequestOptions]
2704
+ attr_accessor :request_options
2705
+
2571
2706
  # If this request is resuming a previously interrupted read, `resume_token`
2572
2707
  # should be copied from the last PartialResultSet yielded before the
2573
2708
  # interruption. Doing this enables the new read to resume where the last read
@@ -2600,6 +2735,7 @@ module Google
2600
2735
  @key_set = args[:key_set] if args.key?(:key_set)
2601
2736
  @limit = args[:limit] if args.key?(:limit)
2602
2737
  @partition_token = args[:partition_token] if args.key?(:partition_token)
2738
+ @request_options = args[:request_options] if args.key?(:request_options)
2603
2739
  @resume_token = args[:resume_token] if args.key?(:resume_token)
2604
2740
  @table = args[:table] if args.key?(:table)
2605
2741
  @transaction = args[:transaction] if args.key?(:transaction)
@@ -2654,6 +2790,53 @@ module Google
2654
2790
  end
2655
2791
  end
2656
2792
 
2793
+ # Common request options for various APIs.
2794
+ class RequestOptions
2795
+ include Google::Apis::Core::Hashable
2796
+
2797
+ # Priority for the request.
2798
+ # Corresponds to the JSON property `priority`
2799
+ # @return [String]
2800
+ attr_accessor :priority
2801
+
2802
+ def initialize(**args)
2803
+ update!(**args)
2804
+ end
2805
+
2806
+ # Update properties of this object
2807
+ def update!(**args)
2808
+ @priority = args[:priority] if args.key?(:priority)
2809
+ end
2810
+ end
2811
+
2812
+ # Encryption configuration for the restored database.
2813
+ class RestoreDatabaseEncryptionConfig
2814
+ include Google::Apis::Core::Hashable
2815
+
2816
+ # Required. The encryption type of the restored database.
2817
+ # Corresponds to the JSON property `encryptionType`
2818
+ # @return [String]
2819
+ attr_accessor :encryption_type
2820
+
2821
+ # Optional. The Cloud KMS key that will be used to encrypt/decrypt the restored
2822
+ # database. This field should be set only when encryption_type is `
2823
+ # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
2824
+ # keyRings//cryptoKeys/`.
2825
+ # Corresponds to the JSON property `kmsKeyName`
2826
+ # @return [String]
2827
+ attr_accessor :kms_key_name
2828
+
2829
+ def initialize(**args)
2830
+ update!(**args)
2831
+ end
2832
+
2833
+ # Update properties of this object
2834
+ def update!(**args)
2835
+ @encryption_type = args[:encryption_type] if args.key?(:encryption_type)
2836
+ @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
2837
+ end
2838
+ end
2839
+
2657
2840
  # Metadata type for the long-running operation returned by RestoreDatabase.
2658
2841
  class RestoreDatabaseMetadata
2659
2842
  include Google::Apis::Core::Hashable
@@ -2736,6 +2919,11 @@ module Google
2736
2919
  # @return [String]
2737
2920
  attr_accessor :database_id
2738
2921
 
2922
+ # Encryption configuration for the restored database.
2923
+ # Corresponds to the JSON property `encryptionConfig`
2924
+ # @return [Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig]
2925
+ attr_accessor :encryption_config
2926
+
2739
2927
  def initialize(**args)
2740
2928
  update!(**args)
2741
2929
  end
@@ -2744,6 +2932,7 @@ module Google
2744
2932
  def update!(**args)
2745
2933
  @backup = args[:backup] if args.key?(:backup)
2746
2934
  @database_id = args[:database_id] if args.key?(:database_id)
2935
+ @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
2747
2936
  end
2748
2937
  end
2749
2938
 
@@ -3213,7 +3402,7 @@ module Google
3213
3402
  # inactivity at the client may cause Cloud Spanner to release a transaction's
3214
3403
  # locks and abort it. Conceptually, a read-write transaction consists of zero or
3215
3404
  # more reads or SQL statements followed by Commit. At any time before Commit,
3216
- # the client can send a Rollback request to abort the transaction. ### Semantics
3405
+ # the client can send a Rollback request to abort the transaction. ## Semantics
3217
3406
  # Cloud Spanner can commit the transaction if all read locks it acquired are
3218
3407
  # still valid at commit time, and it is able to acquire write locks for all
3219
3408
  # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3221,7 +3410,7 @@ module Google
3221
3410
  # not modified any user data in Cloud Spanner. Unless the transaction commits,
3222
3411
  # Cloud Spanner makes no guarantees about how long the transaction's locks were
3223
3412
  # held for. It is an error to use Cloud Spanner locks for any sort of mutual
3224
- # exclusion other than between Cloud Spanner transactions themselves. ###
3413
+ # exclusion other than between Cloud Spanner transactions themselves. ##
3225
3414
  # Retrying Aborted Transactions When a transaction aborts, the application can
3226
3415
  # choose to retry the whole transaction again. To maximize the chances of
3227
3416
  # successfully committing the retry, the client should execute the retry in the
@@ -3232,7 +3421,7 @@ module Google
3232
3421
  # can abort many times in a short period before successfully committing. Thus,
3233
3422
  # it is not a good idea to cap the number of retries a transaction can attempt;
3234
3423
  # instead, it is better to limit the total amount of wall time spent retrying. ##
3235
- # # Idle Transactions A transaction is considered idle if it has no outstanding
3424
+ # Idle Transactions A transaction is considered idle if it has no outstanding
3236
3425
  # reads or SQL queries and has not started a read or SQL query within the last
3237
3426
  # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
3238
3427
  # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3256,7 +3445,7 @@ module Google
3256
3445
  # is geographically distributed, stale read-only transactions can execute more
3257
3446
  # quickly than strong or read-write transaction, because they are able to
3258
3447
  # execute far from the leader replica. Each type of timestamp bound is discussed
3259
- # in detail below. ### Strong Strong reads are guaranteed to see the effects of
3448
+ # in detail below. ## Strong Strong reads are guaranteed to see the effects of
3260
3449
  # all transactions that have committed before the start of the read. Furthermore,
3261
3450
  # all rows yielded by a single read are consistent with each other -- if any
3262
3451
  # part of the read observes a transaction, all parts of the read see the
@@ -3264,7 +3453,7 @@ module Google
3264
3453
  # transactions might return inconsistent results if there are concurrent writes.
3265
3454
  # If consistency across reads is required, the reads should be executed within a
3266
3455
  # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
3267
- # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
3456
+ # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
3268
3457
  # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
3269
3458
  # prefix of the global transaction history: they observe modifications done by
3270
3459
  # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3276,7 +3465,7 @@ module Google
3276
3465
  # to pick a timestamp. As a result, they execute slightly faster than the
3277
3466
  # equivalent boundedly stale concurrency modes. On the other hand, boundedly
3278
3467
  # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
3279
- # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
3468
+ # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
3280
3469
  # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
3281
3470
  # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
3282
3471
  # the newest timestamp within the staleness bound that allows execution of the
@@ -3294,7 +3483,7 @@ module Google
3294
3483
  # timestamp negotiation requires up-front knowledge of which rows will be read,
3295
3484
  # it can only be used with single-use read-only transactions. See
3296
3485
  # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
3297
- # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
3486
+ # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
3298
3487
  # Spanner continuously garbage collects deleted and overwritten data in the
3299
3488
  # background to reclaim storage space. This process is known as "version GC". By
3300
3489
  # default, version GC reclaims versions after they are one hour old. Because of
@@ -3408,7 +3597,7 @@ module Google
3408
3597
  # inactivity at the client may cause Cloud Spanner to release a transaction's
3409
3598
  # locks and abort it. Conceptually, a read-write transaction consists of zero or
3410
3599
  # more reads or SQL statements followed by Commit. At any time before Commit,
3411
- # the client can send a Rollback request to abort the transaction. ### Semantics
3600
+ # the client can send a Rollback request to abort the transaction. ## Semantics
3412
3601
  # Cloud Spanner can commit the transaction if all read locks it acquired are
3413
3602
  # still valid at commit time, and it is able to acquire write locks for all
3414
3603
  # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3416,7 +3605,7 @@ module Google
3416
3605
  # not modified any user data in Cloud Spanner. Unless the transaction commits,
3417
3606
  # Cloud Spanner makes no guarantees about how long the transaction's locks were
3418
3607
  # held for. It is an error to use Cloud Spanner locks for any sort of mutual
3419
- # exclusion other than between Cloud Spanner transactions themselves. ###
3608
+ # exclusion other than between Cloud Spanner transactions themselves. ##
3420
3609
  # Retrying Aborted Transactions When a transaction aborts, the application can
3421
3610
  # choose to retry the whole transaction again. To maximize the chances of
3422
3611
  # successfully committing the retry, the client should execute the retry in the
@@ -3427,7 +3616,7 @@ module Google
3427
3616
  # can abort many times in a short period before successfully committing. Thus,
3428
3617
  # it is not a good idea to cap the number of retries a transaction can attempt;
3429
3618
  # instead, it is better to limit the total amount of wall time spent retrying. ##
3430
- # # Idle Transactions A transaction is considered idle if it has no outstanding
3619
+ # Idle Transactions A transaction is considered idle if it has no outstanding
3431
3620
  # reads or SQL queries and has not started a read or SQL query within the last
3432
3621
  # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
3433
3622
  # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3451,7 +3640,7 @@ module Google
3451
3640
  # is geographically distributed, stale read-only transactions can execute more
3452
3641
  # quickly than strong or read-write transaction, because they are able to
3453
3642
  # execute far from the leader replica. Each type of timestamp bound is discussed
3454
- # in detail below. ### Strong Strong reads are guaranteed to see the effects of
3643
+ # in detail below. ## Strong Strong reads are guaranteed to see the effects of
3455
3644
  # all transactions that have committed before the start of the read. Furthermore,
3456
3645
  # all rows yielded by a single read are consistent with each other -- if any
3457
3646
  # part of the read observes a transaction, all parts of the read see the
@@ -3459,7 +3648,7 @@ module Google
3459
3648
  # transactions might return inconsistent results if there are concurrent writes.
3460
3649
  # If consistency across reads is required, the reads should be executed within a
3461
3650
  # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
3462
- # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
3651
+ # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
3463
3652
  # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
3464
3653
  # prefix of the global transaction history: they observe modifications done by
3465
3654
  # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3471,7 +3660,7 @@ module Google
3471
3660
  # to pick a timestamp. As a result, they execute slightly faster than the
3472
3661
  # equivalent boundedly stale concurrency modes. On the other hand, boundedly
3473
3662
  # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
3474
- # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
3663
+ # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
3475
3664
  # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
3476
3665
  # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
3477
3666
  # the newest timestamp within the staleness bound that allows execution of the
@@ -3489,7 +3678,7 @@ module Google
3489
3678
  # timestamp negotiation requires up-front knowledge of which rows will be read,
3490
3679
  # it can only be used with single-use read-only transactions. See
3491
3680
  # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
3492
- # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
3681
+ # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
3493
3682
  # Spanner continuously garbage collects deleted and overwritten data in the
3494
3683
  # background to reclaim storage space. This process is known as "version GC". By
3495
3684
  # default, version GC reclaims versions after they are one hour old. Because of
@@ -3577,7 +3766,7 @@ module Google
3577
3766
  # inactivity at the client may cause Cloud Spanner to release a transaction's
3578
3767
  # locks and abort it. Conceptually, a read-write transaction consists of zero or
3579
3768
  # more reads or SQL statements followed by Commit. At any time before Commit,
3580
- # the client can send a Rollback request to abort the transaction. ### Semantics
3769
+ # the client can send a Rollback request to abort the transaction. ## Semantics
3581
3770
  # Cloud Spanner can commit the transaction if all read locks it acquired are
3582
3771
  # still valid at commit time, and it is able to acquire write locks for all
3583
3772
  # writes. Cloud Spanner can abort the transaction for any reason. If a commit
@@ -3585,7 +3774,7 @@ module Google
3585
3774
  # not modified any user data in Cloud Spanner. Unless the transaction commits,
3586
3775
  # Cloud Spanner makes no guarantees about how long the transaction's locks were
3587
3776
  # held for. It is an error to use Cloud Spanner locks for any sort of mutual
3588
- # exclusion other than between Cloud Spanner transactions themselves. ###
3777
+ # exclusion other than between Cloud Spanner transactions themselves. ##
3589
3778
  # Retrying Aborted Transactions When a transaction aborts, the application can
3590
3779
  # choose to retry the whole transaction again. To maximize the chances of
3591
3780
  # successfully committing the retry, the client should execute the retry in the
@@ -3596,7 +3785,7 @@ module Google
3596
3785
  # can abort many times in a short period before successfully committing. Thus,
3597
3786
  # it is not a good idea to cap the number of retries a transaction can attempt;
3598
3787
  # instead, it is better to limit the total amount of wall time spent retrying. ##
3599
- # # Idle Transactions A transaction is considered idle if it has no outstanding
3788
+ # Idle Transactions A transaction is considered idle if it has no outstanding
3600
3789
  # reads or SQL queries and has not started a read or SQL query within the last
3601
3790
  # 10 seconds. Idle transactions can be aborted by Cloud Spanner so that they don'
3602
3791
  # t hold on to locks indefinitely. In that case, the commit will fail with error
@@ -3620,7 +3809,7 @@ module Google
3620
3809
  # is geographically distributed, stale read-only transactions can execute more
3621
3810
  # quickly than strong or read-write transaction, because they are able to
3622
3811
  # execute far from the leader replica. Each type of timestamp bound is discussed
3623
- # in detail below. ### Strong Strong reads are guaranteed to see the effects of
3812
+ # in detail below. ## Strong Strong reads are guaranteed to see the effects of
3624
3813
  # all transactions that have committed before the start of the read. Furthermore,
3625
3814
  # all rows yielded by a single read are consistent with each other -- if any
3626
3815
  # part of the read observes a transaction, all parts of the read see the
@@ -3628,7 +3817,7 @@ module Google
3628
3817
  # transactions might return inconsistent results if there are concurrent writes.
3629
3818
  # If consistency across reads is required, the reads should be executed within a
3630
3819
  # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
3631
- # strong. ### Exact Staleness These timestamp bounds execute reads at a user-
3820
+ # strong. ## Exact Staleness These timestamp bounds execute reads at a user-
3632
3821
  # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
3633
3822
  # prefix of the global transaction history: they observe modifications done by
3634
3823
  # all transactions with a commit timestamp <= the read timestamp, and observe
@@ -3640,7 +3829,7 @@ module Google
3640
3829
  # to pick a timestamp. As a result, they execute slightly faster than the
3641
3830
  # equivalent boundedly stale concurrency modes. On the other hand, boundedly
3642
3831
  # stale reads usually return fresher results. See TransactionOptions.ReadOnly.
3643
- # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ### Bounded
3832
+ # read_timestamp and TransactionOptions.ReadOnly.exact_staleness. ## Bounded
3644
3833
  # Staleness Bounded staleness modes allow Cloud Spanner to pick the read
3645
3834
  # timestamp, subject to a user-provided staleness bound. Cloud Spanner chooses
3646
3835
  # the newest timestamp within the staleness bound that allows execution of the
@@ -3658,7 +3847,7 @@ module Google
3658
3847
  # timestamp negotiation requires up-front knowledge of which rows will be read,
3659
3848
  # it can only be used with single-use read-only transactions. See
3660
3849
  # TransactionOptions.ReadOnly.max_staleness and TransactionOptions.ReadOnly.
3661
- # min_read_timestamp. ### Old Read Timestamps and Garbage Collection Cloud
3850
+ # min_read_timestamp. ## Old Read Timestamps and Garbage Collection Cloud
3662
3851
  # Spanner continuously garbage collects deleted and overwritten data in the
3663
3852
  # background to reclaim storage space. This process is known as "version GC". By
3664
3853
  # default, version GC reclaims versions after they are one hour old. Because of
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SpannerV1
18
18
  # Version of the google-apis-spanner_v1 gem
19
- GEM_VERSION = "0.2.0"
19
+ GEM_VERSION = "0.7.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.1.2"
22
+ GENERATOR_VERSION = "0.2.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210123"
25
+ REVISION = "20210318"
26
26
  end
27
27
  end
28
28
  end
@@ -136,6 +136,18 @@ module Google
136
136
  include Google::Apis::Core::JsonObjectSupport
137
137
  end
138
138
 
139
+ class EncryptionConfig
140
+ class Representation < Google::Apis::Core::JsonRepresentation; end
141
+
142
+ include Google::Apis::Core::JsonObjectSupport
143
+ end
144
+
145
+ class EncryptionInfo
146
+ class Representation < Google::Apis::Core::JsonRepresentation; end
147
+
148
+ include Google::Apis::Core::JsonObjectSupport
149
+ end
150
+
139
151
  class ExecuteBatchDmlRequest
140
152
  class Representation < Google::Apis::Core::JsonRepresentation; end
141
153
 
@@ -370,6 +382,18 @@ module Google
370
382
  include Google::Apis::Core::JsonObjectSupport
371
383
  end
372
384
 
385
+ class RequestOptions
386
+ class Representation < Google::Apis::Core::JsonRepresentation; end
387
+
388
+ include Google::Apis::Core::JsonObjectSupport
389
+ end
390
+
391
+ class RestoreDatabaseEncryptionConfig
392
+ class Representation < Google::Apis::Core::JsonRepresentation; end
393
+
394
+ include Google::Apis::Core::JsonObjectSupport
395
+ end
396
+
373
397
  class RestoreDatabaseMetadata
374
398
  class Representation < Google::Apis::Core::JsonRepresentation; end
375
399
 
@@ -519,6 +543,8 @@ module Google
519
543
  class Representation < Google::Apis::Core::JsonRepresentation
520
544
  property :create_time, as: 'createTime'
521
545
  property :database, as: 'database'
546
+ property :encryption_info, as: 'encryptionInfo', class: Google::Apis::SpannerV1::EncryptionInfo, decorator: Google::Apis::SpannerV1::EncryptionInfo::Representation
547
+
522
548
  property :expire_time, as: 'expireTime'
523
549
  property :name, as: 'name'
524
550
  collection :referencing_databases, as: 'referencingDatabases'
@@ -560,6 +586,8 @@ module Google
560
586
  class Representation < Google::Apis::Core::JsonRepresentation
561
587
  property :options, as: 'options', class: Google::Apis::SpannerV1::TransactionOptions, decorator: Google::Apis::SpannerV1::TransactionOptions::Representation
562
588
 
589
+ property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
590
+
563
591
  end
564
592
  end
565
593
 
@@ -587,6 +615,8 @@ module Google
587
615
  class Representation < Google::Apis::Core::JsonRepresentation
588
616
  collection :mutations, as: 'mutations', class: Google::Apis::SpannerV1::Mutation, decorator: Google::Apis::SpannerV1::Mutation::Representation
589
617
 
618
+ property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
619
+
590
620
  property :return_commit_stats, as: 'returnCommitStats'
591
621
  property :single_use_transaction, as: 'singleUseTransaction', class: Google::Apis::SpannerV1::TransactionOptions, decorator: Google::Apis::SpannerV1::TransactionOptions::Representation
592
622
 
@@ -632,6 +662,8 @@ module Google
632
662
  # @private
633
663
  class Representation < Google::Apis::Core::JsonRepresentation
634
664
  property :create_statement, as: 'createStatement'
665
+ property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
666
+
635
667
  collection :extra_statements, as: 'extraStatements'
636
668
  end
637
669
  end
@@ -669,6 +701,10 @@ module Google
669
701
  class Representation < Google::Apis::Core::JsonRepresentation
670
702
  property :create_time, as: 'createTime'
671
703
  property :earliest_version_time, as: 'earliestVersionTime'
704
+ property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::EncryptionConfig, decorator: Google::Apis::SpannerV1::EncryptionConfig::Representation
705
+
706
+ collection :encryption_info, as: 'encryptionInfo', class: Google::Apis::SpannerV1::EncryptionInfo, decorator: Google::Apis::SpannerV1::EncryptionInfo::Representation
707
+
672
708
  property :name, as: 'name'
673
709
  property :restore_info, as: 'restoreInfo', class: Google::Apis::SpannerV1::RestoreInfo, decorator: Google::Apis::SpannerV1::RestoreInfo::Representation
674
710
 
@@ -692,9 +728,28 @@ module Google
692
728
  end
693
729
  end
694
730
 
731
+ class EncryptionConfig
732
+ # @private
733
+ class Representation < Google::Apis::Core::JsonRepresentation
734
+ property :kms_key_name, as: 'kmsKeyName'
735
+ end
736
+ end
737
+
738
+ class EncryptionInfo
739
+ # @private
740
+ class Representation < Google::Apis::Core::JsonRepresentation
741
+ property :encryption_status, as: 'encryptionStatus', class: Google::Apis::SpannerV1::Status, decorator: Google::Apis::SpannerV1::Status::Representation
742
+
743
+ property :encryption_type, as: 'encryptionType'
744
+ property :kms_key_version, as: 'kmsKeyVersion'
745
+ end
746
+ end
747
+
695
748
  class ExecuteBatchDmlRequest
696
749
  # @private
697
750
  class Representation < Google::Apis::Core::JsonRepresentation
751
+ property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
752
+
698
753
  property :seqno, :numeric_string => true, as: 'seqno'
699
754
  collection :statements, as: 'statements', class: Google::Apis::SpannerV1::Statement, decorator: Google::Apis::SpannerV1::Statement::Representation
700
755
 
@@ -723,6 +778,8 @@ module Google
723
778
  property :query_mode, as: 'queryMode'
724
779
  property :query_options, as: 'queryOptions', class: Google::Apis::SpannerV1::QueryOptions, decorator: Google::Apis::SpannerV1::QueryOptions::Representation
725
780
 
781
+ property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
782
+
726
783
  property :resume_token, :base64 => true, as: 'resumeToken'
727
784
  property :seqno, :numeric_string => true, as: 'seqno'
728
785
  property :sql, as: 'sql'
@@ -1039,6 +1096,7 @@ module Google
1039
1096
  class QueryOptions
1040
1097
  # @private
1041
1098
  class Representation < Google::Apis::Core::JsonRepresentation
1099
+ property :optimizer_statistics_package, as: 'optimizerStatisticsPackage'
1042
1100
  property :optimizer_version, as: 'optimizerVersion'
1043
1101
  end
1044
1102
  end
@@ -1072,6 +1130,8 @@ module Google
1072
1130
 
1073
1131
  property :limit, :numeric_string => true, as: 'limit'
1074
1132
  property :partition_token, :base64 => true, as: 'partitionToken'
1133
+ property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
1134
+
1075
1135
  property :resume_token, :base64 => true, as: 'resumeToken'
1076
1136
  property :table, as: 'table'
1077
1137
  property :transaction, as: 'transaction', class: Google::Apis::SpannerV1::TransactionSelector, decorator: Google::Apis::SpannerV1::TransactionSelector::Representation
@@ -1094,6 +1154,21 @@ module Google
1094
1154
  end
1095
1155
  end
1096
1156
 
1157
+ class RequestOptions
1158
+ # @private
1159
+ class Representation < Google::Apis::Core::JsonRepresentation
1160
+ property :priority, as: 'priority'
1161
+ end
1162
+ end
1163
+
1164
+ class RestoreDatabaseEncryptionConfig
1165
+ # @private
1166
+ class Representation < Google::Apis::Core::JsonRepresentation
1167
+ property :encryption_type, as: 'encryptionType'
1168
+ property :kms_key_name, as: 'kmsKeyName'
1169
+ end
1170
+ end
1171
+
1097
1172
  class RestoreDatabaseMetadata
1098
1173
  # @private
1099
1174
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1113,6 +1188,8 @@ module Google
1113
1188
  class Representation < Google::Apis::Core::JsonRepresentation
1114
1189
  property :backup, as: 'backup'
1115
1190
  property :database_id, as: 'databaseId'
1191
+ property :encryption_config, as: 'encryptionConfig', class: Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig, decorator: Google::Apis::SpannerV1::RestoreDatabaseEncryptionConfig::Representation
1192
+
1116
1193
  end
1117
1194
  end
1118
1195
 
@@ -549,6 +549,12 @@ module Google
549
549
  # @param [String] backup_id
550
550
  # Required. The id of the backup to be created. The `backup_id` appended to `
551
551
  # parent` forms the full backup name of the form `projects//instances//backups/`.
552
+ # @param [String] encryption_config_encryption_type
553
+ # Required. The encryption type of the backup.
554
+ # @param [String] encryption_config_kms_key_name
555
+ # Optional. The Cloud KMS key that will be used to protect the backup. This
556
+ # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
557
+ # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
552
558
  # @param [String] fields
553
559
  # Selector specifying which fields to include in a partial response.
554
560
  # @param [String] quota_user
@@ -566,7 +572,7 @@ module Google
566
572
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
567
573
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
568
574
  # @raise [Google::Apis::AuthorizationError] Authorization is required
569
- def create_project_instance_backup(parent, backup_object = nil, backup_id: nil, fields: nil, quota_user: nil, options: nil, &block)
575
+ def create_project_instance_backup(parent, backup_object = nil, backup_id: nil, encryption_config_encryption_type: nil, encryption_config_kms_key_name: nil, fields: nil, quota_user: nil, options: nil, &block)
570
576
  command = make_simple_command(:post, 'v1/{+parent}/backups', options)
571
577
  command.request_representation = Google::Apis::SpannerV1::Backup::Representation
572
578
  command.request_object = backup_object
@@ -574,6 +580,8 @@ module Google
574
580
  command.response_class = Google::Apis::SpannerV1::Operation
575
581
  command.params['parent'] = parent unless parent.nil?
576
582
  command.query['backupId'] = backup_id unless backup_id.nil?
583
+ command.query['encryptionConfig.encryptionType'] = encryption_config_encryption_type unless encryption_config_encryption_type.nil?
584
+ command.query['encryptionConfig.kmsKeyName'] = encryption_config_kms_key_name unless encryption_config_kms_key_name.nil?
577
585
  command.query['fields'] = fields unless fields.nil?
578
586
  command.query['quotaUser'] = quota_user unless quota_user.nil?
579
587
  execute_or_queue_command(command, &block)
@@ -693,18 +701,19 @@ module Google
693
701
  # contains operator. Filter rules are not case sensitive. The following fields
694
702
  # in the Backup are eligible for filtering: * `name` * `database` * `state` * `
695
703
  # create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `
696
- # expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `size_bytes`
697
- # You can combine multiple expressions by enclosing each expression in
698
- # parentheses. By default, expressions are combined with AND logic, but you can
699
- # specify AND, OR, and NOT logic explicitly. Here are a few examples: * `name:
700
- # Howl` - The backup's name contains the string "howl". * `database:prod` - The
701
- # database's name contains the string "prod". * `state:CREATING` - The backup is
702
- # pending creation. * `state:READY` - The backup is fully created and ready for
703
- # use. * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")` - The backup
704
- # name contains the string "howl" and `create_time` of the backup is before 2018-
705
- # 03-28T14:50:00Z. * `expire_time < \"2018-03-28T14:50:00Z\"` - The backup `
706
- # expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes > 10000000000` -
707
- # The backup's size is greater than 10GB
704
+ # expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `
705
+ # version_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) * `
706
+ # size_bytes` You can combine multiple expressions by enclosing each expression
707
+ # in parentheses. By default, expressions are combined with AND logic, but you
708
+ # can specify AND, OR, and NOT logic explicitly. Here are a few examples: * `
709
+ # name:Howl` - The backup's name contains the string "howl". * `database:prod` -
710
+ # The database's name contains the string "prod". * `state:CREATING` - The
711
+ # backup is pending creation. * `state:READY` - The backup is fully created and
712
+ # ready for use. * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")` -
713
+ # The backup name contains the string "howl" and `create_time` of the backup is
714
+ # before 2018-03-28T14:50:00Z. * `expire_time < \"2018-03-28T14:50:00Z\"` - The
715
+ # backup `expire_time` is before 2018-03-28T14:50:00Z. * `size_bytes >
716
+ # 10000000000` - The backup's size is greater than 10GB
708
717
  # @param [Fixnum] page_size
709
718
  # Number of backups to be returned in the response. If 0 or less, defaults to
710
719
  # the server's maximum allowed page size.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-spanner_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.7.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-02-08 00:00:00.000000000 Z
11
+ date: 2021-03-29 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -52,7 +52,7 @@ licenses:
52
52
  metadata:
53
53
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
54
54
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1/CHANGELOG.md
55
- documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.2.0
55
+ documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.7.0
56
56
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1
57
57
  post_install_message:
58
58
  rdoc_options: []
@@ -62,14 +62,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
62
62
  requirements:
63
63
  - - ">="
64
64
  - !ruby/object:Gem::Version
65
- version: '2.4'
65
+ version: '2.5'
66
66
  required_rubygems_version: !ruby/object:Gem::Requirement
67
67
  requirements:
68
68
  - - ">="
69
69
  - !ruby/object:Gem::Version
70
70
  version: '0'
71
71
  requirements: []
72
- rubygems_version: 3.2.6
72
+ rubygems_version: 3.2.13
73
73
  signing_key:
74
74
  specification_version: 4
75
75
  summary: Simple REST client for Cloud Spanner API V1