google-cloud-spanner 1.6.3 → 1.6.4

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

@@ -29,13 +29,13 @@ module Google
     #
     # = Examples
     #
-    # Example 1: Compute Timestamp from POSIX +time()+.
+    # Example 1: Compute Timestamp from POSIX `time()`.
     #
     #     Timestamp timestamp;
     #     timestamp.set_seconds(time(NULL));
     #     timestamp.set_nanos(0);
     #
-    # Example 2: Compute Timestamp from POSIX +gettimeofday()+.
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
     #
     #     struct timeval tv;
     #     gettimeofday(&tv, NULL);
@@ -44,7 +44,7 @@ module Google
     #     timestamp.set_seconds(tv.tv_sec);
     #     timestamp.set_nanos(tv.tv_usec * 1000);
     #
-    # Example 3: Compute Timestamp from Win32 +GetSystemTimeAsFileTime()+.
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
     #
     #     FILETIME ft;
     #     GetSystemTimeAsFileTime(&ft);
@@ -56,7 +56,7 @@ module Google
     #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
     #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
     #
-    # Example 4: Compute Timestamp from Java +System.currentTimeMillis()+.
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
     #
     #     long millis = System.currentTimeMillis();
     #
@@ -87,10 +87,10 @@ module Google
     #
     # In JavaScript, one can convert a Date object to this format using the
     # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
-    # method. In Python, a standard +datetime.datetime+ object can be converted
-    # to this format using [+strftime+](https://docs.python.org/2/library/time.html#time.strftime)
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
     # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
-    # can use the Joda Time's [+ISODateTimeFormat.dateTime()+](
+    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
     # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime--
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/keys.rb

@@ -37,14 +37,14 @@ module Google
       #     ["Bob", "2014-09-23"]
       #     ["Alfred", "2015-06-12"]
       #
-      # Since the +UserEvents+ table's +PRIMARY KEY+ clause names two
-      # columns, each +UserEvents+ key has two elements; the first is the
-      # +UserName+, and the second is the +EventDate+.
+      # Since the `UserEvents` table's `PRIMARY KEY` clause names two
+      # columns, each `UserEvents` key has two elements; the first is the
+      # `UserName`, and the second is the `EventDate`.
       #
       # Key ranges with multiple components are interpreted
       # lexicographically by component using the table or index key's declared
       # sort order. For example, the following range returns all events for
-      # user +"Bob"+ that occurred in the year 2015:
+      # user `"Bob"` that occurred in the year 2015:
       #
       #     "start_closed": ["Bob", "2015-01-01"]
       #     "end_closed": ["Bob", "2015-12-31"]
@@ -55,13 +55,13 @@ module Google
       # provided components are included; if the key is open, then rows
       # that exactly match are not included.
       #
-      # For example, the following range includes all events for +"Bob"+ that
+      # For example, the following range includes all events for `"Bob"` that
       # occurred during and after the year 2000:
       #
       #     "start_closed": ["Bob", "2000-01-01"]
       #     "end_closed": ["Bob"]
       #
-      # The next example retrieves all events for +"Bob"+:
+      # The next example retrieves all events for `"Bob"`:
       #
       #     "start_closed": ["Bob"]
       #     "end_closed": ["Bob"]
@@ -76,13 +76,13 @@ module Google
       #     "start_closed": []
       #     "end_closed": []
       #
-      # This range returns all users whose +UserName+ begins with any
+      # This range returns all users whose `UserName` begins with any
       # character from A to C:
       #
       #     "start_closed": ["A"]
       #     "end_open": ["D"]
       #
-      # This range returns all users whose +UserName+ begins with B:
+      # This range returns all users whose `UserName` begins with B:
       #
       #     "start_closed": ["B"]
       #     "end_open": ["C"]
@@ -102,26 +102,26 @@ module Google
       #     "end_closed": ["1"]
       #
       # Note that 100 is passed as the start, and 1 is passed as the end,
-      # because +Key+ is a descending column in the schema.
+      # because `Key` is a descending column in the schema.
       # @!attribute [rw] start_closed
       #   @return [Google::Protobuf::ListValue]
       #     If the start is closed, then the range includes all rows whose
-      #     first +len(start_closed)+ key columns exactly match +start_closed+.
+      #     first `len(start_closed)` key columns exactly match `start_closed`.
       # @!attribute [rw] start_open
       #   @return [Google::Protobuf::ListValue]
       #     If the start is open, then the range excludes rows whose first
-      #     +len(start_open)+ key columns exactly match +start_open+.
+      #     `len(start_open)` key columns exactly match `start_open`.
       # @!attribute [rw] end_closed
       #   @return [Google::Protobuf::ListValue]
       #     If the end is closed, then the range includes all rows whose
-      #     first +len(end_closed)+ key columns exactly match +end_closed+.
+      #     first `len(end_closed)` key columns exactly match `end_closed`.
       # @!attribute [rw] end_open
       #   @return [Google::Protobuf::ListValue]
       #     If the end is open, then the range excludes rows whose first
-      #     +len(end_open)+ key columns exactly match +end_open+.
+      #     `len(end_open)` key columns exactly match `end_open`.
       class KeyRange; end
 
-      # +KeySet+ defines a collection of Cloud Spanner keys and/or key ranges. All
+      # `KeySet` defines a collection of Cloud Spanner keys and/or key ranges. All
       # the keys are expected to be in the same table or index. The keys need
       # not be sorted in any particular way.
       #
@@ -130,9 +130,9 @@ module Google
       # behaves as if the key were only specified once.
       # @!attribute [rw] keys
       #   @return [Array<Google::Protobuf::ListValue>]
-      #     A list of specific keys. Entries in +keys+ should have exactly as
+      #     A list of specific keys. Entries in `keys` should have exactly as
       #     many elements as there are columns in the primary or index key
-      #     with which this +KeySet+ is used.  Individual key values are
+      #     with which this `KeySet` is used.  Individual key values are
       #     encoded as described {Google::Spanner::V1::TypeCode here}.
       # @!attribute [rw] ranges
       #   @return [Array<Google::Spanner::V1::KeyRange>]
@@ -140,9 +140,9 @@ module Google
       #     key range specifications.
       # @!attribute [rw] all
       #   @return [true, false]
-      #     For convenience +all+ can be set to +true+ to indicate that this
-      #     +KeySet+ matches all keys in the table or index. Note that any keys
-      #     specified in +keys+ or +ranges+ are only yielded once.
+      #     For convenience `all` can be set to `true` to indicate that this
+      #     `KeySet` matches all keys in the table or index. Note that any keys
+      #     specified in `keys` or `ranges` are only yielded once.
       class KeySet; end
     end
   end

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/mutation.rb

@@ -22,11 +22,11 @@ module Google
       # @!attribute [rw] insert
       #   @return [Google::Spanner::V1::Mutation::Write]
       #     Insert new rows in a table. If any of the rows already exist,
-      #     the write or transaction fails with error +ALREADY_EXISTS+.
+      #     the write or transaction fails with error `ALREADY_EXISTS`.
       # @!attribute [rw] update
       #   @return [Google::Spanner::V1::Mutation::Write]
       #     Update existing rows in a table. If any of the rows does not
-      #     already exist, the transaction fails with error +NOT_FOUND+.
+      #     already exist, the transaction fails with error `NOT_FOUND`.
       # @!attribute [rw] insert_or_update
       #   @return [Google::Spanner::V1::Mutation::Write]
       #     Like {Google::Spanner::V1::Mutation#insert insert}, except that if the row already exists, then
@@ -37,7 +37,7 @@ module Google
       #     Like {Google::Spanner::V1::Mutation#insert insert}, except that if the row already exists, it is
       #     deleted, and the column values provided are inserted
       #     instead. Unlike {Google::Spanner::V1::Mutation#insert_or_update insert_or_update}, this means any values not
-      #     explicitly written become +NULL+.
+      #     explicitly written become `NULL`.
       # @!attribute [rw] delete
       #   @return [Google::Spanner::V1::Mutation::Delete]
       #     Delete rows from a table. Succeeds whether or not the named
@@ -57,12 +57,12 @@ module Google
         #     row(s) to be modified.
         # @!attribute [rw] values
         #   @return [Array<Google::Protobuf::ListValue>]
-        #     The values to be written. +values+ can contain more than one
+        #     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
+        #     for each entry in `values`. Each list in `values` must have
         #     exactly as many entries as there are entries in {Google::Spanner::V1::Mutation::Write#columns columns}
         #     above. Sending multiple lists is equivalent to sending multiple
-        #     +Mutation+s, each containing one +values+ entry and repeating
+        #     `Mutation`s, each containing one `values` entry and repeating
         #     {Google::Spanner::V1::Mutation::Write#table table} and {Google::Spanner::V1::Mutation::Write#columns columns}. Individual values in each list are
         #     encoded as described {Google::Spanner::V1::TypeCode here}.
         class Write; end

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/query_plan.rb

@@ -19,7 +19,7 @@ module Google
       # Node information for nodes appearing in a {Google::Spanner::V1::QueryPlan#plan_nodes QueryPlan#plan_nodes}.
       # @!attribute [rw] index
       #   @return [Integer]
-      #     The +PlanNode+'s index in {Google::Spanner::V1::QueryPlan#plan_nodes node list}.
+      #     The `PlanNode`'s index in {Google::Spanner::V1::QueryPlan#plan_nodes node list}.
       # @!attribute [rw] kind
       #   @return [Google::Spanner::V1::PlanNode::Kind]
       #     Used to determine the type of node. May be needed for visualizing
@@ -32,7 +32,7 @@ module Google
       #     The display name for the node.
       # @!attribute [rw] child_links
       #   @return [Array<Google::Spanner::V1::PlanNode::ChildLink>]
-      #     List of child node +index+es and their relationship to this parent.
+      #     List of child node `index`es and their relationship to this parent.
       # @!attribute [rw] short_representation
       #   @return [Google::Spanner::V1::PlanNode::ShortRepresentation]
       #     Condensed representation for {Google::Spanner::V1::PlanNode::Kind::SCALAR SCALAR} nodes.
@@ -69,24 +69,24 @@ module Google
         #     Only present if the child node is {Google::Spanner::V1::PlanNode::Kind::SCALAR 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
+        #     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
+        #     `variable` fields will be set to the variable names assigned to the
         #     columns.
         class ChildLink; end
 
         # Condensed representation of a node and its subtree. Only present for
-        # +SCALAR+ {Google::Spanner::V1::PlanNode PlanNode(s)}.
+        # `SCALAR` {Google::Spanner::V1::PlanNode PlanNode(s)}.
         # @!attribute [rw] description
         #   @return [String]
         #     A string representation of the expression subtree rooted at this node.
         # @!attribute [rw] subqueries
         #   @return [Hash{String => Integer}]
         #     A mapping of (subquery variable name) -> (subquery node id) for cases
-        #     where the +description+ string of this node references a +SCALAR+
+        #     where the `description` string of this node references a `SCALAR`
         #     subquery contained in the expression subtree rooted at this node. The
-        #     referenced +SCALAR+ subquery may not necessarily be a direct child of
+        #     referenced `SCALAR` subquery may not necessarily be a direct child of
         #     this node.
         class ShortRepresentation; end
 
@@ -98,7 +98,7 @@ module Google
 
           # Denotes a Relational operator node in the expression tree. Relational
           # operators represent iterative processing of rows during query execution.
-          # For example, a +TableScan+ operation that reads rows from a table.
+          # For example, a `TableScan` operation that reads rows from a table.
           RELATIONAL = 1
 
           # Denotes a Scalar node in the expression tree. Scalar nodes represent
@@ -113,8 +113,8 @@ module Google
       # @!attribute [rw] plan_nodes
       #   @return [Array<Google::Spanner::V1::PlanNode>]
       #     The nodes in the query plan. Plan nodes are returned in pre-order starting
-      #     with the plan root. Each {Google::Spanner::V1::PlanNode PlanNode}'s +id+ corresponds to its index in
-      #     +plan_nodes+.
+      #     with the plan root. Each {Google::Spanner::V1::PlanNode PlanNode}'s `id` corresponds to its index in
+      #     `plan_nodes`.
       class QueryPlan; end
     end
   end

data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/result_set.rb

@@ -23,7 +23,7 @@ module Google
       #     Metadata about the result set, such as row type information.
       # @!attribute [rw] rows
       #   @return [Array<Google::Protobuf::ListValue>]
-      #     Each element in +rows+ is a row whose format is defined by
+      #     Each element in `rows` is a row whose format is defined by
       #     {Google::Spanner::V1::ResultSetMetadata#row_type metadata::row_type}. The ith element
       #     in each row matches the ith field in
       #     {Google::Spanner::V1::ResultSetMetadata#row_type metadata::row_type}. Elements are
@@ -31,8 +31,13 @@ module Google
       #     {Google::Spanner::V1::TypeCode here}.
       # @!attribute [rw] stats
       #   @return [Google::Spanner::V1::ResultSetStats]
-      #     Query plan and execution statistics for the query that produced this
-      #     result set. These can be requested by setting
+      #     Query plan and execution statistics for the SQL statement that
+      #     produced this result set. These can be requested by setting
+      #     {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode}.
+      #     DML statements always produce stats containing the number of rows
+      #     modified, unless executed using the
+      #     {Google::Spanner::V1::ExecuteSqlRequest::QueryMode::PLAN ExecuteSqlRequest::QueryMode::PLAN} {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode}.
+      #     Other fields may or may not be populated, based on the
       #     {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode}.
       class ResultSet; end
 
@@ -46,7 +51,7 @@ module Google
       # @!attribute [rw] values
       #   @return [Array<Google::Protobuf::Value>]
       #     A streamed result set consists of a stream of values, which might
-      #     be split into many +PartialResultSet+ messages to accommodate
+      #     be split into many `PartialResultSet` messages to accommodate
       #     large rows and/or large values. Every N complete values defines a
       #     row, where N is equal to the number of entries in
       #     {Google::Spanner::V1::StructType#fields metadata::row_type::fields}.
@@ -56,16 +61,16 @@ module Google
       #
       #     It is possible that the last value in values is "chunked",
       #     meaning that the rest of the value is sent in subsequent
-      #     +PartialResultSet+(s). This is denoted by the {Google::Spanner::V1::PartialResultSet#chunked_value chunked_value}
+      #     `PartialResultSet`(s). This is denoted by the {Google::Spanner::V1::PartialResultSet#chunked_value chunked_value}
       #     field. Two or more chunked values can be merged to form a
       #     complete value as follows:
       #
-      #     * +bool/number/null+: cannot be chunked
-      #       * +string+: concatenate the strings
-      #       * +list+: concatenate the lists. If the last element in a list is a
-      #         +string+, +list+, or +object+, merge it with the first element in
+      #     * `bool/number/null`: cannot be chunked
+      #       * `string`: concatenate the strings
+      #       * `list`: concatenate the lists. If the last element in a list is a
+      #         `string`, `list`, or `object`, merge it with the first element in
       #         the next list by applying these rules recursively.
-      #       * +object+: concatenate the (field name, field value) pairs. If a
+      #       * `object`: concatenate the (field name, field value) pairs. If a
       #         field name is duplicated, then apply these rules recursively
       #         to merge the field values.
       #
@@ -97,7 +102,7 @@ module Google
       #
       #     For a more complete example, suppose a streaming SQL query is
       #     yielding a result set whose rows contain a single string
-      #     field. The following +PartialResultSet+s might be yielded:
+      #     field. The following `PartialResultSet`s might be yielded:
       #
       #         {
       #           "metadata": { ... }
@@ -115,35 +120,37 @@ module Google
       #           "resume_token": "Zx1B..."
       #         }
       #
-      #     This sequence of +PartialResultSet+s encodes two rows, one
-      #     containing the field value +"Hello"+, and a second containing the
-      #     field value +"World" = "W" + "orl" + "d"+.
+      #     This sequence of `PartialResultSet`s encodes two rows, one
+      #     containing the field value `"Hello"`, and a second containing the
+      #     field value `"World" = "W" + "orl" + "d"`.
       # @!attribute [rw] chunked_value
       #   @return [true, false]
       #     If true, then the final value in {Google::Spanner::V1::PartialResultSet#values values} is chunked, and must
-      #     be combined with more values from subsequent +PartialResultSet+s
+      #     be combined with more values from subsequent `PartialResultSet`s
       #     to obtain a complete field value.
       # @!attribute [rw] resume_token
       #   @return [String]
       #     Streaming calls might be interrupted for a variety of reasons, such
       #     as TCP connection loss. If this occurs, the stream of results can
       #     be resumed by re-sending the original request and including
-      #     +resume_token+. Note that executing any other transaction in the
+      #     `resume_token`. Note that executing any other transaction in the
       #     same session invalidates the token.
       # @!attribute [rw] stats
       #   @return [Google::Spanner::V1::ResultSetStats]
-      #     Query plan and execution statistics for the query that produced this
+      #     Query plan and execution statistics for the statement that produced this
       #     streaming result set. These can be requested by setting
       #     {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode} and are sent
       #     only once with the last response in the stream.
+      #     This field will also be present in the last response for DML
+      #     statements.
       class PartialResultSet; end
 
       # Metadata about a {Google::Spanner::V1::ResultSet ResultSet} or {Google::Spanner::V1::PartialResultSet PartialResultSet}.
       # @!attribute [rw] row_type
       #   @return [Google::Spanner::V1::StructType]
       #     Indicates the field names and types for the rows in the result
-      #     set.  For example, a SQL query like +"SELECT UserId, UserName FROM
-      #     Users"+ could return a +row_type+ value like:
+      #     set.  For example, a SQL query like `"SELECT UserId, UserName FROM
+      #     Users"` could return a `row_type` value like:
       #
       #         "fields": [
       #           { "name": "UserId", "type": { "code": "INT64" } },
@@ -170,6 +177,13 @@ module Google
       #           "elapsed_time": "1.22 secs",
       #           "cpu_time": "1.19 secs"
       #         }
+      # @!attribute [rw] row_count_exact
+      #   @return [Integer]
+      #     Standard DML returns an exact count of rows that were modified.
+      # @!attribute [rw] row_count_lower_bound
+      #   @return [Integer]
+      #     Partitioned DML does not offer exactly-once semantics, so it
+      #     returns a lower bound of the rows modified.
       class ResultSetStats; end
     end
   end

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

@@ -35,9 +35,9 @@ module Google
       #     The labels for the session.
       #
       #     * Label keys must be between 1 and 63 characters long and must conform to
-      #       the following regular expression: +[a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?+.
+      #       the following regular expression: `[a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?`.
       #     * Label values must be between 0 and 63 characters long and must conform
-      #       to the regular expression +([a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?)?+.
+      #       to the regular expression `([a-z](https://cloud.google.com[-a-z0-9]*[a-z0-9])?)?`.
       #     * No more than 64 labels can be associated with a given session.
       #
       #     See https://goo.gl/xmQnxf for more information on and examples of labels.
@@ -66,7 +66,7 @@ module Google
       #     to the server's maximum allowed page size.
       # @!attribute [rw] page_token
       #   @return [String]
-      #     If non-empty, +page_token+ should contain a
+      #     If non-empty, `page_token` should contain a
       #     {Google::Spanner::V1::ListSessionsResponse#next_page_token next_page_token} from a previous
       #     {Google::Spanner::V1::ListSessionsResponse ListSessionsResponse}.
       # @!attribute [rw] filter
@@ -74,12 +74,12 @@ module Google
       #     An expression for filtering the results of the request. Filter rules are
       #     case insensitive. The fields eligible for filtering are:
       #
-      #     * +labels.key+ where key is the name of a label
+      #     * `labels.key` where key is the name of a label
       #
       #     Some examples of using filters are:
       #
-      #     * +labels.env:*+ --> The session has the label "env".
-      #       * +labels.env:dev+ --> The session has the label "env" and the value of
+      #     * `labels.env:*` --> The session has the label "env".
+      #       * `labels.env:dev` --> The session has the label "env" and the value of
       #         the label contains the string "dev".
       class ListSessionsRequest; end
 
@@ -89,7 +89,7 @@ module Google
       #     The list of requested sessions.
       # @!attribute [rw] next_page_token
       #   @return [String]
-      #     +next_page_token+ can be sent in a subsequent
+      #     `next_page_token` can be sent in a subsequent
       #     {Google::Spanner::V1::Spanner::ListSessions ListSessions} call to fetch more of the matching
       #     sessions.
       class ListSessionsResponse; end
@@ -109,41 +109,52 @@ module Google
       #   @return [Google::Spanner::V1::TransactionSelector]
       #     The transaction to use. If none is provided, the default is a
       #     temporary read-only transaction with strong concurrency.
+      #
+      #     The transaction to use.
+      #
+      #     For queries, if none is provided, the default is a temporary read-only
+      #     transaction with strong concurrency.
+      #
+      #     Standard DML statements require a ReadWrite transaction. Single-use
+      #     transactions are not supported (to avoid replay).  The caller must
+      #     either supply an existing transaction ID or begin a new transaction.
+      #
+      #     Partitioned DML requires an existing PartitionedDml transaction ID.
       # @!attribute [rw] sql
       #   @return [String]
-      #     Required. The SQL query string.
+      #     Required. The SQL string.
       # @!attribute [rw] params
       #   @return [Google::Protobuf::Struct]
-      #     The SQL query string can contain parameter placeholders. A parameter
-      #     placeholder consists of +'@'+ followed by the parameter
+      #     The SQL string can contain parameter placeholders. A parameter
+      #     placeholder consists of `'@'` followed by the parameter
       #     name. Parameter names consist of any combination of letters,
       #     numbers, and underscores.
       #
       #     Parameters can appear anywhere that a literal value is expected.  The same
       #     parameter name can be used more than once, for example:
-      #       +"WHERE id > @msg_id AND id < @msg_id + 100"+
+      #       `"WHERE id > @msg_id AND id < @msg_id + 100"`
       #
-      #     It is an error to execute an SQL query with unbound parameters.
+      #     It is an error to execute an SQL statement with unbound parameters.
       #
-      #     Parameter values are specified using +params+, which is a JSON
+      #     Parameter values are specified using `params`, which is a JSON
       #     object whose keys are parameter names, and whose values are the
       #     corresponding parameter values.
       # @!attribute [rw] param_types
       #   @return [Hash{String => Google::Spanner::V1::Type}]
       #     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 {Google::Spanner::V1::ExecuteSqlRequest#params params} as JSON strings.
+      #     from a JSON value.  For example, values of type `BYTES` and values
+      #     of type `STRING` both appear in {Google::Spanner::V1::ExecuteSqlRequest#params 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
+      #     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
       #     definition of {Google::Spanner::V1::Type Type} for more information
       #     about SQL types.
       # @!attribute [rw] resume_token
       #   @return [String]
-      #     If this request is resuming a previously interrupted SQL query
-      #     execution, +resume_token+ should be copied from the last
+      #     If this request is resuming a previously interrupted SQL statement
+      #     execution, `resume_token` should be copied from the last
       #     {Google::Spanner::V1::PartialResultSet PartialResultSet} yielded before the interruption. Doing this
-      #     enables the new SQL query execution to resume where the last one left
+      #     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.
       # @!attribute [rw] query_mode
@@ -157,19 +168,30 @@ module Google
       #     previously created using PartitionQuery().  There must be an exact
       #     match for the values of fields common to this message and the
       #     PartitionQueryRequest message used to create this partition_token.
+      # @!attribute [rw] seqno
+      #   @return [Integer]
+      #     A per-transaction sequence number used to identify this request. This
+      #     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
+      #     sequence number, the transaction may be aborted. Replays of previously
+      #     handled requests will yield the same response as the first execution.
+      #
+      #     Required for DML statements. Ignored for queries.
       class ExecuteSqlRequest
-        # Mode in which the query must be processed.
+        # Mode in which the statement must be processed.
         module QueryMode
-          # The default mode where only the query result, without any information
-          # about the query plan is returned.
+          # The default mode. Only the statement results are returned.
           NORMAL = 0
 
-          # This mode returns only the query plan, without any result rows or
+          # This mode returns only the query plan, without any results or
           # execution statistics information.
           PLAN = 1
 
           # This mode returns both the query plan and the execution statistics along
-          # with the result rows.
+          # with the results.
           PROFILE = 2
         end
       end
@@ -212,29 +234,33 @@ module Google
       #     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 {Google::Spanner::V1::Spanner::ExecuteStreamingSql ExecuteStreamingSql} with a
+      #     PartitionedDml transaction for large, partition-friendly DML operations.
       # @!attribute [rw] params
       #   @return [Google::Protobuf::Struct]
       #     The SQL query string can contain parameter placeholders. A parameter
-      #     placeholder consists of +'@'+ followed by the parameter
+      #     placeholder consists of `'@'` followed by the parameter
       #     name. Parameter names consist of any combination of letters,
       #     numbers, and underscores.
       #
       #     Parameters can appear anywhere that a literal value is expected.  The same
       #     parameter name can be used more than once, for example:
-      #       +"WHERE id > @msg_id AND id < @msg_id + 100"+
+      #       `"WHERE id > @msg_id AND id < @msg_id + 100"`
       #
       #     It is an error to execute an SQL query with unbound parameters.
       #
-      #     Parameter values are specified using +params+, which is a JSON
+      #     Parameter values are specified using `params`, which is a JSON
       #     object whose keys are parameter names, and whose values are the
       #     corresponding parameter values.
       # @!attribute [rw] param_types
       #   @return [Hash{String => Google::Spanner::V1::Type}]
       #     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 {Google::Spanner::V1::PartitionQueryRequest#params params} as JSON strings.
+      #     from a JSON value.  For example, values of type `BYTES` and values
+      #     of type `STRING` both appear in {Google::Spanner::V1::PartitionQueryRequest#params params} as JSON strings.
       #
-      #     In these cases, +param_types+ can be used to specify the exact
+      #     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
       #     definition of {Google::Spanner::V1::Type Type} for more information
       #     about SQL types.
@@ -265,12 +291,12 @@ module Google
       #     this request.
       # @!attribute [rw] key_set
       #   @return [Google::Spanner::V1::KeySet]
-      #     Required. +key_set+ identifies the rows to be yielded. +key_set+ names the
+      #     Required. `key_set` identifies the rows to be yielded. `key_set` names the
       #     primary keys of the rows in {Google::Spanner::V1::PartitionReadRequest#table table} to be yielded, unless {Google::Spanner::V1::PartitionReadRequest#index index}
       #     is present. If {Google::Spanner::V1::PartitionReadRequest#index index} is present, then {Google::Spanner::V1::PartitionReadRequest#key_set key_set} instead names
       #     index keys in {Google::Spanner::V1::PartitionReadRequest#index index}.
       #
-      #     It is not an error for the +key_set+ to name rows that do not
+      #     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.
       # @!attribute [rw] partition_options
       #   @return [Google::Spanner::V1::PartitionOptions]
@@ -319,7 +345,7 @@ module Google
       #     this request.
       # @!attribute [rw] key_set
       #   @return [Google::Spanner::V1::KeySet]
-      #     Required. +key_set+ identifies the rows to be yielded. +key_set+ names the
+      #     Required. `key_set` identifies the rows to be yielded. `key_set` names the
       #     primary keys of the rows in {Google::Spanner::V1::ReadRequest#table table} to be yielded, unless {Google::Spanner::V1::ReadRequest#index index}
       #     is present. If {Google::Spanner::V1::ReadRequest#index index} is present, then {Google::Spanner::V1::ReadRequest#key_set key_set} instead names
       #     index keys in {Google::Spanner::V1::ReadRequest#index index}.
@@ -329,17 +355,17 @@ module Google
       #     (if {Google::Spanner::V1::ReadRequest#index index} is non-empty).  If the {Google::Spanner::V1::ReadRequest#partition_token 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
+      #     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.
       # @!attribute [rw] limit
       #   @return [Integer]
-      #     If greater than zero, only the first +limit+ rows are yielded. If +limit+
+      #     If greater than zero, only the first `limit` rows are yielded. If `limit`
       #     is zero, the default is no limit. A limit cannot be specified if
-      #     +partition_token+ is set.
+      #     `partition_token` is set.
       # @!attribute [rw] resume_token
       #   @return [String]
       #     If this request is resuming a previously interrupted read,
-      #     +resume_token+ should be copied from the last
+      #     `resume_token` should be copied from the last
       #     {Google::Spanner::V1::PartialResultSet 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
@@ -373,7 +399,7 @@ module Google
       #     Execute mutations in a temporary transaction. Note that unlike
       #     commit of a previously-started transaction, commit with a
       #     temporary transaction is non-idempotent. That is, if the
-      #     +CommitRequest+ is sent to Cloud Spanner more than once (for
+      #     `CommitRequest` is sent to Cloud Spanner more than once (for
       #     instance, due to retries in the application, or in the
       #     transport library), it is possible that the mutations are
       #     executed more than once. If this is undesirable, use