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.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
or "2014-10-02T15:01:23+05:30"
.
approximateLastUseTime
string (
Timestamp
format)
Output only. The approximate timestamp when the session is last used. It's typically earlier than the actual last use time.
Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
or "2014-10-02T15:01:23+05:30"
.
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
to create multiplexed sessions. Don't use sessions.create
sessions.batchCreate
to create a multiplexed session. You can't delete or list multiplexed sessions.
Methods |
|
|---|---|
|
Handles a single message from the client and returns the result as a stream. |
|
Creates a new session to be used for requests made by the adapter. |
|
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. |
