- 1.104.0 (latest)
- 1.103.0
- 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 Instance.
Represents a Cloud Spanner instance
Example:
use Google\Cloud\Spanner\SpannerClient;
$spanner = new SpannerClient();
$instance = $spanner->instance('my-instance');
Namespace
Google \ Cloud \ SpannerMethods
__construct
Create an object representing a Cloud Spanner instance.
connection
Connection\ConnectionInterface
The connection to the Cloud Spanner Admin API. This object is created by SpannerClient, and should not be instantiated outside of this client.
lroConnection
Google\Cloud\Core\LongRunning\LongRunningConnectionInterface
An implementation mapping to methods which handle LRO resolution in the service.
lroCallables
array
projectId
string
The project ID.
name
string
The instance name or ID.
returnInt64AsObject
bool
[optional] If true, 64 bit integers will be returned as a Google\Cloud\Core\Int64 object for 32 bit platform compatibility. Defaults tofalse.
info
array
[optional] A representation of the instance object.
options
array
Instance options
↳ directedReadOptions
array
Directed read options. V1\DirectedReadOptions
If using the replicaSelection::type
setting, utilize the constants available in V1\DirectedReadOptions\ReplicaSelection\Type
to set a value.
name
Return the instance name.
Example:
$name = $instance->name();
string
info
Return the service representation of the instance.
This method may require a service call.
Example:
$info = $instance->info();
echo $info['nodeCount'];
options
array
Configuration options
↳ fieldMask
string|string[]
One or a list of Instance
fields that should be returned. Eligible values are: name
, displayName
, endpointUris
, labels
, config
, nodeCount
, state
. If absent, all fields are returned. Note: This parameter will only apply when service call is required ( info
values are not present).
array
exists
Check if the instance exists.
This method requires a service call.
Example:
if ($instance->exists()) {
echo 'Instance exists!';
}
options
array
[optional] Configuration options.
bool
reload
See also:
options
array
Configuration options
↳ fieldMask
string|string[]
One or a list of Instance
fields that should be returned. Eligible values are: name
, displayName
, endpointUris
, labels
, config
, nodeCount
, state
. If absent, all fields are returned.
array
create
See also:
config
options
array
Configuration options
↳ displayName
string
Defaults tothe value of $name.
↳ nodeCount
int
Defaults to 1
.
↳ processingUnits
int
An alternative measurement to nodeCount
that allows smaller increments.
↳ labels
state
Return the instance state.
When instances are created or updated, they may take some time before they are ready for use. This method allows for checking whether an instance is ready. Note that this value is cached within the class instance, so if you are polling it, first call Instance::reload() to refresh the cached value
Example:
if ($instance->state() === Instance::STATE_READY) {
echo 'Instance is ready!';
}
options
array
[optional] Configuration options.
int|null
update
See also:
options
array
Configuration options
↳ displayName
string
The descriptive name for this instance as it appears in UIs. Defaults tothe value of $name.
↳ nodeCount
int
The number of nodes allocated to this instance. Defaults to 1
.
↳ processingUnits
int
An alternative measurement to nodeCount
that allows smaller increments.
↳ labels
delete
See also:
options
array
[optional] Configuration options.
void
createDatabase
See also:
name
string
The database name.
options
array
Configuration Options
↳ statements
array
Additional DDL statements.
↳ sessionPool
SessionPoolInterface
A pool used to manage sessions.
createDatabaseFromBackup
Create a database from a backup.
Example:
$operation = $instance->createDatabaseFromBackup('my-new-database', $backup);
name
string
The database name.
backup
Backup
|string
The backup to restore, given
as a Backup instance or a string of the form projects/<project>/instances/<instance>/backups/<backup>
.
options
array
[optional] Configuration options.
database
Lazily instantiate a database object
Example:
$database = $instance->database('my-database');
Database role configured on the database object will be applied to the session created by this object.
$database = $instance->database('my-database', ['databaseRole' => 'Reader']);
name
string
The database name
options
array
Configuration options.
↳ sessionPool
SessionPoolInterface
A pool used to manage sessions.
↳ databaseRole
string
The user created database role which creates the session.
databases
See also:
options
array
Configuration options.
↳ pageSize
int
Maximum number of results to return per request.
↳ resultLimit
int
Limit the number of results returned in total. Defaults to 0
(return all results).
↳ pageToken
string
A previously-returned page token used to resume the loading of results from a specific point.
backup
Lazily instantiate a backup object
Example:
$backup = $instance->backup('my-backup');
name
string
The backup name.
backup
array
backups
See also:
options
array
Configuration options.
↳ filter
string
The standard list filter.
↳ pageSize
int
The maximum number of resources contained in the underlying API response. The API may return fewer values in a page, even if there are additional values to be retrieved.
↳ resultLimit
int
Limit the number of results returned in total. Defaults to 0
(return all results).
↳ pageToken
string
A page token is used to specify a page of values to be returned. If no page token is specified (the default), the first page of values will be returned. Any page token used here must have been generated by a previous call to the API.
backupOperations
Lists backup operations for the instance.
Example:
$backupOperations = $instance->backupOperations();
options
array
Configuration options.
↳ pageSize
int
The maximum number of resources contained in the underlying API response. The API may return fewer values in a page, even if there are additional values to be retrieved.
↳ resultLimit
int
Limit the number of results returned in total. Defaults to 0
(return all results).
↳ pageToken
string
A page token is used to specify a page of values to be returned. If no page token is specified (the default), the first page of values will be returned. Any page token used here must have been generated by a previous call to the API.
databaseOperations
Lists database operations for the instance.
Example:
$databaseOperations = $instance->databaseOperations();
options
array
Configuration options.
↳ pageSize
int
The maximum number of resources contained in the underlying API response. The API may return fewer values in a page, even if there are additional values to be retrieved.
↳ resultLimit
int
Limit the number of results returned in total. Defaults to 0
(return all results).
↳ pageToken
string
A page token is used to specify a page of values to be returned. If no page token is specified (the default), the first page of values will be returned. Any page token used here must have been generated by a previous call to the API.
iam
Manage the instance IAM policy
Example:
$iam = $instance->iam();
__debugInfo
Represent the class in a more readable and digestable fashion.
directedReadOptions
Return the directed read options.
Example:
$name = $instance->directedReadOptions();
array
resumeOperation
{ Resume a Long Running Operation
void
longRunningOperations
{ List long running operations.
void
Constants
STATE_READY
Value: \Google\Cloud\Spanner\Admin\Instance\V1\Instance\State::READY
STATE_CREATING
Value: \Google\Cloud\Spanner\Admin\Instance\V1\Instance\State::CREATING
DEFAULT_NODE_COUNT
Value: 1
