Configure a Bigtable instance

Application Design Center lets you configure connections and parameters to provision Bigtable instances based on the terraform-google-bigtable Terraform module on GitHub. This setup provides low-latency key-value and wide-column storage for high-throughput workloads such as clickstream data, IoT telemetry, and machine learning.

Component connections

The following table lists components you can connect to a Bigtable instance and the resulting updates to your application and Terraform code.

Connected component Application updates Background information

Compute Engine instance template

  • The Compute Engine instances can connect to and manage the Bigtable instance.
  • The Bigtable resource metadata is added to the Compute Engine instance template.
  • The roles/bigtable.admin role is granted to the Compute Engine instance template service account.
Bigtable overview

Cloud Run

  • The Cloud Run service can perform administrative functions on the Bigtable instance.
  • The Bigtable resource metadata is added to the Cloud Run environment variables.
  • The roles/bigtable.admin role is granted to the Cloud Run service account.
What is Cloud Run

Required configuration parameters

If your template includes a Bigtable component, you must configure the following Bigtable instance parameters before you deploy.

Parameter name Description and constraints Background information

Project ID

The project where you deploy the Bigtable instance.

Configure components

Name

name name

Optional configuration parameters

The following parameters are optional. To display advanced parameters, in the Configuration area, select Show advanced fields.

Feature Parameter name Description and constraint information Background information

Display Name

displayName display_name
Zones

Key

The zones map object key. zones
Zones

Zone

location Bigtable locations
Zones

Cluster ID

clusterID cluster_id
Zones

Num Nodes

serveNodes Nodes
Zones

KMS Key Name

kmsKeyName Customer-managed encryption keys (CMEK)
Zones: Autoscaling Config

Min Nodes

minServeNodes Determine the minimum number of nodes
Zones: Autoscaling Config

Max Nodes

maxServeNodes Determine the maximum number of nodes
Zones: Autoscaling Config

CPU Target

cpuUtilizationPercent Determine the CPU utilization target
Zones: Autoscaling Config

Storage Target

storageUtilizationGibPerNode Determine the storage utilization target
Tables

Key

The tables map object key. tables
Tables

Table Name

name name
Tables

Split Keys

split_keys Optional: Split the table by row key
Tables

Deletion Protection

deletion_protection Modify deletion protection
Tables

Change Stream Retention

retentionPeriod Change streams overview
Tables: Automated Backup Policy

Retention Period

retentionPeriod Use automated backup
Tables: Automated Backup Policy

Frequency

frequency Use automated backup
Tables: Column Family

Key

The column_family map object key, which is in the tables object. column_family
Tables: Column Family

Family

family Column families

Deletion Protection

When selected, a terraform apply or terraform destroy that would delete the instance fails. When not selected, the instance can be deleted.

deletion_protection

Storage Type

defaultStorageType Choose between SSD and HDD storage
Labels

Key

labels Create and manage instance labels
Labels

Value

labels Create and manage instance labels