Method: projects.instances.tables.create

Creates a new table in the specified instance. The table can be created with a full set of initial column families, specified in the request.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The unique name of the instance in which to create the table. Values are of the form projects/<project>/instances/<instance>.

Authorization requires the following Google IAM permission on the specified resource parent:

  • bigtable.tables.create

Request body

The request body contains data with the following structure:

JSON representation
  "tableId": string,
  "table": {
    object (Table)
  "initialSplits": [
      object (Split)


The name by which the new table should be referred to within the parent instance, e.g., foobar rather than <parent>/tables/foobar. Maximum 50 characters.


object (Table)

The Table to create.


object (Split)

The optional list of row keys that will be used to initially split the table into several tablets (tablets are similar to HBase regions). Given two split keys, s1 and s2, three tablets will be created, spanning the key ranges: [, s1), [s1, s2), [s2, ).


  • Row keys := ["a", "apple", "custom", "customer_1", "customer_2", "other", "zz"]
  • initial_split_keys := ["apple", "customer_1", "customer_2", "other"]
  • Key assignment:
    • Tablet 1 [, apple) => {"a"}.
    • Tablet 2 [apple, customer_1) => {"apple", "custom"}.
    • Tablet 3 [customer_1, customer_2) => {"customer_1"}.
    • Tablet 4 [customer_2, other) => {"customer_2"}.
    • Tablet 5 [other, ) => {"other", "zz"}.

Response body

If successful, the response body contains a newly created instance of Table.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.


An initial split point for a newly created table.

JSON representation
  "key": string

string (bytes format)

Row key to use as an initial tablet boundary.

A base64-encoded string.

Try it!

Trang này có hữu ích không? Hãy cho chúng tôi biết đánh giá của bạn:

Gửi phản hồi về...

Cloud Bigtable Documentation