Lindorm:カスタム時間列に基づくコールド・ホットデータ分離

テーブルのコールド・ホットデータ境界の設定

1. カスタム時間列とコールド・ホットデータ境界を設定します。

   • 方法 1: テーブルの作成時に設定します。

     dt という名前のテーブルを作成します。コールド・ホットデータ境界を 1 日に設定し、p2 列をコールド・ホットデータ分離に使用します。

     -- コールド・ホットデータ境界を 1 日に設定し、p2 列をコールド・ホットデータ分離に使用します。p2 列の値の時間単位は、デフォルトでミリ秒 (ms) です。
     CREATE TABLE dt (p1 integer, p2 bigint, p3 bigint, c1 varchar,  constraint pk PRIMARY KEY(p1, p2, p3)) WITH(COMPRESSION = 'ZSTD', CHS ='86400', CHS_L2 = 'storagetype=COLD', CHS_COLUMN = 'COLUMN=p2');
     
     -- コールド・ホットデータ境界を 1 日に設定し、p2 列をコールド・ホットデータ分離に使用します。p2 列の値の時間単位を秒 (s) に設定します。
     CREATE TABLE dt (p1 integer, p2 bigint, p3 bigint, c1 varchar,  constraint pk PRIMARY KEY(p1, p2, p3)) WITH(COMPRESSION = 'ZSTD', CHS ='86400', CHS_L2 = 'storagetype=COLD', CHS_COLUMN = 'COLUMN=p2|TIMEUNIT=SECONDS');
     
     -- コールド・ホットデータ境界を 1 日に設定し、p2 列をコールド・ホットデータ分離に使用します。p2 列の値の時間単位を分 (min) に設定します。
     CREATE TABLE dt (p1 integer, p2 bigint, p3 bigint, c1 varchar,  constraint pk PRIMARY KEY(p1, p2, p3)) WITH(COMPRESSION = 'ZSTD', CHS ='86400', CHS_L2 = 'storagetype=COLD', CHS_COLUMN = 'COLUMN=p2|TIMEUNIT=MINUTES');

     パラメーター

     パラメーター	説明
     CHS	コールド・ホットデータ境界 (秒単位)。たとえば、CHS が 86400 に設定されている場合、カスタム時間列のタイムスタンプが 86,400 秒 (1 日) より古いデータは、自動的にコールドストレージにアーカイブされます。
     COMPRESSION	圧縮アルゴリズム。これはテーブル全体に適用されます。アルゴリズム名では大文字と小文字は区別されません。デフォルト設定は none です。
     CHS_L2	レイヤー 2 プロパティ。これは通常、ストレージタイプを指定するために設定されます: storagetype=COLD。
     CHS_COLUMN	カスタム時間列。その値のデフォルト単位はミリ秒 (ms) です。その他のサポートされている時間単位には、SECONDS、MINUTES、MICROSECONDS、NANOSECONDS があります。フォーマットは COLUMN=<custom_time_column>|TIMEUNIT=<time_unit> です。例: COLUMN=p2|TIMEUNIT=SECONDS。 重要 CHS_COLUMN を設定する際、等号 (=) の両側にスペースを追加しないでください。追加すると、エラーが発生します。

     結果の確認

     次のいずれかの方法で設定を確認できます:

     • SHOW VARIABLES 文を実行して、テーブルのプロパティを表示します。例: SHOW TABLE VARIABLES FROM dt LIKE 'CHS_COLUMN';。

     • クラスター管理システム の [概要] ページで、ターゲットデータベース内のターゲットテーブルの名前をクリックします。[現在のテーブル詳細] エリアで、CHS や CHS_COLUMN などのパラメーターの値を確認できます。

   • 方法 2: テーブル作成時にコールド・ホットデータ分離が有効になっていなかった場合は、ALTER TABLE 文を使用して関連プロパティを追加します。

     -- 作成時にコールド・ホットデータ分離が有効になっていなかった既存のデータテーブルの場合、例:
     -- CREATE TABLE dt (p1 integer, p2 bigint, p3 bigint, c1 varchar,  constraint pk primary key(p1, p2, p3));
     
     -- dt テーブルに対してカスタム列に基づいてコールド・ホットデータ分離を有効にします。コールド・ホットデータ境界を 1 日に設定し、分離に p2 列を使用し、デフォルトの単位であるミリ秒 (ms) を使用します。
     ALTER TABLE dt SET 'CHS' ='86400', 'CHS_L2' = 'storagetype=COLD', 'CHS_COLUMN' = 'COLUMN=p2';
     
     -- dt テーブルに対してカスタム列に基づいてコールド・ホットデータ分離を有効にします。コールド・ホットデータ境界を 1 日に設定し、分離に p2 列を使用し、時間単位を秒 (s) に変更します。
     ALTER TABLE dt SET 'CHS' ='86400', 'CHS_L2' = 'storagetype=COLD', 'CHS_COLUMN' = 'COLUMN=p2|TIMEUNIT=SECONDS';
     
     -- dt テーブルに対してカスタム列に基づいてコールド・ホットデータ分離を有効にします。コールド・ホットデータ境界を 1 日に設定し、分離に p2 列を使用し、時間単位を分 (min) に変更します。
     ALTER TABLE dt SET 'CHS' ='86400', 'CHS_L2' = 'storagetype=COLD', 'CHS_COLUMN' = 'COLUMN=p2|TIMEUNIT=MINUTES';

     結果の確認

     次のいずれかの方法で設定を確認できます:

     • SHOW VARIABLES 文を実行して、テーブルのプロパティを表示します。例: SHOW TABLE VARIABLES FROM dt LIKE 'CHS_COLUMN';。

     • クラスター管理システム の [概要] ページで、ターゲットデータベース配下のターゲットテーブルの名前をクリックします。[現在のテーブル詳細] エリアで、CHS や CHS_COLUMN などのパラメーターの値を確認します。

2. 任意: テーブルのコールド・ホットデータ境界とカスタム時間列を変更します。

   • コールド・ホットデータ境界を変更します。

     ALTER TABLE dt SET 'CHS'='1000';

   • カスタム時間列を変更します。

     ALTER TABLE dt SET 'CHS_COLUMN'='COLUMN=p3'; 

3. 任意: テーブルのコールド・ホットデータ分離をキャンセルします。

   ALTER TABLE dt SET 'CHS'='', 'CHS_L2' = '', 'CHS_COLUMN'='';

   説明

   コールド・ホットデータ境界を変更したり、コールド・ホットデータ分離をキャンセルしたりした後、データがコールドストレージからホットストレージに戻される前に、システムがバックグラウンドで compaction を実行するのを待つ必要があります。データをすぐにホットストレージに戻すには、major_compact コマンドを手動で実行できます。

セカンダリインデックスのコールド・ホットデータ境界の設定

デフォルトでは、セカンダリインデックスはテーブルに格納されます。したがって、テーブルの場合と同じ方法で、セカンダリインデックスのホットデータとコールドデータを分離できます。

次の例では、前のセクションの dt テーブルのセカンダリインデックスを作成します。

1. セカンダリインデックスを作成し、コールド・ホットデータ分離を有効にします。

   • 方法 1: セカンダリインデックスの作成時にカスタム時間列とコールド・ホットデータ境界を設定します。

     CREATE INDEX idx on dt (c1) WITH(CHS = '86400', CHS_L2 = 'storagetype=COLD', CHS_COLUMN='COLUMN=p2');

     説明

     セカンダリインデックスにカスタム時間列を指定することはできません。CHS_COLUMN は、ベーステーブルのカスタム時間列に設定する必要があります。

   • 方法 2: セカンダリインデックスの作成時に設定が構成されていなかった場合は、ALTER TABLE 文を使用してカスタム時間列とコールド・ホットデータ境界を設定します。

     -- 作成時にコールド・ホットデータ分離が有効になっていなかった既存のセカンダリインデックスの場合、例:
     -- CREATE INDEX idx on dt (c1);
     
     -- セカンダリインデックステーブルのコールド・ホットデータ分離を有効にします。コールド・ホットデータ境界を 1 日に設定し、分離に p2 列を使用します。
     ALTER TABLE `dt.idx` SET 'CHS' = '86400', 'CHS_L2' = 'storagetype=COLD', 'CHS_COLUMN'='COLUMN=p2';

2. 任意: セカンダリインデックスのコールド・ホットデータ境界とカスタム時間列を変更します。

   • コールド・ホットデータ境界を変更します。

     ALTER TABLE `dt.idx` SET 'CHS'='10000';

   • カスタム時間列を変更します。

     ALTER TABLE `dt.idx` SET 'CHS_COLUMN'='COLUMN=p2'; 

   説明

   セカンダリインデックステーブルの名前は TableName.IndexName というフォーマットを使用します。名前には特殊文字であるピリオド (.) が含まれているため、名前をバックティック (`) で囲んでエスケープする必要があります。たとえば、テーブル名が test.idx の場合、エスケープされた名前は `test.idx` です。

3. 任意: セカンダリインデックスのコールド・ホットデータ分離をキャンセルします。

   ALTER TABLE `dt.idx` SET 'CHS'='', 'CHS_L2' = '', 'CHS_COLUMN'='';

クエリの例

• ランダムクエリ (Get)

  -- p2 はカスタム時間列です。
  SELECT * FROM dt WHERE p1 = 10 AND p2 = 10;

• 範囲クエリ

  -- p2 はカスタム時間列です。
  SELECT * FROM dt WHERE p2 > 10 AND p2 < 1000;

  重要

  デフォルトでは、LindormTable は非効率なクエリとして識別された SELECT 文を実行しません。代わりに、例外をスローします。詳細については、「SELECT」をご参照ください。

• HINT を使用してホットデータのみをクエリする

  SELECT /*+ _l_hot_only_(true) */ * FROM dt WHERE p1>1;