建立資料庫

CREATE DATABASE文法用於在Lindorm執行個體中建立資料庫，並設定資料庫屬性，例如資料有效期間TTL，方便您統一歸檔資料。

引擎與版本

CREATE DATABASE文法適用於寬表引擎和時序引擎。
寬表引擎僅2.2.16及以上版本支援CREATE DATABASE文法。
時序引擎無版本限制。

文法

create_database_statement ::=  CREATE DATABASE [ IF NOT EXISTS ] database_identifier [ WITH attribute_statement ]
attribute_statement       ::= '(' attribute_definition (',' attribute_definition)* ')'
attribute_definition      ::= attr_identifier '=' attr_val

說明

2.2.16以下版本的寬表引擎僅支援文法CREATE SCHEMA [ IF NOT EXISTS ] schema_identifier，2.2.16及以上版本的寬表引擎同時支援等價文法CREATE SCHEMA [ IF NOT EXISTS ] schema_identifier。SCHEMA為DATABASE的別名，建立資料庫後，使用該資料庫時統一預設顯示DATABASE。

差異說明

寬表引擎和時序引擎對不同文法要素的支援情況如下：

文法要素	寬表引擎	時序引擎
資料庫名（database_identifier）	〇	〇
資料庫屬性（attribute_definition）	✖️	〇

使用說明

資料庫名（database_identifier）

資料庫名需遵循以下規則：

長度為4~16字元。
可包含數字、大寫英文字元、小寫英文字元、中劃線（-）和底線（_）。
不能是系統保留名稱：lindorm、default、global。

資料庫屬性（attribute_definition）

僅時序引擎支援資料庫屬性。

您可以通過WITH關鍵字為資料庫添加一個或多個屬性，例如WITH (cold_boundary=30, ttl=60)。支援的屬性如下：

屬性名稱	類型	描述
cold_boundary	BIGINT	冷熱儲存分界線，單位為天。預設值為0 ，表示不啟用冷儲存。說明如果需要設定cold_boundary，請先在Lindorm管理主控台上開通冷儲存功能。如何開通，請參見開通冷儲存。
partition_interval	BIGINT	分區時間長度，同一時間段的資料和索引儲存在一個時間分區，單位為天。關於預設值，需注意以下內容： 3.4.19及以上版本的時序引擎，partition_interval參數預設值為30。 3.4.19之前版本的時序引擎，partition_interval參數預設值為0。
ttl	BIGINT	資料有效期間，單位為天。超過有效期間的資料會被自動清理。預設值為0，設定為0或不設定該參數時表示資料永久儲存。說明如果同時設定了ttl和cold_boundary，ttl的設定時間長度必須大於cold_boundary的時間。

樣本

CREATE DATABASE DB1;

結果驗證

您可以通過SHOW DATABASES;語句，查看資料庫是否建立成功。

指定資料庫屬性

建立資料庫DB1，其中資料存滿30天后轉入冷儲存，存滿60天后會被清除。

CREATE DATABASE DB1 WITH(cold_boundary=30,ttl=60);

結果驗證

您可以通過SHOW DATABASES;語句，查看資料庫是否建立成功。
通過DESCRIBE DATABASE DB1;可以查看資料庫DB1的屬性值。