google-cloud-spanner-v1 0.13.0 → 0.14.1

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: 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: []