cbt

Documentation

Overview

Cbt is a tool for doing basic interactions with Cloud Bigtable. To learn how to install the cbt tool, see the [cbt overview](https://cloud.google.com/bigtable/docs/go/cbt-overview).

Usage:

cbt [options] command [arguments]

The commands are:

count                     Count rows in a table
createfamily              Create a column family
createtable               Create a table
deletecolumn              Delete all cells in a column
deletefamily              Delete a column family
deleterow                 Delete a row
deletetable               Delete a table
doc                       Print godoc-suitable documentation for cbt
help                      Print help text
listinstances             List instances in a project
lookup                    Read from a single row
ls                        List tables and column families
mddoc                     Print documentation for cbt in Markdown format
read                      Read rows
set                       Set value of a cell
setgcpolicy               Set the GC policy for a column family
version                   Print the current cbt version

Use "cbt help <command>" for more information about a command.

The options are:

-project string
	project ID, if unset uses gcloud configured project
-instance string
	Cloud Bigtable instance
-creds string
	if set, use application credentials in this file

Count rows in a table

Usage:

cbt count <table>

Create a column family

Usage:

cbt createfamily <table> <family>

Create a table

Usage:

cbt createtable <table> [initial_splits...]
  initial_splits=row		A row key to be used to initially split the table into multiple tablets. Can be repeated to create multiple splits.

Delete all cells in a column

Usage:

cbt deletecolumn <table> <row> <family> <column>

Delete a column family

Usage:

cbt deletefamily <table> <family>

Delete a row

Usage:

cbt deleterow <table> <row>

Delete a table

Usage:

cbt deletetable <table>

Print godoc-suitable documentation for cbt

Usage:

cbt doc

Print help text

Usage:

cbt help [command]

List instances in a project

Usage:

cbt listinstances

Read from a single row

Usage:

cbt lookup <table> <row>

List tables and column families

Usage:

cbt ls			List tables
cbt ls <table>		List column families in <table>

Print documentation for cbt in Markdown format

Usage:

cbt mddoc

Read rows

Usage:

cbt read <table> [start=<row>] [end=<row>] [prefix=<prefix>] [regex=<regex>] [count=<n>]
  start=<row>		Start reading at this row
  end=<row>		Stop reading before this row
  prefix=<prefix>	Read rows with this prefix
  regex=<regex> 	Read rows with keys matching this regex
  count=<n>		Read only this many rows

Set value of a cell

Usage:

cbt set <table> <row> family:column=val[@ts] ...
  family:column=val[@ts] may be repeated to set multiple cells.

  ts is an optional integer timestamp.
  If it cannot be parsed, the `@ts` part will be
  interpreted as part of the value.

Set the GC policy for a column family

Usage:

cbt setgcpolicy <table> <family> ( maxage=<d> | maxversions=<n> )

  maxage=<d>		Maximum timestamp age to preserve (e.g. "1h", "4d")
  maxversions=<n>	Maximum number of versions to preserve

Print the current cbt version

Usage:

cbt version