google-cloud-spanner 1.0.0 → 1.1.0

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

@@ -15,24 +15,24 @@
 module Google
   module Spanner
     module V1
-      # Results from Read or
-      # ExecuteSql.
+      # Results from {Google::Spanner::V1::Spanner::Read Read} or
+      # {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql}.
       # @!attribute [rw] metadata
       #   @return [Google::Spanner::V1::ResultSetMetadata]
       #     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
-      #     Metadata::Row_type. The ith element
+      #     {Google::Spanner::V1::ResultSetMetadata#row_type metadata::row_type}. The ith element
       #     in each row matches the ith field in
-      #     Metadata::Row_type. Elements are
+      #     {Google::Spanner::V1::ResultSetMetadata#row_type metadata::row_type}. Elements are
       #     encoded based on type as described
-      #     Here.
+      #     {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
-      #     ExecuteSqlRequest#query_mode.
+      #     {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode}.
       class ResultSet; end
 
       # Partial results from a streaming read or SQL query. Streaming reads and
@@ -48,18 +48,18 @@ module Google
       #     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
-      #     Metadata::Row_type::Fields.
+      #     {Google::Spanner::V1::StructType#fields metadata::row_type::fields}.
       #
       #     Most values are encoded based on type as described
-      #     Here.
+      #     {Google::Spanner::V1::TypeCode here}.
       #
       #     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 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
+      #     * +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
@@ -68,31 +68,31 @@ module Google
       #         field name is duplicated, then apply these rules recursively
       #         to merge the field values.
       #
-      #     Some examples of merging:
+      #       Some examples of merging:
       #
-      #         # Strings are concatenated.
-      #         "foo", "bar" => "foobar"
+      #       = Strings are concatenated.
+      #       "foo", "bar" => "foobar"
       #
-      #         # Lists of non-strings are concatenated.
-      #         [2, 3], [4] => [2, 3, 4]
+      #       = Lists of non-strings are concatenated.
+      #       [2, 3], [4] => [2, 3, 4]
       #
-      #         # Lists are concatenated, but the last and first elements are merged
-      #         # because they are strings.
-      #         ["a", "b"], ["c", "d"] => ["a", "bc", "d"]
+      #       = Lists are concatenated, but the last and first elements are merged
+      #       = because they are strings.
+      #       ["a", "b"], ["c", "d"] => ["a", "bc", "d"]
       #
-      #         # Lists are concatenated, but the last and first elements are merged
-      #         # because they are lists. Recursively, the last and first elements
-      #         # of the inner lists are merged because they are strings.
-      #         ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]
+      #       = Lists are concatenated, but the last and first elements are merged
+      #       = because they are lists. Recursively, the last and first elements
+      #       = of the inner lists are merged because they are strings.
+      #       ["a", ["b", "c"]], [["d"], "e"] => ["a", ["b", "cd"], "e"]
       #
-      #         # Non-overlapping object fields are combined.
-      #         {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}
+      #       = Non-overlapping object fields are combined.
+      #       {"a": "1"}, {"b": "2"} => {"a": "1", "b": 2"}
       #
-      #         # Overlapping object fields are merged.
-      #         {"a": "1"}, {"a": "2"} => {"a": "12"}
+      #       = Overlapping object fields are merged.
+      #       {"a": "1"}, {"a": "2"} => {"a": "12"}
       #
-      #         # Examples of merging objects containing lists of strings.
-      #         {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}
+      #       = Examples of merging objects containing lists of strings.
+      #       {"a": ["1"]}, {"a": ["2"]} => {"a": ["12"]}
       #
       #     For a more complete example, suppose a streaming SQL query is
       #     yielding a result set whose rows contain a single string
@@ -119,7 +119,7 @@ module Google
       #     field value +"World" = "W" + "orl" + "d"+.
       # @!attribute [rw] chunked_value
       #   @return [true, false]
-      #     If true, then the final value in Values is chunked, and must
+      #     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
       #     to obtain a complete field value.
       # @!attribute [rw] resume_token
@@ -133,11 +133,11 @@ module Google
       #   @return [Google::Spanner::V1::ResultSetStats]
       #     Query plan and execution statistics for the query that produced this
       #     streaming result set. These can be requested by setting
-      #     ExecuteSqlRequest#query_mode and are sent
+      #     {Google::Spanner::V1::ExecuteSqlRequest#query_mode ExecuteSqlRequest#query_mode} and are sent
       #     only once with the last response in the stream.
       class PartialResultSet; end
 
-      # Metadata about a ResultSet or PartialResultSet.
+      # 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
@@ -154,10 +154,10 @@ module Google
       #     information about the new transaction is yielded here.
       class ResultSetMetadata; end
 
-      # Additional statistics about a ResultSet or PartialResultSet.
+      # Additional statistics about a {Google::Spanner::V1::ResultSet ResultSet} or {Google::Spanner::V1::PartialResultSet PartialResultSet}.
       # @!attribute [rw] query_plan
       #   @return [Google::Spanner::V1::QueryPlan]
-      #     QueryPlan for the query associated with this result.
+      #     {Google::Spanner::V1::QueryPlan QueryPlan} for the query associated with this result.
       # @!attribute [rw] query_stats
       #   @return [Google::Protobuf::Struct]
       #     Aggregated statistics from the execution of the query. Only present when

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

@@ -14,33 +14,104 @@
 
 module Google
   module Spanner
+    ##
+    # # Cloud Spanner API Contents
+    #
+    # | Class | Description |
+    # | ----- | ----------- |
+    # | [SpannerClient][] | Cloud Spanner is a managed, mission-critical, globally consistent and scalable relational database service. |
+    # | [Data Types][] | Data types for Google::Cloud::Spanner::V1 |
+    #
+    # [SpannerClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-spanner/latest/google/spanner/v1/spannerclient
+    # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-spanner/latest/google/spanner/v1/datatypes
+    #
     module V1
-      # The request for CreateSession.
+      # The request for {Google::Spanner::V1::Spanner::CreateSession CreateSession}.
       # @!attribute [rw] database
       #   @return [String]
       #     Required. The database in which the new session is created.
+      # @!attribute [rw] session
+      #   @return [Google::Spanner::V1::Session]
+      #     The session to create.
       class CreateSessionRequest; end
 
       # A session in the Cloud Spanner API.
       # @!attribute [rw] name
       #   @return [String]
-      #     Required. The name of the session.
+      #     The name of the session. This is always system-assigned; values provided
+      #     when creating a session are ignored.
+      # @!attribute [rw] labels
+      #   @return [Hash{String => String}]
+      #     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])?+.
+      #     * 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])?)?+.
+      #     * 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.
+      # @!attribute [rw] create_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The timestamp when the session is created.
+      # @!attribute [rw] approximate_last_use_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The approximate timestamp when the session is last used. It is
+      #     typically earlier than the actual last use time.
       class Session; end
 
-      # The request for GetSession.
+      # The request for {Google::Spanner::V1::Spanner::GetSession GetSession}.
       # @!attribute [rw] name
       #   @return [String]
       #     Required. The name of the session to retrieve.
       class GetSessionRequest; end
 
-      # The request for DeleteSession.
+      # The request for {Google::Spanner::V1::Spanner::ListSessions ListSessions}.
+      # @!attribute [rw] database
+      #   @return [String]
+      #     Required. The database in which to list sessions.
+      # @!attribute [rw] page_size
+      #   @return [Integer]
+      #     Number of sessions to be returned in the response. If 0 or less, defaults
+      #     to the server's maximum allowed page size.
+      # @!attribute [rw] page_token
+      #   @return [String]
+      #     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
+      #   @return [String]
+      #     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
+      #
+      #     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
+      #         the label contains the string "dev".
+      class ListSessionsRequest; end
+
+      # The response for {Google::Spanner::V1::Spanner::ListSessions ListSessions}.
+      # @!attribute [rw] sessions
+      #   @return [Array<Google::Spanner::V1::Session>]
+      #     The list of requested sessions.
+      # @!attribute [rw] next_page_token
+      #   @return [String]
+      #     +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
+
+      # The request for {Google::Spanner::V1::Spanner::DeleteSession DeleteSession}.
       # @!attribute [rw] name
       #   @return [String]
       #     Required. The name of the session to delete.
       class DeleteSessionRequest; end
 
-      # The request for ExecuteSql and
-      # ExecuteStreamingSql.
+      # The request for {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql} and
+      # {Google::Spanner::V1::Spanner::ExecuteStreamingSql ExecuteStreamingSql}.
       # @!attribute [rw] session
       #   @return [String]
       #     Required. The session in which the SQL query should be performed.
@@ -71,24 +142,24 @@ module Google
       #   @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 Params as JSON strings.
+      #     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
-      #     definition of Type for more information
+      #     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
-      #     PartialResultSet yielded before the interruption. Doing this
+      #     {Google::Spanner::V1::PartialResultSet PartialResultSet} yielded before the interruption. Doing this
       #     enables the new SQL query 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
       #   @return [Google::Spanner::V1::ExecuteSqlRequest::QueryMode]
       #     Used to control the amount of debugging information returned in
-      #     ResultSetStats.
+      #     {Google::Spanner::V1::ResultSetStats ResultSetStats}.
       class ExecuteSqlRequest
         # Mode in which the query must be processed.
         module QueryMode
@@ -106,8 +177,8 @@ module Google
         end
       end
 
-      # The request for Read and
-      # StreamingRead.
+      # The request for {Google::Spanner::V1::Spanner::Read Read} and
+      # {Google::Spanner::V1::Spanner::StreamingRead StreamingRead}.
       # @!attribute [rw] session
       #   @return [String]
       #     Required. The session in which the read should be performed.
@@ -120,22 +191,22 @@ module Google
       #     Required. The name of the table in the database to be read.
       # @!attribute [rw] index
       #   @return [String]
-      #     If non-empty, the name of an index on Table. This index is
-      #     used instead of the table primary key when interpreting Key_set
-      #     and sorting result rows. See Key_set for further information.
+      #     If non-empty, the name of an index on {Google::Spanner::V1::ReadRequest#table table}. This index is
+      #     used instead of the table primary key when interpreting {Google::Spanner::V1::ReadRequest#key_set key_set}
+      #     and sorting result rows. See {Google::Spanner::V1::ReadRequest#key_set key_set} for further information.
       # @!attribute [rw] columns
       #   @return [Array<String>]
-      #     The columns of Table to be returned for each row matching
+      #     The columns of {Google::Spanner::V1::ReadRequest#table table} to be returned for each row matching
       #     this request.
       # @!attribute [rw] key_set
       #   @return [Google::Spanner::V1::KeySet]
       #     Required. +key_set+ identifies the rows to be yielded. +key_set+ names the
-      #     primary keys of the rows in Table to be yielded, unless Index
-      #     is present. If Index is present, then Key_set instead names
-      #     index keys in Index.
+      #     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}.
       #
-      #     Rows are yielded in table primary key order (if Index is empty)
-      #     or index key order (if Index is non-empty).
+      #     Rows are yielded in table primary key order (if {Google::Spanner::V1::ReadRequest#index index} is empty)
+      #     or index key order (if {Google::Spanner::V1::ReadRequest#index index} is non-empty).
       #
       #     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.
@@ -147,13 +218,13 @@ module Google
       #   @return [String]
       #     If this request is resuming a previously interrupted read,
       #     +resume_token+ should be copied from the last
-      #     PartialResultSet yielded before the interruption. Doing this
+      #     {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
       #     that yielded this token.
       class ReadRequest; end
 
-      # The request for BeginTransaction.
+      # The request for {Google::Spanner::V1::Spanner::BeginTransaction BeginTransaction}.
       # @!attribute [rw] session
       #   @return [String]
       #     Required. The session in which the transaction runs.
@@ -162,7 +233,7 @@ module Google
       #     Required. Options for the new transaction.
       class BeginTransactionRequest; end
 
-      # The request for Commit.
+      # The request for {Google::Spanner::V1::Spanner::Commit Commit}.
       # @!attribute [rw] session
       #   @return [String]
       #     Required. The session in which the transaction to be committed is running.
@@ -178,8 +249,8 @@ module Google
       #     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
-      #     BeginTransaction and
-      #     Commit instead.
+      #     {Google::Spanner::V1::Spanner::BeginTransaction BeginTransaction} and
+      #     {Google::Spanner::V1::Spanner::Commit Commit} instead.
       # @!attribute [rw] mutations
       #   @return [Array<Google::Spanner::V1::Mutation>]
       #     The mutations to be executed when this transaction commits. All
@@ -187,13 +258,13 @@ module Google
       #     this list.
       class CommitRequest; end
 
-      # The response for Commit.
+      # The response for {Google::Spanner::V1::Spanner::Commit Commit}.
       # @!attribute [rw] commit_timestamp
       #   @return [Google::Protobuf::Timestamp]
       #     The Cloud Spanner timestamp at which the transaction committed.
       class CommitResponse; end
 
-      # The request for Rollback.
+      # The request for {Google::Spanner::V1::Spanner::Rollback Rollback}.
       # @!attribute [rw] session
       #   @return [String]
       #     Required. The session in which the transaction to roll back is running.

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

@@ -59,8 +59,8 @@ module Google
       # and cause less contention. Cloud Spanner attempts to keep read locks
       # active as long as the transaction continues to do reads, and the
       # transaction has not been terminated by
-      # Commit or
-      # Rollback.  Long periods of
+      # {Google::Spanner::V1::Spanner::Commit Commit} or
+      # {Google::Spanner::V1::Spanner::Rollback Rollback}.  Long periods of
       # inactivity at the client may cause Cloud Spanner to release a
       # transaction's locks and abort it.
       #
@@ -69,9 +69,9 @@ module Google
       # have been completed.
       # Conceptually, a read-write transaction consists of zero or more
       # reads or SQL queries followed by
-      # Commit. At any time before
-      # Commit, the client can send a
-      # Rollback request to abort the
+      # {Google::Spanner::V1::Spanner::Commit Commit}. At any time before
+      # {Google::Spanner::V1::Spanner::Commit Commit}, the client can send a
+      # {Google::Spanner::V1::Spanner::Rollback Rollback} request to abort the
       # transaction.
       #
       # === Semantics
@@ -133,8 +133,8 @@ module Google
       # need to worry about this in practice.
       #
       # Snapshot read-only transactions do not need to call
-      # Commit or
-      # Rollback (and in fact are not
+      # {Google::Spanner::V1::Spanner::Commit Commit} or
+      # {Google::Spanner::V1::Spanner::Rollback Rollback} (and in fact are not
       # permitted to do so).
       #
       # To execute a snapshot transaction, the client specifies a timestamp
@@ -142,14 +142,14 @@ module Google
       #
       # The types of timestamp bound are:
       #
-      #   - Strong (the default).
-      #   - Bounded staleness.
-      #   - Exact staleness.
+      # * Strong (the default).
+      #   * Bounded staleness.
+      #   * Exact staleness.
       #
-      # If the Cloud Spanner database to be read is geographically distributed,
-      # stale read-only transactions can execute more quickly than strong
-      # or read-write transaction, because they are able to execute far
-      # from the leader replica.
+      #   If the Cloud Spanner database to be read is geographically distributed,
+      #   stale read-only transactions can execute more quickly than strong
+      #   or read-write transaction, because they are able to execute far
+      #   from the leader replica.
       #
       # Each type of timestamp bound is discussed in detail below.
       #
@@ -167,7 +167,7 @@ module Google
       # reads should be executed within a transaction or at an exact read
       # timestamp.
       #
-      # See TransactionOptions::ReadOnly#strong.
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#strong TransactionOptions::ReadOnly#strong}.
       #
       # === Exact Staleness
       #
@@ -188,8 +188,8 @@ module Google
       # equivalent boundedly stale concurrency modes. On the other hand,
       # boundedly stale reads usually return fresher results.
       #
-      # See TransactionOptions::ReadOnly#read_timestamp and
-      # TransactionOptions::ReadOnly#exact_staleness.
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#read_timestamp TransactionOptions::ReadOnly#read_timestamp} and
+      # {Google::Spanner::V1::TransactionOptions::ReadOnly#exact_staleness TransactionOptions::ReadOnly#exact_staleness}.
       #
       # === Bounded Staleness
       #
@@ -218,8 +218,8 @@ module Google
       # which rows will be read, it can only be used with single-use
       # read-only transactions.
       #
-      # See TransactionOptions::ReadOnly#max_staleness and
-      # TransactionOptions::ReadOnly#min_read_timestamp.
+      # See {Google::Spanner::V1::TransactionOptions::ReadOnly#max_staleness TransactionOptions::ReadOnly#max_staleness} and
+      # {Google::Spanner::V1::TransactionOptions::ReadOnly#min_read_timestamp TransactionOptions::ReadOnly#min_read_timestamp}.
       #
       # === Old Read Timestamps and Garbage Collection
       #
@@ -246,10 +246,11 @@ module Google
       #     +spanner.databases.beginReadOnlyTransaction+ permission
       #     on the +session+ resource.
       class TransactionOptions
-        # Options for read-write transactions.
+        # Message type to initiate a read-write transaction. Currently this
+        # transaction type has no options.
         class ReadWrite; end
 
-        # Options for read-only transactions.
+        # Message type to initiate a read-only transaction.
         # @!attribute [rw] strong
         #   @return [true, false]
         #     Read at a timestamp where all previously committed transactions
@@ -263,6 +264,9 @@ module Google
         #     previously committed transaction whose timestamp is known.
         #
         #     Note that this option can only be used in single-use transactions.
+        #
+        #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+        #     Example: +"2014-10-02T15:01:23.045123456Z"+.
         # @!attribute [rw] max_staleness
         #   @return [Google::Protobuf::Duration]
         #     Read data at a timestamp >= +NOW - max_staleness+
@@ -289,6 +293,9 @@ module Google
         #     Useful for large scale consistent reads such as mapreduces, or
         #     for coordinating many reads against a consistent snapshot of the
         #     data.
+        #
+        #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+        #     Example: +"2014-10-02T15:01:23.045123456Z"+.
         # @!attribute [rw] exact_staleness
         #   @return [Google::Protobuf::Duration]
         #     Executes all reads at a timestamp that is +exact_staleness+
@@ -305,7 +312,7 @@ module Google
         # @!attribute [rw] return_read_timestamp
         #   @return [true, false]
         #     If true, the Cloud Spanner-selected read timestamp is included in
-        #     the Transaction message that describes the transaction.
+        #     the {Google::Spanner::V1::Transaction Transaction} message that describes the transaction.
         class ReadOnly; end
       end
 
@@ -313,10 +320,10 @@ module Google
       # @!attribute [rw] id
       #   @return [String]
       #     +id+ may be used to identify the transaction in subsequent
-      #     Read,
-      #     ExecuteSql,
-      #     Commit, or
-      #     Rollback calls.
+      #     {Google::Spanner::V1::Spanner::Read Read},
+      #     {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql},
+      #     {Google::Spanner::V1::Spanner::Commit Commit}, or
+      #     {Google::Spanner::V1::Spanner::Rollback Rollback} calls.
       #
       #     Single-use read-only transactions do not have IDs, because
       #     single-use transactions do not support multiple requests.
@@ -324,14 +331,17 @@ module Google
       #   @return [Google::Protobuf::Timestamp]
       #     For snapshot read-only transactions, the read timestamp chosen
       #     for the transaction. Not returned by default: see
-      #     TransactionOptions::ReadOnly#return_read_timestamp.
+      #     {Google::Spanner::V1::TransactionOptions::ReadOnly#return_read_timestamp TransactionOptions::ReadOnly#return_read_timestamp}.
+      #
+      #     A timestamp in RFC3339 UTC \"Zulu\" format, accurate to nanoseconds.
+      #     Example: +"2014-10-02T15:01:23.045123456Z"+.
       class Transaction; end
 
       # This message is used to select the transaction in which a
-      # Read or
-      # ExecuteSql call runs.
+      # {Google::Spanner::V1::Spanner::Read Read} or
+      # {Google::Spanner::V1::Spanner::ExecuteSql ExecuteSql} call runs.
       #
-      # See TransactionOptions for more information about transactions.
+      # See {Google::Spanner::V1::TransactionOptions TransactionOptions} for more information about transactions.
       # @!attribute [rw] single_use
       #   @return [Google::Spanner::V1::TransactionOptions]
       #     Execute the read or SQL query in a temporary transaction.
@@ -344,7 +354,7 @@ module Google
       #   @return [Google::Spanner::V1::TransactionOptions]
       #     Begin a new transaction and execute this read or SQL query in
       #     it. The transaction ID of the new transaction is returned in
-      #     ResultSetMetadata#transaction, which is a Transaction.
+      #     {Google::Spanner::V1::ResultSetMetadata#transaction ResultSetMetadata#transaction}, which is a {Google::Spanner::V1::Transaction Transaction}.
       class TransactionSelector; end
     end
   end