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
         |