Class ReadSession (2.13.2)

ReadSession(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Information about the ReadSession.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof:


name str
Output only. Unique identifier for the session, in the form ``projects/{project_id}/locations/{location}/sessions/{session_id}``.
expire_time google.protobuf.timestamp_pb2.Timestamp
Output only. Time at which the session becomes invalid. After this time, subsequent requests to read this Session will return errors. The expire_time is automatically assigned and currently cannot be specified or updated.
Immutable. Data format of the output data.
Output only. Avro schema. This field is a member of `oneof`_ ``schema``.
Output only. Arrow schema. This field is a member of `oneof`_ ``schema``.
table str
Immutable. Table that this ReadSession is reading from, in the form ``projects/{project_id}/datasets/{dataset_id}/tables/{table_id}``
Optional. Any modifiers which are applied when reading from the specified table.
Optional. Read options for this session (e.g. column selection, filters).
streams Sequence[]
Output only. A list of streams created with the session. At least one stream is created with the session. In the future, larger request_stream_count values *may* result in this list being unpopulated, in that case, the user will need to use a List method to get the streams instead, which is not yet available.
estimated_total_bytes_scanned int
Output only. An estimate on the number of bytes this session will scan when all streams are completely consumed. This estimate is based on metadata from the table which might be incomplete or stale.
trace_id str
Optional. ID set by client to annotate a session identity. This does not need to be strictly unique, but instead the same ID should be used to group logically connected sessions (e.g. All using the same ID for all sessions needed to complete a Spark SQL query is reasonable). Maximum length is 256 bytes.


builtins.object > proto.message.Message > ReadSession



TableModifiers(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Additional attributes when reading a table.


TableReadOptions(mapping=None, *, ignore_unknown_fields=False, **kwargs)