CREATE TABLE語句用于在Lindorm寬表引擎或時序引擎中創建表,支持多種數據類型,例如VARCHAR、TIMESTAMP、BIGINT等;支持多種表屬性,例如數據有效期TTL、壓縮算法COMPRESSION等。您可以靈活搭配各種表屬性和數據類型,設計出更貼合業務場景的表。
引擎與版本
語法
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
差異說明
Lindorm寬表引擎和時序引擎的CREATE TABLE語法差異較大。差異對比請參見下表。
語法要素 | 寬表引擎 | 時序引擎 |
〇 | 〇 | |
〇 | 〇 | |
〇 | 〇 | |
?? | 〇 | |
〇 | ?? |
使用說明
表名(table_identifier)
關于表名的設置,您需要注意以下內容:
可包含數字、大寫英文字符、小寫英文字符、半角句號(.)、中劃線(-)和下劃線(_)。
表名不能以半角句號(.)或中劃線(-)開頭。
表名的長度為1~255字符。
列定義(column_definition)
語法要素 | 是否必填 | 使用說明 |
列名(column_identifier) | 是 |
|
數據類型(data_type) | 是 | 支持的數據類型,請參見數據類型。 重要 創建時序表時,如果需要使用時間戳(TIMESTAMP)數據類型,請注意以下幾點:
|
NULL約束 | 否 | 列的值是否允許為NULL。 重要 目前Lindorm SQL不會進行NULL約束的校驗,該校驗工作是由存儲引擎執行的。 NULL約束的校驗方式取決于存儲引擎的校驗規則,不同存儲引擎的校驗規則不同,因此在使用過程中可能會出現已指定NOT NULL但仍可寫入NULL的情況。 為保證數據能夠正常寫入,請遵循以下統一要求:
|
主鍵(primary_key)
Lindorm單機版實例不支持PRIMARY KEY。
主鍵是表中數據的唯一標識,由一列或多列組成,建表時必須指定主鍵PRIMARY KEY。
在使用CREATE TABLE
語句建表時,需要注意以下內容:
引擎類型 | 主鍵使用說明 |
寬表引擎 |
|
時序引擎 |
|
分區(partition_definition)
僅時序引擎支持分區。在時序表中,用作PARTITION BY的列必須是主鍵定義中的VARCHAR列。
建表時,您可以通過PARTITION BY HASH(column1, column2, ..., columnN)
語句,顯示指定一個或多個列為表進行Hash分區。例如:PARTITION BY HASH(c1, p1)
。
表屬性(table_options)
僅寬表引擎支持表屬性(table_options)。您可以通過WITH
關鍵字添加以下表屬性:
選項 | 類型 | 描述 |
COMPRESSION | STRING | 表的壓縮算法。可選的壓縮算法分別是:
說明 寬表引擎2.3.4版本前默認未指定壓縮算法,寬表引擎2.3.4及以后的版本默認壓縮算法為ZSTD。 |
TTL | INT | 數據有效期,單位為秒(s)。 說明
|
COMPACTION_MAJOR_PERIOD | LONG | 系統執行 說明 默認值:Math.Min(TTL,1728000000ms)。如果不設置TTL,系統默認該參數值為20天(20*24*60*60*1000ms=1728000000ms)。 |
MUTABILITY | STRING | 索引相關,表示對主表的寫入模式進行分類。默認值為MUTABLE_LATEST。 所有取值如下:
取值的詳細說明,請參見高性能原生二級索引。 重要 創建索引表后,MUTABILITY參數的值不支持修改。 |
CONSISTENCY | STRING | 表的一致性屬性。對于多可用區實例,該參數表示主備數據的一致性。包括以下兩種級別:
重要 對于多可用區實例,如果數據存在先讀后寫,例如increase、append、索引更新,則需要指定主表CONSISTENCY參數的值為 |
NUMREGIONS | INT | 預先設置建表時的Region數。 |
CHS | INT | 冷熱分界線,單位為秒。 說明
|
STARTKEY和ENDKEY | 與PRIMARY KEY中第一個列的數據類型相同 | 預先設置建表的Region分區起止Key。 說明
|
SPLITKEYS | 與PRIMARY KEY中第一個列的數據類型相同 | 預先設置表的全部預分區的起始Key。 說明
|
SPLITALGO | STRING | 定義預分區的分裂算法。目前僅支持以下分裂算法:
|
DYNAMIC_COLUMNS | STRING | 是否開啟動態列。取值:
說明 動態列僅支持Varbinary類型。關于動態列的介紹,請參見動態列。 |
VERSIONS | STRING | 列值保留的版本數。取值為大于等于1的整數。默認值為1,表示保留一個版本。Lindorm支持列值保留多個版本,多版本管理的詳細說明,請參見多版本數據管理。 重要 VERSIONS參數的值過大可能會影響數據的查詢和存儲性能,請盡量避免設置過大的值。建議將VERSIONS的值設置1。 |
BLOB_BUCKET_NAME | STRING | 為包含BLOB列的表創建BUCKET。取值為自定義的BUCKET名稱。 BUCKET名稱需遵循以下規則:
說明
|
2.2.16版本前的寬表引擎在設置表屬性時不支持WITH
關鍵字,需在表屬性關鍵字前后添加半角單引號('),屬性值可以基于類型進行設置。如果屬性值的類型是字符串(STRING)則需在字符串前后添加半角單引號('),例如CREATE TABLE IF NOT EXISTS t1(c1 varchar, c2 bigint, c3 int, c4 int, PRIMARY KEY(c1,c2)) 'CONSISTENCY'='strong';
。
示例
創建表
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)
);
結果驗證
您可以執行DESCRIBE table sensor;
查看表是否已創建成功。
指定數據有效期和壓縮算法
創建寬表時指定數據有效期為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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在當前詳情表格區域,單擊查看表屬性,查看COMPRESSION和TTL參數的值。如何進入集群管理系統,請參見登錄集群管理系統。
指定Major Compaction周期
創建寬表時指定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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在當前詳情表格區域,單擊查看表屬性,查看COMPACTION_MAJOR_PERIOD參數的值。
開啟動態列功能
創建寬表時將DYNAMIC_COLUMNS參數的值設置為TRUE
后,支持在表中寫入動態列數據。
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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在當前詳情表格區域,單擊查看表屬性,查看DYNAMIC_COLUMNS參數的值。
指定冷熱分界線
創建寬表時設置冷熱分界線,系統將根據冷熱分界線歸檔數據。
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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在當前詳情表格區域,單擊查看表屬性,查看CHS和CHS_L2參數的值。
同時設置多個屬性
創建寬表時指定表的壓縮算法、數據有效期以及冷熱分界線。
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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在當前詳情表格區域,單擊查看表屬性,查看COMPRESSION、CHS、CHS_L2和TTL參數的值。
設置分區
創建寬表時預定義5個分區,且5個分區的起始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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在分片詳情區域,查看各分片的startKey和endKey參數的值。
設置多個分區的起始Key
創建寬表時預定義5個分區的起始Key,表創建好后默認包含6個預分區。
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');
結果驗證
您可以執行
DESCRIBE table sensor;
查看表是否已創建成功。在集群管理系統的概覽頁面,單擊目標數據庫下的目標表名。在分片詳情區域,查看各分片的startKey和endKey參數的值。
顯式指定分區列
由于大部分查詢場景會查詢單個設備的瞬時數據,因此可以顯式指定device_id作為數據分區的分區列。
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);
結果驗證
您可以執行DESCRIBE TABLE sensor;
語句,驗證建表結果。