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 +4 -4
- data/CHANGELOG.md +4 -0
- data/lib/google/apis/spanner_v1/classes.rb +273 -31
- data/lib/google/apis/spanner_v1/gem_version.rb +2 -2
- data/lib/google/apis/spanner_v1/representations.rb +116 -0
- data/lib/google/apis/spanner_v1/service.rb +109 -2
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 80aab876566e716fc6f342f93eed7c62dd1ee0bd5552d96ba479de28adde6cb2
|
4
|
+
data.tar.gz: 22a06a2a63ca137eb6926e1b299c9709ceed4be566826ea6fdcb9e1921c9c576
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 8e66fb6ecfa79250487e211943073aa452ae0718fa276ed995bfc2f03c119f6cc5745380a1864840f1af9c5543d1bdb33965ef0f011b8e198515c7bb60747d26
|
7
|
+
data.tar.gz: '09335b0beac3787e24364869a26288b594adef0bd1358b3569bcad38ef9143c3e04519d486e642582af3eade5e50461e1e3992a48bd5f66d8dcac81b3a87271b'
|
data/CHANGELOG.md
CHANGED
@@ -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
|
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
|
2107
|
+
# backup is created.
|
1962
2108
|
class CrontabSpec
|
1963
2109
|
include Google::Apis::Core::Hashable
|
1964
2110
|
|
1965
|
-
# Output only.
|
1966
|
-
#
|
1967
|
-
#
|
1968
|
-
#
|
1969
|
-
#
|
1970
|
-
#
|
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
|
1978
|
-
# copy of the database at the version time.
|
1979
|
-
#
|
1980
|
-
#
|
1981
|
-
# every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * *
|
1982
|
-
#
|
1983
|
-
#
|
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
|
3017
|
-
# instance.
|
3018
|
-
#
|
3019
|
-
#
|
3020
|
-
#
|
3021
|
-
#
|
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.
|
3088
|
-
#
|
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.
|
3100
|
-
#
|
3101
|
-
#
|
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
|
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.
|
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.
|
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 = "
|
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.
|
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-
|
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.
|
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.
|
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: []
|