- 1.103.0 (latest)
- 1.102.0
- 1.101.0
- 1.100.0
- 1.98.0
- 1.97.0
- 1.96.0
- 1.95.0
- 1.94.0
- 1.93.1
- 1.92.1
- 1.91.0
- 1.90.0
- 1.89.0
- 1.88.0
- 1.87.0
- 1.86.0
- 1.85.0
- 1.84.0
- 1.83.0
- 1.82.0
- 1.81.0
- 1.80.0
- 1.79.0
- 1.78.0
- 1.77.0
- 1.76.1
- 1.68.0
- 1.67.0
- 1.66.0
- 1.65.0
- 1.64.0
- 1.63.2
- 1.62.1
- 1.61.0
- 1.60.0
- 1.59.0
- 1.58.4
- 1.57.0
- 1.56.0
- 1.55.0
- 1.54.2
Reference documentation and code samples for the Cloud Spanner Client class KeySet.
Represents a Cloud Spanner KeySet.
Example:
use Google\Cloud\Spanner\SpannerClient;
$spanner = new SpannerClient();
$keySet = $spanner->keySet();
Namespace
Google \ Cloud \ SpannerMethods
__construct
Create a KeySet.
Parameters | |
---|---|
Name | Description |
options |
array
[optional] {
@type array $keys A list of specific keys. Entries in keys should
have exactly as many elements as there are columns in the
primary or index key with which this KeySet is used.
@type KeyRange[] $ranges A list of Key Ranges.
@type bool $all If true, KeySet will match all keys in a table.
Defaults to |
↳ keys |
array
A list of specific keys. Entries in keys should have exactly as many elements as there are columns in the primary or index key with which this KeySet is used. |
↳ ranges |
KeyRange[]
A list of Key Ranges. |
↳ all |
bool
If true, KeySet will match all keys in a table. Defaults to |
ranges
Fetch the KeyRanges
Example:
$ranges = $keySet->ranges();
Returns | |
---|---|
Type | Description |
array<Google\Cloud\Spanner\KeyRange> |
addRange
Add a single KeyRange.
Example:
$range = new KeyRange();
$keySet->addRange($range);
Parameter | |
---|---|
Name | Description |
range |
Google\Cloud\Spanner\KeyRange
A KeyRange instance. |
Returns | |
---|---|
Type | Description |
void |
setRanges
Set the KeySet's KeyRanges.
Any existing KeyRanges will be overridden.
Example:
$range = new KeyRange();
$keySet->setRanges([$range]);
Parameter | |
---|---|
Name | Description |
ranges |
array<Google\Cloud\Spanner\KeyRange>
An array of KeyRange objects. |
Returns | |
---|---|
Type | Description |
void |
keys
Fetch the keys.
Example:
$keys = $keySet->keys();
Returns | |
---|---|
Type | Description |
array |
addKey
Add a single key.
A Key should have exactly as many elements as there are columns in the primary or index key with which this KeySet is used.
Example:
$keySet->addKey('Bob');
Parameter | |
---|---|
Name | Description |
key |
mixed
The Key to add. |
Returns | |
---|---|
Type | Description |
void |
setKeys
Set the KeySet keys.
Any existing keys will be overridden.
Example:
$keySet->setKeys(['Bob', 'Jill']);
Parameter | |
---|---|
Name | Description |
keys |
array
|
Returns | |
---|---|
Type | Description |
void |
matchAll
Get the value of Match All.
Example:
if ($keySet->matchAll()) {
echo "All keys will match";
}
Returns | |
---|---|
Type | Description |
bool |
setMatchAll
Choose whether the KeySet should match all keys in a table.
Example:
$keySet->setMatchAll(true);
Parameter | |
---|---|
Name | Description |
all |
bool
If true, all keys in a table will be matched. |
Returns | |
---|---|
Type | Description |
void |
keySetObject
Format a KeySet object for use in the Spanner API.
static::fromArray
Create a KeySet from an array created by Google\Cloud\Spanner\KeySet::keySetObject().
Parameter | |
---|---|
Name | Description |
keySet |
array
An array of KeySet data. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Spanner\KeySet |