googleapis
diff --git a/‎protos/google/spanner/v1/keys.proto‎
Lines changed: 2 additions & 2 deletions b/‎protos/google/spanner/v1/keys.proto‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎protos/google/spanner/v1/mutation.proto‎
Lines changed: 31 additions & 23 deletions b/‎protos/google/spanner/v1/mutation.proto‎
Lines changed: 31 additions & 23 deletions
diff --git a/‎protos/google/spanner/v1/query_plan.proto‎
Lines changed: 21 additions & 18 deletions b/‎protos/google/spanner/v1/query_plan.proto‎
Lines changed: 21 additions & 18 deletions
@@ -152,8 +152,8 @@ message KeySet {
   // encoded as described [here][google.spanner.v1.TypeCode].
   repeated google.protobuf.ListValue keys = 1;
 
-  // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
-  // key range specifications.
+  // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
+  // information about key range specifications.
   repeated KeyRange ranges = 2;
 
   // For convenience `all` can be set to `true` to indicate that this
 
@@ -32,13 +32,16 @@ option ruby_package = "Google::Cloud::Spanner::V1";
 // applied to a Cloud Spanner database by sending them in a
 // [Commit][google.spanner.v1.Spanner.Commit] call.
 message Mutation {
-  // Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
+  // Arguments to [insert][google.spanner.v1.Mutation.insert],
+  // [update][google.spanner.v1.Mutation.update],
+  // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
   // [replace][google.spanner.v1.Mutation.replace] operations.
   message Write {
     // Required. The table whose rows will be written.
     string table = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
+    // The names of the columns in
+    // [table][google.spanner.v1.Mutation.Write.table] to be written.
     //
     // The list of columns must contain enough columns to allow
     // Cloud Spanner to derive values for all primary key columns in the
@@ -48,11 +51,13 @@ message Mutation {
     // The values to be written. `values` can contain more than one
     // list of values. If it does, then multiple rows are written, one
     // for each entry in `values`. Each list in `values` must have
-    // exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
-    // above. Sending multiple lists is equivalent to sending multiple
-    // `Mutation`s, each containing one `values` entry and repeating
-    // [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
-    // encoded as described [here][google.spanner.v1.TypeCode].
+    // exactly as many entries as there are entries in
+    // [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
+    // multiple lists is equivalent to sending multiple `Mutation`s, each
+    // containing one `values` entry and repeating
+    // [table][google.spanner.v1.Mutation.Write.table] and
+    // [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
+    // each list are encoded as described [here][google.spanner.v1.TypeCode].
     repeated google.protobuf.ListValue values = 3;
   }
 
@@ -61,12 +66,12 @@ message Mutation {
     // Required. The table whose rows will be deleted.
     string table = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // 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.
+    // 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 [(google.api.field_behavior) = REQUIRED];
   }
 
@@ -80,19 +85,22 @@ message Mutation {
     // already exist, the transaction fails with error `NOT_FOUND`.
     Write update = 2;
 
-    // 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.
+    // 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.
+    // 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
-    // deleted, and the column values provided are inserted
-    // instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
-    // explicitly written become `NULL`.
+    // Like [insert][google.spanner.v1.Mutation.insert], except that if the row
+    // already exists, it is deleted, and the column values provided are
+    // inserted instead. Unlike
+    // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
+    // means any values not explicitly written become `NULL`.
     //
     // In an interleaved table, if you create the child table with the
     // `ON DELETE CASCADE` annotation, then replacing a parent row
 
@@ -26,10 +26,11 @@ option java_package = "com.google.spanner.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\V1";
 option ruby_package = "Google::Cloud::Spanner::V1";
 
-// Node information for nodes appearing in a [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
+// Node information for nodes appearing in a
+// [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
 message PlanNode {
-  // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between the two different kinds of
-  // nodes that can appear in a query plan.
+  // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between
+  // the two different kinds of nodes that can appear in a query plan.
   enum Kind {
     // Not specified.
     KIND_UNSPECIFIED = 0;
@@ -58,14 +59,14 @@ message PlanNode {
     // with the output variable.
     string type = 2;
 
-    // Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
-    // to an output variable of the parent node. The field carries the name of
-    // the output variable.
-    // For example, a `TableScan` operator that reads rows from a table will
-    // have child links to the `SCALAR` nodes representing the output variables
-    // created for each column that is read by the operator. The corresponding
-    // `variable` fields will be set to the variable names assigned to the
-    // columns.
+    // Only present if the child node is
+    // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
+    // output variable of the parent node. The field carries the name of the
+    // output variable. For example, a `TableScan` operator that reads rows from
+    // a table will have child links to the `SCALAR` nodes representing the
+    // output variables created for each column that is read by the operator.
+    // The corresponding `variable` fields will be set to the variable names
+    // assigned to the columns.
     string variable = 3;
   }
 
@@ -83,14 +84,15 @@ message PlanNode {
     map<string, int32> subqueries = 2;
   }
 
-  // The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
+  // The `PlanNode`'s index in [node
+  // list][google.spanner.v1.QueryPlan.plan_nodes].
   int32 index = 1;
 
   // Used to determine the type of node. May be needed for visualizing
   // different kinds of nodes differently. For example, If the node is a
-  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
-  // which can be used to directly embed a description of the node in its
-  // parent.
+  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
+  // condensed representation which can be used to directly embed a description
+  // of the node in its parent.
   Kind kind = 2;
 
   // The display name for the node.
@@ -99,7 +101,8 @@ message PlanNode {
   // List of child node `index`es and their relationship to this parent.
   repeated ChildLink child_links = 4;
 
-  // Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+  // Condensed representation for
+  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
   ShortRepresentation short_representation = 5;
 
   // Attributes relevant to the node contained in a group of key-value pairs.
@@ -122,7 +125,7 @@ message PlanNode {
 // Contains an ordered list of nodes appearing in the query plan.
 message QueryPlan {
   // The nodes in the query plan. Plan nodes are returned in pre-order starting
-  // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
-  // `plan_nodes`.
+  // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
+  // corresponds to its index in `plan_nodes`.
   repeated PlanNode plan_nodes = 1;
 }