Resource: Session
A session in the Cloud Spanner API.
JSON representation |
---|
{ "name" : string , "labels" : { string : string , ... } , "createTime" : string , "approximateLastUseTime" : string , "creatorRole" : string , "multiplexed" : boolean } |
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 |
|
---|---|
|
Creates multiple new sessions. |
|
Batches the supplied mutation groups in a collection of efficient transactions. |
|
Begins a new transaction. |
|
Commits a transaction. |
|
Creates a new session. |
|
Ends a session, releasing server resources associated with it. |
|
Executes a batch of SQL DML statements. |
|
Executes an SQL statement, returning all results in a single reply. |
|
Like ExecuteSql
, except returns the result set as a stream. |
|
Gets a session. |
|
Lists all sessions in a given database. |
|
Creates a set of partition tokens that can be used to execute a query operation in parallel. |
|
Creates a set of partition tokens that can be used to execute a read operation in parallel. |
|
Reads rows from the database using key lookups and scans, as a simple key/value style alternative to ExecuteSql
. |
|
Rolls back a transaction, releasing any locks it holds. |
|
Like Read
, except returns the result set as a stream. |