すべてのプロダクト
Search
ドキュメントセンター

Lindorm:CREATE DATABASE

最終更新日:Jan 14, 2025

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 をサポートしています。SCHEMADATABASE と同等です。データベースを作成すると、データベースは DATABASE キーワードで表されます。

サポートされているパラメーター

次の表に、LindormTable と LindormTSDB でサポートされている CREATE DATABASE 構文のパラメーターを示します。

パラメーター

LindormTable

LindormTSDB

データベース名 (database_identifier)

データベース属性 (attribute_definition)

✖️

パラメーター

データベース名 (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 のバージョンによって異なります。

  • LindormTable のバージョンが 3.4.19 以降の場合、この属性のデフォルト値は 30 です。

  • LindormTable のバージョンが 3.4.19 より前の場合、この属性のデフォルト値は 0 です。

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 に設定されている属性を表示できます。