CREATE DATABASE 構文を使用して、Lindorm インスタンスにデータベースを作成し、データベースの TTL などの属性を設定して、データを一元的に管理できます。
適用可能なエンジンとバージョン
CREATE DATABASE 構文は、LindormTable と LindormTSDB に適用されます。
CREATE DATABASE 構文は、LindormTable 2.2.16 以降のバージョンでサポートされています。
CREATE DATABASE 構文は、LindormTSDB のすべてのバージョンでサポートされています。
構文
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 より前の LindormTable は、CREATE SCHEMA [ IF NOT EXISTS ] schema_identifier 構文のみをサポートしています。 LindormTable 2.2.16 以降のバージョンでは、それと同等の構文 CREATE SCHEMA [ IF NOT EXISTS ] schema_identifier をサポートしています。SCHEMA は DATABASE と同等です。データベースを作成すると、データベースは DATABASE キーワードで表されます。
サポートされているパラメーター
次の表に、LindormTable と LindormTSDB でサポートされている CREATE DATABASE 構文のパラメーターを示します。
パラメーター | LindormTable | LindormTSDB |
〇 | 〇 | |
✖️ | 〇 |
パラメーター
データベース名 (database_identifier)
データベース名は、次の規則に準拠する必要があります。
名前の長さは 4 ~ 16 文字にすることができます。
名前に数字、文字、ハイフン (-)、アンダースコア (_) を使用できます。
予約語である lindorm、default、global はデータベース名として使用できません。
データベース属性 (attribute_definition)
このパラメーターは、LindormTSDB のみでサポートされています。
WITH キーワードを使用して、データベースに 1 つ以上の属性を設定できます。例: WITH (cold_boundary=30, ttl=60)。次の表に、データベースに設定できる属性を示します。
属性 | タイプ | 説明 |
cold_boundary | BIGINT | ホットデータとコールドデータの境界。単位: 日。この属性のデフォルト値は 0 で、データベースのコールドストレージが有効になっていないことを示します。 説明 この属性を設定するには、Lindorm コンソールでコールドストレージ機能を有効にする必要があります。詳細については、「容量ストレージを有効にする」をご参照ください。 |
partition_interval | BIGINT | データをパーティション分割する基準となる間隔。同じ間隔内のデータとインデックスは、同じパーティションに格納されます。単位: 日。 この属性のデフォルト値は、LindormTable のバージョンによって異なります。
|
ttl | BIGINT | データベース内のデータの TTL。単位: 日。TTL を超えたデータは自動的に消去されます。デフォルト値: 0。この属性を指定しないでおくか、この属性のデフォルト値を維持すると、データベース内のデータは永続的に保存されます。 説明 ttl 属性と cold_boundary 属性を設定する場合は、ttl 属性の値が cold_boundary 属性の値よりも大きいことを確認してください。 |
例
データベースを作成する
CREATE DATABASE DB1; 結果を確認する
SHOW DATABASES; ステートメントを実行して、データベースが作成されたかどうかを確認できます。
データベースの属性を設定する
DB1 という名前のデータベースを作成し、DB1 内のデータが 30 日後にコールドストレージに転送され、60 日後に消去されるように指定します。
CREATE DATABASE DB1 WITH(cold_boundary=30,ttl=60);結果を確認する
SHOW DATABASES;ステートメントを実行して、データベースが作成されたかどうかを確認できます。DESCRIBE DATABASE DB1;ステートメントを実行して、データベース DB1 に設定されている属性を表示できます。