google-cloud-spanner-v1 0.13.0 → 0.14.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 506e5f2c7f94609ad28e4a3d6d53a00ea9512e861999529e85cca4ab1d3a7fd1
4
- data.tar.gz: c3998ce28c3c96271b0354c47cffd670ca43ac1193c33587a758da2593ba489a
3
+ metadata.gz: 7e009ffe3b3ff028216d252e3b7fa6bfa1a6c697aa6b1312a2b04afa41a1a116
4
+ data.tar.gz: 60ae96f186fa045681506e356480f8200bdf08dda3330949938fb6892c0cd6c1
5
5
  SHA512:
6
- metadata.gz: e2e57a196955b402002d7a50965d08eb676360188d59e063b478635d2a972f458b7643f298414b135738b53fe1234307fefbb3cc091715437b81c6a68220fe93
7
- data.tar.gz: 35c0bf23032ad50669c14e5035893d968d100e4e90639cf6ccd787a9647bace9513d8d6a44ec44a96b28adf4b4220ca29d1caad4f38e6f330d76b557f31282c1
6
+ metadata.gz: 3d4b30ebd5f222c59092a73699b17e57ebef1314761f4ca71eca89b494969db9937b1d534ea67214730761b37bf8c72d0e4720e8d467f1ccc07606cac3e74488
7
+ data.tar.gz: 976bb75e73abb5c4069bdd7dc5544cd747fa586bf348a13096617c062e90b3b0a2638e263fa0f2eaf188bb656dbf324e71f49186e154ec7465e029fedde5a695
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ruby Client for the Cloud Spanner V1 API
2
2
 
3
- API Client library for the Cloud Spanner V1 API
3
+ Cloud Spanner is a managed, mission-critical, globally consistent and scalable relational database service.
4
4
 
5
5
  Cloud Spanner is a managed, mission-critical, globally consistent and scalable relational database service.
6
6
 
@@ -46,8 +46,8 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
49
+ The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -563,13 +563,11 @@ module Google
563
563
  # # Call the list_sessions method.
564
564
  # result = client.list_sessions request
565
565
  #
566
- # # The returned object is of type Gapic::PagedEnumerable. You can
567
- # # iterate over all elements by calling #each, and the enumerable
568
- # # will lazily make API calls to fetch subsequent pages. Other
569
- # # methods are also available for managing paging directly.
570
- # result.each do |response|
566
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
567
+ # # over elements, and API calls will be issued to fetch pages as needed.
568
+ # result.each do |item|
571
569
  # # Each element is of type ::Google::Cloud::Spanner::V1::Session.
572
- # p response
570
+ # p item
573
571
  # end
574
572
  #
575
573
  def list_sessions request, options = nil
@@ -724,7 +722,7 @@ module Google
724
722
  # @param options [::Gapic::CallOptions, ::Hash]
725
723
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
726
724
  #
727
- # @overload execute_sql(session: nil, transaction: nil, sql: nil, params: nil, param_types: nil, resume_token: nil, query_mode: nil, partition_token: nil, seqno: nil, query_options: nil, request_options: nil)
725
+ # @overload execute_sql(session: nil, transaction: nil, sql: nil, params: nil, param_types: nil, resume_token: nil, query_mode: nil, partition_token: nil, seqno: nil, query_options: nil, request_options: nil, data_boost_enabled: nil)
728
726
  # Pass arguments to `execute_sql` via keyword arguments. Note that at
729
727
  # least one keyword argument is required. To specify no parameters, or to keep all
730
728
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -798,6 +796,12 @@ module Google
798
796
  # Query optimizer configuration to use for the given query.
799
797
  # @param request_options [::Google::Cloud::Spanner::V1::RequestOptions, ::Hash]
800
798
  # Common options for this request.
799
+ # @param data_boost_enabled [::Boolean]
800
+ # If this is for a partitioned query and this field is set to `true`, the
801
+ # request will be executed via Spanner independent compute resources.
802
+ #
803
+ # If the field is set to `true` but the request does not set
804
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
801
805
  #
802
806
  # @yield [response, operation] Access the result along with the RPC operation
803
807
  # @yieldparam response [::Google::Cloud::Spanner::V1::ResultSet]
@@ -880,7 +884,7 @@ module Google
880
884
  # @param options [::Gapic::CallOptions, ::Hash]
881
885
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
882
886
  #
883
- # @overload execute_streaming_sql(session: nil, transaction: nil, sql: nil, params: nil, param_types: nil, resume_token: nil, query_mode: nil, partition_token: nil, seqno: nil, query_options: nil, request_options: nil)
887
+ # @overload execute_streaming_sql(session: nil, transaction: nil, sql: nil, params: nil, param_types: nil, resume_token: nil, query_mode: nil, partition_token: nil, seqno: nil, query_options: nil, request_options: nil, data_boost_enabled: nil)
884
888
  # Pass arguments to `execute_streaming_sql` via keyword arguments. Note that at
885
889
  # least one keyword argument is required. To specify no parameters, or to keep all
886
890
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -954,6 +958,12 @@ module Google
954
958
  # Query optimizer configuration to use for the given query.
955
959
  # @param request_options [::Google::Cloud::Spanner::V1::RequestOptions, ::Hash]
956
960
  # Common options for this request.
961
+ # @param data_boost_enabled [::Boolean]
962
+ # If this is for a partitioned query and this field is set to `true`, the
963
+ # request will be executed via Spanner independent compute resources.
964
+ #
965
+ # If the field is set to `true` but the request does not set
966
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
957
967
  #
958
968
  # @yield [response, operation] Access the result along with the RPC operation
959
969
  # @yieldparam response [::Enumerable<::Google::Cloud::Spanner::V1::PartialResultSet>]
@@ -972,13 +982,13 @@ module Google
972
982
  # # Create a request. To set request fields, pass in keyword arguments.
973
983
  # request = Google::Cloud::Spanner::V1::ExecuteSqlRequest.new
974
984
  #
975
- # # Call the execute_streaming_sql method.
976
- # result = client.execute_streaming_sql request
985
+ # # Call the execute_streaming_sql method to start streaming.
986
+ # output = client.execute_streaming_sql request
977
987
  #
978
- # # The returned object is a streamed enumerable yielding elements of
979
- # # type ::Google::Cloud::Spanner::V1::PartialResultSet.
980
- # result.each do |response|
981
- # p response
988
+ # # The returned object is a streamed enumerable yielding elements of type
989
+ # # ::Google::Cloud::Spanner::V1::PartialResultSet
990
+ # output.each do |current_response|
991
+ # p current_response
982
992
  # end
983
993
  #
984
994
  def execute_streaming_sql request, options = nil
@@ -1166,7 +1176,7 @@ module Google
1166
1176
  # @param options [::Gapic::CallOptions, ::Hash]
1167
1177
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1168
1178
  #
1169
- # @overload read(session: nil, transaction: nil, table: nil, index: nil, columns: nil, key_set: nil, limit: nil, resume_token: nil, partition_token: nil, request_options: nil)
1179
+ # @overload read(session: nil, transaction: nil, table: nil, index: nil, columns: nil, key_set: nil, limit: nil, resume_token: nil, partition_token: nil, request_options: nil, data_boost_enabled: nil)
1170
1180
  # Pass arguments to `read` via keyword arguments. Note that at
1171
1181
  # least one keyword argument is required. To specify no parameters, or to keep all
1172
1182
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1216,6 +1226,12 @@ module Google
1216
1226
  # PartitionReadRequest message used to create this partition_token.
1217
1227
  # @param request_options [::Google::Cloud::Spanner::V1::RequestOptions, ::Hash]
1218
1228
  # Common options for this request.
1229
+ # @param data_boost_enabled [::Boolean]
1230
+ # If this is for a partitioned read and this field is set to `true`, the
1231
+ # request will be executed via Spanner independent compute resources.
1232
+ #
1233
+ # If the field is set to `true` but the request does not set
1234
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
1219
1235
  #
1220
1236
  # @yield [response, operation] Access the result along with the RPC operation
1221
1237
  # @yieldparam response [::Google::Cloud::Spanner::V1::ResultSet]
@@ -1298,7 +1314,7 @@ module Google
1298
1314
  # @param options [::Gapic::CallOptions, ::Hash]
1299
1315
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1300
1316
  #
1301
- # @overload streaming_read(session: nil, transaction: nil, table: nil, index: nil, columns: nil, key_set: nil, limit: nil, resume_token: nil, partition_token: nil, request_options: nil)
1317
+ # @overload streaming_read(session: nil, transaction: nil, table: nil, index: nil, columns: nil, key_set: nil, limit: nil, resume_token: nil, partition_token: nil, request_options: nil, data_boost_enabled: nil)
1302
1318
  # Pass arguments to `streaming_read` via keyword arguments. Note that at
1303
1319
  # least one keyword argument is required. To specify no parameters, or to keep all
1304
1320
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1348,6 +1364,12 @@ module Google
1348
1364
  # PartitionReadRequest message used to create this partition_token.
1349
1365
  # @param request_options [::Google::Cloud::Spanner::V1::RequestOptions, ::Hash]
1350
1366
  # Common options for this request.
1367
+ # @param data_boost_enabled [::Boolean]
1368
+ # If this is for a partitioned read and this field is set to `true`, the
1369
+ # request will be executed via Spanner independent compute resources.
1370
+ #
1371
+ # If the field is set to `true` but the request does not set
1372
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
1351
1373
  #
1352
1374
  # @yield [response, operation] Access the result along with the RPC operation
1353
1375
  # @yieldparam response [::Enumerable<::Google::Cloud::Spanner::V1::PartialResultSet>]
@@ -1366,13 +1388,13 @@ module Google
1366
1388
  # # Create a request. To set request fields, pass in keyword arguments.
1367
1389
  # request = Google::Cloud::Spanner::V1::ReadRequest.new
1368
1390
  #
1369
- # # Call the streaming_read method.
1370
- # result = client.streaming_read request
1391
+ # # Call the streaming_read method to start streaming.
1392
+ # output = client.streaming_read request
1371
1393
  #
1372
- # # The returned object is a streamed enumerable yielding elements of
1373
- # # type ::Google::Cloud::Spanner::V1::PartialResultSet.
1374
- # result.each do |response|
1375
- # p response
1394
+ # # The returned object is a streamed enumerable yielding elements of type
1395
+ # # ::Google::Cloud::Spanner::V1::PartialResultSet
1396
+ # output.each do |current_response|
1397
+ # p current_response
1376
1398
  # end
1377
1399
  #
1378
1400
  def streaming_read request, options = nil
@@ -2016,9 +2038,9 @@ module Google
2016
2038
  # * (`String`) The path to a service account key file in JSON format
2017
2039
  # * (`Hash`) A service account key as a Hash
2018
2040
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2019
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
2041
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2020
2042
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2021
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
2043
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2022
2044
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2023
2045
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2024
2046
  # * (`nil`) indicating no credentials
@@ -36,7 +36,7 @@ module Google
36
36
  # The Cloud Spanner API can be used to manage sessions and execute
37
37
  # transactions on data stored in Cloud Spanner databases.
38
38
  #
39
- # To load this service and instantiate a client:
39
+ # @example Load this service and instantiate a gRPC client
40
40
  #
41
41
  # require "google/cloud/spanner/v1/spanner"
42
42
  # client = ::Google::Cloud::Spanner::V1::Spanner::Client.new
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Spanner
23
23
  module V1
24
- VERSION = "0.13.0"
24
+ VERSION = "0.14.1"
25
25
  end
26
26
  end
27
27
  end
@@ -23,9 +23,9 @@ module Google
23
23
  module Cloud
24
24
  module Spanner
25
25
  ##
26
- # To load this package, including all its services, and instantiate a client:
26
+ # API client module.
27
27
  #
28
- # @example
28
+ # @example Load this package, including all its services, and instantiate a gRPC client
29
29
  #
30
30
  # require "google/cloud/spanner/v1"
31
31
  # client = ::Google::Cloud::Spanner::V1::Spanner::Client.new
@@ -78,6 +78,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
78
78
  optional :seqno, :int64, 9
79
79
  optional :query_options, :message, 10, "google.spanner.v1.ExecuteSqlRequest.QueryOptions"
80
80
  optional :request_options, :message, 11, "google.spanner.v1.RequestOptions"
81
+ optional :data_boost_enabled, :bool, 16
81
82
  end
82
83
  add_message "google.spanner.v1.ExecuteSqlRequest.QueryOptions" do
83
84
  optional :optimizer_version, :string, 1
@@ -143,6 +144,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
143
144
  optional :resume_token, :bytes, 9
144
145
  optional :partition_token, :bytes, 10
145
146
  optional :request_options, :message, 11, "google.spanner.v1.RequestOptions"
147
+ optional :data_boost_enabled, :bool, 15
146
148
  end
147
149
  add_message "google.spanner.v1.BeginTransactionRequest" do
148
150
  optional :session, :string, 1
@@ -0,0 +1,324 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # Required information for every language.
23
+ # @!attribute [rw] reference_docs_uri
24
+ # @return [::String]
25
+ # Link to automatically generated reference documentation. Example:
26
+ # https://cloud.google.com/nodejs/docs/reference/asset/latest
27
+ # @!attribute [rw] destinations
28
+ # @return [::Array<::Google::Api::ClientLibraryDestination>]
29
+ # The destination where API teams want this client library to be published.
30
+ class CommonLanguageSettings
31
+ include ::Google::Protobuf::MessageExts
32
+ extend ::Google::Protobuf::MessageExts::ClassMethods
33
+ end
34
+
35
+ # Details about how and where to publish client libraries.
36
+ # @!attribute [rw] version
37
+ # @return [::String]
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
41
+ # @!attribute [rw] launch_stage
42
+ # @return [::Google::Api::LaunchStage]
43
+ # Launch stage of this version of the API.
44
+ # @!attribute [rw] rest_numeric_enums
45
+ # @return [::Boolean]
46
+ # When using transport=rest, the client request will encode enums as
47
+ # numbers rather than strings.
48
+ # @!attribute [rw] java_settings
49
+ # @return [::Google::Api::JavaSettings]
50
+ # Settings for legacy Java features, supported in the Service YAML.
51
+ # @!attribute [rw] cpp_settings
52
+ # @return [::Google::Api::CppSettings]
53
+ # Settings for C++ client libraries.
54
+ # @!attribute [rw] php_settings
55
+ # @return [::Google::Api::PhpSettings]
56
+ # Settings for PHP client libraries.
57
+ # @!attribute [rw] python_settings
58
+ # @return [::Google::Api::PythonSettings]
59
+ # Settings for Python client libraries.
60
+ # @!attribute [rw] node_settings
61
+ # @return [::Google::Api::NodeSettings]
62
+ # Settings for Node client libraries.
63
+ # @!attribute [rw] dotnet_settings
64
+ # @return [::Google::Api::DotnetSettings]
65
+ # Settings for .NET client libraries.
66
+ # @!attribute [rw] ruby_settings
67
+ # @return [::Google::Api::RubySettings]
68
+ # Settings for Ruby client libraries.
69
+ # @!attribute [rw] go_settings
70
+ # @return [::Google::Api::GoSettings]
71
+ # Settings for Go client libraries.
72
+ class ClientLibrarySettings
73
+ include ::Google::Protobuf::MessageExts
74
+ extend ::Google::Protobuf::MessageExts::ClassMethods
75
+ end
76
+
77
+ # This message configures the settings for publishing [Google Cloud Client
78
+ # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
79
+ # generated from the service config.
80
+ # @!attribute [rw] method_settings
81
+ # @return [::Array<::Google::Api::MethodSettings>]
82
+ # A list of API method settings, e.g. the behavior for methods that use the
83
+ # long-running operation pattern.
84
+ # @!attribute [rw] new_issue_uri
85
+ # @return [::String]
86
+ # Link to a place that API users can report issues. Example:
87
+ # https://issuetracker.google.com/issues/new?component=190865&template=1161103
88
+ # @!attribute [rw] documentation_uri
89
+ # @return [::String]
90
+ # Link to product home page. Example:
91
+ # https://cloud.google.com/asset-inventory/docs/overview
92
+ # @!attribute [rw] api_short_name
93
+ # @return [::String]
94
+ # Used as a tracking tag when collecting data about the APIs developer
95
+ # relations artifacts like docs, packages delivered to package managers,
96
+ # etc. Example: "speech".
97
+ # @!attribute [rw] github_label
98
+ # @return [::String]
99
+ # GitHub label to apply to issues and pull requests opened for this API.
100
+ # @!attribute [rw] codeowner_github_teams
101
+ # @return [::Array<::String>]
102
+ # GitHub teams to be added to CODEOWNERS in the directory in GitHub
103
+ # containing source code for the client libraries for this API.
104
+ # @!attribute [rw] doc_tag_prefix
105
+ # @return [::String]
106
+ # A prefix used in sample code when demarking regions to be included in
107
+ # documentation.
108
+ # @!attribute [rw] organization
109
+ # @return [::Google::Api::ClientLibraryOrganization]
110
+ # For whom the client library is being published.
111
+ # @!attribute [rw] library_settings
112
+ # @return [::Array<::Google::Api::ClientLibrarySettings>]
113
+ # Client library settings. If the same version string appears multiple
114
+ # times in this list, then the last one wins. Settings from earlier
115
+ # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
120
+ class Publishing
121
+ include ::Google::Protobuf::MessageExts
122
+ extend ::Google::Protobuf::MessageExts::ClassMethods
123
+ end
124
+
125
+ # Settings for Java client libraries.
126
+ # @!attribute [rw] library_package
127
+ # @return [::String]
128
+ # The package name to use in Java. Clobbers the java_package option
129
+ # set in the protobuf. This should be used **only** by APIs
130
+ # who have already set the language_settings.java.package_name" field
131
+ # in gapic.yaml. API teams should use the protobuf java_package option
132
+ # where possible.
133
+ #
134
+ # Example of a YAML configuration::
135
+ #
136
+ # publishing:
137
+ # java_settings:
138
+ # library_package: com.google.cloud.pubsub.v1
139
+ # @!attribute [rw] service_class_names
140
+ # @return [::Google::Protobuf::Map{::String => ::String}]
141
+ # Configure the Java class name to use instead of the service's for its
142
+ # corresponding generated GAPIC client. Keys are fully-qualified
143
+ # service names as they appear in the protobuf (including the full
144
+ # the language_settings.java.interface_names" field in gapic.yaml. API
145
+ # teams should otherwise use the service name as it appears in the
146
+ # protobuf.
147
+ #
148
+ # Example of a YAML configuration::
149
+ #
150
+ # publishing:
151
+ # java_settings:
152
+ # service_class_names:
153
+ # - google.pubsub.v1.Publisher: TopicAdmin
154
+ # - google.pubsub.v1.Subscriber: SubscriptionAdmin
155
+ # @!attribute [rw] common
156
+ # @return [::Google::Api::CommonLanguageSettings]
157
+ # Some settings.
158
+ class JavaSettings
159
+ include ::Google::Protobuf::MessageExts
160
+ extend ::Google::Protobuf::MessageExts::ClassMethods
161
+
162
+ # @!attribute [rw] key
163
+ # @return [::String]
164
+ # @!attribute [rw] value
165
+ # @return [::String]
166
+ class ServiceClassNamesEntry
167
+ include ::Google::Protobuf::MessageExts
168
+ extend ::Google::Protobuf::MessageExts::ClassMethods
169
+ end
170
+ end
171
+
172
+ # Settings for C++ client libraries.
173
+ # @!attribute [rw] common
174
+ # @return [::Google::Api::CommonLanguageSettings]
175
+ # Some settings.
176
+ class CppSettings
177
+ include ::Google::Protobuf::MessageExts
178
+ extend ::Google::Protobuf::MessageExts::ClassMethods
179
+ end
180
+
181
+ # Settings for Php client libraries.
182
+ # @!attribute [rw] common
183
+ # @return [::Google::Api::CommonLanguageSettings]
184
+ # Some settings.
185
+ class PhpSettings
186
+ include ::Google::Protobuf::MessageExts
187
+ extend ::Google::Protobuf::MessageExts::ClassMethods
188
+ end
189
+
190
+ # Settings for Python client libraries.
191
+ # @!attribute [rw] common
192
+ # @return [::Google::Api::CommonLanguageSettings]
193
+ # Some settings.
194
+ class PythonSettings
195
+ include ::Google::Protobuf::MessageExts
196
+ extend ::Google::Protobuf::MessageExts::ClassMethods
197
+ end
198
+
199
+ # Settings for Node client libraries.
200
+ # @!attribute [rw] common
201
+ # @return [::Google::Api::CommonLanguageSettings]
202
+ # Some settings.
203
+ class NodeSettings
204
+ include ::Google::Protobuf::MessageExts
205
+ extend ::Google::Protobuf::MessageExts::ClassMethods
206
+ end
207
+
208
+ # Settings for Dotnet client libraries.
209
+ # @!attribute [rw] common
210
+ # @return [::Google::Api::CommonLanguageSettings]
211
+ # Some settings.
212
+ class DotnetSettings
213
+ include ::Google::Protobuf::MessageExts
214
+ extend ::Google::Protobuf::MessageExts::ClassMethods
215
+ end
216
+
217
+ # Settings for Ruby client libraries.
218
+ # @!attribute [rw] common
219
+ # @return [::Google::Api::CommonLanguageSettings]
220
+ # Some settings.
221
+ class RubySettings
222
+ include ::Google::Protobuf::MessageExts
223
+ extend ::Google::Protobuf::MessageExts::ClassMethods
224
+ end
225
+
226
+ # Settings for Go client libraries.
227
+ # @!attribute [rw] common
228
+ # @return [::Google::Api::CommonLanguageSettings]
229
+ # Some settings.
230
+ class GoSettings
231
+ include ::Google::Protobuf::MessageExts
232
+ extend ::Google::Protobuf::MessageExts::ClassMethods
233
+ end
234
+
235
+ # Describes the generator configuration for a method.
236
+ # @!attribute [rw] selector
237
+ # @return [::String]
238
+ # The fully qualified name of the method, for which the options below apply.
239
+ # This is used to find the method to apply the options.
240
+ # @!attribute [rw] long_running
241
+ # @return [::Google::Api::MethodSettings::LongRunning]
242
+ # Describes settings to use for long-running operations when generating
243
+ # API methods for RPCs. Complements RPCs that use the annotations in
244
+ # google/longrunning/operations.proto.
245
+ #
246
+ # Example of a YAML configuration::
247
+ #
248
+ # publishing:
249
+ # method_settings:
250
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
251
+ # long_running:
252
+ # initial_poll_delay:
253
+ # seconds: 60 # 1 minute
254
+ # poll_delay_multiplier: 1.5
255
+ # max_poll_delay:
256
+ # seconds: 360 # 6 minutes
257
+ # total_poll_timeout:
258
+ # seconds: 54000 # 90 minutes
259
+ class MethodSettings
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+
263
+ # Describes settings to use when generating API methods that use the
264
+ # long-running operation pattern.
265
+ # All default values below are from those used in the client library
266
+ # generators (e.g.
267
+ # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
268
+ # @!attribute [rw] initial_poll_delay
269
+ # @return [::Google::Protobuf::Duration]
270
+ # Initial delay after which the first poll request will be made.
271
+ # Default value: 5 seconds.
272
+ # @!attribute [rw] poll_delay_multiplier
273
+ # @return [::Float]
274
+ # Multiplier to gradually increase delay between subsequent polls until it
275
+ # reaches max_poll_delay.
276
+ # Default value: 1.5.
277
+ # @!attribute [rw] max_poll_delay
278
+ # @return [::Google::Protobuf::Duration]
279
+ # Maximum time between two subsequent poll requests.
280
+ # Default value: 45 seconds.
281
+ # @!attribute [rw] total_poll_timeout
282
+ # @return [::Google::Protobuf::Duration]
283
+ # Total polling timeout.
284
+ # Default value: 5 minutes.
285
+ class LongRunning
286
+ include ::Google::Protobuf::MessageExts
287
+ extend ::Google::Protobuf::MessageExts::ClassMethods
288
+ end
289
+ end
290
+
291
+ # The organization for which the client libraries are being published.
292
+ # Affects the url where generated docs are published, etc.
293
+ module ClientLibraryOrganization
294
+ # Not useful.
295
+ CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
296
+
297
+ # Google Cloud Platform Org.
298
+ CLOUD = 1
299
+
300
+ # Ads (Advertising) Org.
301
+ ADS = 2
302
+
303
+ # Photos Org.
304
+ PHOTOS = 3
305
+
306
+ # Street View Org.
307
+ STREET_VIEW = 4
308
+ end
309
+
310
+ # To where should client libraries be published?
311
+ module ClientLibraryDestination
312
+ # Client libraries will neither be generated nor published to package
313
+ # managers.
314
+ CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
315
+
316
+ # Generate the client library in a repo under github.com/googleapis,
317
+ # but don't publish it to package managers.
318
+ GITHUB = 10
319
+
320
+ # Publish the library to package managers like nuget.org and npmjs.com.
321
+ PACKAGE_MANAGER = 20
322
+ end
323
+ end
324
+ end
@@ -0,0 +1,71 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Api
22
+ # The launch stage as defined by [Google Cloud Platform
23
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
24
+ module LaunchStage
25
+ # Do not use this default value.
26
+ LAUNCH_STAGE_UNSPECIFIED = 0
27
+
28
+ # The feature is not yet implemented. Users can not use it.
29
+ UNIMPLEMENTED = 6
30
+
31
+ # Prelaunch features are hidden from users and are only visible internally.
32
+ PRELAUNCH = 7
33
+
34
+ # Early Access features are limited to a closed group of testers. To use
35
+ # these features, you must sign up in advance and sign a Trusted Tester
36
+ # agreement (which includes confidentiality provisions). These features may
37
+ # be unstable, changed in backward-incompatible ways, and are not
38
+ # guaranteed to be released.
39
+ EARLY_ACCESS = 1
40
+
41
+ # Alpha is a limited availability test for releases before they are cleared
42
+ # for widespread use. By Alpha, all significant design issues are resolved
43
+ # and we are in the process of verifying functionality. Alpha customers
44
+ # need to apply for access, agree to applicable terms, and have their
45
+ # projects allowlisted. Alpha releases don't have to be feature complete,
46
+ # no SLAs are provided, and there are no technical support obligations, but
47
+ # they will be far enough along that customers can actually use them in
48
+ # test environments or for limited-use tests -- just like they would in
49
+ # normal production cases.
50
+ ALPHA = 2
51
+
52
+ # Beta is the point at which we are ready to open a release for any
53
+ # customer to use. There are no SLA or technical support obligations in a
54
+ # Beta release. Products will be complete from a feature perspective, but
55
+ # may have some open outstanding issues. Beta releases are suitable for
56
+ # limited production use cases.
57
+ BETA = 3
58
+
59
+ # GA features are open to all developers and are considered stable and
60
+ # fully qualified for production use.
61
+ GA = 4
62
+
63
+ # Deprecated features are scheduled to be shut down and removed. For more
64
+ # information, see the "Deprecation Policy" section of our [Terms of
65
+ # Service](https://cloud.google.com/terms/)
66
+ # and the [Google Cloud Platform Subject to the Deprecation
67
+ # Policy](https://cloud.google.com/terms/deprecation) documentation.
68
+ DEPRECATED = 5
69
+ end
70
+ end
71
+ end
@@ -28,12 +28,14 @@ module Google
28
28
  # [API Design Guide](https://cloud.google.com/apis/design/errors).
29
29
  # @!attribute [rw] code
30
30
  # @return [::Integer]
31
- # The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
31
+ # The status code, which should be an enum value of
32
+ # [google.rpc.Code][google.rpc.Code].
32
33
  # @!attribute [rw] message
33
34
  # @return [::String]
34
35
  # A developer-facing error message, which should be in English. Any
35
36
  # user-facing error message should be localized and sent in the
36
- # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
37
+ # {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
38
+ # by the client.
37
39
  # @!attribute [rw] details
38
40
  # @return [::Array<::Google::Protobuf::Any>]
39
41
  # A list of messages that carry the error details. There is a common set of
@@ -308,6 +308,13 @@ module Google
308
308
  # @!attribute [rw] request_options
309
309
  # @return [::Google::Cloud::Spanner::V1::RequestOptions]
310
310
  # Common options for this request.
311
+ # @!attribute [rw] data_boost_enabled
312
+ # @return [::Boolean]
313
+ # If this is for a partitioned query and this field is set to `true`, the
314
+ # request will be executed via Spanner independent compute resources.
315
+ #
316
+ # If the field is set to `true` but the request does not set
317
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
311
318
  class ExecuteSqlRequest
312
319
  include ::Google::Protobuf::MessageExts
313
320
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -718,6 +725,13 @@ module Google
718
725
  # @!attribute [rw] request_options
719
726
  # @return [::Google::Cloud::Spanner::V1::RequestOptions]
720
727
  # Common options for this request.
728
+ # @!attribute [rw] data_boost_enabled
729
+ # @return [::Boolean]
730
+ # If this is for a partitioned read and this field is set to `true`, the
731
+ # request will be executed via Spanner independent compute resources.
732
+ #
733
+ # If the field is set to `true` but the request does not set
734
+ # `partition_token`, the API will return an `INVALID_ARGUMENT` error.
721
735
  class ReadRequest
722
736
  include ::Google::Protobuf::MessageExts
723
737
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-spanner-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.0
4
+ version: 0.14.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-10-24 00:00:00.000000000 Z
11
+ date: 2023-03-21 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: '0.12'
19
+ version: 0.18.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: '0.12'
29
+ version: 0.18.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -50,14 +50,14 @@ dependencies:
50
50
  requirements:
51
51
  - - "~>"
52
52
  - !ruby/object:Gem::Version
53
- version: 1.26.1
53
+ version: 1.26.3
54
54
  type: :development
55
55
  prerelease: false
56
56
  version_requirements: !ruby/object:Gem::Requirement
57
57
  requirements:
58
58
  - - "~>"
59
59
  - !ruby/object:Gem::Version
60
- version: 1.26.1
60
+ version: 1.26.3
61
61
  - !ruby/object:Gem::Dependency
62
62
  name: minitest
63
63
  requirement: !ruby/object:Gem::Requirement
@@ -186,7 +186,9 @@ files:
186
186
  - lib/google/spanner/v1/transaction_pb.rb
187
187
  - lib/google/spanner/v1/type_pb.rb
188
188
  - proto_docs/README.md
189
+ - proto_docs/google/api/client.rb
189
190
  - proto_docs/google/api/field_behavior.rb
191
+ - proto_docs/google/api/launch_stage.rb
190
192
  - proto_docs/google/api/resource.rb
191
193
  - proto_docs/google/protobuf/any.rb
192
194
  - proto_docs/google/protobuf/duration.rb
@@ -221,8 +223,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
221
223
  - !ruby/object:Gem::Version
222
224
  version: '0'
223
225
  requirements: []
224
- rubygems_version: 3.3.14
226
+ rubygems_version: 3.4.2
225
227
  signing_key:
226
228
  specification_version: 4
227
- summary: API Client library for the Cloud Spanner V1 API
229
+ summary: Cloud Spanner is a managed, mission-critical, globally consistent and scalable
230
+ relational database service.
228
231
  test_files: []