google-cloud-spanner 1.9.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5c589e7b5b2fab89d1674e002e9db6f7ce100aa97b0f7490955757437040618
-  data.tar.gz: d3cf3ff3735eec3ecef646c8f31af7a09bc373a083e1ffa4bff82aa4ec4f2083
+  metadata.gz: 01e57b593ae2ee535ca3c1a3a6432fac3cb89a20a7281b65b4ac27c1218af892
+  data.tar.gz: c662c62580697337783a77d9af59e25465e14f083fb13ce50ff3fefb66cc9df3
 SHA512:
-  metadata.gz: fcb394cbded603e3fb52dbc2e606d66478111432f1b23271c12cbe445436af800762f5e79eeb2fe3a728a64d56260b0473d1811fdaca4c99c330c52839636a92
-  data.tar.gz: 3700d8c37a6062e37b90213c3961958e58141b9cf2026a3a53b1f73d59681ac4416058a8fc02362602a1b75c3a6e0f687d664e33601fff004596a0fdce0bcf9e
+  metadata.gz: cf84f31f5fd21b4a458fda2b236d1204be4c6113d9ec7617a77e2a8a7db9c5eef66f90d985a1ecbc43eeb4f9846967d95f500eeb61d2851fa8e3b010f71e6760
+  data.tar.gz: 0516eb395fc8602ab97eafbf935e4dd51d3583fdac8c0ba9ed35eb7dbb15d5c1b2f41ddab90ddeac7a9a55c4dc630b8fa2874dfc71a60d55922268c65e9f9a21

data/AUTHENTICATION.md

@@ -2,20 +2,39 @@
 
 In general, the google-cloud-spanner library uses [Service
 Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
-credentials to connect to Google Cloud services. When running on Compute Engine
+credentials to connect to Google Cloud services. When running within [Google
+Cloud Platform environments](#google-cloud-platform-environments)
 the credentials will be discovered automatically. When running on other
 environments, the Service Account credentials can be specified by providing the
 path to the [JSON
 keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for
-the account (or the JSON itself) in environment variables. Additionally, Cloud
-SDK credentials can also be discovered automatically, but this is only
-recommended during development.
+the account (or the JSON itself) in [environment
+variables](#environment-variables). Additionally, Cloud SDK credentials can also
+be discovered automatically, but this is only recommended during development.
+
+## Quickstart
+
+1. [Create a service account and credentials](#creating-a-service-account).
+2. Set the [environment variable](#environment-variables).
+
+```sh
+export SPANNER_CREDENTIALS=/path/to/json`
+```
+
+3. Initialize the client.
+
+```ruby
+require "google/cloud/spanner"
+
+client = Google::Cloud::Spanner.new
+```
 
 ## Project and Credential Lookup
 
-The google-cloud-spanner library aims to make authentication as simple as
-possible, and provides several mechanisms to configure your system without
-providing **Project ID** and **Service Account Credentials** directly in code.
+The google-cloud-spanner library aims to make authentication
+as simple as possible, and provides several mechanisms to configure your system
+without providing **Project ID** and **Service Account Credentials** directly in
+code.
 
 **Project ID** is discovered in the following order:
 
@@ -23,6 +42,7 @@ providing **Project ID** and **Service Account Credentials** directly in code.
 2. Specify project ID in configuration
 3. Discover project ID in environment variables
 4. Discover GCE project ID
+5. Discover project ID in credentials JSON
 
 **Credentials** are discovered in the following order:
 
@@ -73,12 +93,12 @@ environment variable, or the **Credentials JSON** itself can be stored for
 environments such as Docker containers where writing files is difficult or not
 encouraged.
 
-The environment variables that Spanner checks for project ID are:
+The environment variables that google-cloud-spanner checks for project ID are:
 
 1. `SPANNER_PROJECT`
 2. `GOOGLE_CLOUD_PROJECT`
 
-The environment variables that Spanner checks for credentials are configured on {Google::Cloud::Spanner::V1::Credentials}:
+The environment variables that google-cloud-spanner checks for credentials are configured on {Google::Cloud::Spanner::V1::Credentials}:
 
 1. `SPANNER_CREDENTIALS` - Path to JSON file, or JSON contents
 2. `SPANNER_KEYFILE` - Path to JSON file, or JSON contents
@@ -92,7 +112,7 @@ require "google/cloud/spanner"
 ENV["SPANNER_PROJECT"]     = "my-project-id"
 ENV["SPANNER_CREDENTIALS"] = "path/to/keyfile.json"
 
-spanner = Google::Cloud::Spanner.new
+client = Google::Cloud::Spanner.new
 ```
 
 ### Configuration
@@ -107,7 +127,7 @@ Google::Cloud::Spanner.configure do |config|
   config.credentials = "path/to/keyfile.json"
 end
 
-spanner = Google::Cloud::Spanner.new
+client = Google::Cloud::Spanner.new
 ```
 
 ### Cloud SDK
@@ -140,7 +160,8 @@ Google Cloud requires a **Project ID** and **Service Account Credentials** to
 connect to the APIs. You will use the **Project ID** and **JSON key file** to
 connect to most services with google-cloud-spanner.
 
-If you are not running this client on Google Compute Engine, you need a Google
+If you are not running this client within [Google Cloud Platform
+environments](#google-cloud-platform-environments), you need a Google
 Developers service account.
 
 1. Visit the [Google Developers Console][dev-console].

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release History
 
+### 1.9.1 / 2019-04-30
+
+* Fix Spanner session limit bug.
+* Update AUTHENTICATION.md guide.
+* Update documentation for common types.
+* Update generated documentation.
+* Extract gRPC header values from request.
+
 ### 1.9.0 / 2019-03-08
 
 * Spanner Batch DML.

data/lib/google/cloud/spanner/admin/database/v1/database_admin_client.rb

@@ -81,28 +81,17 @@ module Google
                 self::GRPC_INTERCEPTORS = DatabaseAdminClient::GRPC_INTERCEPTORS
               end
 
-              INSTANCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-                "projects/{project}/instances/{instance}"
-              )
-
-              private_constant :INSTANCE_PATH_TEMPLATE
-
               DATABASE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
                 "projects/{project}/instances/{instance}/databases/{database}"
               )
 
               private_constant :DATABASE_PATH_TEMPLATE
 
-              # Returns a fully-qualified instance resource name string.
-              # @param project [String]
-              # @param instance [String]
-              # @return [String]
-              def self.instance_path project, instance
-                INSTANCE_PATH_TEMPLATE.render(
-                  :"project" => project,
-                  :"instance" => instance
-                )
-              end
+              INSTANCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+                "projects/{project}/instances/{instance}"
+              )
+
+              private_constant :INSTANCE_PATH_TEMPLATE
 
               # Returns a fully-qualified database resource name string.
               # @param project [String]
@@ -117,6 +106,17 @@ module Google
                 )
               end
 
+              # Returns a fully-qualified instance resource name string.
+              # @param project [String]
+              # @param instance [String]
+              # @return [String]
+              def self.instance_path project, instance
+                INSTANCE_PATH_TEMPLATE.render(
+                  :"project" => project,
+                  :"instance" => instance
+                )
+              end
+
               # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
               #   Provides the means for authenticating requests made by the client. This parameter can
               #   be many types.
@@ -232,47 +232,74 @@ module Google
                 @list_databases = Google::Gax.create_api_call(
                   @database_admin_stub.method(:list_databases),
                   defaults["list_databases"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
                 )
                 @create_database = Google::Gax.create_api_call(
                   @database_admin_stub.method(:create_database),
                   defaults["create_database"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
                 )
                 @get_database = Google::Gax.create_api_call(
                   @database_admin_stub.method(:get_database),
                   defaults["get_database"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
                 )
                 @update_database_ddl = Google::Gax.create_api_call(
                   @database_admin_stub.method(:update_database_ddl),
                   defaults["update_database_ddl"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'database' => request.database}
+                  end
                 )
                 @drop_database = Google::Gax.create_api_call(
                   @database_admin_stub.method(:drop_database),
                   defaults["drop_database"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'database' => request.database}
+                  end
                 )
                 @get_database_ddl = Google::Gax.create_api_call(
                   @database_admin_stub.method(:get_database_ddl),
                   defaults["get_database_ddl"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'database' => request.database}
+                  end
                 )
                 @set_iam_policy = Google::Gax.create_api_call(
                   @database_admin_stub.method(:set_iam_policy),
                   defaults["set_iam_policy"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
                 @get_iam_policy = Google::Gax.create_api_call(
                   @database_admin_stub.method(:get_iam_policy),
                   defaults["get_iam_policy"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
                 @test_iam_permissions = Google::Gax.create_api_call(
                   @database_admin_stub.method(:test_iam_permissions),
                   defaults["test_iam_permissions"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
               end
 

data/lib/google/cloud/spanner/admin/database/v1/doc/google/longrunning/operations.rb

@@ -31,7 +31,7 @@ module Google
     # @!attribute [rw] done
     #   @return [true, false]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]

data/lib/google/cloud/spanner/admin/database/v1/doc/google/protobuf/any.rb

@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/spanner/admin/instance/v1/doc/google/longrunning/operations.rb

@@ -31,7 +31,7 @@ module Google
     # @!attribute [rw] done
     #   @return [true, false]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [Google::Rpc::Status]

data/lib/google/cloud/spanner/admin/instance/v1/doc/google/protobuf/any.rb

@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/spanner/admin/instance/v1/doc/google/protobuf/field_mask.rb

@@ -83,57 +83,49 @@ module Google
     # describe the updated values, the API ignores the values of all
     # fields not covered by the mask.
     #
-    # If a repeated field is specified for an update operation, the existing
-    # repeated values in the target resource will be overwritten by the new values.
-    # Note that a repeated field is only allowed in the last position of a `paths`
-    # string.
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
     #
     # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then the existing sub-message in the target resource is
-    # overwritten. Given the target message:
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
     #
     #     f {
     #       b {
-    #         d : 1
-    #         x : 2
+    #         d: 1
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1]
     #     }
     #
     # And an update message:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
     #       }
+    #       c: [2]
     #     }
     #
     # then if the field mask is:
     #
-    #  paths: "f.b"
+    #  paths: ["f.b", "f.c"]
     #
     # then the result will be:
     #
     #     f {
     #       b {
-    #         d : 10
+    #         d: 10
+    #         x: 2
     #       }
-    #       c : 1
+    #       c: [1, 2]
     #     }
     #
-    # However, if the update mask was:
-    #
-    #  paths: "f.b.d"
-    #
-    # then the result would be:
-    #
-    #     f {
-    #       b {
-    #         d : 10
-    #         x : 2
-    #       }
-    #       c : 1
-    #     }
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
     #
     # In order to reset a field's value to the default, the field must
     # be in the mask and set to the default value in the provided resource.

data/lib/google/cloud/spanner/admin/instance/v1/instance_admin_client.rb

@@ -101,11 +101,11 @@ module Google
                 self::GRPC_INTERCEPTORS = InstanceAdminClient::GRPC_INTERCEPTORS
               end
 
-              PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-                "projects/{project}"
+              INSTANCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+                "projects/{project}/instances/{instance}"
               )
 
-              private_constant :PROJECT_PATH_TEMPLATE
+              private_constant :INSTANCE_PATH_TEMPLATE
 
               INSTANCE_CONFIG_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
                 "projects/{project}/instanceConfigs/{instance_config}"
@@ -113,18 +113,20 @@ module Google
 
               private_constant :INSTANCE_CONFIG_PATH_TEMPLATE
 
-              INSTANCE_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
-                "projects/{project}/instances/{instance}"
+              PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+                "projects/{project}"
               )
 
-              private_constant :INSTANCE_PATH_TEMPLATE
+              private_constant :PROJECT_PATH_TEMPLATE
 
-              # Returns a fully-qualified project resource name string.
+              # Returns a fully-qualified instance resource name string.
               # @param project [String]
+              # @param instance [String]
               # @return [String]
-              def self.project_path project
-                PROJECT_PATH_TEMPLATE.render(
-                  :"project" => project
+              def self.instance_path project, instance
+                INSTANCE_PATH_TEMPLATE.render(
+                  :"project" => project,
+                  :"instance" => instance
                 )
               end
 
@@ -139,14 +141,12 @@ module Google
                 )
               end
 
-              # Returns a fully-qualified instance resource name string.
+              # Returns a fully-qualified project resource name string.
               # @param project [String]
-              # @param instance [String]
               # @return [String]
-              def self.instance_path project, instance
-                INSTANCE_PATH_TEMPLATE.render(
-                  :"project" => project,
-                  :"instance" => instance
+              def self.project_path project
+                PROJECT_PATH_TEMPLATE.render(
+                  :"project" => project
                 )
               end
 
@@ -265,52 +265,82 @@ module Google
                 @list_instance_configs = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:list_instance_configs),
                   defaults["list_instance_configs"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
                 )
                 @get_instance_config = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:get_instance_config),
                   defaults["get_instance_config"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
                 )
                 @list_instances = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:list_instances),
                   defaults["list_instances"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
                 )
                 @get_instance = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:get_instance),
                   defaults["get_instance"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
                 )
                 @create_instance = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:create_instance),
                   defaults["create_instance"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'parent' => request.parent}
+                  end
                 )
                 @update_instance = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:update_instance),
                   defaults["update_instance"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'instance.name' => request.instance.name}
+                  end
                 )
                 @delete_instance = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:delete_instance),
                   defaults["delete_instance"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'name' => request.name}
+                  end
                 )
                 @set_iam_policy = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:set_iam_policy),
                   defaults["set_iam_policy"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
                 @get_iam_policy = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:get_iam_policy),
                   defaults["get_iam_policy"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
                 @test_iam_permissions = Google::Gax.create_api_call(
                   @instance_admin_stub.method(:test_iam_permissions),
                   defaults["test_iam_permissions"],
-                  exception_transformer: exception_transformer
+                  exception_transformer: exception_transformer,
+                  params_extractor: proc do |request|
+                    {'resource' => request.resource}
+                  end
                 )
               end
 

data/lib/google/cloud/spanner/pool.rb

@@ -71,7 +71,6 @@ module Google
               return write_transaction.session if write_transaction
 
               if can_allocate_more_sessions?
-                @new_sessions_in_process += 1
                 action = :new
                 break
               end
@@ -127,7 +126,6 @@ module Google
               end
 
               if can_allocate_more_sessions?
-                @new_sessions_in_process += 1
                 action = :new
                 break
               end
@@ -204,7 +202,7 @@ module Google
           # init the thread pool
           @thread_pool = Concurrent::FixedThreadPool.new @threads
           # init the queues
-          @new_sessions_in_process = @min.to_i
+          @new_sessions_in_process = 0
           @all_sessions = []
           @session_queue = []
           @transaction_queue = []
@@ -241,15 +239,24 @@ module Google
         end
 
         def new_session!
-          session = @client.create_new_session
-
           @mutex.synchronize do
-            # don't add if the pool is closed
-            return session.release! if @closed
+            @new_sessions_in_process += 1
+          end
+
+          begin
+            session = @client.create_new_session
+          rescue StandardError => e
+            @mutex.synchronize do
+              @new_sessions_in_process -= 1
+            end
+            raise e
+          end
 
+          @mutex.synchronize do
             @new_sessions_in_process -= 1
             all_sessions << session
           end
+
           session
         end
 

data/lib/google/cloud/spanner/v1/doc/google/protobuf/any.rb

@@ -97,7 +97,8 @@ module Google
     # @!attribute [rw] type_url
     #   @return [String]
     #     A URL/resource name that uniquely identifies the type of the serialized
-    #     protocol buffer message. The last segment of the URL's path must represent
+    #     protocol buffer message. This string must contain at least
+    #     one "/" character. The last segment of the URL's path must represent
     #     the fully qualified name of the type (as in
     #     `path/google.protobuf.Duration`). The name should be in a canonical form
     #     (e.g., leading "." is not accepted).

data/lib/google/cloud/spanner/v1/doc/google/protobuf/timestamp.rb

@@ -15,17 +15,19 @@
 
 module Google
   module Protobuf
-    # A Timestamp represents a point in time independent of any time zone
-    # or calendar, represented as seconds and fractions of seconds at
-    # nanosecond resolution in UTC Epoch time. It is encoded using the
-    # Proleptic Gregorian Calendar which extends the Gregorian calendar
-    # backwards to year one. It is encoded assuming all minutes are 60
-    # seconds long, i.e. leap seconds are "smeared" so that no leap second
-    # table is needed for interpretation. Range is from
-    # 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
-    # By restricting to that range, we ensure that we can convert to
-    # and from  RFC 3339 date strings.
-    # See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
     #
     # = Examples
     #
@@ -86,12 +88,12 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
     # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
     # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
+    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [Integer]

data/lib/google/cloud/spanner/v1/spanner_client.rb

@@ -217,72 +217,114 @@ module Google
             @create_session = Google::Gax.create_api_call(
               @spanner_stub.method(:create_session),
               defaults["create_session"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'database' => request.database}
+              end
             )
             @get_session = Google::Gax.create_api_call(
               @spanner_stub.method(:get_session),
               defaults["get_session"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @list_sessions = Google::Gax.create_api_call(
               @spanner_stub.method(:list_sessions),
               defaults["list_sessions"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'database' => request.database}
+              end
             )
             @delete_session = Google::Gax.create_api_call(
               @spanner_stub.method(:delete_session),
               defaults["delete_session"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
             )
             @execute_sql = Google::Gax.create_api_call(
               @spanner_stub.method(:execute_sql),
               defaults["execute_sql"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @execute_streaming_sql = Google::Gax.create_api_call(
               @spanner_stub.method(:execute_streaming_sql),
               defaults["execute_streaming_sql"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @execute_batch_dml = Google::Gax.create_api_call(
               @spanner_stub.method(:execute_batch_dml),
               defaults["execute_batch_dml"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @read = Google::Gax.create_api_call(
               @spanner_stub.method(:read),
               defaults["read"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @streaming_read = Google::Gax.create_api_call(
               @spanner_stub.method(:streaming_read),
               defaults["streaming_read"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @begin_transaction = Google::Gax.create_api_call(
               @spanner_stub.method(:begin_transaction),
               defaults["begin_transaction"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @commit = Google::Gax.create_api_call(
               @spanner_stub.method(:commit),
               defaults["commit"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @rollback = Google::Gax.create_api_call(
               @spanner_stub.method(:rollback),
               defaults["rollback"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @partition_query = Google::Gax.create_api_call(
               @spanner_stub.method(:partition_query),
               defaults["partition_query"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
             @partition_read = Google::Gax.create_api_call(
               @spanner_stub.method(:partition_read),
               defaults["partition_read"],
-              exception_transformer: exception_transformer
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'session' => request.session}
+              end
             )
           end
 

data/lib/google/cloud/spanner/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Spanner
-      VERSION = "1.9.0".freeze
+      VERSION = "1.9.1".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-spanner
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.1
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-08 00:00:00.000000000 Z
+date: 2019-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -333,8 +333,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Spanner API