final case class ReadRequest(session: String = "", transaction: Option[TransactionSelector] = _root_.scala.None, table: String = "", index: String = "", columns: Seq[String] = _root_.scala.Seq.empty, keySet: Option[KeySet] = _root_.scala.None, limit: Long = 0L, resumeToken: ByteString = ..., partitionToken: ByteString = ..., unknownFields: UnknownFieldSet = ...) extends GeneratedMessage with Updatable[ReadRequest] with Product with Serializable
The request for [Read][google.spanner.v1.Spanner.Read] and [StreamingRead][google.spanner.v1.Spanner.StreamingRead].
- session
Required. The session in which the read should be performed.
- transaction
The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
- table
Required. The name of the table in the database to be read.
- index
If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set] and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
- columns
Required. The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
- keySet
Required.
key_setidentifies the rows to be yielded.key_setnames the primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names index keys in [index][google.spanner.v1.ReadRequest.index]. If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is empty, rows are yielded in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty) or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is not empty, rows will be yielded in an unspecified order. It is not an error for thekey_setto name rows that do not exist in the database. Read yields nothing for nonexistent rows.- limit
If greater than zero, only the first
limitrows are yielded. Iflimitis zero, the default is no limit. A limit cannot be specified ifpartition_tokenis set.- resumeToken
If this request is resuming a previously interrupted read,
resume_tokenshould be copied from the last [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this enables the new read to resume where the last read left off. The rest of the request parameters must exactly match the request that yielded this token.- partitionToken
If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.
- Annotations
- @SerialVersionUID()
- Alphabetic
- By Inheritance
- ReadRequest
- Product
- Equals
- Updatable
- GeneratedMessage
- Serializable
- Serializable
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Instance Constructors
-
new
ReadRequest(session: String = "", transaction: Option[TransactionSelector] = _root_.scala.None, table: String = "", index: String = "", columns: Seq[String] = _root_.scala.Seq.empty, keySet: Option[KeySet] = _root_.scala.None, limit: Long = 0L, resumeToken: ByteString = ..., partitionToken: ByteString = ..., unknownFields: UnknownFieldSet = ...)
- session
Required. The session in which the read should be performed.
- transaction
The transaction to use. If none is provided, the default is a temporary read-only transaction with strong concurrency.
- table
Required. The name of the table in the database to be read.
- index
If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set] and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
- columns
Required. The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching this request.
- keySet
Required.
key_setidentifies the rows to be yielded.key_setnames the primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names index keys in [index][google.spanner.v1.ReadRequest.index]. If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is empty, rows are yielded in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty) or index key order (if [index][google.spanner.v1.ReadRequest.index] is non-empty). If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is not empty, rows will be yielded in an unspecified order. It is not an error for thekey_setto name rows that do not exist in the database. Read yields nothing for nonexistent rows.- limit
If greater than zero, only the first
limitrows are yielded. Iflimitis zero, the default is no limit. A limit cannot be specified ifpartition_tokenis set.- resumeToken
If this request is resuming a previously interrupted read,
resume_tokenshould be copied from the last [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this enables the new read to resume where the last read left off. The rest of the request parameters must exactly match the request that yielded this token.- partitionToken
If present, results will be restricted to the specified partition previously created using PartitionRead(). There must be an exact match for the values of fields common to this message and the PartitionReadRequest message used to create this partition_token.
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- def addAllColumns(__vs: Iterable[String]): ReadRequest
- def addColumns(__vs: String*): ReadRequest
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clearColumns: ReadRequest
- def clearKeySet: ReadRequest
- def clearTransaction: ReadRequest
-
def
clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
- val columns: Seq[String]
-
def
companion: ReadRequest.type
- Definition Classes
- ReadRequest → GeneratedMessage
- def discardUnknownFields: ReadRequest
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
-
def
getField(__field: FieldDescriptor): PValue
- Definition Classes
- ReadRequest → GeneratedMessage
-
def
getFieldByNumber(__fieldNumber: Int): Any
- Definition Classes
- ReadRequest → GeneratedMessage
- def getKeySet: KeySet
- def getTransaction: TransactionSelector
- val index: String
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- val keySet: Option[KeySet]
- val limit: Long
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- val partitionToken: ByteString
- val resumeToken: ByteString
-
def
serializedSize: Int
- Definition Classes
- ReadRequest → GeneratedMessage
- val session: String
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
- val table: String
-
final
def
toByteArray: Array[Byte]
- Definition Classes
- GeneratedMessage
-
final
def
toByteString: ByteString
- Definition Classes
- GeneratedMessage
-
final
def
toPMessage: PMessage
- Definition Classes
- GeneratedMessage
-
def
toProtoString: String
- Definition Classes
- ReadRequest → GeneratedMessage
- val transaction: Option[TransactionSelector]
- val unknownFields: UnknownFieldSet
-
def
update(ms: (Lens[ReadRequest, ReadRequest]) ⇒ scalapb.lenses.Mutation[ReadRequest]*): ReadRequest
- Definition Classes
- Updatable
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
- def withColumns(__v: Seq[String]): ReadRequest
- def withIndex(__v: String): ReadRequest
- def withKeySet(__v: KeySet): ReadRequest
- def withLimit(__v: Long): ReadRequest
- def withPartitionToken(__v: ByteString): ReadRequest
- def withResumeToken(__v: ByteString): ReadRequest
- def withSession(__v: String): ReadRequest
- def withTable(__v: String): ReadRequest
- def withTransaction(__v: TransactionSelector): ReadRequest
- def withUnknownFields(__v: UnknownFieldSet): ReadRequest
-
final
def
writeDelimitedTo(output: OutputStream): Unit
- Definition Classes
- GeneratedMessage
-
def
writeTo(_output__: CodedOutputStream): Unit
- Definition Classes
- ReadRequest → GeneratedMessage
-
final
def
writeTo(output: OutputStream): Unit
- Definition Classes
- GeneratedMessage