引擎與版本

• CREATE TABLE適用于寬表引擎和時(shí)序引擎。

• 時(shí)序引擎自3.4.32版本開(kāi)始支持標(biāo)準(zhǔn)CREATE TABLE語(yǔ)法。如何查看或升級(jí)時(shí)序引擎版本，請(qǐng)參見(jiàn)時(shí)序引擎版本說(shuō)明和升級(jí)小版本。

語(yǔ)法

create_table_statement ::=  CREATE TABLE [ IF NOT EXISTS ] table_identifier
                            '('
                                column_definition
                                ( ',' column_definition )*
                                 ',' PRIMARY KEY '(' primary_key ')' 
                            ')' 
                            [ PARTITION BY partition_definition ]
                            [ WITH  table_options ]
column_definition      ::=  column_identifier data_type [ NOT NULL ]
primary_key            ::=  column_identifier [ ',' column_identifier (ASC|DESC)]
partition_definition   ::=  HASH '(' column_identifier (',' column_identifier )* ')'
table_options          ::=  '(' option_definition (',' option_definition )*  ')'
option_definition      ::=  option_identifer '=' string_literal

差異說(shuō)明

Lindorm寬表引擎和時(shí)序引擎的CREATE TABLE語(yǔ)法差異較大。差異對(duì)比請(qǐng)參見(jiàn)下表。

使用說(shuō)明

表名（table_identifier）

關(guān)于表名的設(shè)置，您需要注意以下內(nèi)容：

• 可包含數(shù)字、大寫(xiě)英文字符、小寫(xiě)英文字符、半角句號(hào)（.）、中劃線（-）和下劃線（_）。

• 表名不能以半角句號(hào)（.）或中劃線（-）開(kāi)頭。

• 表名的長(zhǎng)度為1~255字符。

列定義（column_definition）

主鍵（primary_key）

主鍵是表中數(shù)據(jù)的唯一標(biāo)識(shí)，由一列或多列組成，建表時(shí)必須指定主鍵PRIMARY KEY。

在使用CREATE TABLE語(yǔ)句建表時(shí)，需要注意以下內(nèi)容：

分區(qū)（partition_definition）

僅時(shí)序引擎支持分區(qū)。在時(shí)序表中，用作PARTITION BY的列必須是主鍵定義中的VARCHAR列。

建表時(shí)，您可以通過(guò)PARTITION BY HASH(column1, column2, ..., columnN)語(yǔ)句，顯示指定一個(gè)或多個(gè)列為表進(jìn)行Hash分區(qū)。例如：PARTITION BY HASH(c1, p1)。

表屬性（table_options）

僅寬表引擎支持表屬性（table_options）。您可以通過(guò)WITH關(guān)鍵字添加以下表屬性：

示例

創(chuàng)建表

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
);

結(jié)果驗(yàn)證

您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

指定數(shù)據(jù)有效期和壓縮算法

創(chuàng)建寬表時(shí)指定數(shù)據(jù)有效期為30天（2592000秒），壓縮算法為ZSTD。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) WITH (COMPRESSION='ZSTD', TTL='2592000');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在當(dāng)前詳情表格區(qū)域，單擊查看表屬性，查看COMPRESSION和TTL參數(shù)的值。如何進(jìn)入集群管理系統(tǒng)，請(qǐng)參見(jiàn)登錄集群管理系統(tǒng)。

指定Major Compaction周期

創(chuàng)建寬表時(shí)指定Major Compaction的周期為10天（864,000,000毫秒）。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) WITH (COMPACTION_MAJOR_PERIOD='864000000');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在當(dāng)前詳情表格區(qū)域，單擊查看表屬性，查看COMPACTION_MAJOR_PERIOD參數(shù)的值。

開(kāi)啟動(dòng)態(tài)列功能

創(chuàng)建寬表時(shí)將DYNAMIC_COLUMNS參數(shù)的值設(shè)置為TRUE后，支持在表中寫(xiě)入動(dòng)態(tài)列數(shù)據(jù)。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) WITH (DYNAMIC_COLUMNS='TRUE');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在當(dāng)前詳情表格區(qū)域，單擊查看表屬性，查看DYNAMIC_COLUMNS參數(shù)的值。

指定冷熱分界線

創(chuàng)建寬表時(shí)設(shè)置冷熱分界線，系統(tǒng)將根據(jù)冷熱分界線歸檔數(shù)據(jù)。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) WITH (CHS = '86400', CHS_L2 = 'storagetype=COLD');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在當(dāng)前詳情表格區(qū)域，單擊查看表屬性，查看CHS和CHS_L2參數(shù)的值。

同時(shí)設(shè)置多個(gè)屬性

創(chuàng)建寬表時(shí)指定表的壓縮算法、數(shù)據(jù)有效期以及冷熱分界線。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) WITH (
    COMPRESSION='ZSTD', 
    CHS = '86400', 
    CHS_L2 = 'storagetype=COLD', 
    TTL = '2592000');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在當(dāng)前詳情表格區(qū)域，單擊查看表屬性，查看COMPRESSION、CHS、CHS_L2和TTL參數(shù)的值。

設(shè)置分區(qū)

創(chuàng)建寬表時(shí)預(yù)定義5個(gè)分區(qū)，且5個(gè)分區(qū)的起始Key為1000，終止Key為9000。

CREATE TABLE sensor (
  p1 INTEGER NOT NULL, 
  c1 INTEGER, 
  c2 VARCHAR, 
  c3 VARCHAR,
  PRIMARY KEY(p1)
) WITH (NUMREGIONS='5', STARTKEY='1000', ENDKEY='9000');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在分片詳情區(qū)域，查看各分片的startKey和endKey參數(shù)的值。

設(shè)置多個(gè)分區(qū)的起始Key

創(chuàng)建寬表時(shí)預(yù)定義5個(gè)分區(qū)的起始Key，表創(chuàng)建好后默認(rèn)包含6個(gè)預(yù)分區(qū)。

CREATE TABLE sensor (
  p1 INT NOT NULL,
  p2 INT NOT NULL,
  c1 VARCHAR,
  c2 BIGINT,
  PRIMARY KEY(p1, p2)
) WITH (SPLITKEYS = '100000,300000,500000,700000,900000');

結(jié)果驗(yàn)證

• 您可以執(zhí)行DESCRIBE table sensor;查看表是否已創(chuàng)建成功。

• 在集群管理系統(tǒng)的概覽頁(yè)面，單擊目標(biāo)數(shù)據(jù)庫(kù)下的目標(biāo)表名。在分片詳情區(qū)域，查看各分片的startKey和endKey參數(shù)的值。

顯式指定分區(qū)列

由于大部分查詢(xún)場(chǎng)景會(huì)查詢(xún)單個(gè)設(shè)備的瞬時(shí)數(shù)據(jù)，因此可以顯式指定device_id作為數(shù)據(jù)分區(qū)的分區(qū)列。

CREATE TABLE sensor (
    device_id VARCHAR NOT NULL,
    region VARCHAR NOT NULL,
    time TIMESTAMP NOT NULL,
    temperature DOUBLE,
    humidity BIGINT,
    PRIMARY KEY(device_id, region, time)
) PARTITION BY HASH(device_id);

結(jié)果驗(yàn)證

您可以執(zhí)行DESCRIBE TABLE sensor;語(yǔ)句，驗(yàn)證建表結(jié)果。