Quickstart Using cbt

This page explains how to use the cbt command to connect to a Cloud Bigtable instance, perform basic administrative tasks, and read and write data in a table.

If you are familiar with HBase, you might want to follow the quickstart using the HBase shell instead.

Before you begin

  1. Sign in to your Google account.

    If you don't already have one, sign up for a new account.

  2. Select or create a Cloud Platform project.

    Go to the Manage resources page

  3. Enable billing for your project.

    Enable billing

  4. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs.

    Enable the APIs

Create a Cloud Bigtable instance

  1. Go to the Create Instance page in the Google Cloud Platform Console.

    Go to the Create Instance page

    Screenshot of the
    'Create instance' page

  2. For Instance name, enter Quickstart instance.
  3. For Instance ID, enter quickstart-instance.
  4. For Instance type, select Development.
  5. For Cluster ID, enter quickstart-instance-cluster.
  6. For Zone, select us-east1-c.
  7. Click Create to create the instance.

Connect to your instance

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

  2. Open a terminal window.

  3. Install the cbt command:

    gcloud components update
    gcloud components install cbt
  4. Configure cbt to use your project and instance by modifying the .cbtrc file, replacing [PROJECT_ID] with your project ID:

    echo project = [PROJECT_ID] > ~/.cbtrc
    echo instance = quickstart-instance >> ~/.cbtrc

Now you're ready to use the cbt command.

Read and write data

Cloud Bigtable stores data in tables, which contain rows. Each row is identified by a row key.

Data in a row is organized into column families, or groups of columns. A column qualifier identifies a single column within a column family.

A cell is the intersection of a row and a column. Each cell can contain multiple versions of a value.

  1. Create a table named my-table.

    cbt createtable my-table
  2. List your tables:

    cbt ls

    The command displays output similar to the following:

  3. Add one column family named cf1:

    cbt createfamily my-table cf1
  4. List your column families:

    cbt ls my-table

    The command displays output similar to the following:

  5. Put the value test-value in the row r1, using the column family cf1 and the column qualifier c1:

    cbt set my-table r1 cf1:c1=test-value
  6. Use the cbt read command to read the data you added to the table:

    cbt read my-table

    The shell displays output similar to the following:

      cf1:c1                                   @ 2016/10/31-15:05:38.840000
  7. Delete the table my-table:

    cbt deletetable my-table

Clean up

To avoid incurring charges to your Google Cloud Platform account for the resources used in this quickstart:

  1. Go to the Instances page in the Google Cloud Platform Console.

    Go to the Instances page

  2. Click Quickstart instance.
  3. Click Delete.

    Screenshot of the
    'Delete instance' pane

  4. Type quickstart-instance, then click Delete to delete the instance.
  5. In your terminal, delete the .cbtrc file:
    rm ~/.cbtrc

What's next