本文介紹建立時空資料表的文法。
文法
create_table_statement ::= CREATE TABLE [ IF NOT EXISTS ] table_name
'('
column_definition
( ',' column_definition )*
',' [constraint pk] PRIMARY KEY '(' primary_key ')'
')' WITH [ table_options ]
column_definition ::= column_name lql_type
primary_key ::= primary_item [ ',' primary_item ]
primary_item ::= column_name (ASC|DESC)
| [z-order] '(' [ column_name ( ',' column_name )* ] ')'
建立表語句支援IF NOT EXISTS,其中主鍵由某個或某幾個列組合而成。
使用說明
表名(table_identifier)
關於表名的設定,您需要注意以下內容:
可包含數字、大寫英文字元、小寫英文字元、半形句號(.)、中劃線(-)和底線(_)。
表名不能以半形句號(.)或中劃線(-)開頭。
表名的長度為1~255字元。
列定義(column_definition)
文法要素 | 是否必填 | 使用說明 |
列名(column_identifier) | 是 |
|
資料類型(data_type) | 是 | 支援的資料類型,請參見資料類型。 重要 建立時序表時,如果需要使用時間戳(TIMESTAMP)資料類型,請注意以下幾點:
|
NULL約束 | 否 | 列的值是否允許為NULL。 重要 目前Lindorm SQL不會進行NULL約束的校正,該校正工作是由儲存引擎執行的。 NULL約束的校正方式取決於儲存引擎的校正規則,不同儲存引擎的校正規則不同,因此在使用過程中可能會出現已指定NOT NULL但仍可寫入NULL的情況。 為保證資料能夠正常寫入,請遵循以下統一要求:
|
主鍵(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 | 表的一致性。預設主表和索引表最終一致,包括以下兩種層級:
重要 建立索引表後,CONSISTENCY參數的值不支援由 建立主表時設定參數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';
。
樣本
建立支援任意空間資料類型(Geometry)的表,可以寫入任意空間資料類型。
CREATE TABLE geoms(gid INT, g GEOMETRY, PRIMARY KEY(gid));
寫入任意空間資料類型的資料。
UPSERT INTO geoms(gid, g) VALUES(0,ST_GeomFromText('POINT(-10.1 3.3)')),(1,ST_GeomFromText('LINESTRING(-12.2 4.3, -10.2 4.3)')),(2,ST_GeomFromText('POLYGON((2 2, 2 8, 8 8, 8 2, 2 2))'));
建立支援點類型(Point)的表,僅支援寫入點資料。
CREATE TABLE pts(gid INT, g GEOMETRY(POINT), PRIMARY KEY(gid));
寫入點資料。
UPSERT INTO pts(gid, g) VALUES(0, ST_MakePoint(0,0)),(1, ST_MakePoint(1,1));
建立支援面類型(Polygon)的表,僅支援寫入面資料。
CREATE TABLE polys(gid INT, g GEOMETRY(POLYGON), PRIMARY KEY(gid));
寫入面資料。
UPSERT INTO polys(gid,g) VALUES(0,ST_GeomFromText('POLYGON((2 2, 2 8, 8 8, 8 2, 2 2))'));
建立支援線類型(LineString)的表,僅支援寫入線資料。
CREATE TABLE lines(gid INT, g GEOMETRY(LINESTRING), PRIMARY KEY(gid));
寫入線資料。
UPSERT INTO lines(gid,g) VALUES(0, ST_GeomFromText('LINESTRING(-12.2 4.3, -10.2 4.3)'));
建立支援多點(MULTIPOINT)類型的表,僅支援寫入多點資料。
CREATE TABLE multipoints(gid INT, g GEOMETRY(MULTIPOINT), PRIMARY KEY(gid));
寫入多點資料。
UPSERT INTO multipoints(gid,g) VALUES(0, ST_GeomFromText('MULTIPOINT (10 40, 40 30, 20 20, 30 10)'));
建立支援多線段(MULTILINESTRING)類型的表,僅支援寫入多線段資料。
CREATE TABLE multilines(gid INT, g GEOMETRY(MULTILINESTRING), PRIMARY KEY(gid));
寫入多線段資料。
UPSERT INTO multilines(gid,g) VALUES(0, ST_GeomFromText('MULTILINESTRING ((10 10, 20 20, 10 40),(40 40, 30 30, 40 20, 30 10))'));
建立支援多面(MULTIPOLYGON)類型的表,僅支援寫入多面資料。
CREATE TABLE multipolys(gid INT, g GEOMETRY(MULTIPOLYGON), PRIMARY KEY(gid));
寫入多面資料。
UPSERT INTO multipolys(gid,g) VALUES(0, ST_GeomFromText('MULTIPOLYGON (((30 20, 45 40, 10 40, 30 20)),((15 5, 40 10, 10 20, 5 10, 15 5)))'));
建立支援多空間對象(GEOMETRYCOLLECTION)類型的表,僅支援寫入多空間對象資料。
CREATE TABLE collections(gid INT, g GEOMETRY(GEOMETRYCOLLECTION), PRIMARY KEY(gid));
寫入多空間對象資料。
UPSERT INTO collections(gid,g) VALUES(0, ST_GeomFromText('GEOMETRYCOLLECTION (POINT (40 10), LINESTRING (10 10, 20 20, 10 40), POLYGON ((40 40, 20 45, 45 30, 40 40)))'));
建立由多個空間資料類型(Geometry)的列組成的表。
CREATE TABLE mix(gid INT, pt GEOMETRY(POINT), ply GEOMETRY(POLYGON), PRIMARY KEY(gid));