Cloud Spanner Instance Partition

Docs > DDSQL Reference > Data Directory > Cloud Spanner Instance Partition

A Cloud Spanner Instance Partition is a logical subdivision of a Cloud Spanner instance that allows you to isolate workloads and scale compute resources independently within the same instance. Each partition can handle its own set of databases and queries, enabling better performance management and cost optimization for large-scale or multi-tenant applications.

gcp.spanner_instance_partition

Fields

ID	Type	Data Type	Description
_key	core	string
ancestors	core	array<string>
config	core	string	Required. The name of the instance partition's configuration. Values are of the form `projects//instanceConfigs/`. See also InstanceConfig and ListInstanceConfigs.
create_time	core	timestamp	Output only. The time at which the instance partition was created.
datadog_display_name	core	string
etag	core	string	Used for optimistic concurrency control as a way to help prevent simultaneous updates of a instance partition from overwriting each other. It is strongly suggested that systems make use of the etag in the read-modify-write cycle to perform instance partition updates in order to avoid race conditions: An etag is returned in the response which contains instance partitions, and systems are expected to put that etag in the request to update instance partitions to ensure that their change will be applied to the same version of the instance partition. If no etag is provided in the call to update instance partition, then the existing instance partition is overwritten blindly.
gcp_display_name	core	string	Required. The descriptive name for this instance partition as it appears in UIs. Must be unique per project and between 4 and 30 characters in length.
labels	core	array<string>
name	core	string	Required. A unique identifier for the instance partition. Values are of the form `projects//instances//instancePartitions/a-z*[a-z0-9]`. The final segment of the name must be between 2 and 64 characters in length. An instance partition's name cannot be changed after the instance partition is created.
node_count	core	int64	The number of nodes allocated to this instance partition. Users can set the `node_count` field to specify the target number of nodes allocated to the instance partition. This may be zero in API responses for instance partitions that are not yet in state `READY`.
organization_id	core	string
parent	core	string
processing_units	core	int64	The number of processing units allocated to this instance partition. Users can set the `processing_units` field to specify the target number of processing units allocated to the instance partition. This might be zero in API responses for instance partitions that are not yet in the `READY` state.
project_id	core	string
project_number	core	string
referencing_backups	core	array<string>	Output only. Deprecated: This field is not populated. Output only. The names of the backups that reference this instance partition. Referencing backups should share the parent instance. The existence of any referencing backup prevents the instance partition from being deleted.
referencing_databases	core	array<string>	Output only. The names of the databases that reference this instance partition. Referencing databases should share the parent instance. The existence of any referencing database prevents the instance partition from being deleted.
region_id	core	string
resource_name	core	string
state	core	string	Output only. The current instance partition state.
tags	core	hstore_csv
update_time	core	timestamp	Output only. The time at which the instance partition was most recently updated.
zone_id	core	string