Creates a new table with the given type (definition of columns). The type is specified in input parameter type_id as either a numerical type ID (as returned by Create Type) or as a list of columns, each specified as a list of the column name, data type, and any column attributes.
Example of a type definition with some parameters:
[ ["id", "int8", "primary_key"], ["dept_id", "int8", "primary_key", "shard_key"], ["manager_id", "int8", "nullable"], ["first_name", "char32"], ["last_name", "char64"], ["salary", "decimal"], ["hire_date", "date"] ]
Each column definition consists of the column name (which should meet the standard column naming criteria), the column's specific type (int, long, float, double, string, bytes, or any of the properties map values from Create Type), and any data handling, data key, or data replacement properties.
A table may optionally be designated to use a replicated distribution scheme, or be assigned: foreign keys to other tables, a partitioning scheme, and/or a tier strategy.
Input Parameter Description
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
table_name | string | Name of the table to be created, in [schema_name.]table_name format, using standard name resolution rules and meeting table naming criteria. Error for requests with existing table of the same name and type ID may be suppressed by using the no_error_if_exists option. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
type_id | string | The type for the table, specified as either an existing table's numerical type ID (as returned by Create Type ) or a type definition (as described above). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
options | map of string to strings | Optional parameters. The default value is an empty map ( {} ).
|
Output Parameter Description
Name | Type | Description | ||||
---|---|---|---|---|---|---|
table_name | string | Value of input parameter table_name. | ||||
type_id | string | Value of input parameter type_id. | ||||
is_collection | boolean | [DEPRECATED--this will always return false] Indicates if the created entity is a schema. | ||||
info | map of string to strings | Additional information. The default value is an empty map ( {} ).
|