REST Resource: projects.instances.databases.sessions

Resource: Session

A session in the Cloud Spanner API.

JSON representation 
{
  "name": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "approximateLastUseTime": string,
  "creatorRole": string,
  "multiplexed": boolean
}
Fields
name

string

Output only. The name of the session. This is always system-assigned.
labels

map (key: string, value: 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]([-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]([-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.
createTime

string (Timestamp format)

Output only. The timestamp when the session is created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
approximateLastUseTime

string (Timestamp format)

Output only. The approximate timestamp when the session is last used. It is typically earlier than the actual last use time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
creatorRole

string

The database role which created this session.
multiplexed

boolean

Optional. If true, specifies a multiplexed session. Use a multiplexed session for multiple, concurrent read-only operations. Don't use them for read-write transactions, partitioned reads, or partitioned queries. Use sessions.create to create multiplexed sessions. Don't use sessions.batchCreate to create a multiplexed session. You can't delete or list multiplexed sessions.

Methods

batchCreate

 Creates multiple new sessions.

batchWrite

 Batches the supplied mutation groups in a collection of efficient transactions.

beginTransaction

 Begins a new transaction.

commit

 Commits a transaction.

create

 Creates a new session.

delete

 Ends a session, releasing server resources associated with it.

executeBatchDml

 Executes a batch of SQL DML statements.

executeSql

 Executes an SQL statement, returning all results in a single reply.

executeStreamingSql

 Like ExecuteSql, except returns the result set as a stream.

get

 Gets a session.

list

 Lists all sessions in a given database.

partitionQuery

 Creates a set of partition tokens that can be used to execute a query operation in parallel.

partitionRead

 Creates a set of partition tokens that can be used to execute a read operation in parallel.

read

 Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ExecuteSql.

rollback

 Rolls back a transaction, releasing any locks it holds.

streamingRead

 Like Read, except returns the result set as a stream.