public static final class KeyRange.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder> implements KeyRangeOrBuilder
KeyRange represents a range of rows in a table or index.
A range has a start key and an end key. These keys can be open or
closed, indicating if the range includes rows with that key.
Keys are represented by lists, where the ith value in the list
corresponds to the ith component of the table or index primary key.
Individual values are encoded as described [here][google.spanner.v1.TypeCode].
For example, consider the following table definition:
CREATE TABLE UserEvents (
UserName STRING(MAX),
EventDate STRING(10)
) PRIMARY KEY(UserName, EventDate);
The following keys name rows in this table:
["Bob", "2014-09-23"]
["Alfred", "2015-06-12"]
Since the `UserEvents` table's `PRIMARY KEY` clause names two
columns, each `UserEvents` key has two elements; the first is the
`UserName`, and the second is the `EventDate`.
Key ranges with multiple components are interpreted
lexicographically by component using the table or index key's declared
sort order. For example, the following range returns all events for
user `"Bob"` that occurred in the year 2015:
"start_closed": ["Bob", "2015-01-01"]
"end_closed": ["Bob", "2015-12-31"]
Start and end keys can omit trailing key components. This affects the
inclusion and exclusion of rows that exactly match the provided key
components: if the key is closed, then rows that exactly match the
provided components are included; if the key is open, then rows
that exactly match are not included.
For example, the following range includes all events for `"Bob"` that
occurred during and after the year 2000:
"start_closed": ["Bob", "2000-01-01"]
"end_closed": ["Bob"]
The next example retrieves all events for `"Bob"`:
"start_closed": ["Bob"]
"end_closed": ["Bob"]
To retrieve events before the year 2000:
"start_closed": ["Bob"]
"end_open": ["Bob", "2000-01-01"]
The following range includes all rows in the table:
"start_closed": []
"end_closed": []
This range returns all users whose `UserName` begins with any
character from A to C:
"start_closed": ["A"]
"end_open": ["D"]
This range returns all users whose `UserName` begins with B:
"start_closed": ["B"]
"end_open": ["C"]
Key ranges honor column sort order. For example, suppose a table is
defined as follows:
CREATE TABLE DescendingSortedTable {
Key INT64,
...
) PRIMARY KEY(Key DESC);
The following range retrieves all rows with key values between 1
and 100 inclusive:
"start_closed": ["100"]
"end_closed": ["1"]
Note that 100 is passed as the start, and 1 is passed as the end,
because `Key` is a descending column in the schema.
Protobuf type google.spanner.v1.KeyRange| Modifier and Type | Method and Description |
|---|---|
KeyRange.Builder |
addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
KeyRange |
build() |
KeyRange |
buildPartial() |
KeyRange.Builder |
clear() |
KeyRange.Builder |
clearEndClosed()
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
KeyRange.Builder |
clearEndKeyType() |
KeyRange.Builder |
clearEndOpen()
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
KeyRange.Builder |
clearField(com.google.protobuf.Descriptors.FieldDescriptor field) |
KeyRange.Builder |
clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) |
KeyRange.Builder |
clearStartClosed()
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
KeyRange.Builder |
clearStartKeyType() |
KeyRange.Builder |
clearStartOpen()
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
KeyRange.Builder |
clone() |
KeyRange |
getDefaultInstanceForType() |
static com.google.protobuf.Descriptors.Descriptor |
getDescriptor() |
com.google.protobuf.Descriptors.Descriptor |
getDescriptorForType() |
com.google.protobuf.ListValue |
getEndClosed()
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
com.google.protobuf.ListValue.Builder |
getEndClosedBuilder()
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
com.google.protobuf.ListValueOrBuilder |
getEndClosedOrBuilder()
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
KeyRange.EndKeyTypeCase |
getEndKeyTypeCase() |
com.google.protobuf.ListValue |
getEndOpen()
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
com.google.protobuf.ListValue.Builder |
getEndOpenBuilder()
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
com.google.protobuf.ListValueOrBuilder |
getEndOpenOrBuilder()
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
com.google.protobuf.ListValue |
getStartClosed()
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
com.google.protobuf.ListValue.Builder |
getStartClosedBuilder()
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
com.google.protobuf.ListValueOrBuilder |
getStartClosedOrBuilder()
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
KeyRange.StartKeyTypeCase |
getStartKeyTypeCase() |
com.google.protobuf.ListValue |
getStartOpen()
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
com.google.protobuf.ListValue.Builder |
getStartOpenBuilder()
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
com.google.protobuf.ListValueOrBuilder |
getStartOpenOrBuilder()
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
boolean |
hasEndClosed()
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
boolean |
hasEndOpen()
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
boolean |
hasStartClosed()
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
boolean |
hasStartOpen()
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable |
internalGetFieldAccessorTable() |
boolean |
isInitialized() |
KeyRange.Builder |
mergeEndClosed(com.google.protobuf.ListValue value)
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
KeyRange.Builder |
mergeEndOpen(com.google.protobuf.ListValue value)
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
KeyRange.Builder |
mergeFrom(com.google.protobuf.CodedInputStream input,
com.google.protobuf.ExtensionRegistryLite extensionRegistry) |
KeyRange.Builder |
mergeFrom(KeyRange other) |
KeyRange.Builder |
mergeFrom(com.google.protobuf.Message other) |
KeyRange.Builder |
mergeStartClosed(com.google.protobuf.ListValue value)
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
KeyRange.Builder |
mergeStartOpen(com.google.protobuf.ListValue value)
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
KeyRange.Builder |
mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
KeyRange.Builder |
setEndClosed(com.google.protobuf.ListValue.Builder builderForValue)
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
KeyRange.Builder |
setEndClosed(com.google.protobuf.ListValue value)
If the end is closed, then the range includes all rows whose
first `len(end_closed)` key columns exactly match `end_closed`.
|
KeyRange.Builder |
setEndOpen(com.google.protobuf.ListValue.Builder builderForValue)
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
KeyRange.Builder |
setEndOpen(com.google.protobuf.ListValue value)
If the end is open, then the range excludes rows whose first
`len(end_open)` key columns exactly match `end_open`.
|
KeyRange.Builder |
setField(com.google.protobuf.Descriptors.FieldDescriptor field,
Object value) |
KeyRange.Builder |
setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
int index,
Object value) |
KeyRange.Builder |
setStartClosed(com.google.protobuf.ListValue.Builder builderForValue)
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
KeyRange.Builder |
setStartClosed(com.google.protobuf.ListValue value)
If the start is closed, then the range includes all rows whose
first `len(start_closed)` key columns exactly match `start_closed`.
|
KeyRange.Builder |
setStartOpen(com.google.protobuf.ListValue.Builder builderForValue)
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
KeyRange.Builder |
setStartOpen(com.google.protobuf.ListValue value)
If the start is open, then the range excludes rows whose first
`len(start_open)` key columns exactly match `start_open`.
|
KeyRange.Builder |
setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields) |
getAllFields, getField, getFieldBuilder, getOneofFieldDescriptor, getParentForChildren, getRepeatedField, getRepeatedFieldBuilder, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMutableMapField, isClean, markClean, newBuilderForField, onBuilt, onChanged, setUnknownFieldsProto3findInitializationErrors, getInitializationErrorString, internalMergeFrom, mergeDelimitedFrom, mergeDelimitedFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, newUninitializedMessageException, toStringaddAll, addAll, mergeFrom, newUninitializedMessageExceptionequals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitpublic static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder clear()
clear in interface com.google.protobuf.Message.Builderclear in interface com.google.protobuf.MessageLite.Builderclear in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
getDescriptorForType in interface com.google.protobuf.Message.BuildergetDescriptorForType in interface com.google.protobuf.MessageOrBuildergetDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange getDefaultInstanceForType()
getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuildergetDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilderpublic KeyRange build()
build in interface com.google.protobuf.Message.Builderbuild in interface com.google.protobuf.MessageLite.Builderpublic KeyRange buildPartial()
buildPartial in interface com.google.protobuf.Message.BuilderbuildPartial in interface com.google.protobuf.MessageLite.Builderpublic KeyRange.Builder clone()
clone in interface com.google.protobuf.Message.Builderclone in interface com.google.protobuf.MessageLite.Builderclone in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
setField in interface com.google.protobuf.Message.BuildersetField in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
clearField in interface com.google.protobuf.Message.BuilderclearField in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
clearOneof in interface com.google.protobuf.Message.BuilderclearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
setRepeatedField in interface com.google.protobuf.Message.BuildersetRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
addRepeatedField in interface com.google.protobuf.Message.BuilderaddRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder mergeFrom(com.google.protobuf.Message other)
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<KeyRange.Builder>public KeyRange.Builder mergeFrom(KeyRange other)
public final boolean isInitialized()
isInitialized in interface com.google.protobuf.MessageLiteOrBuilderisInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public KeyRange.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
mergeFrom in interface com.google.protobuf.Message.BuildermergeFrom in interface com.google.protobuf.MessageLite.BuildermergeFrom in class com.google.protobuf.AbstractMessage.Builder<KeyRange.Builder>IOExceptionpublic KeyRange.StartKeyTypeCase getStartKeyTypeCase()
getStartKeyTypeCase in interface KeyRangeOrBuilderpublic KeyRange.Builder clearStartKeyType()
public KeyRange.EndKeyTypeCase getEndKeyTypeCase()
getEndKeyTypeCase in interface KeyRangeOrBuilderpublic KeyRange.Builder clearEndKeyType()
public boolean hasStartClosed()
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;hasStartClosed in interface KeyRangeOrBuilderpublic com.google.protobuf.ListValue getStartClosed()
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;getStartClosed in interface KeyRangeOrBuilderpublic KeyRange.Builder setStartClosed(com.google.protobuf.ListValue value)
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;public KeyRange.Builder setStartClosed(com.google.protobuf.ListValue.Builder builderForValue)
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;public KeyRange.Builder mergeStartClosed(com.google.protobuf.ListValue value)
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;public KeyRange.Builder clearStartClosed()
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;public com.google.protobuf.ListValue.Builder getStartClosedBuilder()
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;public com.google.protobuf.ListValueOrBuilder getStartClosedOrBuilder()
If the start is closed, then the range includes all rows whose first `len(start_closed)` key columns exactly match `start_closed`.
.google.protobuf.ListValue start_closed = 1;getStartClosedOrBuilder in interface KeyRangeOrBuilderpublic boolean hasStartOpen()
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;hasStartOpen in interface KeyRangeOrBuilderpublic com.google.protobuf.ListValue getStartOpen()
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;getStartOpen in interface KeyRangeOrBuilderpublic KeyRange.Builder setStartOpen(com.google.protobuf.ListValue value)
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;public KeyRange.Builder setStartOpen(com.google.protobuf.ListValue.Builder builderForValue)
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;public KeyRange.Builder mergeStartOpen(com.google.protobuf.ListValue value)
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;public KeyRange.Builder clearStartOpen()
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;public com.google.protobuf.ListValue.Builder getStartOpenBuilder()
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;public com.google.protobuf.ListValueOrBuilder getStartOpenOrBuilder()
If the start is open, then the range excludes rows whose first `len(start_open)` key columns exactly match `start_open`.
.google.protobuf.ListValue start_open = 2;getStartOpenOrBuilder in interface KeyRangeOrBuilderpublic boolean hasEndClosed()
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;hasEndClosed in interface KeyRangeOrBuilderpublic com.google.protobuf.ListValue getEndClosed()
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;getEndClosed in interface KeyRangeOrBuilderpublic KeyRange.Builder setEndClosed(com.google.protobuf.ListValue value)
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;public KeyRange.Builder setEndClosed(com.google.protobuf.ListValue.Builder builderForValue)
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;public KeyRange.Builder mergeEndClosed(com.google.protobuf.ListValue value)
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;public KeyRange.Builder clearEndClosed()
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;public com.google.protobuf.ListValue.Builder getEndClosedBuilder()
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;public com.google.protobuf.ListValueOrBuilder getEndClosedOrBuilder()
If the end is closed, then the range includes all rows whose first `len(end_closed)` key columns exactly match `end_closed`.
.google.protobuf.ListValue end_closed = 3;getEndClosedOrBuilder in interface KeyRangeOrBuilderpublic boolean hasEndOpen()
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;hasEndOpen in interface KeyRangeOrBuilderpublic com.google.protobuf.ListValue getEndOpen()
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;getEndOpen in interface KeyRangeOrBuilderpublic KeyRange.Builder setEndOpen(com.google.protobuf.ListValue value)
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;public KeyRange.Builder setEndOpen(com.google.protobuf.ListValue.Builder builderForValue)
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;public KeyRange.Builder mergeEndOpen(com.google.protobuf.ListValue value)
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;public KeyRange.Builder clearEndOpen()
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;public com.google.protobuf.ListValue.Builder getEndOpenBuilder()
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;public com.google.protobuf.ListValueOrBuilder getEndOpenOrBuilder()
If the end is open, then the range excludes rows whose first `len(end_open)` key columns exactly match `end_open`.
.google.protobuf.ListValue end_open = 4;getEndOpenOrBuilder in interface KeyRangeOrBuilderpublic final KeyRange.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
setUnknownFields in interface com.google.protobuf.Message.BuildersetUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>public final KeyRange.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
mergeUnknownFields in interface com.google.protobuf.Message.BuildermergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<KeyRange.Builder>Copyright © 2019 Google LLC. All rights reserved.