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
POST https://bigtableadmin.googleapis.com/v2/{parent=projects/*/instances/*}/tables
The URL uses gRPC Transcoding syntax.
Path parameters
parent
string
Required. 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 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 ( |
tableId
string
Required. 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.
table
object (
Table
)
Required. The Table to create.
initialSplits[]
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, )
.
Example:
- 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"}.
- Tablet 1
Response body
If successful, the response body contains a newly created instance of Table
.
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/bigtable.admin -
https://www.googleapis.com/auth/bigtable.admin.table -
https://www.googleapis.com/auth/cloud-bigtable.admin -
https://www.googleapis.com/auth/cloud-bigtable.admin.table -
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
Split
An initial split point for a newly created table.
| JSON representation |
|---|
{ "key" : string } |
| Fields | |
|---|---|
key
|
Row key to use as an initial tablet boundary. A base64-encoded string. |
