google-cloud-spanner-v1 0.2.2 → 0.6.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/LICENSE.md +188 -190
- data/README.md +66 -2
- data/lib/google/cloud/spanner/v1.rb +3 -0
- data/lib/google/cloud/spanner/v1/spanner/client.rb +106 -70
- data/lib/google/cloud/spanner/v1/version.rb +1 -1
- data/lib/google/spanner/v1/spanner_pb.rb +26 -0
- data/lib/google/spanner/v1/spanner_services_pb.rb +21 -15
- data/proto_docs/google/api/field_behavior.rb +6 -0
- data/proto_docs/google/api/resource.rb +50 -14
- data/proto_docs/google/protobuf/any.rb +5 -2
- data/proto_docs/google/protobuf/timestamp.rb +10 -1
- data/proto_docs/google/spanner/v1/spanner.rb +148 -12
- data/proto_docs/google/spanner/v1/transaction.rb +12 -11
- data/proto_docs/google/spanner/v1/type.rb +1 -1
- metadata +11 -9
@@ -24,10 +24,11 @@ module Google
|
|
24
24
|
# # Transactions
|
25
25
|
#
|
26
26
|
#
|
27
|
-
# Each session can have at most one active transaction at a time
|
28
|
-
#
|
29
|
-
#
|
30
|
-
#
|
27
|
+
# Each session can have at most one active transaction at a time (note that
|
28
|
+
# standalone reads and queries use a transaction internally and do count
|
29
|
+
# towards the one transaction limit). After the active transaction is
|
30
|
+
# completed, the session can immediately be re-used for the next transaction.
|
31
|
+
# It is not necessary to create a new session for each transaction.
|
31
32
|
#
|
32
33
|
# # Transaction Modes
|
33
34
|
#
|
@@ -85,7 +86,7 @@ module Google
|
|
85
86
|
# {::Google::Cloud::Spanner::V1::Spanner::Client#rollback Rollback} request to abort the
|
86
87
|
# transaction.
|
87
88
|
#
|
88
|
-
#
|
89
|
+
# ## Semantics
|
89
90
|
#
|
90
91
|
# Cloud Spanner can commit the transaction if all read locks it acquired
|
91
92
|
# are still valid at commit time, and it is able to acquire write
|
@@ -98,7 +99,7 @@ module Google
|
|
98
99
|
# use Cloud Spanner locks for any sort of mutual exclusion other than
|
99
100
|
# between Cloud Spanner transactions themselves.
|
100
101
|
#
|
101
|
-
#
|
102
|
+
# ## Retrying Aborted Transactions
|
102
103
|
#
|
103
104
|
# When a transaction aborts, the application can choose to retry the
|
104
105
|
# whole transaction again. To maximize the chances of successfully
|
@@ -114,7 +115,7 @@ module Google
|
|
114
115
|
# instead, it is better to limit the total amount of wall time spent
|
115
116
|
# retrying.
|
116
117
|
#
|
117
|
-
#
|
118
|
+
# ## Idle Transactions
|
118
119
|
#
|
119
120
|
# A transaction is considered idle if it has no outstanding reads or
|
120
121
|
# SQL queries and has not started a read or SQL query within the last 10
|
@@ -164,7 +165,7 @@ module Google
|
|
164
165
|
#
|
165
166
|
# Each type of timestamp bound is discussed in detail below.
|
166
167
|
#
|
167
|
-
#
|
168
|
+
# ## Strong
|
168
169
|
#
|
169
170
|
# Strong reads are guaranteed to see the effects of all transactions
|
170
171
|
# that have committed before the start of the read. Furthermore, all
|
@@ -180,7 +181,7 @@ module Google
|
|
180
181
|
#
|
181
182
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions.ReadOnly.strong}.
|
182
183
|
#
|
183
|
-
#
|
184
|
+
# ## Exact Staleness
|
184
185
|
#
|
185
186
|
# These timestamp bounds execute reads at a user-specified
|
186
187
|
# timestamp. Reads at a timestamp are guaranteed to see a consistent
|
@@ -202,7 +203,7 @@ module Google
|
|
202
203
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions.ReadOnly.read_timestamp} and
|
203
204
|
# {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#exact_staleness TransactionOptions.ReadOnly.exact_staleness}.
|
204
205
|
#
|
205
|
-
#
|
206
|
+
# ## Bounded Staleness
|
206
207
|
#
|
207
208
|
# Bounded staleness modes allow Cloud Spanner to pick the read timestamp,
|
208
209
|
# subject to a user-provided staleness bound. Cloud Spanner chooses the
|
@@ -232,7 +233,7 @@ module Google
|
|
232
233
|
# See {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions.ReadOnly.max_staleness} and
|
233
234
|
# {::Google::Cloud::Spanner::V1::TransactionOptions::ReadOnly#min_read_timestamp TransactionOptions.ReadOnly.min_read_timestamp}.
|
234
235
|
#
|
235
|
-
#
|
236
|
+
# ## Old Read Timestamps and Garbage Collection
|
236
237
|
#
|
237
238
|
# Cloud Spanner continuously garbage collects deleted and overwritten data
|
238
239
|
# in the background to reclaim storage space. This process is known
|
@@ -59,7 +59,7 @@ module Google
|
|
59
59
|
# SQL queries, it is the column alias (e.g., `"Word"` in the
|
60
60
|
# query `"SELECT 'hello' AS Word"`), or the column name (e.g.,
|
61
61
|
# `"ColName"` in the query `"SELECT ColName FROM Table"`). Some
|
62
|
-
# columns might have an empty name (e.g.,
|
62
|
+
# columns might have an empty name (e.g., `"SELECT
|
63
63
|
# UPPER(ColName)"`). Note that a query result can contain
|
64
64
|
# multiple fields with the same name.
|
65
65
|
# @!attribute [rw] type
|
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.
|
4
|
+
version: 0.6.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2021-04-05 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|
@@ -16,14 +16,14 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - "~>"
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '0.
|
19
|
+
version: '0.4'
|
20
20
|
type: :runtime
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - "~>"
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version: '0.
|
26
|
+
version: '0.4'
|
27
27
|
- !ruby/object:Gem::Dependency
|
28
28
|
name: google-cloud-errors
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|
@@ -44,14 +44,14 @@ dependencies:
|
|
44
44
|
requirements:
|
45
45
|
- - "~>"
|
46
46
|
- !ruby/object:Gem::Version
|
47
|
-
version: 1.
|
47
|
+
version: 1.25.1
|
48
48
|
type: :development
|
49
49
|
prerelease: false
|
50
50
|
version_requirements: !ruby/object:Gem::Requirement
|
51
51
|
requirements:
|
52
52
|
- - "~>"
|
53
53
|
- !ruby/object:Gem::Version
|
54
|
-
version: 1.
|
54
|
+
version: 1.25.1
|
55
55
|
- !ruby/object:Gem::Dependency
|
56
56
|
name: minitest
|
57
57
|
requirement: !ruby/object:Gem::Requirement
|
@@ -151,7 +151,9 @@ dependencies:
|
|
151
151
|
- !ruby/object:Gem::Version
|
152
152
|
version: '0.9'
|
153
153
|
description: Cloud Spanner is a managed, mission-critical, globally consistent and
|
154
|
-
scalable relational database service.
|
154
|
+
scalable relational database service. Note that google-cloud-spanner-v1 is a version-specific
|
155
|
+
client library. For most uses, we recommend installing the main client library google-cloud-spanner
|
156
|
+
instead. See the readme for more details.
|
155
157
|
email: googleapis-packages@google.com
|
156
158
|
executables: []
|
157
159
|
extensions: []
|
@@ -204,14 +206,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
204
206
|
requirements:
|
205
207
|
- - ">="
|
206
208
|
- !ruby/object:Gem::Version
|
207
|
-
version: '2.
|
209
|
+
version: '2.5'
|
208
210
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
209
211
|
requirements:
|
210
212
|
- - ">="
|
211
213
|
- !ruby/object:Gem::Version
|
212
214
|
version: '0'
|
213
215
|
requirements: []
|
214
|
-
rubygems_version: 3.
|
216
|
+
rubygems_version: 3.2.13
|
215
217
|
signing_key:
|
216
218
|
specification_version: 4
|
217
219
|
summary: API Client library for the Cloud Spanner V1 API
|