From 23916c511a54be7e7304affc55680d86f150a6d3 Mon Sep 17 00:00:00 2001
From: Yoshi Automation Bot <yoshi-automation@google.com>
Date: Thu, 12 Mar 2020 00:35:31 -0700
Subject: [PATCH] [CHANGE ME] Re-generated  to pick up changes in the API or
 client library generator. (#27)

Co-authored-by: larkee <31196561+larkee@users.noreply.github.com>
---
 .../proto/spanner_database_admin.proto        |  85 ++---
 .../proto/spanner_database_admin_pb2_grpc.py  |   7 +-
 .../gapic/instance_admin_client.py            |  19 +-
 .../proto/spanner_instance_admin.proto        |  26 +-
 .../proto/spanner_instance_admin_pb2.py       |  37 +-
 .../cloud/spanner_v1/gapic/spanner_client.py  |  20 +-
 .../transports/spanner_grpc_transport.py      |   2 +-
 google/cloud/spanner_v1/proto/keys.proto      |   3 +-
 google/cloud/spanner_v1/proto/mutation.proto  |  12 +-
 google/cloud/spanner_v1/proto/mutation_pb2.py |  14 +-
 .../cloud/spanner_v1/proto/query_plan.proto   |   3 +-
 .../cloud/spanner_v1/proto/result_set.proto   |   3 +-
 google/cloud/spanner_v1/proto/spanner.proto   | 317 +++++++++---------
 google/cloud/spanner_v1/proto/spanner_pb2.py  | 170 +++++++---
 .../spanner_v1/proto/spanner_pb2_grpc.py      |  68 ++--
 .../cloud/spanner_v1/proto/transaction.proto  |   3 +-
 google/cloud/spanner_v1/proto/type.proto      |   3 +-
 synth.metadata                                |  16 +-
 18 files changed, 434 insertions(+), 374 deletions(-)

diff --git a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto
index ea5200b4cb..5ee127d1ef 100644
--- a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto
+++ b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -33,10 +32,6 @@ option java_multiple_files = true;
 option java_outer_classname = "SpannerDatabaseAdminProto";
 option java_package = "com.google.spanner.admin.database.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
-
-// The Instance resource is defined in `google.spanner.admin.instance.v1`.
-// Because this is a separate, independent API (technically), we redefine
-// the resource name pattern here.
 option (google.api.resource_definition) = {
   type: "spanner.googleapis.com/Instance"
   pattern: "projects/{project}/instances/{instance}"
@@ -66,11 +61,10 @@ service DatabaseAdmin {
   // have a name of the format `<database_name>/operations/<operation_id>` and
   // can be used to track preparation of the database. The
   // [metadata][google.longrunning.Operation.metadata] field type is
-  // [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-  // The [response][google.longrunning.Operation.response] field type is
+  // [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+  // [response][google.longrunning.Operation.response] field type is
   // [Database][google.spanner.admin.database.v1.Database], if successful.
-  rpc CreateDatabase(CreateDatabaseRequest)
-      returns (google.longrunning.Operation) {
+  rpc CreateDatabase(CreateDatabaseRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/instances/*}/databases"
       body: "*"
@@ -96,10 +90,8 @@ service DatabaseAdmin {
   // the format `<database_name>/operations/<operation_id>` and can be used to
   // track execution of the schema change(s). The
   // [metadata][google.longrunning.Operation.metadata] field type is
-  // [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-  // The operation has no response.
-  rpc UpdateDatabaseDdl(UpdateDatabaseDdlRequest)
-      returns (google.longrunning.Operation) {
+  // [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
+  rpc UpdateDatabaseDdl(UpdateDatabaseDdlRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
       body: "*"
@@ -134,8 +126,7 @@ service DatabaseAdmin {
   //
   // Authorization requires `spanner.databases.setIamPolicy`
   // permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy"
       body: "*"
@@ -153,8 +144,7 @@ service DatabaseAdmin {
   //
   // Authorization requires `spanner.databases.getIamPolicy` permission on
   // [resource][google.iam.v1.GetIamPolicyRequest.resource].
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy"
       body: "*"
@@ -172,8 +162,7 @@ service DatabaseAdmin {
   // result in a NOT_FOUND error if the user has
   // `spanner.databases.list` permission on the containing Cloud
   // Spanner instance. Otherwise returns an empty set of permissions.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions"
       body: "*"
@@ -217,8 +206,7 @@ message Database {
   State state = 2;
 }
 
-// The request for
-// [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+// The request for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
 message ListDatabasesRequest {
   // Required. The instance whose databases should be listed.
   // Values are of the form `projects/<project>/instances/<instance>`.
@@ -234,26 +222,23 @@ message ListDatabasesRequest {
   int32 page_size = 3;
 
   // If non-empty, `page_token` should contain a
-  // [next_page_token][google.spanner.admin.database.v1.ListDatabasesResponse.next_page_token]
-  // from a previous
-  // [ListDatabasesResponse][google.spanner.admin.database.v1.ListDatabasesResponse].
+  // [next_page_token][google.spanner.admin.database.v1.ListDatabasesResponse.next_page_token] from a
+  // previous [ListDatabasesResponse][google.spanner.admin.database.v1.ListDatabasesResponse].
   string page_token = 4;
 }
 
-// The response for
-// [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+// The response for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
 message ListDatabasesResponse {
   // Databases that matched the request.
   repeated Database databases = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases]
-  // call to fetch more of the matching databases.
+  // [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases] call to fetch more
+  // of the matching databases.
   string next_page_token = 2;
 }
 
-// The request for
-// [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+// The request for [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
 message CreateDatabaseRequest {
   // Required. The name of the instance that will serve the new database.
   // Values are of the form `projects/<project>/instances/<instance>`.
@@ -283,12 +268,11 @@ message CreateDatabaseRequest {
 message CreateDatabaseMetadata {
   // The database being created.
   string database = 1 [(google.api.resource_reference) = {
-    type: "spanner.googleapis.com/Database"
-  }];
+                         type: "spanner.googleapis.com/Database"
+                       }];
 }
 
-// The request for
-// [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
+// The request for [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
 message GetDatabaseRequest {
   // Required. The name of the requested database. Values are of the form
   // `projects/<project>/instances/<instance>/databases/<database>`.
@@ -314,8 +298,8 @@ message GetDatabaseRequest {
 // Each batch of statements is assigned a name which can be used with
 // the [Operations][google.longrunning.Operations] API to monitor
 // progress. See the
-// [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id]
-// field for more details.
+// [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id] field for more
+// details.
 message UpdateDatabaseDdlRequest {
   // Required. The database to update.
   string database = 1 [
@@ -335,20 +319,18 @@ message UpdateDatabaseDdlRequest {
   //
   // Specifying an explicit operation ID simplifies determining
   // whether the statements were executed in the event that the
-  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]
-  // call is replayed, or the return value is otherwise lost: the
-  // [database][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.database]
-  // and `operation_id` fields can be combined to form the
+  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] call is replayed,
+  // or the return value is otherwise lost: the [database][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.database] and
+  // `operation_id` fields can be combined to form the
   // [name][google.longrunning.Operation.name] of the resulting
-  // [longrunning.Operation][google.longrunning.Operation]:
-  // `<database>/operations/<operation_id>`.
+  // [longrunning.Operation][google.longrunning.Operation]: `<database>/operations/<operation_id>`.
   //
   // `operation_id` should be unique within the database, and must be
   // a valid identifier: `[a-z][a-z0-9_]*`. Note that
   // automatically-generated operation IDs always begin with an
   // underscore. If the named operation already exists,
-  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]
-  // returns `ALREADY_EXISTS`.
+  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns
+  // `ALREADY_EXISTS`.
   string operation_id = 3;
 }
 
@@ -357,8 +339,8 @@ message UpdateDatabaseDdlRequest {
 message UpdateDatabaseDdlMetadata {
   // The database being modified.
   string database = 1 [(google.api.resource_reference) = {
-    type: "spanner.googleapis.com/Database"
-  }];
+                         type: "spanner.googleapis.com/Database"
+                       }];
 
   // For an update this list contains all the statements. For an
   // individual statement, this list contains only that statement.
@@ -370,8 +352,7 @@ message UpdateDatabaseDdlMetadata {
   repeated google.protobuf.Timestamp commit_timestamps = 3;
 }
 
-// The request for
-// [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
+// The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
 message DropDatabaseRequest {
   // Required. The database to be dropped.
   string database = 1 [
@@ -382,8 +363,7 @@ message DropDatabaseRequest {
   ];
 }
 
-// The request for
-// [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+// The request for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
 message GetDatabaseDdlRequest {
   // Required. The database whose schema we wish to get.
   string database = 1 [
@@ -394,8 +374,7 @@ message GetDatabaseDdlRequest {
   ];
 }
 
-// The response for
-// [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+// The response for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
 message GetDatabaseDdlResponse {
   // A list of formatted DDL statements defining the schema of the database
   // specified in the request.
diff --git a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py
index 7ea7ddb6fa..2491691e6b 100644
--- a/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py
+++ b/google/cloud/spanner_admin_database_v1/proto/spanner_database_admin_pb2_grpc.py
@@ -94,8 +94,8 @@ def CreateDatabase(self, request, context):
     have a name of the format `<database_name>/operations/<operation_id>` and
     can be used to track preparation of the database. The
     [metadata][google.longrunning.Operation.metadata] field type is
-    [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-    The [response][google.longrunning.Operation.response] field type is
+    [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+    [response][google.longrunning.Operation.response] field type is
     [Database][google.spanner.admin.database.v1.Database], if successful.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
@@ -116,8 +116,7 @@ def UpdateDatabaseDdl(self, request, context):
     the format `<database_name>/operations/<operation_id>` and can be used to
     track execution of the schema change(s). The
     [metadata][google.longrunning.Operation.metadata] field type is
-    [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-    The operation has no response.
+    [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
diff --git a/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py b/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py
index c7c4912f2a..130a069bf5 100644
--- a/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py
+++ b/google/cloud/spanner_admin_instance_v1/gapic/instance_admin_client.py
@@ -562,8 +562,8 @@ def get_instance(
         Args:
             name (str): Required. The name of the requested instance. Values are of the form
                 ``projects/<project>/instances/<instance>``.
-            field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): If field\_mask is present, specifies the subset of [][google.spanner.admin.instance.v1.Instance] fields
-                that should be returned. If absent, all [][google.spanner.admin.instance.v1.Instance] fields are
+            field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): If field\_mask is present, specifies the subset of ``Instance`` fields
+                that should be returned. If absent, all ``Instance`` fields are
                 returned.
 
                 If a dict is provided, it must be of the same form as the protobuf
@@ -821,18 +821,15 @@ def update_instance(
 
         Args:
             instance (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.Instance]): Required. The instance to update, which must always include the instance
-                name. Otherwise, only fields mentioned in
-                [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field\_mask]
-                need be included.
+                name. Otherwise, only fields mentioned in ``field_mask`` need be
+                included.
 
                 If a dict is provided, it must be of the same form as the protobuf
                 message :class:`~google.cloud.spanner_admin_instance_v1.types.Instance`
-            field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): Required. A mask specifying which fields in
-                [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance]
-                should be updated. The field mask must always be specified; this
-                prevents any future fields in
-                [][google.spanner.admin.instance.v1.Instance] from being erased
-                accidentally by clients that do not know about them.
+            field_mask (Union[dict, ~google.cloud.spanner_admin_instance_v1.types.FieldMask]): Required. A mask specifying which fields in ``Instance`` should be
+                updated. The field mask must always be specified; this prevents any
+                future fields in ``Instance`` from being erased accidentally by clients
+                that do not know about them.
 
                 If a dict is provided, it must be of the same form as the protobuf
                 message :class:`~google.cloud.spanner_admin_instance_v1.types.FieldMask`
diff --git a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto
index a437874133..6a068baca2 100644
--- a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto
+++ b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -353,8 +352,8 @@ message Instance {
   // also [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] and
   // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
   string config = 2 [(google.api.resource_reference) = {
-    type: "spanner.googleapis.com/InstanceConfig"
-  }];
+                       type: "spanner.googleapis.com/InstanceConfig"
+                     }];
 
   // Required. The descriptive name for this instance as it appears in UIs.
   // Must be unique per project and between 4 and 30 characters in length.
@@ -398,14 +397,7 @@ message Instance {
   // allow "_" in a future release.
   map<string, string> labels = 7;
 
-  // Output only. The endpoint URIs based on the instance config.
-  // For example, instances located in a specific cloud region (or multi region)
-  // such as nam3, would have a nam3 specific endpoint URI.
-  // This URI is to be used implictly by SDK clients, with fallback to default
-  // URI. These endpoints are intended to optimize the network routing between
-  // the client and the instance's serving resources.
-  // If multiple endpoints are present, client may establish connections using
-  // any of the given URIs.
+  // Deprecated. This field is not populated.
   repeated string endpoint_uris = 8;
 }
 
@@ -466,9 +458,9 @@ message GetInstanceRequest {
     }
   ];
 
-  // If field_mask is present, specifies the subset of [][Instance] fields that
+  // If field_mask is present, specifies the subset of [Instance][google.spanner.admin.instance.v1.Instance] fields that
   // should be returned.
-  // If absent, all [][Instance] fields are returned.
+  // If absent, all [Instance][google.spanner.admin.instance.v1.Instance] fields are returned.
   google.protobuf.FieldMask field_mask = 2;
 }
 
@@ -549,12 +541,12 @@ message ListInstancesResponse {
 // The request for [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
 message UpdateInstanceRequest {
   // Required. The instance to update, which must always include the instance
-  // name.  Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
+  // name.  Otherwise, only fields mentioned in [field_mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
   Instance instance = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.
+  // Required. A mask specifying which fields in [Instance][google.spanner.admin.instance.v1.Instance] should be updated.
   // The field mask must always be specified; this prevents any future fields in
-  // [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
+  // [Instance][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
   // about them.
   google.protobuf.FieldMask field_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py
index 356c47f1a0..d55c007030 100644
--- a/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py
+++ b/google/cloud/spanner_admin_instance_v1/proto/spanner_instance_admin_pb2.py
@@ -1340,8 +1340,8 @@
         ),
         DESCRIPTOR=_INSTANCE,
         __module__="google.cloud.spanner.admin.instance_v1.proto.spanner_instance_admin_pb2",
-        __doc__="""An isolated set of Cloud Spanner resources on which
-  databases can be hosted.
+        __doc__="""An isolated set of Cloud Spanner resources on which databases can be
+  hosted.
   
   
   Attributes:
@@ -1398,15 +1398,7 @@
           as the string: name + "*" + value would prove problematic if
           we were to allow "*" in a future release.
       endpoint_uris:
-          Output only. The endpoint URIs based on the instance config.
-          For example, instances located in a specific cloud region (or
-          multi region) such as nam3, would have a nam3 specific
-          endpoint URI. This URI is to be used implictly by SDK clients,
-          with fallback to default URI. These endpoints are intended to
-          optimize the network routing between the client and the
-          instance's serving resources. If multiple endpoints are
-          present, client may establish connections using any of the
-          given URIs.
+          Deprecated. This field is not populated.
   """,
         # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.Instance)
     ),
@@ -1506,8 +1498,10 @@
           the form ``projects/<project>/instances/<instance>``.
       field_mask:
           If field\_mask is present, specifies the subset of
-          [][Instance] fields that should be returned. If absent, all
-          [][Instance] fields are returned.
+          [Instance][google.spanner.admin.instance.v1.Instance] fields
+          that should be returned. If absent, all
+          [Instance][google.spanner.admin.instance.v1.Instance] fields
+          are returned.
   """,
         # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.GetInstanceRequest)
     ),
@@ -1620,16 +1614,17 @@
   Attributes:
       instance:
           Required. The instance to update, which must always include
-          the instance name. Otherwise, only fields mentioned in [][goog
-          le.spanner.admin.instance.v1.UpdateInstanceRequest.field\_mask
-          ] need be included.
+          the instance name. Otherwise, only fields mentioned in [field\
+          _mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.
+          field\_mask] need be included.
       field_mask:
-          Required. A mask specifying which fields in [][google.spanner.
-          admin.instance.v1.UpdateInstanceRequest.instance] should be
-          updated. The field mask must always be specified; this
+          Required. A mask specifying which fields in
+          [Instance][google.spanner.admin.instance.v1.Instance] should
+          be updated. The field mask must always be specified; this
           prevents any future fields in
-          [][google.spanner.admin.instance.v1.Instance] from being
-          erased accidentally by clients that do not know about them.
+          [Instance][google.spanner.admin.instance.v1.Instance] from
+          being erased accidentally by clients that do not know about
+          them.
   """,
         # @@protoc_insertion_point(class_scope:google.spanner.admin.instance.v1.UpdateInstanceRequest)
     ),
diff --git a/google/cloud/spanner_v1/gapic/spanner_client.py b/google/cloud/spanner_v1/gapic/spanner_client.py
index cf6aafd6b6..20b6522780 100644
--- a/google/cloud/spanner_v1/gapic/spanner_client.py
+++ b/google/cloud/spanner_v1/gapic/spanner_client.py
@@ -237,7 +237,7 @@ def create_session(
 
         Active sessions use additional server resources, so it is a good idea to
         delete idle and unneeded sessions. Aside from explicit deletes, Cloud
-        Spanner can delete sessions for which no operations are sent for more
+        Spanner may delete sessions for which no operations are sent for more
         than an hour. If a session is deleted, requests to it return
         ``NOT_FOUND``.
 
@@ -659,6 +659,7 @@ def execute_sql(
         query_mode=None,
         partition_token=None,
         seqno=None,
+        query_options=None,
         retry=google.api_core.gapic_v1.method.DEFAULT,
         timeout=google.api_core.gapic_v1.method.DEFAULT,
         metadata=None,
@@ -752,6 +753,10 @@ def execute_sql(
                 handled requests will yield the same response as the first execution.
 
                 Required for DML statements. Ignored for queries.
+            query_options (Union[dict, ~google.cloud.spanner_v1.types.QueryOptions]): Query optimizer configuration to use for the given query.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.QueryOptions`
             retry (Optional[google.api_core.retry.Retry]):  A retry object used
                 to retry requests. If ``None`` is specified, requests will
                 be retried using a default configuration.
@@ -792,6 +797,7 @@ def execute_sql(
             query_mode=query_mode,
             partition_token=partition_token,
             seqno=seqno,
+            query_options=query_options,
         )
         if metadata is None:
             metadata = []
@@ -821,6 +827,7 @@ def execute_streaming_sql(
         query_mode=None,
         partition_token=None,
         seqno=None,
+        query_options=None,
         retry=google.api_core.gapic_v1.method.DEFAULT,
         timeout=google.api_core.gapic_v1.method.DEFAULT,
         metadata=None,
@@ -909,6 +916,10 @@ def execute_streaming_sql(
                 handled requests will yield the same response as the first execution.
 
                 Required for DML statements. Ignored for queries.
+            query_options (Union[dict, ~google.cloud.spanner_v1.types.QueryOptions]): Query optimizer configuration to use for the given query.
+
+                If a dict is provided, it must be of the same form as the protobuf
+                message :class:`~google.cloud.spanner_v1.types.QueryOptions`
             retry (Optional[google.api_core.retry.Retry]):  A retry object used
                 to retry requests. If ``None`` is specified, requests will
                 be retried using a default configuration.
@@ -949,6 +960,7 @@ def execute_streaming_sql(
             query_mode=query_mode,
             partition_token=partition_token,
             seqno=seqno,
+            query_options=query_options,
         )
         if metadata is None:
             metadata = []
@@ -1028,9 +1040,9 @@ def execute_batch_dml(
 
                 If a dict is provided, it must be of the same form as the protobuf
                 message :class:`~google.cloud.spanner_v1.types.Statement`
-            seqno (long): Required. A per-transaction sequence number used to identify this request.
-                This field makes each request idempotent such that if the request is
-                received multiple times, at most one will succeed.
+            seqno (long): Required. A per-transaction sequence number used to identify this request. This field
+                makes each request idempotent such that if the request is received multiple
+                times, at most one will succeed.
 
                 The sequence number must be monotonically increasing within the
                 transaction. If a request arrives for the first time with an out-of-order
diff --git a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py
index 47cedd3cc8..3d43f5088e 100644
--- a/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py
+++ b/google/cloud/spanner_v1/gapic/transports/spanner_grpc_transport.py
@@ -133,7 +133,7 @@ def create_session(self):
 
         Active sessions use additional server resources, so it is a good idea to
         delete idle and unneeded sessions. Aside from explicit deletes, Cloud
-        Spanner can delete sessions for which no operations are sent for more
+        Spanner may delete sessions for which no operations are sent for more
         than an hour. If a session is deleted, requests to it return
         ``NOT_FOUND``.
 
diff --git a/google/cloud/spanner_v1/proto/keys.proto b/google/cloud/spanner_v1/proto/keys.proto
index de5307aaaf..d129255c45 100644
--- a/google/cloud/spanner_v1/proto/keys.proto
+++ b/google/cloud/spanner_v1/proto/keys.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/google/cloud/spanner_v1/proto/mutation.proto b/google/cloud/spanner_v1/proto/mutation.proto
index 7df99c0ee6..2c675830f0 100644
--- a/google/cloud/spanner_v1/proto/mutation.proto
+++ b/google/cloud/spanner_v1/proto/mutation.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -61,7 +60,10 @@ message Mutation {
     // Required. The table whose rows will be deleted.
     string table = 1;
 
-    // Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.
+    // Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
+    // primary keys must be specified in the order in which they appear in the
+    // `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
+    // statement used to create the table).
     // Delete is idempotent. The transaction will succeed even if some or all
     // rows do not exist.
     KeySet key_set = 2;
@@ -80,6 +82,10 @@ message Mutation {
     // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
     // its column values are overwritten with the ones provided. Any
     // column values not explicitly written are preserved.
+    //
+    // When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
+    // NULL` columns in the table must be given a value. This holds true
+    // even when the row already exists and will therefore actually be updated.
     Write insert_or_update = 3;
 
     // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
diff --git a/google/cloud/spanner_v1/proto/mutation_pb2.py b/google/cloud/spanner_v1/proto/mutation_pb2.py
index db5a781f69..b6ad0429b8 100644
--- a/google/cloud/spanner_v1/proto/mutation_pb2.py
+++ b/google/cloud/spanner_v1/proto/mutation_pb2.py
@@ -383,8 +383,11 @@
         key_set:
             Required. The primary keys of the rows within
             [table][google.spanner.v1.Mutation.Delete.table] to delete.
-            Delete is idempotent. The transaction will succeed even if
-            some or all rows do not exist.
+            The primary keys must be specified in the order in which they
+            appear in the ``PRIMARY KEY()`` clause of the table's
+            equivalent DDL statement (the DDL statement used to create the
+            table). Delete is idempotent. The transaction will succeed
+            even if some or all rows do not exist.
     """,
                 # @@protoc_insertion_point(class_scope:google.spanner.v1.Mutation.Delete)
             ),
@@ -409,7 +412,12 @@
           Like [insert][google.spanner.v1.Mutation.insert], except that
           if the row already exists, then its column values are
           overwritten with the ones provided. Any column values not
-          explicitly written are preserved.
+          explicitly written are preserved.  When using [insert\_or\_upd
+          ate][google.spanner.v1.Mutation.insert\_or\_update], just as
+          when using [insert][google.spanner.v1.Mutation.insert], all
+          ``NOT NULL`` columns in the table must be given a value. This
+          holds true even when the row already exists and will therefore
+          actually be updated.
       replace:
           Like [insert][google.spanner.v1.Mutation.insert], except that
           if the row already exists, it is deleted, and the column
diff --git a/google/cloud/spanner_v1/proto/query_plan.proto b/google/cloud/spanner_v1/proto/query_plan.proto
index 2d6be2e2bd..6ad13a77b0 100644
--- a/google/cloud/spanner_v1/proto/query_plan.proto
+++ b/google/cloud/spanner_v1/proto/query_plan.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/google/cloud/spanner_v1/proto/result_set.proto b/google/cloud/spanner_v1/proto/result_set.proto
index a4b785283c..e24a35aaf8 100644
--- a/google/cloud/spanner_v1/proto/result_set.proto
+++ b/google/cloud/spanner_v1/proto/result_set.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/google/cloud/spanner_v1/proto/spanner.proto b/google/cloud/spanner_v1/proto/spanner.proto
index 2ff4c8db89..0c7da37c72 100644
--- a/google/cloud/spanner_v1/proto/spanner.proto
+++ b/google/cloud/spanner_v1/proto/spanner.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -37,10 +36,6 @@ option java_multiple_files = true;
 option java_outer_classname = "SpannerProto";
 option java_package = "com.google.spanner.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\V1";
-
-// The Database resource is defined in `google.spanner.admin.database.v1`.
-// Because this is a separate, independent API (technically), we redefine
-// the resource name pattern here.
 option (google.api.resource_definition) = {
   type: "spanner.googleapis.com/Database"
   pattern: "projects/{project}/instances/{instance}/databases/{database}"
@@ -69,7 +64,7 @@ service Spanner {
   //
   // Active sessions use additional server resources, so it is a good idea to
   // delete idle and unneeded sessions.
-  // Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+  // Aside from explicit deletes, Cloud Spanner may delete sessions for which no
   // operations are sent for more than an hour. If a session is deleted,
   // requests to it return `NOT_FOUND`.
   //
@@ -87,8 +82,7 @@ service Spanner {
   //
   // This API can be used to initialize a session cache on the clients.
   // See https://goo.gl/TgSFN2 for best practices on session cache management.
-  rpc BatchCreateSessions(BatchCreateSessionsRequest)
-      returns (BatchCreateSessionsResponse) {
+  rpc BatchCreateSessions(BatchCreateSessionsRequest) returns (BatchCreateSessionsResponse) {
     option (google.api.http) = {
       post: "/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate"
       body: "*"
@@ -131,12 +125,10 @@ service Spanner {
   //
   // Operations inside read-write transactions might return `ABORTED`. If
   // this occurs, the application should restart the transaction from
-  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-  // details.
+  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
   //
   // Larger result sets can be fetched in streaming fashion by calling
-  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
-  // instead.
+  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
   rpc ExecuteSql(ExecuteSqlRequest) returns (ResultSet) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql"
@@ -144,11 +136,11 @@ service Spanner {
     };
   }
 
-  // Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the
-  // result set as a stream. Unlike
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there is no limit on
-  // the size of the returned result set. However, no individual row in the
-  // result set can exceed 100 MiB, and no column value can exceed 10 MiB.
+  // Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the result
+  // set as a stream. Unlike [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there
+  // is no limit on the size of the returned result set. However, no
+  // individual row in the result set can exceed 100 MiB, and no
+  // column value can exceed 10 MiB.
   rpc ExecuteStreamingSql(ExecuteSqlRequest) returns (stream PartialResultSet) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql"
@@ -161,15 +153,13 @@ service Spanner {
   // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
   //
   // Statements are executed in sequential order. A request can succeed even if
-  // a statement fails. The
-  // [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status]
-  // field in the response provides information about the statement that failed.
-  // Clients must inspect this field to determine whether an error occurred.
+  // a statement fails. The [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status] field in the
+  // response provides information about the statement that failed. Clients must
+  // inspect this field to determine whether an error occurred.
   //
   // Execution stops after the first failed statement; the remaining statements
   // are not executed.
-  rpc ExecuteBatchDml(ExecuteBatchDmlRequest)
-      returns (ExecuteBatchDmlResponse) {
+  rpc ExecuteBatchDml(ExecuteBatchDmlRequest) returns (ExecuteBatchDmlResponse) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml"
       body: "*"
@@ -178,15 +168,14 @@ service Spanner {
 
   // Reads rows from the database using key lookups and scans, as a
   // simple key/value style alternative to
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be
-  // used to return a result set larger than 10 MiB; if the read matches more
+  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be used to
+  // return a result set larger than 10 MiB; if the read matches more
   // data than that, the read fails with a `FAILED_PRECONDITION`
   // error.
   //
   // Reads inside read-write transactions might return `ABORTED`. If
   // this occurs, the application should restart the transaction from
-  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-  // details.
+  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
   //
   // Larger result sets can be yielded in streaming fashion by calling
   // [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
@@ -197,9 +186,9 @@ service Spanner {
     };
   }
 
-  // Like [Read][google.spanner.v1.Spanner.Read], except returns the result set
-  // as a stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no
-  // limit on the size of the returned result set. However, no individual row in
+  // Like [Read][google.spanner.v1.Spanner.Read], except returns the result set as a
+  // stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no limit on the
+  // size of the returned result set. However, no individual row in
   // the result set can exceed 100 MiB, and no column value can exceed
   // 10 MiB.
   rpc StreamingRead(ReadRequest) returns (stream PartialResultSet) {
@@ -210,8 +199,7 @@ service Spanner {
   }
 
   // Begins a new transaction. This step can often be skipped:
-  // [Read][google.spanner.v1.Spanner.Read],
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+  // [Read][google.spanner.v1.Spanner.Read], [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
   // [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
   // side-effect.
   rpc BeginTransaction(BeginTransactionRequest) returns (Transaction) {
@@ -236,15 +224,13 @@ service Spanner {
       body: "*"
     };
     option (google.api.method_signature) = "session,transaction_id,mutations";
-    option (google.api.method_signature) =
-        "session,single_use_transaction,mutations";
+    option (google.api.method_signature) = "session,single_use_transaction,mutations";
   }
 
   // Rolls back a transaction, releasing any locks it holds. It is a good
   // idea to call this for any transaction that includes one or more
-  // [Read][google.spanner.v1.Spanner.Read] or
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and ultimately
-  // decides not to commit.
+  // [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and
+  // ultimately decides not to commit.
   //
   // `Rollback` returns `OK` if it successfully aborts the transaction, the
   // transaction was already aborted, or the transaction is not
@@ -259,11 +245,10 @@ service Spanner {
 
   // Creates a set of partition tokens that can be used to execute a query
   // operation in parallel.  Each of the returned partition tokens can be used
-  // by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-  // specify a subset of the query result to read.  The same session and
-  // read-only transaction must be used by the PartitionQueryRequest used to
-  // create the partition tokens and the ExecuteSqlRequests that use the
-  // partition tokens.
+  // by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset
+  // of the query result to read.  The same session and read-only transaction
+  // must be used by the PartitionQueryRequest used to create the
+  // partition tokens and the ExecuteSqlRequests that use the partition tokens.
   //
   // Partition tokens become invalid when the session used to create them
   // is deleted, is idle for too long, begins a new transaction, or becomes too
@@ -278,13 +263,12 @@ service Spanner {
 
   // Creates a set of partition tokens that can be used to execute a read
   // operation in parallel.  Each of the returned partition tokens can be used
-  // by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a
-  // subset of the read result to read.  The same session and read-only
-  // transaction must be used by the PartitionReadRequest used to create the
-  // partition tokens and the ReadRequests that use the partition tokens.  There
-  // are no ordering guarantees on rows returned among the returned partition
-  // tokens, or even within each individual StreamingRead call issued with a
-  // partition_token.
+  // by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
+  // result to read.  The same session and read-only transaction must be used by
+  // the PartitionReadRequest used to create the partition tokens and the
+  // ReadRequests that use the partition tokens.  There are no ordering
+  // guarantees on rows returned among the returned partition tokens, or even
+  // within each individual StreamingRead call issued with a partition_token.
   //
   // Partition tokens become invalid when the session used to create them
   // is deleted, is idle for too long, begins a new transaction, or becomes too
@@ -312,8 +296,7 @@ message CreateSessionRequest {
   Session session = 2;
 }
 
-// The request for
-// [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+// The request for [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
 message BatchCreateSessionsRequest {
   // Required. The database in which the new sessions are created.
   string database = 1 [
@@ -330,13 +313,11 @@ message BatchCreateSessionsRequest {
   // The API may return fewer than the requested number of sessions. If a
   // specific number of sessions are desired, the client can make additional
   // calls to BatchCreateSessions (adjusting
-  // [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count]
-  // as necessary).
+  // [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count] as necessary).
   int32 session_count = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The response for
-// [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+// The response for [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
 message BatchCreateSessionsResponse {
   // The freshly created sessions.
   repeated Session session = 1;
@@ -377,7 +358,9 @@ message GetSessionRequest {
   // Required. The name of the session to retrieve.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 }
 
@@ -396,8 +379,7 @@ message ListSessionsRequest {
   int32 page_size = 2;
 
   // If non-empty, `page_token` should contain a
-  // [next_page_token][google.spanner.v1.ListSessionsResponse.next_page_token]
-  // from a previous
+  // [next_page_token][google.spanner.v1.ListSessionsResponse.next_page_token] from a previous
   // [ListSessionsResponse][google.spanner.v1.ListSessionsResponse].
   string page_token = 3;
 
@@ -420,8 +402,8 @@ message ListSessionsResponse {
   repeated Session sessions = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListSessions][google.spanner.v1.Spanner.ListSessions] call to fetch more
-  // of the matching sessions.
+  // [ListSessions][google.spanner.v1.Spanner.ListSessions] call to fetch more of the matching
+  // sessions.
   string next_page_token = 2;
 }
 
@@ -430,13 +412,36 @@ message DeleteSessionRequest {
   // Required. The name of the session to delete.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 }
 
 // The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
 // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql].
 message ExecuteSqlRequest {
+  // Query optimizer configuration.
+  message QueryOptions {
+    // An option to control the selection of optimizer version.
+    //
+    // This parameter allows individual queries to pick different query
+    // optimizer versions.
+    //
+    // Specifying "latest" as a value instructs Cloud Spanner to use the
+    // latest supported query optimizer version. If not specified, Cloud Spanner
+    // uses optimizer version set at the database level options. Any other
+    // positive integer (from the list of supported optimizer versions)
+    // overrides the default optimizer version for query execution.
+    // The list of supported optimizer versions can be queried from
+    // SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement
+    // with an invalid optimizer version will fail with a syntax error
+    // (`INVALID_ARGUMENT`) status.
+    //
+    // The `optimizer_version` statement hint has precedence over this setting.
+    string optimizer_version = 1;
+  }
+
   // Mode in which the statement must be processed.
   enum QueryMode {
     // The default mode. Only the statement results are returned.
@@ -454,7 +459,9 @@ message ExecuteSqlRequest {
   // Required. The session in which the SQL query should be performed.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // The transaction to use.
@@ -488,8 +495,7 @@ message ExecuteSqlRequest {
 
   // It is not always possible for Cloud Spanner to infer the right SQL type
   // from a JSON value.  For example, values of type `BYTES` and values
-  // of type `STRING` both appear in
-  // [params][google.spanner.v1.ExecuteSqlRequest.params] as JSON strings.
+  // of type `STRING` both appear in [params][google.spanner.v1.ExecuteSqlRequest.params] as JSON strings.
   //
   // In these cases, `param_types` can be used to specify the exact
   // SQL type for some or all of the SQL statement parameters. See the
@@ -499,18 +505,15 @@ message ExecuteSqlRequest {
 
   // If this request is resuming a previously interrupted SQL statement
   // execution, `resume_token` should be copied from the last
-  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the
-  // interruption. Doing this enables the new SQL statement execution to resume
-  // where the last one left off. The rest of the request parameters must
-  // exactly match the request that yielded this token.
+  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this
+  // enables the new SQL statement execution to resume where the last one left
+  // off. The rest of the request parameters must exactly match the
+  // request that yielded this token.
   bytes resume_token = 6;
 
   // Used to control the amount of debugging information returned in
-  // [ResultSetStats][google.spanner.v1.ResultSetStats]. If
-  // [partition_token][google.spanner.v1.ExecuteSqlRequest.partition_token] is
-  // set, [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] can only
-  // be set to
-  // [QueryMode.NORMAL][google.spanner.v1.ExecuteSqlRequest.QueryMode.NORMAL].
+  // [ResultSetStats][google.spanner.v1.ResultSetStats]. If [partition_token][google.spanner.v1.ExecuteSqlRequest.partition_token] is set, [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] can only
+  // be set to [QueryMode.NORMAL][google.spanner.v1.ExecuteSqlRequest.QueryMode.NORMAL].
   QueryMode query_mode = 7;
 
   // If present, results will be restricted to the specified partition
@@ -530,6 +533,9 @@ message ExecuteSqlRequest {
   //
   // Required for DML statements. Ignored for queries.
   int64 seqno = 9;
+
+  // Query optimizer configuration to use for the given query.
+  QueryOptions query_options = 10;
 }
 
 // The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml].
@@ -555,9 +561,7 @@ message ExecuteBatchDmlRequest {
 
     // It is not always possible for Cloud Spanner to infer the right SQL type
     // from a JSON value.  For example, values of type `BYTES` and values
-    // of type `STRING` both appear in
-    // [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as
-    // JSON strings.
+    // of type `STRING` both appear in [params][google.spanner.v1.ExecuteBatchDmlRequest.Statement.params] as JSON strings.
     //
     // In these cases, `param_types` can be used to specify the exact
     // SQL type for some or all of the SQL statement parameters. See the
@@ -569,7 +573,9 @@ message ExecuteBatchDmlRequest {
   // Required. The session in which the DML statements should be performed.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Required. The transaction to use. Must be a read-write transaction.
@@ -579,17 +585,17 @@ message ExecuteBatchDmlRequest {
   // transaction.
   TransactionSelector transaction = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The list of statements to execute in this batch. Statements are
-  // executed serially, such that the effects of statement `i` are visible to
-  // statement `i+1`. Each statement must be a DML statement. Execution stops at
-  // the first failed statement; the remaining statements are not executed.
+  // Required. The list of statements to execute in this batch. Statements are executed
+  // serially, such that the effects of statement `i` are visible to statement
+  // `i+1`. Each statement must be a DML statement. Execution stops at the
+  // first failed statement; the remaining statements are not executed.
   //
   // Callers must provide at least one statement.
   repeated Statement statements = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. A per-transaction sequence number used to identify this request.
-  // This field makes each request idempotent such that if the request is
-  // received multiple times, at most one will succeed.
+  // Required. A per-transaction sequence number used to identify this request. This field
+  // makes each request idempotent such that if the request is received multiple
+  // times, at most one will succeed.
   //
   // The sequence number must be monotonically increasing within the
   // transaction. If a request arrives for the first time with an out-of-order
@@ -598,47 +604,38 @@ message ExecuteBatchDmlRequest {
   int64 seqno = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The response for
-// [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. Contains a list
-// of [ResultSet][google.spanner.v1.ResultSet] messages, one for each DML
-// statement that has successfully executed, in the same order as the statements
-// in the request. If a statement fails, the status in the response body
-// identifies the cause of the failure.
+// The response for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. Contains a list
+// of [ResultSet][google.spanner.v1.ResultSet] messages, one for each DML statement that has successfully
+// executed, in the same order as the statements in the request. If a statement
+// fails, the status in the response body identifies the cause of the failure.
 //
 // To check for DML statements that failed, use the following approach:
 //
-// 1. Check the status in the response message. The
-// [google.rpc.Code][google.rpc.Code] enum
+// 1. Check the status in the response message. The [google.rpc.Code][google.rpc.Code] enum
 //    value `OK` indicates that all statements were executed successfully.
 // 2. If the status was not `OK`, check the number of result sets in the
-//    response. If the response contains `N`
-//    [ResultSet][google.spanner.v1.ResultSet] messages, then statement `N+1` in
-//    the request failed.
+//    response. If the response contains `N` [ResultSet][google.spanner.v1.ResultSet] messages, then
+//    statement `N+1` in the request failed.
 //
 // Example 1:
 //
 // * Request: 5 DML statements, all executed successfully.
-// * Response: 5 [ResultSet][google.spanner.v1.ResultSet] messages, with the
-// status `OK`.
+// * Response: 5 [ResultSet][google.spanner.v1.ResultSet] messages, with the status `OK`.
 //
 // Example 2:
 //
 // * Request: 5 DML statements. The third statement has a syntax error.
-// * Response: 2 [ResultSet][google.spanner.v1.ResultSet] messages, and a syntax
-// error (`INVALID_ARGUMENT`)
-//   status. The number of [ResultSet][google.spanner.v1.ResultSet] messages
-//   indicates that the third statement failed, and the fourth and fifth
-//   statements were not executed.
+// * Response: 2 [ResultSet][google.spanner.v1.ResultSet] messages, and a syntax error (`INVALID_ARGUMENT`)
+//   status. The number of [ResultSet][google.spanner.v1.ResultSet] messages indicates that the third
+//   statement failed, and the fourth and fifth statements were not executed.
 message ExecuteBatchDmlResponse {
-  // One [ResultSet][google.spanner.v1.ResultSet] for each statement in the
-  // request that ran successfully, in the same order as the statements in the
-  // request. Each [ResultSet][google.spanner.v1.ResultSet] does not contain any
-  // rows. The [ResultSetStats][google.spanner.v1.ResultSetStats] in each
-  // [ResultSet][google.spanner.v1.ResultSet] contain the number of rows
-  // modified by the statement.
-  //
-  // Only the first [ResultSet][google.spanner.v1.ResultSet] in the response
-  // contains valid [ResultSetMetadata][google.spanner.v1.ResultSetMetadata].
+  // One [ResultSet][google.spanner.v1.ResultSet] for each statement in the request that ran successfully,
+  // in the same order as the statements in the request. Each [ResultSet][google.spanner.v1.ResultSet] does
+  // not contain any rows. The [ResultSetStats][google.spanner.v1.ResultSetStats] in each [ResultSet][google.spanner.v1.ResultSet] contain
+  // the number of rows modified by the statement.
+  //
+  // Only the first [ResultSet][google.spanner.v1.ResultSet] in the response contains valid
+  // [ResultSetMetadata][google.spanner.v1.ResultSetMetadata].
   repeated ResultSet result_sets = 1;
 
   // If all DML statements are executed successfully, the status is `OK`.
@@ -673,23 +670,24 @@ message PartitionQueryRequest {
   // Required. The session used to create the partitions.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Read only snapshot transactions are supported, read/write and single use
   // transactions are not.
   TransactionSelector transaction = 2;
 
-  // Required. The query request to generate partitions for. The request will
-  // fail if the query is not root partitionable. The query plan of a root
+  // Required. The query request to generate partitions for. The request will fail if
+  // the query is not root partitionable. The query plan of a root
   // partitionable query has a single distributed union operator. A distributed
   // union operator conceptually divides one or more tables into multiple
   // splits, remotely evaluates a subquery independently on each split, and
   // then unions all results.
   //
   // This must not contain DML commands, such as INSERT, UPDATE, or
-  // DELETE. Use
-  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] with a
+  // DELETE. Use [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] with a
   // PartitionedDml transaction for large, partition-friendly DML operations.
   string sql = 3 [(google.api.field_behavior) = REQUIRED];
 
@@ -709,8 +707,7 @@ message PartitionQueryRequest {
 
   // It is not always possible for Cloud Spanner to infer the right SQL type
   // from a JSON value.  For example, values of type `BYTES` and values
-  // of type `STRING` both appear in
-  // [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
+  // of type `STRING` both appear in [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
   //
   // In these cases, `param_types` can be used to specify the exact
   // SQL type for some or all of the SQL query parameters. See the
@@ -727,7 +724,9 @@ message PartitionReadRequest {
   // Required. The session used to create the partitions.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Read only snapshot transactions are supported, read/write and single use
@@ -737,24 +736,18 @@ message PartitionReadRequest {
   // Required. The name of the table in the database to be read.
   string table = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // If non-empty, the name of an index on
-  // [table][google.spanner.v1.PartitionReadRequest.table]. This index is used
-  // instead of the table primary key when interpreting
-  // [key_set][google.spanner.v1.PartitionReadRequest.key_set] and sorting
-  // result rows. See [key_set][google.spanner.v1.PartitionReadRequest.key_set]
-  // for further information.
+  // If non-empty, the name of an index on [table][google.spanner.v1.PartitionReadRequest.table]. This index is
+  // used instead of the table primary key when interpreting [key_set][google.spanner.v1.PartitionReadRequest.key_set]
+  // and sorting result rows. See [key_set][google.spanner.v1.PartitionReadRequest.key_set] for further information.
   string index = 4;
 
-  // The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be
-  // returned for each row matching this request.
+  // The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be returned for each row matching
+  // this request.
   repeated string columns = 5;
 
   // Required. `key_set` identifies the rows to be yielded. `key_set` names the
-  // primary keys of the rows in
-  // [table][google.spanner.v1.PartitionReadRequest.table] to be yielded, unless
-  // [index][google.spanner.v1.PartitionReadRequest.index] is present. If
-  // [index][google.spanner.v1.PartitionReadRequest.index] is present, then
-  // [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
+  // primary keys of the rows in [table][google.spanner.v1.PartitionReadRequest.table] to be yielded, unless [index][google.spanner.v1.PartitionReadRequest.index]
+  // is present. If [index][google.spanner.v1.PartitionReadRequest.index] is present, then [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
   // index keys in [index][google.spanner.v1.PartitionReadRequest.index].
   //
   // It is not an error for the `key_set` to name rows that do not
@@ -790,7 +783,9 @@ message ReadRequest {
   // Required. The session in which the read should be performed.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // The transaction to use. If none is provided, the default is a
@@ -800,31 +795,24 @@ message ReadRequest {
   // Required. The name of the table in the database to be read.
   string table = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // If non-empty, the name of an index on
-  // [table][google.spanner.v1.ReadRequest.table]. This index is used instead of
-  // the table primary key when interpreting
-  // [key_set][google.spanner.v1.ReadRequest.key_set] and sorting result rows.
-  // See [key_set][google.spanner.v1.ReadRequest.key_set] for further
-  // information.
+  // If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is
+  // used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set]
+  // and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
   string index = 4;
 
-  // Required. The columns of [table][google.spanner.v1.ReadRequest.table] to be
-  // returned for each row matching this request.
+  // Required. The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
+  // this request.
   repeated string columns = 5 [(google.api.field_behavior) = REQUIRED];
 
   // Required. `key_set` identifies the rows to be yielded. `key_set` names the
-  // primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to
-  // be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present.
-  // If [index][google.spanner.v1.ReadRequest.index] is present, then
-  // [key_set][google.spanner.v1.ReadRequest.key_set] instead names index keys
-  // in [index][google.spanner.v1.ReadRequest.index].
-  //
-  // If the [partition_token][google.spanner.v1.ReadRequest.partition_token]
-  // field is empty, rows are yielded in table primary key order (if
-  // [index][google.spanner.v1.ReadRequest.index] is empty) or index key order
-  // (if [index][google.spanner.v1.ReadRequest.index] is non-empty).  If the
-  // [partition_token][google.spanner.v1.ReadRequest.partition_token] field is
-  // not empty, rows will be yielded in an unspecified order.
+  // primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index]
+  // is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names
+  // index keys in [index][google.spanner.v1.ReadRequest.index].
+  //
+  // If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is empty, rows are yielded
+  // in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty) or index key order
+  // (if [index][google.spanner.v1.ReadRequest.index] is non-empty).  If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is not
+  // empty, rows will be yielded in an unspecified order.
   //
   // It is not an error for the `key_set` to name rows that do not
   // exist in the database. Read yields nothing for nonexistent rows.
@@ -837,9 +825,9 @@ message ReadRequest {
 
   // If this request is resuming a previously interrupted read,
   // `resume_token` should be copied from the last
-  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the
-  // interruption. Doing this enables the new read to resume where the last read
-  // left off. The rest of the request parameters must exactly match the request
+  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this
+  // enables the new read to resume where the last read left off. The
+  // rest of the request parameters must exactly match the request
   // that yielded this token.
   bytes resume_token = 9;
 
@@ -850,13 +838,14 @@ message ReadRequest {
   bytes partition_token = 10;
 }
 
-// The request for
-// [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
+// The request for [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
 message BeginTransactionRequest {
   // Required. The session in which the transaction runs.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Required. Options for the new transaction.
@@ -868,7 +857,9 @@ message CommitRequest {
   // Required. The session in which the transaction to be committed is running.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Required. The transaction in which to commit.
@@ -905,7 +896,9 @@ message RollbackRequest {
   // Required. The session in which the transaction to roll back is running.
   string session = 1 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = { type: "spanner.googleapis.com/Session" }
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
   ];
 
   // Required. The transaction to roll back.
diff --git a/google/cloud/spanner_v1/proto/spanner_pb2.py b/google/cloud/spanner_v1/proto/spanner_pb2.py
index 3415264909..ab1ff4e42e 100644
--- a/google/cloud/spanner_v1/proto/spanner_pb2.py
+++ b/google/cloud/spanner_v1/proto/spanner_pb2.py
@@ -48,7 +48,7 @@
         "\n\025com.google.spanner.v1B\014SpannerProtoP\001Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\252\002\027Google.Cloud.Spanner.V1\312\002\027Google\\Cloud\\Spanner\\V1\352A_\n\037spanner.googleapis.com/Database\022<projects/{project}/instances/{instance}/databases/{database}"
     ),
     serialized_pb=_b(
-        '\n+google/cloud/spanner_v1/proto/spanner.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a,google/cloud/spanner_v1/proto/mutation.proto\x1a.google/cloud/spanner_v1/proto/result_set.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto"~\n\x14\x43reateSessionRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12+\n\x07session\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session"\xa9\x01\n\x1a\x42\x61tchCreateSessionsRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x34\n\x10session_template\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session\x12\x1a\n\rsession_count\x18\x03 \x01(\x05\x42\x03\xe0\x41\x02"J\n\x1b\x42\x61tchCreateSessionsResponse\x12+\n\x07session\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session"\xe4\x02\n\x07Session\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x06labels\x18\x02 \x03(\x0b\x32&.google.spanner.v1.Session.LabelsEntry\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12=\n\x19\x61pproximate_last_use_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01:t\xea\x41q\n\x1espanner.googleapis.com/Session\x12Oprojects/{project}/instances/{instance}/databases/{database}/sessions/{session}"I\n\x11GetSessionRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session"\x87\x01\n\x13ListSessionsRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"]\n\x14ListSessionsResponse\x12,\n\x08sessions\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"L\n\x14\x44\x65leteSessionRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session"\x8d\x04\n\x11\x45xecuteSqlRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x10\n\x03sql\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12I\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x34.google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry\x12\x14\n\x0cresume_token\x18\x06 \x01(\x0c\x12\x42\n\nquery_mode\x18\x07 \x01(\x0e\x32..google.spanner.v1.ExecuteSqlRequest.QueryMode\x12\x17\n\x0fpartition_token\x18\x08 \x01(\x0c\x12\r\n\x05seqno\x18\t \x01(\x03\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01".\n\tQueryMode\x12\n\n\x06NORMAL\x10\x00\x12\x08\n\x04PLAN\x10\x01\x12\x0b\n\x07PROFILE\x10\x02"\xdf\x03\n\x16\x45xecuteBatchDmlRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12@\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelectorB\x03\xe0\x41\x02\x12L\n\nstatements\x18\x03 \x03(\x0b\x32\x33.google.spanner.v1.ExecuteBatchDmlRequest.StatementB\x03\xe0\x41\x02\x12\x12\n\x05seqno\x18\x04 \x01(\x03\x42\x03\xe0\x41\x02\x1a\xe7\x01\n\tStatement\x12\x0b\n\x03sql\x18\x01 \x01(\t\x12\'\n\x06params\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12X\n\x0bparam_types\x18\x03 \x03(\x0b\x32\x43.google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"p\n\x17\x45xecuteBatchDmlResponse\x12\x31\n\x0bresult_sets\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.ResultSet\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status"H\n\x10PartitionOptions\x12\x1c\n\x14partition_size_bytes\x18\x01 \x01(\x03\x12\x16\n\x0emax_partitions\x18\x02 \x01(\x03"\xa3\x03\n\x15PartitionQueryRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x10\n\x03sql\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12M\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x38.google.spanner.v1.PartitionQueryRequest.ParamTypesEntry\x12>\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12<projects/{project}/instances/{instance}/databases/{database}b\x06proto3'
+        '\n+google/cloud/spanner_v1/proto/spanner.proto\x12\x11google.spanner.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a(google/cloud/spanner_v1/proto/keys.proto\x1a,google/cloud/spanner_v1/proto/mutation.proto\x1a.google/cloud/spanner_v1/proto/result_set.proto\x1a/google/cloud/spanner_v1/proto/transaction.proto\x1a(google/cloud/spanner_v1/proto/type.proto"~\n\x14\x43reateSessionRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12+\n\x07session\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session"\xa9\x01\n\x1a\x42\x61tchCreateSessionsRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x34\n\x10session_template\x18\x02 \x01(\x0b\x32\x1a.google.spanner.v1.Session\x12\x1a\n\rsession_count\x18\x03 \x01(\x05\x42\x03\xe0\x41\x02"J\n\x1b\x42\x61tchCreateSessionsResponse\x12+\n\x07session\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session"\xe4\x02\n\x07Session\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x06labels\x18\x02 \x03(\x0b\x32&.google.spanner.v1.Session.LabelsEntry\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12=\n\x19\x61pproximate_last_use_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01:t\xea\x41q\n\x1espanner.googleapis.com/Session\x12Oprojects/{project}/instances/{instance}/databases/{database}/sessions/{session}"I\n\x11GetSessionRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session"\x87\x01\n\x13ListSessionsRequest\x12\x39\n\x08\x64\x61tabase\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1fspanner.googleapis.com/Database\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x04 \x01(\t"]\n\x14ListSessionsResponse\x12,\n\x08sessions\x18\x01 \x03(\x0b\x32\x1a.google.spanner.v1.Session\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"L\n\x14\x44\x65leteSessionRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session"\x82\x05\n\x11\x45xecuteSqlRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x10\n\x03sql\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12I\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x34.google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry\x12\x14\n\x0cresume_token\x18\x06 \x01(\x0c\x12\x42\n\nquery_mode\x18\x07 \x01(\x0e\x32..google.spanner.v1.ExecuteSqlRequest.QueryMode\x12\x17\n\x0fpartition_token\x18\x08 \x01(\x0c\x12\r\n\x05seqno\x18\t \x01(\x03\x12H\n\rquery_options\x18\n \x01(\x0b\x32\x31.google.spanner.v1.ExecuteSqlRequest.QueryOptions\x1a)\n\x0cQueryOptions\x12\x19\n\x11optimizer_version\x18\x01 \x01(\t\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01".\n\tQueryMode\x12\n\n\x06NORMAL\x10\x00\x12\x08\n\x04PLAN\x10\x01\x12\x0b\n\x07PROFILE\x10\x02"\xdf\x03\n\x16\x45xecuteBatchDmlRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12@\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelectorB\x03\xe0\x41\x02\x12L\n\nstatements\x18\x03 \x03(\x0b\x32\x33.google.spanner.v1.ExecuteBatchDmlRequest.StatementB\x03\xe0\x41\x02\x12\x12\n\x05seqno\x18\x04 \x01(\x03\x42\x03\xe0\x41\x02\x1a\xe7\x01\n\tStatement\x12\x0b\n\x03sql\x18\x01 \x01(\t\x12\'\n\x06params\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\x12X\n\x0bparam_types\x18\x03 \x03(\x0b\x32\x43.google.spanner.v1.ExecuteBatchDmlRequest.Statement.ParamTypesEntry\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"p\n\x17\x45xecuteBatchDmlResponse\x12\x31\n\x0bresult_sets\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.ResultSet\x12"\n\x06status\x18\x02 \x01(\x0b\x32\x12.google.rpc.Status"H\n\x10PartitionOptions\x12\x1c\n\x14partition_size_bytes\x18\x01 \x01(\x03\x12\x16\n\x0emax_partitions\x18\x02 \x01(\x03"\xa3\x03\n\x15PartitionQueryRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x10\n\x03sql\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\'\n\x06params\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12M\n\x0bparam_types\x18\x05 \x03(\x0b\x32\x38.google.spanner.v1.PartitionQueryRequest.ParamTypesEntry\x12>\n\x11partition_options\x18\x06 \x01(\x0b\x32#.google.spanner.v1.PartitionOptions\x1aJ\n\x0fParamTypesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.google.spanner.v1.Type:\x02\x38\x01"\xb1\x02\n\x14PartitionReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x0f\n\x07\x63olumns\x18\x05 \x03(\t\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12>\n\x11partition_options\x18\t \x01(\x0b\x32#.google.spanner.v1.PartitionOptions"$\n\tPartition\x12\x17\n\x0fpartition_token\x18\x01 \x01(\x0c"z\n\x11PartitionResponse\x12\x30\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.google.spanner.v1.Partition\x12\x33\n\x0btransaction\x18\x02 \x01(\x0b\x32\x1e.google.spanner.v1.Transaction"\xab\x02\n\x0bReadRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x0btransaction\x18\x02 \x01(\x0b\x32&.google.spanner.v1.TransactionSelector\x12\x12\n\x05table\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12\r\n\x05index\x18\x04 \x01(\t\x12\x14\n\x07\x63olumns\x18\x05 \x03(\tB\x03\xe0\x41\x02\x12/\n\x07key_set\x18\x06 \x01(\x0b\x32\x19.google.spanner.v1.KeySetB\x03\xe0\x41\x02\x12\r\n\x05limit\x18\x08 \x01(\x03\x12\x14\n\x0cresume_token\x18\t \x01(\x0c\x12\x17\n\x0fpartition_token\x18\n \x01(\x0c"\x8f\x01\n\x17\x42\x65ginTransactionRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12;\n\x07options\x18\x02 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsB\x03\xe0\x41\x02"\xea\x01\n\rCommitRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x18\n\x0etransaction_id\x18\x02 \x01(\x0cH\x00\x12G\n\x16single_use_transaction\x18\x03 \x01(\x0b\x32%.google.spanner.v1.TransactionOptionsH\x00\x12.\n\tmutations\x18\x04 \x03(\x0b\x32\x1b.google.spanner.v1.MutationB\r\n\x0btransaction"F\n\x0e\x43ommitResponse\x12\x34\n\x10\x63ommit_timestamp\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"g\n\x0fRollbackRequest\x12\x37\n\x07session\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1espanner.googleapis.com/Session\x12\x1b\n\x0etransaction_id\x18\x02 \x01(\x0c\x42\x03\xe0\x41\x02\x32\xc0\x16\n\x07Spanner\x12\xa6\x01\n\rCreateSession\x12\'.google.spanner.v1.CreateSessionRequest\x1a\x1a.google.spanner.v1.Session"P\x82\xd3\xe4\x93\x02?":/v1/{database=projects/*/instances/*/databases/*}/sessions:\x01*\xda\x41\x08\x64\x61tabase\x12\xe0\x01\n\x13\x42\x61tchCreateSessions\x12-.google.spanner.v1.BatchCreateSessionsRequest\x1a..google.spanner.v1.BatchCreateSessionsResponse"j\x82\xd3\xe4\x93\x02K"F/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate:\x01*\xda\x41\x16\x64\x61tabase,session_count\x12\x97\x01\n\nGetSession\x12$.google.spanner.v1.GetSessionRequest\x1a\x1a.google.spanner.v1.Session"G\x82\xd3\xe4\x93\x02:\x12\x38/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xae\x01\n\x0cListSessions\x12&.google.spanner.v1.ListSessionsRequest\x1a\'.google.spanner.v1.ListSessionsResponse"M\x82\xd3\xe4\x93\x02<\x12:/v1/{database=projects/*/instances/*/databases/*}/sessions\xda\x41\x08\x64\x61tabase\x12\x99\x01\n\rDeleteSession\x12\'.google.spanner.v1.DeleteSessionRequest\x1a\x16.google.protobuf.Empty"G\x82\xd3\xe4\x93\x02:*8/v1/{name=projects/*/instances/*/databases/*/sessions/*}\xda\x41\x04name\x12\xa3\x01\n\nExecuteSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a\x1c.google.spanner.v1.ResultSet"Q\x82\xd3\xe4\x93\x02K"F/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql:\x01*\x12\xbe\x01\n\x13\x45xecuteStreamingSql\x12$.google.spanner.v1.ExecuteSqlRequest\x1a#.google.spanner.v1.PartialResultSet"Z\x82\xd3\xe4\x93\x02T"O/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql:\x01*0\x01\x12\xc0\x01\n\x0f\x45xecuteBatchDml\x12).google.spanner.v1.ExecuteBatchDmlRequest\x1a*.google.spanner.v1.ExecuteBatchDmlResponse"V\x82\xd3\xe4\x93\x02P"K/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml:\x01*\x12\x91\x01\n\x04Read\x12\x1e.google.spanner.v1.ReadRequest\x1a\x1c.google.spanner.v1.ResultSet"K\x82\xd3\xe4\x93\x02\x45"@/v1/{session=projects/*/instances/*/databases/*/sessions/*}:read:\x01*\x12\xac\x01\n\rStreamingRead\x12\x1e.google.spanner.v1.ReadRequest\x1a#.google.spanner.v1.PartialResultSet"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:streamingRead:\x01*0\x01\x12\xc9\x01\n\x10\x42\x65ginTransaction\x12*.google.spanner.v1.BeginTransactionRequest\x1a\x1e.google.spanner.v1.Transaction"i\x82\xd3\xe4\x93\x02Q"L/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction:\x01*\xda\x41\x0fsession,options\x12\xeb\x01\n\x06\x43ommit\x12 .google.spanner.v1.CommitRequest\x1a!.google.spanner.v1.CommitResponse"\x9b\x01\x82\xd3\xe4\x93\x02G"B/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit:\x01*\xda\x41 session,transaction_id,mutations\xda\x41(session,single_use_transaction,mutations\x12\xb0\x01\n\x08Rollback\x12".google.spanner.v1.RollbackRequest\x1a\x16.google.protobuf.Empty"h\x82\xd3\xe4\x93\x02I"D/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback:\x01*\xda\x41\x16session,transaction_id\x12\xb7\x01\n\x0ePartitionQuery\x12(.google.spanner.v1.PartitionQueryRequest\x1a$.google.spanner.v1.PartitionResponse"U\x82\xd3\xe4\x93\x02O"J/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionQuery:\x01*\x12\xb4\x01\n\rPartitionRead\x12\'.google.spanner.v1.PartitionReadRequest\x1a$.google.spanner.v1.PartitionResponse"T\x82\xd3\xe4\x93\x02N"I/v1/{session=projects/*/instances/*/databases/*/sessions/*}:partitionRead:\x01*\x1aw\xca\x41\x16spanner.googleapis.com\xd2\x41[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.dataB\xf7\x01\n\x15\x63om.google.spanner.v1B\x0cSpannerProtoP\x01Z8google.golang.org/genproto/googleapis/spanner/v1;spanner\xaa\x02\x17Google.Cloud.Spanner.V1\xca\x02\x17Google\\Cloud\\Spanner\\V1\xea\x41_\n\x1fspanner.googleapis.com/Database\x12<projects/{project}/instances/{instance}/databases/{database}b\x06proto3'
     ),
     dependencies=[
         google_dot_api_dot_annotations__pb2.DESCRIPTOR,
@@ -86,8 +86,8 @@
     ],
     containing_type=None,
     serialized_options=None,
-    serialized_start=2126,
-    serialized_end=2172,
+    serialized_start=2243,
+    serialized_end=2289,
 )
 _sym_db.RegisterEnumDescriptor(_EXECUTESQLREQUEST_QUERYMODE)
 
@@ -652,6 +652,44 @@
 )
 
 
+_EXECUTESQLREQUEST_QUERYOPTIONS = _descriptor.Descriptor(
+    name="QueryOptions",
+    full_name="google.spanner.v1.ExecuteSqlRequest.QueryOptions",
+    filename=None,
+    file=DESCRIPTOR,
+    containing_type=None,
+    fields=[
+        _descriptor.FieldDescriptor(
+            name="optimizer_version",
+            full_name="google.spanner.v1.ExecuteSqlRequest.QueryOptions.optimizer_version",
+            index=0,
+            number=1,
+            type=9,
+            cpp_type=9,
+            label=1,
+            has_default_value=False,
+            default_value=_b("").decode("utf-8"),
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        )
+    ],
+    extensions=[],
+    nested_types=[],
+    enum_types=[],
+    serialized_options=None,
+    is_extendable=False,
+    syntax="proto3",
+    extension_ranges=[],
+    oneofs=[],
+    serialized_start=2124,
+    serialized_end=2165,
+)
+
 _EXECUTESQLREQUEST_PARAMTYPESENTRY = _descriptor.Descriptor(
     name="ParamTypesEntry",
     full_name="google.spanner.v1.ExecuteSqlRequest.ParamTypesEntry",
@@ -704,8 +742,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2050,
-    serialized_end=2124,
+    serialized_start=2167,
+    serialized_end=2241,
 )
 
 _EXECUTESQLREQUEST = _descriptor.Descriptor(
@@ -879,9 +917,27 @@
             serialized_options=None,
             file=DESCRIPTOR,
         ),
+        _descriptor.FieldDescriptor(
+            name="query_options",
+            full_name="google.spanner.v1.ExecuteSqlRequest.query_options",
+            index=9,
+            number=10,
+            type=11,
+            cpp_type=10,
+            label=1,
+            has_default_value=False,
+            default_value=None,
+            message_type=None,
+            enum_type=None,
+            containing_type=None,
+            is_extension=False,
+            extension_scope=None,
+            serialized_options=None,
+            file=DESCRIPTOR,
+        ),
     ],
     extensions=[],
-    nested_types=[_EXECUTESQLREQUEST_PARAMTYPESENTRY],
+    nested_types=[_EXECUTESQLREQUEST_QUERYOPTIONS, _EXECUTESQLREQUEST_PARAMTYPESENTRY],
     enum_types=[_EXECUTESQLREQUEST_QUERYMODE],
     serialized_options=None,
     is_extendable=False,
@@ -889,7 +945,7 @@
     extension_ranges=[],
     oneofs=[],
     serialized_start=1647,
-    serialized_end=2172,
+    serialized_end=2289,
 )
 
 
@@ -945,8 +1001,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2050,
-    serialized_end=2124,
+    serialized_start=2167,
+    serialized_end=2241,
 )
 
 _EXECUTEBATCHDMLREQUEST_STATEMENT = _descriptor.Descriptor(
@@ -1019,8 +1075,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2423,
-    serialized_end=2654,
+    serialized_start=2540,
+    serialized_end=2771,
 )
 
 _EXECUTEBATCHDMLREQUEST = _descriptor.Descriptor(
@@ -1113,8 +1169,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2175,
-    serialized_end=2654,
+    serialized_start=2292,
+    serialized_end=2771,
 )
 
 
@@ -1170,8 +1226,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2656,
-    serialized_end=2768,
+    serialized_start=2773,
+    serialized_end=2885,
 )
 
 
@@ -1227,8 +1283,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2770,
-    serialized_end=2842,
+    serialized_start=2887,
+    serialized_end=2959,
 )
 
 
@@ -1284,8 +1340,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2050,
-    serialized_end=2124,
+    serialized_start=2167,
+    serialized_end=2241,
 )
 
 _PARTITIONQUERYREQUEST = _descriptor.Descriptor(
@@ -1414,8 +1470,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=2845,
-    serialized_end=3264,
+    serialized_start=2962,
+    serialized_end=3381,
 )
 
 
@@ -1563,8 +1619,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=3267,
-    serialized_end=3572,
+    serialized_start=3384,
+    serialized_end=3689,
 )
 
 
@@ -1602,8 +1658,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=3574,
-    serialized_end=3610,
+    serialized_start=3691,
+    serialized_end=3727,
 )
 
 
@@ -1659,8 +1715,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=3612,
-    serialized_end=3734,
+    serialized_start=3729,
+    serialized_end=3851,
 )
 
 
@@ -1844,8 +1900,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=3737,
-    serialized_end=4036,
+    serialized_start=3854,
+    serialized_end=4153,
 )
 
 
@@ -1903,8 +1959,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=4039,
-    serialized_end=4182,
+    serialized_start=4156,
+    serialized_end=4299,
 )
 
 
@@ -2006,8 +2062,8 @@
             fields=[],
         )
     ],
-    serialized_start=4185,
-    serialized_end=4419,
+    serialized_start=4302,
+    serialized_end=4536,
 )
 
 
@@ -2045,8 +2101,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=4421,
-    serialized_end=4491,
+    serialized_start=4538,
+    serialized_end=4608,
 )
 
 
@@ -2104,8 +2160,8 @@
     syntax="proto3",
     extension_ranges=[],
     oneofs=[],
-    serialized_start=4493,
-    serialized_end=4596,
+    serialized_start=4610,
+    serialized_end=4713,
 )
 
 _CREATESESSIONREQUEST.fields_by_name["session"].message_type = _SESSION
@@ -2120,6 +2176,7 @@
     "approximate_last_use_time"
 ].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
 _LISTSESSIONSRESPONSE.fields_by_name["sessions"].message_type = _SESSION
+_EXECUTESQLREQUEST_QUERYOPTIONS.containing_type = _EXECUTESQLREQUEST
 _EXECUTESQLREQUEST_PARAMTYPESENTRY.fields_by_name[
     "value"
 ].message_type = google_dot_cloud_dot_spanner__v1_dot_proto_dot_type__pb2._TYPE
@@ -2136,6 +2193,9 @@
     "param_types"
 ].message_type = _EXECUTESQLREQUEST_PARAMTYPESENTRY
 _EXECUTESQLREQUEST.fields_by_name["query_mode"].enum_type = _EXECUTESQLREQUEST_QUERYMODE
+_EXECUTESQLREQUEST.fields_by_name[
+    "query_options"
+].message_type = _EXECUTESQLREQUEST_QUERYOPTIONS
 _EXECUTESQLREQUEST_QUERYMODE.containing_type = _EXECUTESQLREQUEST
 _EXECUTEBATCHDMLREQUEST_STATEMENT_PARAMTYPESENTRY.fields_by_name[
     "value"
@@ -2477,6 +2537,35 @@
     "ExecuteSqlRequest",
     (_message.Message,),
     dict(
+        QueryOptions=_reflection.GeneratedProtocolMessageType(
+            "QueryOptions",
+            (_message.Message,),
+            dict(
+                DESCRIPTOR=_EXECUTESQLREQUEST_QUERYOPTIONS,
+                __module__="google.cloud.spanner_v1.proto.spanner_pb2",
+                __doc__="""Query optimizer configuration.
+    
+    
+    Attributes:
+        optimizer_version:
+            An option to control the selection of optimizer version.  This
+            parameter allows individual queries to pick different query
+            optimizer versions.  Specifying "latest" as a value instructs
+            Cloud Spanner to use the latest supported query optimizer
+            version. If not specified, Cloud Spanner uses optimizer
+            version set at the database level options. Any other positive
+            integer (from the list of supported optimizer versions)
+            overrides the default optimizer version for query execution.
+            The list of supported optimizer versions can be queried from
+            SPANNER\_SYS.SUPPORTED\_OPTIMIZER\_VERSIONS. Executing a SQL
+            statement with an invalid optimizer version will fail with a
+            syntax error (``INVALID_ARGUMENT``) status.  The
+            ``optimizer_version`` statement hint has precedence over this
+            setting.
+    """,
+                # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest.QueryOptions)
+            ),
+        ),
         ParamTypesEntry=_reflection.GeneratedProtocolMessageType(
             "ParamTypesEntry",
             (_message.Message,),
@@ -2561,11 +2650,14 @@
           be aborted. Replays of previously handled requests will yield
           the same response as the first execution.  Required for DML
           statements. Ignored for queries.
+      query_options:
+          Query optimizer configuration to use for the given query.
   """,
         # @@protoc_insertion_point(class_scope:google.spanner.v1.ExecuteSqlRequest)
     ),
 )
 _sym_db.RegisterMessage(ExecuteSqlRequest)
+_sym_db.RegisterMessage(ExecuteSqlRequest.QueryOptions)
 _sym_db.RegisterMessage(ExecuteSqlRequest.ParamTypesEntry)
 
 ExecuteBatchDmlRequest = _reflection.GeneratedProtocolMessageType(
@@ -3130,8 +3222,8 @@
     serialized_options=_b(
         "\312A\026spanner.googleapis.com\322A[https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spanner.data"
     ),
-    serialized_start=4599,
-    serialized_end=7479,
+    serialized_start=4716,
+    serialized_end=7596,
     methods=[
         _descriptor.MethodDescriptor(
             name="CreateSession",
diff --git a/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py b/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py
index 4505b75cbc..1ac098d328 100644
--- a/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py
+++ b/google/cloud/spanner_v1/proto/spanner_pb2_grpc.py
@@ -124,7 +124,7 @@ def CreateSession(self, request, context):
 
     Active sessions use additional server resources, so it is a good idea to
     delete idle and unneeded sessions.
-    Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+    Aside from explicit deletes, Cloud Spanner may delete sessions for which no
     operations are sent for more than an hour. If a session is deleted,
     requests to it return `NOT_FOUND`.
 
@@ -178,23 +178,21 @@ def ExecuteSql(self, request, context):
 
     Operations inside read-write transactions might return `ABORTED`. If
     this occurs, the application should restart the transaction from
-    the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-    details.
+    the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
 
     Larger result sets can be fetched in streaming fashion by calling
-    [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
-    instead.
+    [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
         raise NotImplementedError("Method not implemented!")
 
     def ExecuteStreamingSql(self, request, context):
-        """Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the
-    result set as a stream. Unlike
-    [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there is no limit on
-    the size of the returned result set. However, no individual row in the
-    result set can exceed 100 MiB, and no column value can exceed 10 MiB.
+        """Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the result
+    set as a stream. Unlike [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there
+    is no limit on the size of the returned result set. However, no
+    individual row in the result set can exceed 100 MiB, and no
+    column value can exceed 10 MiB.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -206,10 +204,9 @@ def ExecuteBatchDml(self, request, context):
     [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
 
     Statements are executed in sequential order. A request can succeed even if
-    a statement fails. The
-    [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status]
-    field in the response provides information about the statement that failed.
-    Clients must inspect this field to determine whether an error occurred.
+    a statement fails. The [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status] field in the
+    response provides information about the statement that failed. Clients must
+    inspect this field to determine whether an error occurred.
 
     Execution stops after the first failed statement; the remaining statements
     are not executed.
@@ -221,15 +218,14 @@ def ExecuteBatchDml(self, request, context):
     def Read(self, request, context):
         """Reads rows from the database using key lookups and scans, as a
     simple key/value style alternative to
-    [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be
-    used to return a result set larger than 10 MiB; if the read matches more
+    [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be used to
+    return a result set larger than 10 MiB; if the read matches more
     data than that, the read fails with a `FAILED_PRECONDITION`
     error.
 
     Reads inside read-write transactions might return `ABORTED`. If
     this occurs, the application should restart the transaction from
-    the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-    details.
+    the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
 
     Larger result sets can be yielded in streaming fashion by calling
     [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
@@ -239,9 +235,9 @@ def Read(self, request, context):
         raise NotImplementedError("Method not implemented!")
 
     def StreamingRead(self, request, context):
-        """Like [Read][google.spanner.v1.Spanner.Read], except returns the result set
-    as a stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no
-    limit on the size of the returned result set. However, no individual row in
+        """Like [Read][google.spanner.v1.Spanner.Read], except returns the result set as a
+    stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no limit on the
+    size of the returned result set. However, no individual row in
     the result set can exceed 100 MiB, and no column value can exceed
     10 MiB.
     """
@@ -251,8 +247,7 @@ def StreamingRead(self, request, context):
 
     def BeginTransaction(self, request, context):
         """Begins a new transaction. This step can often be skipped:
-    [Read][google.spanner.v1.Spanner.Read],
-    [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+    [Read][google.spanner.v1.Spanner.Read], [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
     [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
     side-effect.
     """
@@ -277,9 +272,8 @@ def Commit(self, request, context):
     def Rollback(self, request, context):
         """Rolls back a transaction, releasing any locks it holds. It is a good
     idea to call this for any transaction that includes one or more
-    [Read][google.spanner.v1.Spanner.Read] or
-    [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and ultimately
-    decides not to commit.
+    [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and
+    ultimately decides not to commit.
 
     `Rollback` returns `OK` if it successfully aborts the transaction, the
     transaction was already aborted, or the transaction is not
@@ -292,11 +286,10 @@ def Rollback(self, request, context):
     def PartitionQuery(self, request, context):
         """Creates a set of partition tokens that can be used to execute a query
     operation in parallel.  Each of the returned partition tokens can be used
-    by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-    specify a subset of the query result to read.  The same session and
-    read-only transaction must be used by the PartitionQueryRequest used to
-    create the partition tokens and the ExecuteSqlRequests that use the
-    partition tokens.
+    by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset
+    of the query result to read.  The same session and read-only transaction
+    must be used by the PartitionQueryRequest used to create the
+    partition tokens and the ExecuteSqlRequests that use the partition tokens.
 
     Partition tokens become invalid when the session used to create them
     is deleted, is idle for too long, begins a new transaction, or becomes too
@@ -310,13 +303,12 @@ def PartitionQuery(self, request, context):
     def PartitionRead(self, request, context):
         """Creates a set of partition tokens that can be used to execute a read
     operation in parallel.  Each of the returned partition tokens can be used
-    by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a
-    subset of the read result to read.  The same session and read-only
-    transaction must be used by the PartitionReadRequest used to create the
-    partition tokens and the ReadRequests that use the partition tokens.  There
-    are no ordering guarantees on rows returned among the returned partition
-    tokens, or even within each individual StreamingRead call issued with a
-    partition_token.
+    by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
+    result to read.  The same session and read-only transaction must be used by
+    the PartitionReadRequest used to create the partition tokens and the
+    ReadRequests that use the partition tokens.  There are no ordering
+    guarantees on rows returned among the returned partition tokens, or even
+    within each individual StreamingRead call issued with a partition_token.
 
     Partition tokens become invalid when the session used to create them
     is deleted, is idle for too long, begins a new transaction, or becomes too
diff --git a/google/cloud/spanner_v1/proto/transaction.proto b/google/cloud/spanner_v1/proto/transaction.proto
index 7c2434b14a..6a429f5d41 100644
--- a/google/cloud/spanner_v1/proto/transaction.proto
+++ b/google/cloud/spanner_v1/proto/transaction.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/google/cloud/spanner_v1/proto/type.proto b/google/cloud/spanner_v1/proto/type.proto
index ccef29143e..b749d5084f 100644
--- a/google/cloud/spanner_v1/proto/type.proto
+++ b/google/cloud/spanner_v1/proto/type.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/synth.metadata b/synth.metadata
index 6e39ad3e0a..8abfac8f6a 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -1,27 +1,27 @@
 {
-  "updateTime": "2020-02-01T13:21:36.175336Z",
+  "updateTime": "2020-03-03T13:26:45.038429Z",
   "sources": [
     {
       "generator": {
         "name": "artman",
-        "version": "0.44.4",
-        "dockerImage": "googleapis/artman@sha256:19e945954fc960a4bdfee6cb34695898ab21a8cf0bac063ee39b91f00a1faec8"
+        "version": "0.47.0",
+        "dockerImage": "googleapis/artman@sha256:b3e50d6b8de03920b9f065bbc3d210e2ca93a043446f1fa16cdf567393c09678"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "b5cbe4a4ba64ab19e6627573ff52057a1657773d",
-        "internalRef": "292647187",
-        "log": "b5cbe4a4ba64ab19e6627573ff52057a1657773d\nSecurityCenter v1p1beta1: move file-level option on top to workaround protobuf.js bug.\n\nPiperOrigin-RevId: 292647187\n\nb224b317bf20c6a4fbc5030b4a969c3147f27ad3\nAdds API definitions for bigqueryreservation v1beta1.\n\nPiperOrigin-RevId: 292634722\n\nc1468702f9b17e20dd59007c0804a089b83197d2\nSynchronize new proto/yaml changes.\n\nPiperOrigin-RevId: 292626173\n\nffdfa4f55ab2f0afc11d0eb68f125ccbd5e404bd\nvision: v1p3beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605599\n\n78f61482cd028fc1d9892aa5d89d768666a954cd\nvision: v1p1beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292605125\n\n60bb5a294a604fd1778c7ec87b265d13a7106171\nvision: v1p2beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604980\n\n3bcf7aa79d45eb9ec29ab9036e9359ea325a7fc3\nvision: v1p4beta1 publish annotations and retry config\n\nPiperOrigin-RevId: 292604656\n\n"
+        "sha": "4a180bfff8a21645b3a935c2756e8d6ab18a74e0",
+        "internalRef": "298484782",
+        "log": "4a180bfff8a21645b3a935c2756e8d6ab18a74e0\nautoml/v1beta1 publish proto updates\n\nPiperOrigin-RevId: 298484782\n\n6de6e938b7df1cd62396563a067334abeedb9676\nchore: use the latest gapic-generator and protoc-java-resource-name-plugin in Bazel workspace.\n\nPiperOrigin-RevId: 298474513\n\n244ab2b83a82076a1fa7be63b7e0671af73f5c02\nAdds service config definition for bigqueryreservation v1\n\nPiperOrigin-RevId: 298455048\n\n83c6f84035ee0f80eaa44d8b688a010461cc4080\nUpdate google/api/auth.proto to make AuthProvider to have JwtLocation\n\nPiperOrigin-RevId: 297918498\n\ne9e90a787703ec5d388902e2cb796aaed3a385b4\nDialogflow weekly v2/v2beta1 library update:\n  - adding get validation result\n  - adding field mask override control for output audio config\nImportant updates are also posted at:\nhttps://cloud.google.com/dialogflow/docs/release-notes\n\nPiperOrigin-RevId: 297671458\n\n1a2b05cc3541a5f7714529c665aecc3ea042c646\nAdding .yaml and .json config files.\n\nPiperOrigin-RevId: 297570622\n\ndfe1cf7be44dee31d78f78e485d8c95430981d6e\nPublish `QueryOptions` proto.\n\nIntroduced a `query_options` input in `ExecuteSqlRequest`.\n\nPiperOrigin-RevId: 297497710\n\ndafc905f71e5d46f500b41ed715aad585be062c3\npubsub: revert pull init_rpc_timeout & max_rpc_timeout back to 25 seconds and reset multiplier to 1.0\n\nPiperOrigin-RevId: 297486523\n\nf077632ba7fee588922d9e8717ee272039be126d\nfirestore: add update_transform\n\nPiperOrigin-RevId: 297405063\n\n0aba1900ffef672ec5f0da677cf590ee5686e13b\ncluster: use square brace for cross-reference\n\nPiperOrigin-RevId: 297204568\n\n5dac2da18f6325cbaed54603c43f0667ecd50247\nRestore retry params in gapic config because securitycenter has non-standard default retry params.\nRestore a few retry codes for some idempotent methods.\n\nPiperOrigin-RevId: 297196720\n\n1eb61455530252bba8b2c8d4bc9832960e5a56f6\npubsub: v1 replace IAM HTTP rules\n\nPiperOrigin-RevId: 297188590\n\n80b2d25f8d43d9d47024ff06ead7f7166548a7ba\nDialogflow weekly v2/v2beta1 library update:\n  - updates to mega agent api\n  - adding field mask override control for output audio config\nImportant updates are also posted at:\nhttps://cloud.google.com/dialogflow/docs/release-notes\n\nPiperOrigin-RevId: 297187629\n\n0b1876b35e98f560f9c9ca9797955f020238a092\nUse an older version of protoc-docs-plugin that is compatible with the specified gapic-generator and protobuf versions.\n\nprotoc-docs-plugin >=0.4.0 (see commit https://github.com/googleapis/protoc-docs-plugin/commit/979f03ede6678c487337f3d7e88bae58df5207af) is incompatible with protobuf 3.9.1.\n\nPiperOrigin-RevId: 296986742\n\n1e47e676cddbbd8d93f19ba0665af15b5532417e\nFix: Restore a method signature for UpdateCluster\n\nPiperOrigin-RevId: 296901854\n\n7f910bcc4fc4704947ccfd3ceed015d16b9e00c2\nUpdate Dataproc v1beta2 client.\n\nPiperOrigin-RevId: 296451205\n\nde287524405a3dce124d301634731584fc0432d7\nFix: Reinstate method signatures that had been missed off some RPCs\nFix: Correct resource types for two fields\n\nPiperOrigin-RevId: 296435091\n\ne5bc9566ae057fb4c92f8b7e047f1c8958235b53\nDeprecate the endpoint_uris field, as it is unused.\n\nPiperOrigin-RevId: 296357191\n\n8c12e2b4dca94e12bff9f538bdac29524ff7ef7a\nUpdate Dataproc v1 client.\n\nPiperOrigin-RevId: 296336662\n\n17567c4a1ef0a9b50faa87024d66f8acbb561089\nRemoving erroneous comment, a la https://github.com/googleapis/java-speech/pull/103\n\nPiperOrigin-RevId: 296332968\n\n3eaaaf8626ce5b0c0bc7eee05e143beffa373b01\nAdd BUILD.bazel for v1 secretmanager.googleapis.com\n\nPiperOrigin-RevId: 296274723\n\ne76149c3d992337f85eeb45643106aacae7ede82\nMove securitycenter v1 to use generate from annotations.\n\nPiperOrigin-RevId: 296266862\n\n203740c78ac69ee07c3bf6be7408048751f618f8\nAdd StackdriverLoggingConfig field to Cloud Tasks v2 API.\n\nPiperOrigin-RevId: 296256388\n\ne4117d5e9ed8bbca28da4a60a94947ca51cb2083\nCreate a Bazel BUILD file for the google.actions.type export.\n\nPiperOrigin-RevId: 296212567\n\na9639a0a9854fd6e1be08bba1ac3897f4f16cb2f\nAdd secretmanager.googleapis.com v1 protos\n\nPiperOrigin-RevId: 295983266\n\nce4f4c21d9dd2bfab18873a80449b9d9851efde8\nasset: v1p1beta1 remove SearchResources and SearchIamPolicies\n\nPiperOrigin-RevId: 295861722\n\ncb61d6c2d070b589980c779b68ffca617f789116\nasset: v1p1beta1 remove SearchResources and SearchIamPolicies\n\nPiperOrigin-RevId: 295855449\n\nab2685d8d3a0e191dc8aef83df36773c07cb3d06\nfix: Dataproc v1 - AutoscalingPolicy annotation\n\nThis adds the second resource name pattern to the\nAutoscalingPolicy resource.\n\nCommitter: @lukesneeringer\nPiperOrigin-RevId: 295738415\n\n8a1020bf6828f6e3c84c3014f2c51cb62b739140\nUpdate cloud asset api v1p4beta1.\n\nPiperOrigin-RevId: 295286165\n\n5cfa105206e77670369e4b2225597386aba32985\nAdd service control related proto build rule.\n\nPiperOrigin-RevId: 295262088\n\nee4dddf805072004ab19ac94df2ce669046eec26\nmonitoring v3: Add prefix \"https://cloud.google.com/\" into the link for global access\ncl 295167522, get ride of synth.py hacks\n\nPiperOrigin-RevId: 295238095\n\nd9835e922ea79eed8497db270d2f9f85099a519c\nUpdate some minor docs changes about user event proto\n\nPiperOrigin-RevId: 295185610\n\n5f311e416e69c170243de722023b22f3df89ec1c\nfix: use correct PHP package name in gapic configuration\n\nPiperOrigin-RevId: 295161330\n\n6cdd74dcdb071694da6a6b5a206e3a320b62dd11\npubsub: v1 add client config annotations and retry config\n\nPiperOrigin-RevId: 295158776\n\n5169f46d9f792e2934d9fa25c36d0515b4fd0024\nAdded cloud asset api v1p4beta1.\n\nPiperOrigin-RevId: 295026522\n\n56b55aa8818cd0a532a7d779f6ef337ba809ccbd\nFix: Resource annotations for CreateTimeSeriesRequest and ListTimeSeriesRequest should refer to valid resources. TimeSeries is not a named resource.\n\nPiperOrigin-RevId: 294931650\n\n0646bc775203077226c2c34d3e4d50cc4ec53660\nRemove unnecessary languages from bigquery-related artman configuration files.\n\nPiperOrigin-RevId: 294809380\n\n8b78aa04382e3d4147112ad6d344666771bb1909\nUpdate backend.proto for schemes and protocol\n\nPiperOrigin-RevId: 294788800\n\n80b8f8b3de2359831295e24e5238641a38d8488f\nAdds artman config files for bigquerystorage endpoints v1beta2, v1alpha2, v1\n\nPiperOrigin-RevId: 294763931\n\n2c17ac33b226194041155bb5340c3f34733f1b3a\nAdd parameter to sample generated for UpdateInstance. Related to https://github.com/googleapis/python-redis/issues/4\n\nPiperOrigin-RevId: 294734008\n\nd5e8a8953f2acdfe96fb15e85eb2f33739623957\nMove bigquery datatransfer to gapic v2.\n\nPiperOrigin-RevId: 294703703\n\nefd36705972cfcd7d00ab4c6dfa1135bafacd4ae\nfix: Add two annotations that we missed.\n\nPiperOrigin-RevId: 294664231\n\n8a36b928873ff9c05b43859b9d4ea14cd205df57\nFix: Define the \"bigquery.googleapis.com/Table\" resource in the BigQuery Storage API (v1beta2).\n\nPiperOrigin-RevId: 294459768\n\nc7a3caa2c40c49f034a3c11079dd90eb24987047\nFix: Define the \"bigquery.googleapis.com/Table\" resource in the BigQuery Storage API (v1).\n\nPiperOrigin-RevId: 294456889\n\n5006247aa157e59118833658084345ee59af7c09\nFix: Make deprecated fields optional\nFix: Deprecate SetLoggingServiceRequest.zone in line with the comments\nFeature: Add resource name method signatures where appropriate\n\nPiperOrigin-RevId: 294383128\n\neabba40dac05c5cbe0fca3a35761b17e372036c4\nFix: C# and PHP package/namespace capitalization for BigQuery Storage v1.\n\nPiperOrigin-RevId: 294382444\n\nf8d9a858a7a55eba8009a23aa3f5cc5fe5e88dde\nfix: artman configuration file for bigtable-admin\n\nPiperOrigin-RevId: 294322616\n\n0f29555d1cfcf96add5c0b16b089235afbe9b1a9\nAPI definition for (not-yet-launched) GCS gRPC.\n\nPiperOrigin-RevId: 294321472\n\nfcc86bee0e84dc11e9abbff8d7c3529c0626f390\nfix: Bigtable Admin v2\n\nChange LRO metadata from PartialUpdateInstanceMetadata\nto UpdateInstanceMetadata. (Otherwise, it will not build.)\n\nPiperOrigin-RevId: 294264582\n\n6d9361eae2ebb3f42d8c7ce5baf4bab966fee7c0\nrefactor: Add annotations to Bigtable Admin v2.\n\nPiperOrigin-RevId: 294243406\n\nad7616f3fc8e123451c8b3a7987bc91cea9e6913\nFix: Resource type in CreateLogMetricRequest should use logging.googleapis.com.\nFix: ListLogEntries should have a method signature for convenience of calling it.\n\nPiperOrigin-RevId: 294222165\n\n63796fcbb08712676069e20a3e455c9f7aa21026\nFix: Remove extraneous resource definition for cloudkms.googleapis.com/CryptoKey.\n\nPiperOrigin-RevId: 294176658\n\ne7d8a694f4559201e6913f6610069cb08b39274e\nDepend on the latest gapic-generator and resource names plugin.\n\nThis fixes the very old an very annoying bug: https://github.com/googleapis/gapic-generator/pull/3087\n\nPiperOrigin-RevId: 293903652\n\n806b2854a966d55374ee26bb0cef4e30eda17b58\nfix: correct capitalization of Ruby namespaces in SecurityCenter V1p1beta1\n\nPiperOrigin-RevId: 293903613\n\n1b83c92462b14d67a7644e2980f723112472e03a\nPublish annotations and grpc service config for Logging API.\n\nPiperOrigin-RevId: 293893514\n\ne46f761cd6ec15a9e3d5ed4ff321a4bcba8e8585\nGenerate the Bazel build file for recommendengine public api\n\nPiperOrigin-RevId: 293710856\n\n68477017c4173c98addac0373950c6aa9d7b375f\nMake `language_code` optional for UpdateIntentRequest and BatchUpdateIntentsRequest.\n\nThe comments and proto annotations describe this parameter as optional.\n\nPiperOrigin-RevId: 293703548\n\n16f823f578bca4e845a19b88bb9bc5870ea71ab2\nAdd BUILD.bazel files for managedidentities API\n\nPiperOrigin-RevId: 293698246\n\n2f53fd8178c9a9de4ad10fae8dd17a7ba36133f2\nAdd v1p1beta1 config file\n\nPiperOrigin-RevId: 293696729\n\n052b274138fce2be80f97b6dcb83ab343c7c8812\nAdd source field for user event and add field behavior annotations\n\nPiperOrigin-RevId: 293693115\n\n1e89732b2d69151b1b3418fff3d4cc0434f0dded\ndatacatalog: v1beta1 add three new RPCs to gapic v1beta1 config\n\nPiperOrigin-RevId: 293692823\n\n9c8bd09bbdc7c4160a44f1fbab279b73cd7a2337\nchange the name of AccessApproval service to AccessApprovalAdmin\n\nPiperOrigin-RevId: 293690934\n\n2e23b8fbc45f5d9e200572ca662fe1271bcd6760\nAdd ListEntryGroups method, add http bindings to support entry group tagging, and update some comments.\n\nPiperOrigin-RevId: 293666452\n\n0275e38a4ca03a13d3f47a9613aac8c8b0d3f1f2\nAdd proto_package field to managedidentities API. It is needed for APIs that still depend on artman generation.\n\nPiperOrigin-RevId: 293643323\n\n4cdfe8278cb6f308106580d70648001c9146e759\nRegenerating public protos for Data Catalog to add new Custom Type Entry feature.\n\nPiperOrigin-RevId: 293614782\n\n45d2a569ab526a1fad3720f95eefb1c7330eaada\nEnable client generation for v1 ManagedIdentities API.\n\nPiperOrigin-RevId: 293515675\n\n2c17086b77e6f3bcf04a1f65758dfb0c3da1568f\nAdd the Actions on Google common types (//google/actions/type/*).\n\nPiperOrigin-RevId: 293478245\n\n781aadb932e64a12fb6ead7cd842698d99588433\nDialogflow weekly v2/v2beta1 library update:\n- Documentation updates\nImportant updates are also posted at\nhttps://cloud.google.com/dialogflow/docs/release-notes\n\nPiperOrigin-RevId: 293443396\n\ne2602608c9138c2fca24162720e67f9307c30b95\nDialogflow weekly v2/v2beta1 library update:\n- Documentation updates\nImportant updates are also posted at\nhttps://cloud.google.com/dialogflow/docs/release-notes\n\nPiperOrigin-RevId: 293442964\n\nc8aef82028d06b7992278fa9294c18570dc86c3d\nAdd cc_proto_library and cc_grpc_library targets for Bigtable protos.\n\nAlso fix indentation of cc_grpc_library targets in Spanner and IAM protos.\n\nPiperOrigin-RevId: 293440538\n\ne2faab04f4cb7f9755072330866689b1943a16e9\ncloudtasks: v2 replace non-standard retry params in gapic config v2\n\nPiperOrigin-RevId: 293424055\n\ndfb4097ea628a8470292c6590a4313aee0c675bd\nerrorreporting: v1beta1 add legacy artman config for php\n\nPiperOrigin-RevId: 293423790\n\nb18aed55b45bfe5b62476292c72759e6c3e573c6\nasset: v1p1beta1 updated comment for `page_size` limit.\n\nPiperOrigin-RevId: 293421386\n\nc9ef36b7956d9859a2fc86ad35fcaa16958ab44f\nbazel: Refactor CI build scripts\n\nPiperOrigin-RevId: 293387911\n\na8ed9d921fdddc61d8467bfd7c1668f0ad90435c\nfix: set Ruby module name for OrgPolicy\n\nPiperOrigin-RevId: 293257997\n\n6c7d28509bd8315de8af0889688ee20099594269\nredis: v1beta1 add UpgradeInstance and connect_mode field to Instance\n\nPiperOrigin-RevId: 293242878\n\nae0abed4fcb4c21f5cb67a82349a049524c4ef68\nredis: v1 add connect_mode field to Instance\n\nPiperOrigin-RevId: 293241914\n\n3f7a0d29b28ee9365771da2b66edf7fa2b4e9c56\nAdds service config definition for bigqueryreservation v1beta1\n\nPiperOrigin-RevId: 293234418\n\n0c88168d5ed6fe353a8cf8cbdc6bf084f6bb66a5\naddition of BUILD & configuration for accessapproval v1\n\nPiperOrigin-RevId: 293219198\n\n39bedc2e30f4778ce81193f6ba1fec56107bcfc4\naccessapproval: v1 publish protos\n\nPiperOrigin-RevId: 293167048\n\n69d9945330a5721cd679f17331a78850e2618226\nAdd file-level `Session` resource definition\n\nPiperOrigin-RevId: 293080182\n\nf6a1a6b417f39694275ca286110bc3c1ca4db0dc\nAdd file-level `Session` resource definition\n\nPiperOrigin-RevId: 293080178\n\n29d40b78e3dc1579b0b209463fbcb76e5767f72a\nExpose managedidentities/v1beta1/ API for client library usage.\n\nPiperOrigin-RevId: 292979741\n\na22129a1fb6e18056d576dfb7717aef74b63734a\nExpose managedidentities/v1/ API for client library usage.\n\nPiperOrigin-RevId: 292968186\n\n"
       }
     },
     {
       "template": {
-        "name": "python_split_library",
+        "name": "python_library",
         "origin": "synthtool.gcp",
-        "version": "2019.10.17"
+        "version": "2020.2.4"
       }
     }
   ],