Class TransactionOptions.ReadOnly (6.69.0)

public static final class TransactionOptions.ReadOnly extends GeneratedMessageV3 implements TransactionOptions.ReadOnlyOrBuilder

Message type to initiate a read-only transaction.

Protobuf type google.spanner.v1.TransactionOptions.ReadOnly

Static Fields

EXACT_STALENESS_FIELD_NUMBER

public static final int EXACT_STALENESS_FIELD_NUMBER
Field Value
Type Description
int

MAX_STALENESS_FIELD_NUMBER

public static final int MAX_STALENESS_FIELD_NUMBER
Field Value
Type Description
int

MIN_READ_TIMESTAMP_FIELD_NUMBER

public static final int MIN_READ_TIMESTAMP_FIELD_NUMBER
Field Value
Type Description
int

READ_TIMESTAMP_FIELD_NUMBER

public static final int READ_TIMESTAMP_FIELD_NUMBER
Field Value
Type Description
int

RETURN_READ_TIMESTAMP_FIELD_NUMBER

public static final int RETURN_READ_TIMESTAMP_FIELD_NUMBER
Field Value
Type Description
int

STRONG_FIELD_NUMBER

public static final int STRONG_FIELD_NUMBER
Field Value
Type Description
int

Static Methods

getDefaultInstance()

public static TransactionOptions.ReadOnly getDefaultInstance()
Returns
Type Description
TransactionOptions.ReadOnly

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

newBuilder()

public static TransactionOptions.ReadOnly.Builder newBuilder()
Returns
Type Description
TransactionOptions.ReadOnly.Builder

newBuilder(TransactionOptions.ReadOnly prototype)

public static TransactionOptions.ReadOnly.Builder newBuilder(TransactionOptions.ReadOnly prototype)
Parameter
Name Description
prototype TransactionOptions.ReadOnly
Returns
Type Description
TransactionOptions.ReadOnly.Builder

parseDelimitedFrom(InputStream input)

public static TransactionOptions.ReadOnly parseDelimitedFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseFrom(byte[] data)

public static TransactionOptions.ReadOnly parseFrom(byte[] data)
Parameter
Name Description
data byte[]
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data byte[]
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static TransactionOptions.ReadOnly parseFrom(ByteString data)
Parameter
Name Description
data ByteString
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteString
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static TransactionOptions.ReadOnly parseFrom(CodedInputStream input)
Parameter
Name Description
input CodedInputStream
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseFrom(InputStream input)

public static TransactionOptions.ReadOnly parseFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
IOException

parseFrom(ByteBuffer data)

public static TransactionOptions.ReadOnly parseFrom(ByteBuffer data)
Parameter
Name Description
data ByteBuffer
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static TransactionOptions.ReadOnly parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteBuffer
extensionRegistry ExtensionRegistryLite
Returns
Type Description
TransactionOptions.ReadOnly
Exceptions
Type Description
InvalidProtocolBufferException

parser()

public static Parser<TransactionOptions.ReadOnly> parser()
Returns
Type Description
Parser<ReadOnly>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
boolean
Overrides

getDefaultInstanceForType()

public TransactionOptions.ReadOnly getDefaultInstanceForType()
Returns
Type Description
TransactionOptions.ReadOnly

getExactStaleness()

public Duration getExactStaleness()

Executes all reads at a timestamp that is exact_staleness old. The timestamp is chosen soon after the read is started.

Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading at nearby replicas without the distributed timestamp negotiation overhead of max_staleness.

.google.protobuf.Duration exact_staleness = 5;

Returns
Type Description
Duration

The exactStaleness.

getExactStalenessOrBuilder()

public DurationOrBuilder getExactStalenessOrBuilder()

Executes all reads at a timestamp that is exact_staleness old. The timestamp is chosen soon after the read is started.

Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading at nearby replicas without the distributed timestamp negotiation overhead of max_staleness.

.google.protobuf.Duration exact_staleness = 5;

Returns
Type Description
DurationOrBuilder

getMaxStaleness()

public Duration getMaxStaleness()

Read data at a timestamp >= NOW - max_staleness seconds. Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading the freshest data available at a nearby replica, while bounding the possible staleness if the local replica has fallen behind.

Note that this option can only be used in single-use transactions.

.google.protobuf.Duration max_staleness = 3;

Returns
Type Description
Duration

The maxStaleness.

getMaxStalenessOrBuilder()

public DurationOrBuilder getMaxStalenessOrBuilder()

Read data at a timestamp >= NOW - max_staleness seconds. Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading the freshest data available at a nearby replica, while bounding the possible staleness if the local replica has fallen behind.

Note that this option can only be used in single-use transactions.

.google.protobuf.Duration max_staleness = 3;

Returns
Type Description
DurationOrBuilder

getMinReadTimestamp()

public Timestamp getMinReadTimestamp()

Executes all reads at a timestamp >= min_read_timestamp.

This is useful for requesting fresher data than some previous read, or data that is fresh enough to observe the effects of some 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".

.google.protobuf.Timestamp min_read_timestamp = 2;

Returns
Type Description
Timestamp

The minReadTimestamp.

getMinReadTimestampOrBuilder()

public TimestampOrBuilder getMinReadTimestampOrBuilder()

Executes all reads at a timestamp >= min_read_timestamp.

This is useful for requesting fresher data than some previous read, or data that is fresh enough to observe the effects of some 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".

.google.protobuf.Timestamp min_read_timestamp = 2;

Returns
Type Description
TimestampOrBuilder

getParserForType()

public Parser<TransactionOptions.ReadOnly> getParserForType()
Returns
Type Description
Parser<ReadOnly>
Overrides

getReadTimestamp()

public Timestamp getReadTimestamp()

Executes all reads at the given timestamp. Unlike other modes, reads at a specific timestamp are repeatable; the same read at the same timestamp always returns the same data. If the timestamp is in the future, the read will block until the specified timestamp, modulo the read's deadline.

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".

.google.protobuf.Timestamp read_timestamp = 4;

Returns
Type Description
Timestamp

The readTimestamp.

getReadTimestampOrBuilder()

public TimestampOrBuilder getReadTimestampOrBuilder()

Executes all reads at the given timestamp. Unlike other modes, reads at a specific timestamp are repeatable; the same read at the same timestamp always returns the same data. If the timestamp is in the future, the read will block until the specified timestamp, modulo the read's deadline.

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".

.google.protobuf.Timestamp read_timestamp = 4;

Returns
Type Description
TimestampOrBuilder

getReturnReadTimestamp()

public boolean getReturnReadTimestamp()

If true, the Cloud Spanner-selected read timestamp is included in the Transaction message that describes the transaction.

bool return_read_timestamp = 6;

Returns
Type Description
boolean

The returnReadTimestamp.

getSerializedSize()

public int getSerializedSize()
Returns
Type Description
int
Overrides

getStrong()

public boolean getStrong()

Read at a timestamp where all previously committed transactions are visible.

bool strong = 1;

Returns
Type Description
boolean

The strong.

getTimestampBoundCase()

public TransactionOptions.ReadOnly.TimestampBoundCase getTimestampBoundCase()
Returns
Type Description
TransactionOptions.ReadOnly.TimestampBoundCase

hasExactStaleness()

public boolean hasExactStaleness()

Executes all reads at a timestamp that is exact_staleness old. The timestamp is chosen soon after the read is started.

Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading at nearby replicas without the distributed timestamp negotiation overhead of max_staleness.

.google.protobuf.Duration exact_staleness = 5;

Returns
Type Description
boolean

Whether the exactStaleness field is set.

hasMaxStaleness()

public boolean hasMaxStaleness()

Read data at a timestamp >= NOW - max_staleness seconds. Guarantees that all writes that have committed more than the specified number of seconds ago are visible. Because Cloud Spanner chooses the exact timestamp, this mode works even if the client's local clock is substantially skewed from Cloud Spanner commit timestamps.

Useful for reading the freshest data available at a nearby replica, while bounding the possible staleness if the local replica has fallen behind.

Note that this option can only be used in single-use transactions.

.google.protobuf.Duration max_staleness = 3;

Returns
Type Description
boolean

Whether the maxStaleness field is set.

hasMinReadTimestamp()

public boolean hasMinReadTimestamp()

Executes all reads at a timestamp >= min_read_timestamp.

This is useful for requesting fresher data than some previous read, or data that is fresh enough to observe the effects of some 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".

.google.protobuf.Timestamp min_read_timestamp = 2;

Returns
Type Description
boolean

Whether the minReadTimestamp field is set.

hasReadTimestamp()

public boolean hasReadTimestamp()

Executes all reads at the given timestamp. Unlike other modes, reads at a specific timestamp are repeatable; the same read at the same timestamp always returns the same data. If the timestamp is in the future, the read will block until the specified timestamp, modulo the read's deadline.

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".

.google.protobuf.Timestamp read_timestamp = 4;

Returns
Type Description
boolean

Whether the readTimestamp field is set.

hasStrong()

public boolean hasStrong()

Read at a timestamp where all previously committed transactions are visible.

bool strong = 1;

Returns
Type Description
boolean

Whether the strong field is set.

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

newBuilderForType()

public TransactionOptions.ReadOnly.Builder newBuilderForType()
Returns
Type Description
TransactionOptions.ReadOnly.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected TransactionOptions.ReadOnly.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Name Description
parent BuilderParent
Returns
Type Description
TransactionOptions.ReadOnly.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Name Description
unused UnusedPrivateParameter
Returns
Type Description
Object
Overrides

toBuilder()

public TransactionOptions.ReadOnly.Builder toBuilder()
Returns
Type Description
TransactionOptions.ReadOnly.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
Name Description
output CodedOutputStream
Overrides
Exceptions
Type Description
IOException