cbt tool overview
cbt tool is a command-line interface for performing several different
operations on Cloud Bigtable. It is written in Go using the Go client
library for Cloud Bigtable. Source code for the
is available in the GitHub repository
GoogleCloudPlatform/google-cloud-go. This repository is a mirror
For information about Bigtable in general, see the overview of Bigtable.
Installing the cbt tool
You can install the
cbt tool as a gcloud CLI component or by
using the standard
cbt tool does not implement smart retries or error handling. When working in a
production environment, use a Bigtable client library or the
Google Cloud console.
This installation path is recommended if you work with multiple Google Cloud products.
- Install the gcloud CLI.
Run the following commands:
gcloud components update gcloud components install cbt
If the tool is already installed, the terminal window displays the message
All components are up to date.
If you have the latest stable release of the
go tool installed,
you can install the
cbt tool using the following command:
go get cloud.google.com/go/bigtable/cmd/cbt
Verifying the installation
cbt command to verify installation of the tool:
The terminal window displays two columns named
Instance Name and
Creating a .cbtrc file
cbtto use your project and instance by creating a
.cbtrcfile, replacing project-id with the ID for the project where you created your Bigtable instance:
echo project = project-id > ~/.cbtrc
echo instance = quickstart-instance >> ~/.cbtrc
Verify that you set up the
The terminal displays the contents of the
.cbtrcfile, which looks similar to the following:
project = project-id instance = quickstart-instance
Now you can use the
cbttool with your instance.
Using the cbt tool
For details about using the
cbt tool, including a list of available commands,