--- title: Cloud Spanner Instance Partition description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > DDSQL Reference > Data Directory > Cloud Spanner Instance Partition --- # 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 | Title | ID | Type | Data Type | Description | | --------------------- | ---- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | _key | core | string | | ancestors | core | array | | 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 | | 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 | 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 | 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 |