cbt

command-line interface for Google Cloud Bigtable

TLDR

List all tables in an instance

$ cbt -project [project_id] -instance [instance_id] ls

Read rows from a table

$ cbt -project [project_id] -instance [instance_id] read [table_name]

Count rows in a table

$ cbt -project [project_id] -instance [instance_id] count [table_name]

Create a new table

$ cbt -project [project_id] -instance [instance_id] createtable [table_name]

Create a column family

$ cbt -project [project_id] -instance [instance_id] createfamily [table_name] [family_name]

Write a value to a cell

$ cbt -project [project_id] -instance [instance_id] set [table_name] [row_key] [family]:[column]=[value]

SYNOPSIS

cbt [-project project] [-instance instance] [-creds file] [-timeout duration] command [arguments...]

cbt is a command-line interface for Google Cloud Bigtable, a fully managed NoSQL database service. It allows performing administrative and data operations on Bigtable instances, tables, column families, and rows.The tool can be configured via a ~/.cbtrc file containing project and instance defaults, or by passing flags directly.

PARAMETERS

-project projectid_

Google Cloud project ID. Uses gcloud default if unset

-instance instanceid_

Cloud Bigtable instance name

-creds file

Path to credentials JSON file

-timeout duration

Operation timeout (e.g., 10s, 5m)

Common commands:ls - List tablesread table - Read rows from tablecount table - Count rows in tablecreatetable table - Create a tabledeletetable table - Delete a tablecreatefamily table family - Create column familyset table row family:col=val - Write cell valuedeleterow table row - Delete a rowhelp - Print help text

CONFIGURATION

~/.cbtrc

Default project and instance settings, avoiding the need to pass -project and -instance flags on every invocation.

CAVEATS

The cbt CLI does not implement smart retries or advanced error handling. For production environments, use a Bigtable client library or the Google Cloud console instead.Bash shell syntax rules apply: values with spaces or operators require quotes, and arbitrary byte values need dollar-sign prefix with single quotes.

HISTORY

The cbt tool was developed by Google as part of the Cloud Bigtable ecosystem, written in Go using the official Go client library for Bigtable. It provides a quick way to interact with Bigtable for development and debugging purposes.

RESOURCES

Source code · Documentation

cbt