🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Author: gcf-owl-bot[bot]

google/cloud/spanner_v1/services/spanner/async_client.py

@@ -49,6 +49,7 @@
 
 from google.cloud.spanner_v1.services.spanner import pagers
 from google.cloud.spanner_v1.types import commit_response
+from google.cloud.spanner_v1.types import location
 from google.cloud.spanner_v1.types import mutation
 from google.cloud.spanner_v1.types import result_set
 from google.cloud.spanner_v1.types import spanner

google/cloud/spanner_v1/services/spanner/client.py

@@ -64,6 +64,7 @@
 
 from google.cloud.spanner_v1.services.spanner import pagers
 from google.cloud.spanner_v1.types import commit_response
+from google.cloud.spanner_v1.types import location
 from google.cloud.spanner_v1.types import mutation
 from google.cloud.spanner_v1.types import result_set
 from google.cloud.spanner_v1.types import spanner

google/cloud/spanner_v1/types/__init__.py

@@ -23,6 +23,15 @@
     KeyRange,
     KeySet,
 )
+from .location import (
+    CacheUpdate,
+    Group,
+    KeyRecipe,
+    Range,
+    RecipeList,
+    RoutingHint,
+    Tablet,
+)
 from .mutation import (
     Mutation,
 )
@@ -81,6 +90,13 @@
     "CommitResponse",
     "KeyRange",
     "KeySet",
+    "CacheUpdate",
+    "Group",
+    "KeyRecipe",
+    "Range",
+    "RecipeList",
+    "RoutingHint",
+    "Tablet",
     "Mutation",
     "PlanNode",
     "QueryAdvisorResult",

…oogle/cloud/spanner_v1/types/location.py google/cloud/spanner_v1/types/location.pyowl-bot-staging/spanner/v1/google/cloud/spanner_v1/types/location.py renamed to google/cloud/spanner_v1/types/location.py owl-bot-staging/spanner/v1/google/cloud/spanner_v1/types/location.py renamed to google/cloud/spanner_v1/types/location.py

@@ -24,15 +24,15 @@
 
 
 __protobuf__ = proto.module(
-    package='google.spanner.v1',
+    package="google.spanner.v1",
     manifest={
-        'Range',
-        'Tablet',
-        'Group',
-        'KeyRecipe',
-        'RecipeList',
-        'CacheUpdate',
-        'RoutingHint',
+        "Range",
+        "Tablet",
+        "Group",
+        "KeyRecipe",
+        "RecipeList",
+        "CacheUpdate",
+        "RoutingHint",
     },
 )
 
@@ -172,6 +172,7 @@ class Tablet(proto.Message):
             this cues the server to send updated information for this
             tablet should it become usable again.
     """
+
     class Role(proto.Enum):
         r"""Indicates the role of the tablet.
 
@@ -253,10 +254,10 @@ class Group(proto.Message):
         proto.UINT64,
         number=1,
     )
-    tablets: MutableSequence['Tablet'] = proto.RepeatedField(
+    tablets: MutableSequence["Tablet"] = proto.RepeatedField(
         proto.MESSAGE,
         number=2,
-        message='Tablet',
+        message="Tablet",
     )
     leader_index: int = proto.Field(
         proto.INT32,
@@ -348,6 +349,7 @@ class Part(proto.Message):
                 It is a repeated field to support fetching key columns from
                 nested structs, such as ``STRUCT`` query parameters.
         """
+
         class Order(proto.Enum):
             r"""The remaining fields encode column values.
 
@@ -389,15 +391,15 @@ class NullOrder(proto.Enum):
             proto.UINT32,
             number=1,
         )
-        order: 'KeyRecipe.Part.Order' = proto.Field(
+        order: "KeyRecipe.Part.Order" = proto.Field(
             proto.ENUM,
             number=2,
-            enum='KeyRecipe.Part.Order',
+            enum="KeyRecipe.Part.Order",
         )
-        null_order: 'KeyRecipe.Part.NullOrder' = proto.Field(
+        null_order: "KeyRecipe.Part.NullOrder" = proto.Field(
             proto.ENUM,
             number=3,
-            enum='KeyRecipe.Part.NullOrder',
+            enum="KeyRecipe.Part.NullOrder",
         )
         type_: gs_type.Type = proto.Field(
             proto.MESSAGE,
@@ -407,18 +409,18 @@ class NullOrder(proto.Enum):
         identifier: str = proto.Field(
             proto.STRING,
             number=5,
-            oneof='value_type',
+            oneof="value_type",
         )
         value: struct_pb2.Value = proto.Field(
             proto.MESSAGE,
             number=6,
-            oneof='value_type',
+            oneof="value_type",
             message=struct_pb2.Value,
         )
         random: bool = proto.Field(
             proto.BOOL,
             number=8,
-            oneof='value_type',
+            oneof="value_type",
         )
         struct_identifiers: MutableSequence[int] = proto.RepeatedField(
             proto.INT32,
@@ -428,17 +430,17 @@ class NullOrder(proto.Enum):
     table_name: str = proto.Field(
         proto.STRING,
         number=1,
-        oneof='target',
+        oneof="target",
     )
     index_name: str = proto.Field(
         proto.STRING,
         number=2,
-        oneof='target',
+        oneof="target",
     )
     operation_uid: int = proto.Field(
         proto.UINT64,
         number=3,
-        oneof='target',
+        oneof="target",
     )
     part: MutableSequence[Part] = proto.RepeatedField(
         proto.MESSAGE,
@@ -468,10 +470,10 @@ class RecipeList(proto.Message):
         proto.BYTES,
         number=1,
     )
-    recipe: MutableSequence['KeyRecipe'] = proto.RepeatedField(
+    recipe: MutableSequence["KeyRecipe"] = proto.RepeatedField(
         proto.MESSAGE,
         number=3,
-        message='KeyRecipe',
+        message="KeyRecipe",
     )
 
 
@@ -503,20 +505,20 @@ class CacheUpdate(proto.Message):
         proto.UINT64,
         number=1,
     )
-    range_: MutableSequence['Range'] = proto.RepeatedField(
+    range_: MutableSequence["Range"] = proto.RepeatedField(
         proto.MESSAGE,
         number=2,
-        message='Range',
+        message="Range",
     )
-    group: MutableSequence['Group'] = proto.RepeatedField(
+    group: MutableSequence["Group"] = proto.RepeatedField(
         proto.MESSAGE,
         number=3,
-        message='Group',
+        message="Group",
     )
-    key_recipes: 'RecipeList' = proto.Field(
+    key_recipes: "RecipeList" = proto.Field(
         proto.MESSAGE,
         number=5,
-        message='RecipeList',
+        message="RecipeList",
     )
 
 

google/cloud/spanner_v1/types/result_set.py

@@ -19,6 +19,7 @@
 
 import proto  # type: ignore
 
+from google.cloud.spanner_v1.types import location
 from google.cloud.spanner_v1.types import query_plan as gs_query_plan
 from google.cloud.spanner_v1.types import transaction as gs_transaction
 from google.cloud.spanner_v1.types import type as gs_type
@@ -223,6 +224,14 @@ class PartialResultSet(proto.Message):
             ``PartialResultSet`` in the stream. The server might
             optionally set this field. Clients shouldn't rely on this
             field being set in all cases.
+        cache_update (google.cloud.spanner_v1.types.CacheUpdate):
+            Optional. A cache update expresses a set of changes the
+            client should incorporate into its location cache. The
+            client should discard the changes if they are older than the
+            data it already has. This data can be obtained in response
+            to requests that included a ``RoutingHint`` field, but may
+            also be obtained by explicit location-fetching RPCs which
+            may be added in the future.
     """
 
     metadata: "ResultSetMetadata" = proto.Field(
@@ -257,6 +266,11 @@ class PartialResultSet(proto.Message):
         proto.BOOL,
         number=9,
     )
+    cache_update: location.CacheUpdate = proto.Field(
+        proto.MESSAGE,
+        number=10,
+        message=location.CacheUpdate,
+    )
 
 
 class ResultSetMetadata(proto.Message):

google/cloud/spanner_v1/types/spanner.py

@@ -20,6 +20,7 @@
 import proto  # type: ignore
 
 from google.cloud.spanner_v1.types import keys
+from google.cloud.spanner_v1.types import location as gs_location
 from google.cloud.spanner_v1.types import mutation
 from google.cloud.spanner_v1.types import result_set
 from google.cloud.spanner_v1.types import transaction as gs_transaction
@@ -660,6 +661,15 @@ class ExecuteSqlRequest(proto.Message):
             example, validation of unique constraints). Given this,
             successful execution of a DML statement shouldn't be assumed
             until a subsequent ``Commit`` call completes successfully.
+        routing_hint (google.cloud.spanner_v1.types.RoutingHint):
+            Optional. If present, it makes the Spanner
+            requests location-aware.
+            It gives the server hints that can be used to
+            route the request to an appropriate server,
+            potentially significantly decreasing latency and
+            improving throughput. To achieve improved
+            performance, most fields must be filled in with
+            accurate values.
     """
 
     class QueryMode(proto.Enum):
@@ -826,6 +836,11 @@ class QueryOptions(proto.Message):
         proto.BOOL,
         number=17,
     )
+    routing_hint: gs_location.RoutingHint = proto.Field(
+        proto.MESSAGE,
+        number=18,
+        message=gs_location.RoutingHint,
+    )
 
 
 class ExecuteBatchDmlRequest(proto.Message):
@@ -1385,6 +1400,15 @@ class ReadRequest(proto.Message):
         lock_hint (google.cloud.spanner_v1.types.ReadRequest.LockHint):
             Optional. Lock Hint for the request, it can
             only be used with read-write transactions.
+        routing_hint (google.cloud.spanner_v1.types.RoutingHint):
+            Optional. If present, it makes the Spanner
+            requests location-aware.
+            It gives the server hints that can be used to
+            route the request to an appropriate server,
+            potentially significantly decreasing latency and
+            improving throughput. To achieve improved
+            performance, most fields must be filled in with
+            accurate values.
     """
 
     class OrderBy(proto.Enum):
@@ -1530,6 +1554,11 @@ class LockHint(proto.Enum):
         number=17,
         enum=LockHint,
     )
+    routing_hint: gs_location.RoutingHint = proto.Field(
+        proto.MESSAGE,
+        number=18,
+        message=gs_location.RoutingHint,
+    )
 
 
 class BeginTransactionRequest(proto.Message):