public static final class StructuredQuery.Builder extends GeneratedMessageV3.Builder<StructuredQuery.Builder> implements StructuredQueryOrBuilder
A Firestore query.
The query stages are executed in the following order:
- from
- where
- select
- order_by + start_at + end_at
- offset
- limit
Protobuf type google.firestore.v1.StructuredQuery
Inheritance
Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > StructuredQuery.BuilderImplements
StructuredQueryOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns | |
---|---|
Type | Description |
Descriptor |
Methods
addAllFrom(Iterable<? extends StructuredQuery.CollectionSelector> values)
public StructuredQuery.Builder addAllFrom(Iterable<? extends StructuredQuery.CollectionSelector> values)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
values | Iterable<? extends com.google.firestore.v1.StructuredQuery.CollectionSelector> |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addAllOrderBy(Iterable<? extends StructuredQuery.Order> values)
public StructuredQuery.Builder addAllOrderBy(Iterable<? extends StructuredQuery.Order> values)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
values | Iterable<? extends com.google.firestore.v1.StructuredQuery.Order> |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addFrom(StructuredQuery.CollectionSelector value)
public StructuredQuery.Builder addFrom(StructuredQuery.CollectionSelector value)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.CollectionSelector |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addFrom(StructuredQuery.CollectionSelector.Builder builderForValue)
public StructuredQuery.Builder addFrom(StructuredQuery.CollectionSelector.Builder builderForValue)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
builderForValue | StructuredQuery.CollectionSelector.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addFrom(int index, StructuredQuery.CollectionSelector value)
public StructuredQuery.Builder addFrom(int index, StructuredQuery.CollectionSelector value)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameters | |
---|---|
Name | Description |
index | int |
value | StructuredQuery.CollectionSelector |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addFrom(int index, StructuredQuery.CollectionSelector.Builder builderForValue)
public StructuredQuery.Builder addFrom(int index, StructuredQuery.CollectionSelector.Builder builderForValue)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameters | |
---|---|
Name | Description |
index | int |
builderForValue | StructuredQuery.CollectionSelector.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addFromBuilder()
public StructuredQuery.CollectionSelector.Builder addFromBuilder()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
StructuredQuery.CollectionSelector.Builder |
addFromBuilder(int index)
public StructuredQuery.CollectionSelector.Builder addFromBuilder(int index)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.CollectionSelector.Builder |
addOrderBy(StructuredQuery.Order value)
public StructuredQuery.Builder addOrderBy(StructuredQuery.Order value)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.Order |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addOrderBy(StructuredQuery.Order.Builder builderForValue)
public StructuredQuery.Builder addOrderBy(StructuredQuery.Order.Builder builderForValue)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
builderForValue | StructuredQuery.Order.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addOrderBy(int index, StructuredQuery.Order value)
public StructuredQuery.Builder addOrderBy(int index, StructuredQuery.Order value)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameters | |
---|---|
Name | Description |
index | int |
value | StructuredQuery.Order |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addOrderBy(int index, StructuredQuery.Order.Builder builderForValue)
public StructuredQuery.Builder addOrderBy(int index, StructuredQuery.Order.Builder builderForValue)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameters | |
---|---|
Name | Description |
index | int |
builderForValue | StructuredQuery.Order.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
addOrderByBuilder()
public StructuredQuery.Order.Builder addOrderByBuilder()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
StructuredQuery.Order.Builder |
addOrderByBuilder(int index)
public StructuredQuery.Order.Builder addOrderByBuilder(int index)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.Order.Builder |
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public StructuredQuery.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters | |
---|---|
Name | Description |
field | FieldDescriptor |
value | Object |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
build()
public StructuredQuery build()
Returns | |
---|---|
Type | Description |
StructuredQuery |
buildPartial()
public StructuredQuery buildPartial()
Returns | |
---|---|
Type | Description |
StructuredQuery |
clear()
public StructuredQuery.Builder clear()
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearEndAt()
public StructuredQuery.Builder clearEndAt()
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearField(Descriptors.FieldDescriptor field)
public StructuredQuery.Builder clearField(Descriptors.FieldDescriptor field)
Parameter | |
---|---|
Name | Description |
field | FieldDescriptor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearFrom()
public StructuredQuery.Builder clearFrom()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearLimit()
public StructuredQuery.Builder clearLimit()
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearOffset()
public StructuredQuery.Builder clearOffset()
The number of documents to skip before returning the first result.
This applies after the constraints specified by the WHERE
, START AT
, &
END AT
but before the LIMIT
clause.
Requires:
- The value must be greater than or equal to zero if specified.
int32 offset = 6;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder | This builder for chaining. |
clearOneof(Descriptors.OneofDescriptor oneof)
public StructuredQuery.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter | |
---|---|
Name | Description |
oneof | OneofDescriptor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearOrderBy()
public StructuredQuery.Builder clearOrderBy()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearSelect()
public StructuredQuery.Builder clearSelect()
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearStartAt()
public StructuredQuery.Builder clearStartAt()
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clearWhere()
public StructuredQuery.Builder clearWhere()
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
clone()
public StructuredQuery.Builder clone()
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
getDefaultInstanceForType()
public StructuredQuery getDefaultInstanceForType()
Returns | |
---|---|
Type | Description |
StructuredQuery |
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()
Returns | |
---|---|
Type | Description |
Descriptor |
getEndAt()
public Cursor getEndAt()
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Returns | |
---|---|
Type | Description |
Cursor | The endAt. |
getEndAtBuilder()
public Cursor.Builder getEndAtBuilder()
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Returns | |
---|---|
Type | Description |
Cursor.Builder |
getEndAtOrBuilder()
public CursorOrBuilder getEndAtOrBuilder()
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Returns | |
---|---|
Type | Description |
CursorOrBuilder |
getFrom(int index)
public StructuredQuery.CollectionSelector getFrom(int index)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.CollectionSelector |
getFromBuilder(int index)
public StructuredQuery.CollectionSelector.Builder getFromBuilder(int index)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.CollectionSelector.Builder |
getFromBuilderList()
public List<StructuredQuery.CollectionSelector.Builder> getFromBuilderList()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
List<Builder> |
getFromCount()
public int getFromCount()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
int |
getFromList()
public List<StructuredQuery.CollectionSelector> getFromList()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
List<CollectionSelector> |
getFromOrBuilder(int index)
public StructuredQuery.CollectionSelectorOrBuilder getFromOrBuilder(int index)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.CollectionSelectorOrBuilder |
getFromOrBuilderList()
public List<? extends StructuredQuery.CollectionSelectorOrBuilder> getFromOrBuilderList()
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Returns | |
---|---|
Type | Description |
List<? extends com.google.firestore.v1.StructuredQuery.CollectionSelectorOrBuilder> |
getLimit()
public Int32Value getLimit()
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Returns | |
---|---|
Type | Description |
Int32Value | The limit. |
getLimitBuilder()
public Int32Value.Builder getLimitBuilder()
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Returns | |
---|---|
Type | Description |
Builder |
getLimitOrBuilder()
public Int32ValueOrBuilder getLimitOrBuilder()
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Returns | |
---|---|
Type | Description |
Int32ValueOrBuilder |
getOffset()
public int getOffset()
The number of documents to skip before returning the first result.
This applies after the constraints specified by the WHERE
, START AT
, &
END AT
but before the LIMIT
clause.
Requires:
- The value must be greater than or equal to zero if specified.
int32 offset = 6;
Returns | |
---|---|
Type | Description |
int | The offset. |
getOrderBy(int index)
public StructuredQuery.Order getOrderBy(int index)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.Order |
getOrderByBuilder(int index)
public StructuredQuery.Order.Builder getOrderByBuilder(int index)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.Order.Builder |
getOrderByBuilderList()
public List<StructuredQuery.Order.Builder> getOrderByBuilderList()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
List<Builder> |
getOrderByCount()
public int getOrderByCount()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
int |
getOrderByList()
public List<StructuredQuery.Order> getOrderByList()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
List<Order> |
getOrderByOrBuilder(int index)
public StructuredQuery.OrderOrBuilder getOrderByOrBuilder(int index)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.OrderOrBuilder |
getOrderByOrBuilderList()
public List<? extends StructuredQuery.OrderOrBuilder> getOrderByOrBuilderList()
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Returns | |
---|---|
Type | Description |
List<? extends com.google.firestore.v1.StructuredQuery.OrderOrBuilder> |
getSelect()
public StructuredQuery.Projection getSelect()
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Returns | |
---|---|
Type | Description |
StructuredQuery.Projection | The select. |
getSelectBuilder()
public StructuredQuery.Projection.Builder getSelectBuilder()
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Returns | |
---|---|
Type | Description |
StructuredQuery.Projection.Builder |
getSelectOrBuilder()
public StructuredQuery.ProjectionOrBuilder getSelectOrBuilder()
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Returns | |
---|---|
Type | Description |
StructuredQuery.ProjectionOrBuilder |
getStartAt()
public Cursor getStartAt()
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Returns | |
---|---|
Type | Description |
Cursor | The startAt. |
getStartAtBuilder()
public Cursor.Builder getStartAtBuilder()
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Returns | |
---|---|
Type | Description |
Cursor.Builder |
getStartAtOrBuilder()
public CursorOrBuilder getStartAtOrBuilder()
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Returns | |
---|---|
Type | Description |
CursorOrBuilder |
getWhere()
public StructuredQuery.Filter getWhere()
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Returns | |
---|---|
Type | Description |
StructuredQuery.Filter | The where. |
getWhereBuilder()
public StructuredQuery.Filter.Builder getWhereBuilder()
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Returns | |
---|---|
Type | Description |
StructuredQuery.Filter.Builder |
getWhereOrBuilder()
public StructuredQuery.FilterOrBuilder getWhereOrBuilder()
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Returns | |
---|---|
Type | Description |
StructuredQuery.FilterOrBuilder |
hasEndAt()
public boolean hasEndAt()
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Returns | |
---|---|
Type | Description |
boolean | Whether the endAt field is set. |
hasLimit()
public boolean hasLimit()
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Returns | |
---|---|
Type | Description |
boolean | Whether the limit field is set. |
hasSelect()
public boolean hasSelect()
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Returns | |
---|---|
Type | Description |
boolean | Whether the select field is set. |
hasStartAt()
public boolean hasStartAt()
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Returns | |
---|---|
Type | Description |
boolean | Whether the startAt field is set. |
hasWhere()
public boolean hasWhere()
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Returns | |
---|---|
Type | Description |
boolean | Whether the where field is set. |
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns | |
---|---|
Type | Description |
FieldAccessorTable |
isInitialized()
public final boolean isInitialized()
Returns | |
---|---|
Type | Description |
boolean |
mergeEndAt(Cursor value)
public StructuredQuery.Builder mergeEndAt(Cursor value)
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Parameter | |
---|---|
Name | Description |
value | Cursor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeFrom(StructuredQuery other)
public StructuredQuery.Builder mergeFrom(StructuredQuery other)
Parameter | |
---|---|
Name | Description |
other | StructuredQuery |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public StructuredQuery.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters | |
---|---|
Name | Description |
input | CodedInputStream |
extensionRegistry | ExtensionRegistryLite |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
Exceptions | |
---|---|
Type | Description |
IOException |
mergeFrom(Message other)
public StructuredQuery.Builder mergeFrom(Message other)
Parameter | |
---|---|
Name | Description |
other | Message |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeLimit(Int32Value value)
public StructuredQuery.Builder mergeLimit(Int32Value value)
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Parameter | |
---|---|
Name | Description |
value | Int32Value |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeSelect(StructuredQuery.Projection value)
public StructuredQuery.Builder mergeSelect(StructuredQuery.Projection value)
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.Projection |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeStartAt(Cursor value)
public StructuredQuery.Builder mergeStartAt(Cursor value)
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Parameter | |
---|---|
Name | Description |
value | Cursor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeUnknownFields(UnknownFieldSet unknownFields)
public final StructuredQuery.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter | |
---|---|
Name | Description |
unknownFields | UnknownFieldSet |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
mergeWhere(StructuredQuery.Filter value)
public StructuredQuery.Builder mergeWhere(StructuredQuery.Filter value)
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.Filter |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
removeFrom(int index)
public StructuredQuery.Builder removeFrom(int index)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
removeOrderBy(int index)
public StructuredQuery.Builder removeOrderBy(int index)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameter | |
---|---|
Name | Description |
index | int |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setEndAt(Cursor value)
public StructuredQuery.Builder setEndAt(Cursor value)
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Parameter | |
---|---|
Name | Description |
value | Cursor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setEndAt(Cursor.Builder builderForValue)
public StructuredQuery.Builder setEndAt(Cursor.Builder builderForValue)
A potential prefix of a position in the result set to end the query at.
This is similar to START_AT
but with it controlling the end position
rather than the start position.
Requires:
- The number of values cannot be greater than the number of fields
specified in the
ORDER BY
clause.
.google.firestore.v1.Cursor end_at = 8;
Parameter | |
---|---|
Name | Description |
builderForValue | Cursor.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setField(Descriptors.FieldDescriptor field, Object value)
public StructuredQuery.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters | |
---|---|
Name | Description |
field | FieldDescriptor |
value | Object |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setFrom(int index, StructuredQuery.CollectionSelector value)
public StructuredQuery.Builder setFrom(int index, StructuredQuery.CollectionSelector value)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameters | |
---|---|
Name | Description |
index | int |
value | StructuredQuery.CollectionSelector |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setFrom(int index, StructuredQuery.CollectionSelector.Builder builderForValue)
public StructuredQuery.Builder setFrom(int index, StructuredQuery.CollectionSelector.Builder builderForValue)
The collections to query.
repeated .google.firestore.v1.StructuredQuery.CollectionSelector from = 2;
Parameters | |
---|---|
Name | Description |
index | int |
builderForValue | StructuredQuery.CollectionSelector.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setLimit(Int32Value value)
public StructuredQuery.Builder setLimit(Int32Value value)
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Parameter | |
---|---|
Name | Description |
value | Int32Value |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setLimit(Int32Value.Builder builderForValue)
public StructuredQuery.Builder setLimit(Int32Value.Builder builderForValue)
The maximum number of results to return.
Applies after all other constraints.
Requires:
- The value must be greater than or equal to zero if specified.
.google.protobuf.Int32Value limit = 5;
Parameter | |
---|---|
Name | Description |
builderForValue | Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setOffset(int value)
public StructuredQuery.Builder setOffset(int value)
The number of documents to skip before returning the first result.
This applies after the constraints specified by the WHERE
, START AT
, &
END AT
but before the LIMIT
clause.
Requires:
- The value must be greater than or equal to zero if specified.
int32 offset = 6;
Parameter | |
---|---|
Name | Description |
value | int The offset to set. |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder | This builder for chaining. |
setOrderBy(int index, StructuredQuery.Order value)
public StructuredQuery.Builder setOrderBy(int index, StructuredQuery.Order value)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameters | |
---|---|
Name | Description |
index | int |
value | StructuredQuery.Order |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setOrderBy(int index, StructuredQuery.Order.Builder builderForValue)
public StructuredQuery.Builder setOrderBy(int index, StructuredQuery.Order.Builder builderForValue)
The order to apply to the query results.
Firestore allows callers to provide a full ordering, a partial ordering, or no ordering at all. In all cases, Firestore guarantees a stable ordering through the following rules:
- The
order_by
is required to reference all fields used with an inequality filter. - All fields that are required to be in the
order_by
but are not already present are appended in lexicographical ordering of the field name. If an order on
name
is not specified, it is appended by default.Fields are appended with the same sort direction as the last order specified, or 'ASCENDING' if no order was specified. For example:
ORDER BY a
becomesORDER BY a ASC, name ASC
ORDER BY a DESC
becomesORDER BY a DESC, name DESC
WHERE a > 1
becomesWHERE a > 1 ORDER BY a ASC, name ASC
WHERE name > ... AND a > 1
becomesWHERE name > ... AND a > 1 ORDER BY a ASC, name ASC
repeated .google.firestore.v1.StructuredQuery.Order order_by = 4;
Parameters | |
---|---|
Name | Description |
index | int |
builderForValue | StructuredQuery.Order.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public StructuredQuery.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters | |
---|---|
Name | Description |
field | FieldDescriptor |
index | int |
value | Object |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setSelect(StructuredQuery.Projection value)
public StructuredQuery.Builder setSelect(StructuredQuery.Projection value)
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.Projection |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setSelect(StructuredQuery.Projection.Builder builderForValue)
public StructuredQuery.Builder setSelect(StructuredQuery.Projection.Builder builderForValue)
Optional sub-set of the fields to return.
This acts as a DocumentMask over the documents returned from a query. When not set, assumes that the caller wants all fields returned.
.google.firestore.v1.StructuredQuery.Projection select = 1;
Parameter | |
---|---|
Name | Description |
builderForValue | StructuredQuery.Projection.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setStartAt(Cursor value)
public StructuredQuery.Builder setStartAt(Cursor value)
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Parameter | |
---|---|
Name | Description |
value | Cursor |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setStartAt(Cursor.Builder builderForValue)
public StructuredQuery.Builder setStartAt(Cursor.Builder builderForValue)
A potential prefix of a position in the result set to start the query at.
The ordering of the result set is based on the ORDER BY
clause of the
original query.
`
SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, name ASC;
This query's results are ordered by
(b ASC, name ASC).
Cursors can reference either the full ordering or a prefix of the location,
though it cannot reference more fields than what are in the provided
ORDER BY.
Continuing off the example above, attaching the following start cursors
will have varying impact:
START BEFORE (2, /k/123): start the query right before
a = 1 AND
b > 2 AND name > /k/123.
START AFTER (10): start the query right after
a = 1 AND b > 10.
Unlike
OFFSET which requires scanning over the first N results to skip,
a start cursor allows the query to begin at a logical position. This
position is not required to match an actual result, it will scan forward
from this position to find the next document.
Requires:
The number of values cannot be greater than the number of fields
specified in the
ORDER BY` clause.
.google.firestore.v1.Cursor start_at = 7;
Parameter | |
---|---|
Name | Description |
builderForValue | Cursor.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setUnknownFields(UnknownFieldSet unknownFields)
public final StructuredQuery.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter | |
---|---|
Name | Description |
unknownFields | UnknownFieldSet |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setWhere(StructuredQuery.Filter value)
public StructuredQuery.Builder setWhere(StructuredQuery.Filter value)
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Parameter | |
---|---|
Name | Description |
value | StructuredQuery.Filter |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |
setWhere(StructuredQuery.Filter.Builder builderForValue)
public StructuredQuery.Builder setWhere(StructuredQuery.Filter.Builder builderForValue)
The filter to apply.
.google.firestore.v1.StructuredQuery.Filter where = 3;
Parameter | |
---|---|
Name | Description |
builderForValue | StructuredQuery.Filter.Builder |
Returns | |
---|---|
Type | Description |
StructuredQuery.Builder |