Creating a Cloud Bigtable Instance

A Cloud Bigtable instance is a container for a single Cloud Bigtable cluster. The instance ID and cluster ID combine to uniquely identify your cluster.

When you create your Cloud Bigtable instance, take note of the instance ID. You'll need this value to connect to your instance.

To enable the Cloud Bigtable APIs:

  1. Go to the Google Cloud Platform Console.
  2. Create a new Cloud Platform Console project, or open an existing project by selecting the project name.
  3. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs.

    Enable the APIs

Console

To create a Cloud Bigtable instance:

  1. Create a new instance in the Cloud Platform Console.

    Screenshot of the 'Create
instance' page

  2. Enter a name for the instance. The name is used to identify your instance in the Cloud Platform Console.

  3. Enter an instance ID. The instance ID is a permanent identifier for your instance that is unique within your Cloud Platform project.
  4. Enter a cluster ID. The cluster ID is a permanent identifier for your cluster that is unique within your instance.
  5. Choose the zone where your Cloud Bigtable cluster will run. Use the same zone you use for other Cloud Platform services, or another zone in the same region.
  6. Choose the number of Cloud Bigtable nodes for your cluster. You can change this value later.
  7. Choose whether to use an SSD or HDD disk for your cluster. In most cases, SSD is the best choice. Your choice is permanent. See "Choosing between SSD and HDD storage" for details.

    The Cloud Platform Console shows you how the disk type and number of nodes affect the number of queries per second (QPS) and megabytes per second (MB/s) your cluster can handle, as well as the cost for your cluster.

  8. Click Create to create the instance.

gcloud

To create a Cloud Bigtable instance:

  1. Install the Cloud SDK if you haven't already.

  2. Use the beta bigtable instances create command to create an instance:

    $ gcloud beta bigtable instances create INSTANCE --cluster CLUSTER \
        --cluster-zone CLUSTER_ZONE --cluster-num-nodes CLUSTER_NUM_NODES \
        --description DESCRIPTION [--async] \
        [--cluster-storage-type CLUSTER_STORAGE_TYPE; default="SSD"]
    

    Where:

    • INSTANCE: Is the permanent identifier for your instance.
    • CLUSTER: Is the permanent identifier for your cluster.
    • CLUSTER_ZONE: Is the zone where your Cloud Bigtable cluster runs.
    • CLUSTER_NUM_NODES: Is the size of the Cloud Bigtable cluster. Each cluster must have at least three nodes.
    • DESCRIPTION: Is a human-readable name for the instance.

    The command accepts the following optional flags:

    • --async: Return immediately without waiting for the operation to finish.
    • --cluster-storage-type CLUSTER_STORAGE_TYPE: The type of storage to use for the cluster. Accepts the values SSD (default) and HDD.

Send feedback about...

Cloud Bigtable Documentation