google-apis-spanner_v1 0.38.0 → 0.39.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: fd7d82b009260b024177aea46127ebf13307e62e4ed6ad312073f40339350deb
4
- data.tar.gz: 18953a84f3a342c625a352b390161e0afca081ce14156ee15f3a3616d5f7777e
3
+ metadata.gz: 80aab876566e716fc6f342f93eed7c62dd1ee0bd5552d96ba479de28adde6cb2
4
+ data.tar.gz: 22a06a2a63ca137eb6926e1b299c9709ceed4be566826ea6fdcb9e1921c9c576
5
5
  SHA512:
6
- metadata.gz: 2c3d57d5f2c299b8288f8c8af491ff7d486aa39ee1a2df917eb298e708a3a8cf8c302c4eead4a132d332ee2100ac18d40f5b91dd2ca0f5aa2ee67bfc7b0885b3
7
- data.tar.gz: 6a6a32e3ad6941f02b37c191eadaa5735e3555285122256c922dbb762da7b371b242f99f8f41e2df07b7f9aa6243f0a0a517c2eae541317a9e77a4042db9c93c
6
+ metadata.gz: 8e66fb6ecfa79250487e211943073aa452ae0718fa276ed995bfc2f03c119f6cc5745380a1864840f1af9c5543d1bdb33965ef0f011b8e198515c7bb60747d26
7
+ data.tar.gz: '09335b0beac3787e24364869a26288b594adef0bd1358b3569bcad38ef9143c3e04519d486e642582af3eade5e50461e1e3992a48bd5f66d8dcac81b3a87271b'
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-spanner_v1
2
2
 
3
+ ### v0.39.0 (2025-02-26)
4
+
5
+ * Regenerated from discovery document revision 20250220
6
+
3
7
  ### v0.38.0 (2025-01-12)
4
8
 
5
9
  * Regenerated from discovery document revision 20241218
@@ -22,6 +22,124 @@ module Google
22
22
  module Apis
23
23
  module SpannerV1
24
24
 
25
+ # Message sent by the client to the adapter.
26
+ class AdaptMessageRequest
27
+ include Google::Apis::Core::Hashable
28
+
29
+ # Optional. Opaque request state passed by the client to the server.
30
+ # Corresponds to the JSON property `attachments`
31
+ # @return [Hash<String,String>]
32
+ attr_accessor :attachments
33
+
34
+ # Optional. Uninterpreted bytes from the underlying wire protocol.
35
+ # Corresponds to the JSON property `payload`
36
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
37
+ # @return [String]
38
+ attr_accessor :payload
39
+
40
+ # Required. Identifier for the underlying wire protocol.
41
+ # Corresponds to the JSON property `protocol`
42
+ # @return [String]
43
+ attr_accessor :protocol
44
+
45
+ def initialize(**args)
46
+ update!(**args)
47
+ end
48
+
49
+ # Update properties of this object
50
+ def update!(**args)
51
+ @attachments = args[:attachments] if args.key?(:attachments)
52
+ @payload = args[:payload] if args.key?(:payload)
53
+ @protocol = args[:protocol] if args.key?(:protocol)
54
+ end
55
+ end
56
+
57
+ # Message sent by the adapter to the client.
58
+ class AdaptMessageResponse
59
+ include Google::Apis::Core::Hashable
60
+
61
+ # Optional. Uninterpreted bytes from the underlying wire protocol.
62
+ # Corresponds to the JSON property `payload`
63
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
64
+ # @return [String]
65
+ attr_accessor :payload
66
+
67
+ # Optional. Opaque state updates to be applied by the client.
68
+ # Corresponds to the JSON property `stateUpdates`
69
+ # @return [Hash<String,String>]
70
+ attr_accessor :state_updates
71
+
72
+ def initialize(**args)
73
+ update!(**args)
74
+ end
75
+
76
+ # Update properties of this object
77
+ def update!(**args)
78
+ @payload = args[:payload] if args.key?(:payload)
79
+ @state_updates = args[:state_updates] if args.key?(:state_updates)
80
+ end
81
+ end
82
+
83
+ # A session in the Cloud Spanner Adapter API.
84
+ class AdapterSession
85
+ include Google::Apis::Core::Hashable
86
+
87
+ # Identifier. The name of the session. This is always system-assigned.
88
+ # Corresponds to the JSON property `name`
89
+ # @return [String]
90
+ attr_accessor :name
91
+
92
+ def initialize(**args)
93
+ update!(**args)
94
+ end
95
+
96
+ # Update properties of this object
97
+ def update!(**args)
98
+ @name = args[:name] if args.key?(:name)
99
+ end
100
+ end
101
+
102
+ # The request for AddSplitPoints.
103
+ class AddSplitPointsRequest
104
+ include Google::Apis::Core::Hashable
105
+
106
+ # Optional. A user-supplied tag associated with the split points. For example, "
107
+ # initial_data_load", "special_event_1". Defaults to "CloudAddSplitPointsAPI" if
108
+ # not specified. The length of the tag must not exceed 50 characters,else will
109
+ # be trimmed. Only valid UTF8 characters are allowed.
110
+ # Corresponds to the JSON property `initiator`
111
+ # @return [String]
112
+ attr_accessor :initiator
113
+
114
+ # Required. The split points to add.
115
+ # Corresponds to the JSON property `splitPoints`
116
+ # @return [Array<Google::Apis::SpannerV1::SplitPoints>]
117
+ attr_accessor :split_points
118
+
119
+ def initialize(**args)
120
+ update!(**args)
121
+ end
122
+
123
+ # Update properties of this object
124
+ def update!(**args)
125
+ @initiator = args[:initiator] if args.key?(:initiator)
126
+ @split_points = args[:split_points] if args.key?(:split_points)
127
+ end
128
+ end
129
+
130
+ # The response for AddSplitPoints.
131
+ class AddSplitPointsResponse
132
+ include Google::Apis::Core::Hashable
133
+
134
+ def initialize(**args)
135
+ update!(**args)
136
+ end
137
+
138
+ # Update properties of this object
139
+ def update!(**args)
140
+ end
141
+ end
142
+
25
143
  # AsymmetricAutoscalingOption specifies the scaling of replicas identified by
26
144
  # the given selection.
27
145
  class AsymmetricAutoscalingOption
@@ -290,6 +408,13 @@ module Google
290
408
  # @return [String]
291
409
  attr_accessor :incremental_backup_chain_id
292
410
 
411
+ # Output only. The instance partition(s) storing the backup. This is the same as
412
+ # the list of the instance partition(s) that the database had footprint in at
413
+ # the backup's `version_time`.
414
+ # Corresponds to the JSON property `instancePartitions`
415
+ # @return [Array<Google::Apis::SpannerV1::BackupInstancePartition>]
416
+ attr_accessor :instance_partitions
417
+
293
418
  # Output only. The max allowed expiration time of the backup, with microseconds
294
419
  # granularity. A backup's expiration time can be configured in multiple APIs:
295
420
  # CreateBackup, UpdateBackup, CopyBackup. When updating or copying an existing
@@ -375,6 +500,7 @@ module Google
375
500
  @expire_time = args[:expire_time] if args.key?(:expire_time)
376
501
  @freeable_size_bytes = args[:freeable_size_bytes] if args.key?(:freeable_size_bytes)
377
502
  @incremental_backup_chain_id = args[:incremental_backup_chain_id] if args.key?(:incremental_backup_chain_id)
503
+ @instance_partitions = args[:instance_partitions] if args.key?(:instance_partitions)
378
504
  @max_expire_time = args[:max_expire_time] if args.key?(:max_expire_time)
379
505
  @name = args[:name] if args.key?(:name)
380
506
  @oldest_version_time = args[:oldest_version_time] if args.key?(:oldest_version_time)
@@ -426,6 +552,26 @@ module Google
426
552
  end
427
553
  end
428
554
 
555
+ # Instance partition information for the backup.
556
+ class BackupInstancePartition
557
+ include Google::Apis::Core::Hashable
558
+
559
+ # A unique identifier for the instance partition. Values are of the form `
560
+ # projects//instances//instancePartitions/`
561
+ # Corresponds to the JSON property `instancePartition`
562
+ # @return [String]
563
+ attr_accessor :instance_partition
564
+
565
+ def initialize(**args)
566
+ update!(**args)
567
+ end
568
+
569
+ # Update properties of this object
570
+ def update!(**args)
571
+ @instance_partition = args[:instance_partition] if args.key?(:instance_partition)
572
+ end
573
+ end
574
+
429
575
  # BackupSchedule expresses the automated backup creation specification for a
430
576
  # Spanner database.
431
577
  class BackupSchedule
@@ -500,7 +646,7 @@ module Google
500
646
  include Google::Apis::Core::Hashable
501
647
 
502
648
  # CrontabSpec can be used to specify the version time and frequency at which the
503
- # backup should be created.
649
+ # backup is created.
504
650
  # Corresponds to the JSON property `cronSpec`
505
651
  # @return [Google::Apis::SpannerV1::CrontabSpec]
506
652
  attr_accessor :cron_spec
@@ -1958,35 +2104,37 @@ module Google
1958
2104
  end
1959
2105
 
1960
2106
  # CrontabSpec can be used to specify the version time and frequency at which the
1961
- # backup should be created.
2107
+ # backup is created.
1962
2108
  class CrontabSpec
1963
2109
  include Google::Apis::Core::Hashable
1964
2110
 
1965
- # Output only. Schedule backups will contain an externally consistent copy of
1966
- # the database at the version time specified in `schedule_spec.cron_spec`.
1967
- # However, Spanner may not initiate the creation of the scheduled backups at
1968
- # that version time. Spanner will initiate the creation of scheduled backups
1969
- # within the time window bounded by the version_time specified in `schedule_spec.
1970
- # cron_spec` and version_time + `creation_window`.
2111
+ # Output only. Scheduled backups contain an externally consistent copy of the
2112
+ # database at the version time specified in `schedule_spec.cron_spec`. However,
2113
+ # Spanner might not initiate the creation of the scheduled backups at that
2114
+ # version time. Spanner initiates the creation of scheduled backups within the
2115
+ # time window bounded by the version_time specified in `schedule_spec.cron_spec`
2116
+ # and version_time + `creation_window`.
1971
2117
  # Corresponds to the JSON property `creationWindow`
1972
2118
  # @return [String]
1973
2119
  attr_accessor :creation_window
1974
2120
 
1975
2121
  # Required. Textual representation of the crontab. User can customize the backup
1976
2122
  # frequency and the backup version time using the cron expression. The version
1977
- # time must be in UTC timzeone. The backup will contain an externally consistent
1978
- # copy of the database at the version time. Allowed frequencies are 12 hour, 1
1979
- # day, 1 week and 1 month. Examples of valid cron specifications: * `0 2/12 * * *
1980
- # ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * * ` :
1981
- # every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a
1982
- # day at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2
1983
- # past midnight in UTC. * `0 2 8 * * ` : once a month on 8th day at 2 past
1984
- # midnight in UTC.
2123
+ # time must be in UTC timezone. The backup will contain an externally consistent
2124
+ # copy of the database at the version time. Full backups must be scheduled a
2125
+ # minimum of 12 hours apart and incremental backups must be scheduled a minimum
2126
+ # of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` :
2127
+ # every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every
2128
+ # 12 hours at (2, 14) hours past midnight in UTC. * `0 */4 * * *` : (incremental
2129
+ # backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in
2130
+ # UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` :
2131
+ # once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a
2132
+ # month on 8th day at 2 past midnight in UTC.
1985
2133
  # Corresponds to the JSON property `text`
1986
2134
  # @return [String]
1987
2135
  attr_accessor :text
1988
2136
 
1989
- # Output only. The time zone of the times in `CrontabSpec.text`. Currently only
2137
+ # Output only. The time zone of the times in `CrontabSpec.text`. Currently, only
1990
2138
  # UTC is supported.
1991
2139
  # Corresponds to the JSON property `timeZone`
1992
2140
  # @return [String]
@@ -2443,6 +2591,18 @@ module Google
2443
2591
  class ExecuteBatchDmlRequest
2444
2592
  include Google::Apis::Core::Hashable
2445
2593
 
2594
+ # Optional. If set to true, this request marks the end of the transaction. The
2595
+ # transaction should be committed or aborted after these statements execute, and
2596
+ # attempts to execute any other requests against this transaction (including
2597
+ # reads and queries) will be rejected. Setting this option may cause some error
2598
+ # reporting to be deferred until commit time (e.g. validation of unique
2599
+ # constraints). Given this, successful execution of statements should not be
2600
+ # assumed until a subsequent Commit call completes successfully.
2601
+ # Corresponds to the JSON property `lastStatements`
2602
+ # @return [Boolean]
2603
+ attr_accessor :last_statements
2604
+ alias_method :last_statements?, :last_statements
2605
+
2446
2606
  # Common request options for various APIs.
2447
2607
  # Corresponds to the JSON property `requestOptions`
2448
2608
  # @return [Google::Apis::SpannerV1::RequestOptions]
@@ -2480,6 +2640,7 @@ module Google
2480
2640
 
2481
2641
  # Update properties of this object
2482
2642
  def update!(**args)
2643
+ @last_statements = args[:last_statements] if args.key?(:last_statements)
2483
2644
  @request_options = args[:request_options] if args.key?(:request_options)
2484
2645
  @seqno = args[:seqno] if args.key?(:seqno)
2485
2646
  @statements = args[:statements] if args.key?(:statements)
@@ -2564,6 +2725,19 @@ module Google
2564
2725
  # @return [Google::Apis::SpannerV1::DirectedReadOptions]
2565
2726
  attr_accessor :directed_read_options
2566
2727
 
2728
+ # Optional. If set to true, this statement marks the end of the transaction. The
2729
+ # transaction should be committed or aborted after this statement executes, and
2730
+ # attempts to execute any other requests against this transaction (including
2731
+ # reads and queries) will be rejected. For DML statements, setting this option
2732
+ # may cause some error reporting to be deferred until commit time (e.g.
2733
+ # validation of unique constraints). Given this, successful execution of a DML
2734
+ # statement should not be assumed until a subsequent Commit call completes
2735
+ # successfully.
2736
+ # Corresponds to the JSON property `lastStatement`
2737
+ # @return [Boolean]
2738
+ attr_accessor :last_statement
2739
+ alias_method :last_statement?, :last_statement
2740
+
2567
2741
  # It is not always possible for Cloud Spanner to infer the right SQL type from a
2568
2742
  # JSON value. For example, values of type `BYTES` and values of type `STRING`
2569
2743
  # both appear in params as JSON strings. In these cases, `param_types` can be
@@ -2650,6 +2824,7 @@ module Google
2650
2824
  def update!(**args)
2651
2825
  @data_boost_enabled = args[:data_boost_enabled] if args.key?(:data_boost_enabled)
2652
2826
  @directed_read_options = args[:directed_read_options] if args.key?(:directed_read_options)
2827
+ @last_statement = args[:last_statement] if args.key?(:last_statement)
2653
2828
  @param_types = args[:param_types] if args.key?(:param_types)
2654
2829
  @params = args[:params] if args.key?(:params)
2655
2830
  @partition_token = args[:partition_token] if args.key?(:partition_token)
@@ -3013,12 +3188,14 @@ module Google
3013
3188
  # @return [String]
3014
3189
  attr_accessor :create_time
3015
3190
 
3016
- # Optional. Controls the default backup behavior for new databases within the
3017
- # instance. Note that `AUTOMATIC` is not permitted for free instances, as
3018
- # backups and backup schedules are not allowed for free instances. In the `
3019
- # GetInstance` or `ListInstances` response, if the value of
3020
- # default_backup_schedule_type is unset or NONE, no default backup schedule will
3021
- # be created for new databases within the instance.
3191
+ # Optional. Controls the default backup schedule behavior for new databases
3192
+ # within the instance. By default, a backup schedule is created automatically
3193
+ # when a new database is created in a new instance. Note that the `AUTOMATIC`
3194
+ # value isn't permitted for free instances, as backups and backup schedules aren'
3195
+ # t supported for free instances. In the `GetInstance` or `ListInstances`
3196
+ # response, if the value of `default_backup_schedule_type` isn't set, or set to `
3197
+ # NONE`, Spanner doesn't create a default backup schedule for new databases in
3198
+ # the instance.
3022
3199
  # Corresponds to the JSON property `defaultBackupScheduleType`
3023
3200
  # @return [String]
3024
3201
  attr_accessor :default_backup_schedule_type
@@ -3084,8 +3261,11 @@ module Google
3084
3261
  # the instance. If autoscaling is enabled, `node_count` is treated as an `
3085
3262
  # OUTPUT_ONLY` field and reflects the current number of nodes allocated to the
3086
3263
  # instance. This might be zero in API responses for instances that are not yet
3087
- # in the `READY` state. For more information, see [Compute capacity, nodes, and
3088
- # processing units](https://cloud.google.com/spanner/docs/compute-capacity).
3264
+ # in the `READY` state. If the instance has varying node count across replicas (
3265
+ # achieved by setting `asymmetric_autoscaling_options` in the autoscaling
3266
+ # configuration), the `node_count` set here is the maximum node count across all
3267
+ # replicas. For more information, see [Compute capacity, nodes, and processing
3268
+ # units](https://cloud.google.com/spanner/docs/compute-capacity).
3089
3269
  # Corresponds to the JSON property `nodeCount`
3090
3270
  # @return [Fixnum]
3091
3271
  attr_accessor :node_count
@@ -3096,9 +3276,12 @@ module Google
3096
3276
  # processing units allocated to the instance. If autoscaling is enabled, `
3097
3277
  # processing_units` is treated as an `OUTPUT_ONLY` field and reflects the
3098
3278
  # current number of processing units allocated to the instance. This might be
3099
- # zero in API responses for instances that are not yet in the `READY` state. For
3100
- # more information, see [Compute capacity, nodes and processing units](https://
3101
- # cloud.google.com/spanner/docs/compute-capacity).
3279
+ # zero in API responses for instances that are not yet in the `READY` state. If
3280
+ # the instance has varying processing units per replica (achieved by setting `
3281
+ # asymmetric_autoscaling_options` in the autoscaling configuration), the `
3282
+ # processing_units` set here is the maximum processing units across all replicas.
3283
+ # For more information, see [Compute capacity, nodes and processing units](
3284
+ # https://cloud.google.com/spanner/docs/compute-capacity).
3102
3285
  # Corresponds to the JSON property `processingUnits`
3103
3286
  # @return [Fixnum]
3104
3287
  attr_accessor :processing_units
@@ -3441,6 +3624,25 @@ module Google
3441
3624
  end
3442
3625
  end
3443
3626
 
3627
+ # A split key.
3628
+ class Key
3629
+ include Google::Apis::Core::Hashable
3630
+
3631
+ # Required. The column values making up the split key.
3632
+ # Corresponds to the JSON property `keyParts`
3633
+ # @return [Array<Object>]
3634
+ attr_accessor :key_parts
3635
+
3636
+ def initialize(**args)
3637
+ update!(**args)
3638
+ end
3639
+
3640
+ # Update properties of this object
3641
+ def update!(**args)
3642
+ @key_parts = args[:key_parts] if args.key?(:key_parts)
3643
+ end
3644
+ end
3645
+
3444
3646
  # KeyRange represents a range of rows in a table or index. A range has a start
3445
3647
  # key and an end key. These keys can be open or closed, indicating if the range
3446
3648
  # includes rows with that key. Keys are represented by lists, where the ith
@@ -5923,8 +6125,8 @@ module Google
5923
6125
 
5924
6126
  # Optional. If true, specifies a multiplexed session. Use a multiplexed session
5925
6127
  # for multiple, concurrent read-only operations. Don't use them for read-write
5926
- # transactions, partitioned reads, or partitioned queries. Use CreateSession to
5927
- # create multiplexed sessions. Don't use BatchCreateSessions to create a
6128
+ # transactions, partitioned reads, or partitioned queries. Use `sessions.create`
6129
+ # to create multiplexed sessions. Don't use BatchCreateSessions to create a
5928
6130
  # multiplexed session. You can't delete or list multiplexed sessions.
5929
6131
  # Corresponds to the JSON property `multiplexed`
5930
6132
  # @return [Boolean]
@@ -6048,6 +6250,46 @@ module Google
6048
6250
  end
6049
6251
  end
6050
6252
 
6253
+ # The split points of a table/index.
6254
+ class SplitPoints
6255
+ include Google::Apis::Core::Hashable
6256
+
6257
+ # Optional. The expiration timestamp of the split points. A timestamp in the
6258
+ # past means immediate expiration. The maximum value can be 30 days in the
6259
+ # future. Defaults to 10 days in the future if not specified.
6260
+ # Corresponds to the JSON property `expireTime`
6261
+ # @return [String]
6262
+ attr_accessor :expire_time
6263
+
6264
+ # The index to split. If specified, the `table` field must refer to the index's
6265
+ # base table.
6266
+ # Corresponds to the JSON property `index`
6267
+ # @return [String]
6268
+ attr_accessor :index
6269
+
6270
+ # Required. The list of split keys, i.e., the split boundaries.
6271
+ # Corresponds to the JSON property `keys`
6272
+ # @return [Array<Google::Apis::SpannerV1::Key>]
6273
+ attr_accessor :keys
6274
+
6275
+ # The table to split.
6276
+ # Corresponds to the JSON property `table`
6277
+ # @return [String]
6278
+ attr_accessor :table
6279
+
6280
+ def initialize(**args)
6281
+ update!(**args)
6282
+ end
6283
+
6284
+ # Update properties of this object
6285
+ def update!(**args)
6286
+ @expire_time = args[:expire_time] if args.key?(:expire_time)
6287
+ @index = args[:index] if args.key?(:index)
6288
+ @keys = args[:keys] if args.key?(:keys)
6289
+ @table = args[:table] if args.key?(:table)
6290
+ end
6291
+ end
6292
+
6051
6293
  # A single DML statement.
6052
6294
  class Statement
6053
6295
  include Google::Apis::Core::Hashable
@@ -7025,7 +7267,7 @@ module Google
7025
7267
  attr_accessor :operation_id
7026
7268
 
7027
7269
  # Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements.
7028
- # Contains a protobuf-serialized [google.protobufFileDescriptorSet](https://
7270
+ # Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://
7029
7271
  # github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.
7030
7272
  # proto). To generate it, [install](https://grpc.io/docs/protoc-installation/)
7031
7273
  # and run `protoc` with --include_imports and --descriptor_set_out. For example,
@@ -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.38.0"
19
+ GEM_VERSION = "0.39.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.16.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20241218"
25
+ REVISION = "20250220"
26
26
  end
27
27
  end
28
28
  end
@@ -22,6 +22,36 @@ module Google
22
22
  module Apis
23
23
  module SpannerV1
24
24
 
25
+ class AdaptMessageRequest
26
+ class Representation < Google::Apis::Core::JsonRepresentation; end
27
+
28
+ include Google::Apis::Core::JsonObjectSupport
29
+ end
30
+
31
+ class AdaptMessageResponse
32
+ class Representation < Google::Apis::Core::JsonRepresentation; end
33
+
34
+ include Google::Apis::Core::JsonObjectSupport
35
+ end
36
+
37
+ class AdapterSession
38
+ class Representation < Google::Apis::Core::JsonRepresentation; end
39
+
40
+ include Google::Apis::Core::JsonObjectSupport
41
+ end
42
+
43
+ class AddSplitPointsRequest
44
+ class Representation < Google::Apis::Core::JsonRepresentation; end
45
+
46
+ include Google::Apis::Core::JsonObjectSupport
47
+ end
48
+
49
+ class AddSplitPointsResponse
50
+ class Representation < Google::Apis::Core::JsonRepresentation; end
51
+
52
+ include Google::Apis::Core::JsonObjectSupport
53
+ end
54
+
25
55
  class AsymmetricAutoscalingOption
26
56
  class Representation < Google::Apis::Core::JsonRepresentation; end
27
57
 
@@ -64,6 +94,12 @@ module Google
64
94
  include Google::Apis::Core::JsonObjectSupport
65
95
  end
66
96
 
97
+ class BackupInstancePartition
98
+ class Representation < Google::Apis::Core::JsonRepresentation; end
99
+
100
+ include Google::Apis::Core::JsonObjectSupport
101
+ end
102
+
67
103
  class BackupSchedule
68
104
  class Representation < Google::Apis::Core::JsonRepresentation; end
69
105
 
@@ -436,6 +472,12 @@ module Google
436
472
  include Google::Apis::Core::JsonObjectSupport
437
473
  end
438
474
 
475
+ class Key
476
+ class Representation < Google::Apis::Core::JsonRepresentation; end
477
+
478
+ include Google::Apis::Core::JsonObjectSupport
479
+ end
480
+
439
481
  class KeyRange
440
482
  class Representation < Google::Apis::Core::JsonRepresentation; end
441
483
 
@@ -826,6 +868,12 @@ module Google
826
868
  include Google::Apis::Core::JsonObjectSupport
827
869
  end
828
870
 
871
+ class SplitPoints
872
+ class Representation < Google::Apis::Core::JsonRepresentation; end
873
+
874
+ include Google::Apis::Core::JsonObjectSupport
875
+ end
876
+
829
877
  class Statement
830
878
  class Representation < Google::Apis::Core::JsonRepresentation; end
831
879
 
@@ -952,6 +1000,45 @@ module Google
952
1000
  include Google::Apis::Core::JsonObjectSupport
953
1001
  end
954
1002
 
1003
+ class AdaptMessageRequest
1004
+ # @private
1005
+ class Representation < Google::Apis::Core::JsonRepresentation
1006
+ hash :attachments, as: 'attachments'
1007
+ property :payload, :base64 => true, as: 'payload'
1008
+ property :protocol, as: 'protocol'
1009
+ end
1010
+ end
1011
+
1012
+ class AdaptMessageResponse
1013
+ # @private
1014
+ class Representation < Google::Apis::Core::JsonRepresentation
1015
+ property :payload, :base64 => true, as: 'payload'
1016
+ hash :state_updates, as: 'stateUpdates'
1017
+ end
1018
+ end
1019
+
1020
+ class AdapterSession
1021
+ # @private
1022
+ class Representation < Google::Apis::Core::JsonRepresentation
1023
+ property :name, as: 'name'
1024
+ end
1025
+ end
1026
+
1027
+ class AddSplitPointsRequest
1028
+ # @private
1029
+ class Representation < Google::Apis::Core::JsonRepresentation
1030
+ property :initiator, as: 'initiator'
1031
+ collection :split_points, as: 'splitPoints', class: Google::Apis::SpannerV1::SplitPoints, decorator: Google::Apis::SpannerV1::SplitPoints::Representation
1032
+
1033
+ end
1034
+ end
1035
+
1036
+ class AddSplitPointsResponse
1037
+ # @private
1038
+ class Representation < Google::Apis::Core::JsonRepresentation
1039
+ end
1040
+ end
1041
+
955
1042
  class AsymmetricAutoscalingOption
956
1043
  # @private
957
1044
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1016,6 +1103,8 @@ module Google
1016
1103
  property :expire_time, as: 'expireTime'
1017
1104
  property :freeable_size_bytes, :numeric_string => true, as: 'freeableSizeBytes'
1018
1105
  property :incremental_backup_chain_id, as: 'incrementalBackupChainId'
1106
+ collection :instance_partitions, as: 'instancePartitions', class: Google::Apis::SpannerV1::BackupInstancePartition, decorator: Google::Apis::SpannerV1::BackupInstancePartition::Representation
1107
+
1019
1108
  property :max_expire_time, as: 'maxExpireTime'
1020
1109
  property :name, as: 'name'
1021
1110
  property :oldest_version_time, as: 'oldestVersionTime'
@@ -1037,6 +1126,13 @@ module Google
1037
1126
  end
1038
1127
  end
1039
1128
 
1129
+ class BackupInstancePartition
1130
+ # @private
1131
+ class Representation < Google::Apis::Core::JsonRepresentation
1132
+ property :instance_partition, as: 'instancePartition'
1133
+ end
1134
+ end
1135
+
1040
1136
  class BackupSchedule
1041
1137
  # @private
1042
1138
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1469,6 +1565,7 @@ module Google
1469
1565
  class ExecuteBatchDmlRequest
1470
1566
  # @private
1471
1567
  class Representation < Google::Apis::Core::JsonRepresentation
1568
+ property :last_statements, as: 'lastStatements'
1472
1569
  property :request_options, as: 'requestOptions', class: Google::Apis::SpannerV1::RequestOptions, decorator: Google::Apis::SpannerV1::RequestOptions::Representation
1473
1570
 
1474
1571
  property :seqno, :numeric_string => true, as: 'seqno'
@@ -1497,6 +1594,7 @@ module Google
1497
1594
  property :data_boost_enabled, as: 'dataBoostEnabled'
1498
1595
  property :directed_read_options, as: 'directedReadOptions', class: Google::Apis::SpannerV1::DirectedReadOptions, decorator: Google::Apis::SpannerV1::DirectedReadOptions::Representation
1499
1596
 
1597
+ property :last_statement, as: 'lastStatement'
1500
1598
  hash :param_types, as: 'paramTypes', class: Google::Apis::SpannerV1::Type, decorator: Google::Apis::SpannerV1::Type::Representation
1501
1599
 
1502
1600
  hash :params, as: 'params'
@@ -1689,6 +1787,13 @@ module Google
1689
1787
  end
1690
1788
  end
1691
1789
 
1790
+ class Key
1791
+ # @private
1792
+ class Representation < Google::Apis::Core::JsonRepresentation
1793
+ collection :key_parts, as: 'keyParts'
1794
+ end
1795
+ end
1796
+
1692
1797
  class KeyRange
1693
1798
  # @private
1694
1799
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2372,6 +2477,17 @@ module Google
2372
2477
  end
2373
2478
  end
2374
2479
 
2480
+ class SplitPoints
2481
+ # @private
2482
+ class Representation < Google::Apis::Core::JsonRepresentation
2483
+ property :expire_time, as: 'expireTime'
2484
+ property :index, as: 'index'
2485
+ collection :keys, as: 'keys', class: Google::Apis::SpannerV1::Key, decorator: Google::Apis::SpannerV1::Key::Representation
2486
+
2487
+ property :table, as: 'table'
2488
+ end
2489
+ end
2490
+
2375
2491
  class Statement
2376
2492
  # @private
2377
2493
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1734,6 +1734,40 @@ module Google
1734
1734
  execute_or_queue_command(command, &block)
1735
1735
  end
1736
1736
 
1737
+ # Adds split points to specified tables, indexes of a database.
1738
+ # @param [String] database
1739
+ # Required. The database on whose tables/indexes split points are to be added.
1740
+ # Values are of the form `projects//instances//databases/`.
1741
+ # @param [Google::Apis::SpannerV1::AddSplitPointsRequest] add_split_points_request_object
1742
+ # @param [String] fields
1743
+ # Selector specifying which fields to include in a partial response.
1744
+ # @param [String] quota_user
1745
+ # Available to use for quota purposes for server-side applications. Can be any
1746
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1747
+ # @param [Google::Apis::RequestOptions] options
1748
+ # Request-specific options
1749
+ #
1750
+ # @yield [result, err] Result & error if block supplied
1751
+ # @yieldparam result [Google::Apis::SpannerV1::AddSplitPointsResponse] parsed result object
1752
+ # @yieldparam err [StandardError] error object if request failed
1753
+ #
1754
+ # @return [Google::Apis::SpannerV1::AddSplitPointsResponse]
1755
+ #
1756
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1757
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1758
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1759
+ def add_database_split_points(database, add_split_points_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1760
+ command = make_simple_command(:post, 'v1/{+database}:addSplitPoints', options)
1761
+ command.request_representation = Google::Apis::SpannerV1::AddSplitPointsRequest::Representation
1762
+ command.request_object = add_split_points_request_object
1763
+ command.response_representation = Google::Apis::SpannerV1::AddSplitPointsResponse::Representation
1764
+ command.response_class = Google::Apis::SpannerV1::AddSplitPointsResponse
1765
+ command.params['database'] = database unless database.nil?
1766
+ command.query['fields'] = fields unless fields.nil?
1767
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1768
+ execute_or_queue_command(command, &block)
1769
+ end
1770
+
1737
1771
  # `ChangeQuorum` is strictly restricted to databases that use dual-region
1738
1772
  # instance configurations. Initiates a background operation to change the quorum
1739
1773
  # of a database from dual-region mode to single-region mode or vice versa. The
@@ -2779,6 +2813,76 @@ module Google
2779
2813
  execute_or_queue_command(command, &block)
2780
2814
  end
2781
2815
 
2816
+ # Handles a single message from the client and returns the result as a stream.
2817
+ # The server will interpret the message frame and respond with message frames to
2818
+ # the client.
2819
+ # @param [String] name
2820
+ # Required. The database session in which the adapter request is processed.
2821
+ # @param [Google::Apis::SpannerV1::AdaptMessageRequest] adapt_message_request_object
2822
+ # @param [String] fields
2823
+ # Selector specifying which fields to include in a partial response.
2824
+ # @param [String] quota_user
2825
+ # Available to use for quota purposes for server-side applications. Can be any
2826
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2827
+ # @param [Google::Apis::RequestOptions] options
2828
+ # Request-specific options
2829
+ #
2830
+ # @yield [result, err] Result & error if block supplied
2831
+ # @yieldparam result [Google::Apis::SpannerV1::AdaptMessageResponse] parsed result object
2832
+ # @yieldparam err [StandardError] error object if request failed
2833
+ #
2834
+ # @return [Google::Apis::SpannerV1::AdaptMessageResponse]
2835
+ #
2836
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2837
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2838
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2839
+ def adapt_session_message(name, adapt_message_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2840
+ command = make_simple_command(:post, 'v1/{+name}:adaptMessage', options)
2841
+ command.request_representation = Google::Apis::SpannerV1::AdaptMessageRequest::Representation
2842
+ command.request_object = adapt_message_request_object
2843
+ command.response_representation = Google::Apis::SpannerV1::AdaptMessageResponse::Representation
2844
+ command.response_class = Google::Apis::SpannerV1::AdaptMessageResponse
2845
+ command.params['name'] = name unless name.nil?
2846
+ command.query['fields'] = fields unless fields.nil?
2847
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2848
+ execute_or_queue_command(command, &block)
2849
+ end
2850
+
2851
+ # Creates a new session to be used for requests made by the adapter. A session
2852
+ # identifies a specific incarnation of a database resource and is meant to be
2853
+ # reused across many `AdaptMessage` calls.
2854
+ # @param [String] parent
2855
+ # Required. The database in which the new session is created.
2856
+ # @param [Google::Apis::SpannerV1::AdapterSession] adapter_session_object
2857
+ # @param [String] fields
2858
+ # Selector specifying which fields to include in a partial response.
2859
+ # @param [String] quota_user
2860
+ # Available to use for quota purposes for server-side applications. Can be any
2861
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2862
+ # @param [Google::Apis::RequestOptions] options
2863
+ # Request-specific options
2864
+ #
2865
+ # @yield [result, err] Result & error if block supplied
2866
+ # @yieldparam result [Google::Apis::SpannerV1::AdapterSession] parsed result object
2867
+ # @yieldparam err [StandardError] error object if request failed
2868
+ #
2869
+ # @return [Google::Apis::SpannerV1::AdapterSession]
2870
+ #
2871
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2872
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2873
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2874
+ def adapter_project_instance_database_session(parent, adapter_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2875
+ command = make_simple_command(:post, 'v1/{+parent}/sessions:adapter', options)
2876
+ command.request_representation = Google::Apis::SpannerV1::AdapterSession::Representation
2877
+ command.request_object = adapter_session_object
2878
+ command.response_representation = Google::Apis::SpannerV1::AdapterSession::Representation
2879
+ command.response_class = Google::Apis::SpannerV1::AdapterSession
2880
+ command.params['parent'] = parent unless parent.nil?
2881
+ command.query['fields'] = fields unless fields.nil?
2882
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2883
+ execute_or_queue_command(command, &block)
2884
+ end
2885
+
2782
2886
  # Creates multiple new sessions. This API can be used to initialize a session
2783
2887
  # cache on the clients. See https://goo.gl/TgSFN2 for best practices on session
2784
2888
  # cache management.
@@ -3055,7 +3159,9 @@ module Google
3055
3159
  # Operations inside read-write transactions might return `ABORTED`. If this
3056
3160
  # occurs, the application should restart the transaction from the beginning. See
3057
3161
  # Transaction for more details. Larger result sets can be fetched in streaming
3058
- # fashion by calling ExecuteStreamingSql instead.
3162
+ # fashion by calling ExecuteStreamingSql instead. The query string can be SQL or
3163
+ # [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/
3164
+ # standard-sql/graph-intro).
3059
3165
  # @param [String] session
3060
3166
  # Required. The session in which the SQL query should be performed.
3061
3167
  # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
@@ -3091,7 +3197,8 @@ module Google
3091
3197
  # Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql,
3092
3198
  # there is no limit on the size of the returned result set. However, no
3093
3199
  # individual row in the result set can exceed 100 MiB, and no column value can
3094
- # exceed 10 MiB.
3200
+ # exceed 10 MiB. The query string can be SQL or [Graph Query Language (GQL)](
3201
+ # https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
3095
3202
  # @param [String] session
3096
3203
  # Required. The session in which the SQL query should be performed.
3097
3204
  # @param [Google::Apis::SpannerV1::ExecuteSqlRequest] execute_sql_request_object
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-spanner_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.38.0
4
+ version: 0.39.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-12 00:00:00.000000000 Z
10
+ date: 2025-03-02 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.38.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.39.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
62
62
  rdoc_options: []
63
63
  require_paths:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
73
73
  - !ruby/object:Gem::Version
74
74
  version: '0'
75
75
  requirements: []
76
- rubygems_version: 3.6.2
76
+ rubygems_version: 3.6.5
77
77
  specification_version: 4
78
78
  summary: Simple REST client for Cloud Spanner API V1
79
79
  test_files: []