Hologres:ALTER DYNAMIC TABLE

V4.0.7 以降

-- 更新の計算リソースを変更します。ローカル実行またはサーバーレス実行を選択できます。
ALTER [DYNAMIC] TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (['local' | 'serverless' | '<warehouse_name>'])

-- サーバーレス実行の計算仕様を変更します。
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema>.]<table_name> SET (auto_refresh_guc_hg_experimental_serverless_computing_required_cores='<num>')

V3.1

-- 更新の計算リソースを変更します。ローカル実行またはサーバーレス実行を選択できます。
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (computing_resource ='[local|serverless]');

-- サーバーレス実行の計算仕様を変更します。
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (refresh_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.0

-- 単一テーブルの更新リソースを変更します。
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_computing_resource ='[local|serverless]');

-- サーバーレスモードの場合、サーバーレスの計算仕様も変更できます。
ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
SET (<incremental/full>_guc_hg_experimental_serverless_computing_required_cores='<num>');

V3.1 構文

ALTER DYNAMIC TABLE <schema_name>.<table_name> SET (auto_refresh_mode = '<full/auto>');

V3.0 構文

ALTER DYNAMIC TABLE <schema_name>.<table_name> SET (refresh_mode = 'full');

V3.1 構文

Hologres V3.1.18 以降、動的テーブルのクエリ定義を変更し、クエリに列を追加することで動的テーブルに列を追加できます。

ALTER DYNAMIC TABLE [ IF EXISTS ] [<schema_name>.]<table_name> 
AS
<query>; -- 新しいクエリ定義。

• 注意事項：

  • 新しいクエリ定義は、次の要件を満たす必要があります:

    • 新しいクエリによって生成される動的テーブルは、元のクエリによって生成される動的テーブルと互換性のあるテーブルスキーマを持つ必要があります。これには、次の要件が含まれます：

      • 両方のテーブルは、パーティションテーブルまたは非パーティションテーブルである必要があります。

      • 両方のテーブルのプライマリキー (PK) は同じである必要があります。

      • 両方のテーブルの分散キーは同じである必要があります。分散キーは変更できません。

      • 両方のテーブルのパーティションキーは同じである必要があります。パーティションキーは変更できません。

      • 両方のテーブルのクラスタリングキー、セグメントキー、ストレージモード (列ストアや行列ハイブリッドストアなど)、辞書エンコーディング、ビットマップインデックスは同じである必要があります。

      • 両方のテーブルのフィールド名は同じである必要があります。フィールド名は変更できません。

      • 同じ名前のフィールドは、同じデータ型と NULLABLE プロパティを持つ必要があります。

    • クエリでは列の追加のみが可能で、列の削除はできません。列を追加すると、既存のデータは変更されません。新しい列にはデフォルトで NULL 値が入力されます。データは次回の更新後に更新されます。

  • クエリ定義を変更した後、リフレッシュの動作は次のようになります:

    • 非パーティション化動的テーブル: 次のリフレッシュ (自動リフレッシュまたは手動リフレッシュ) は、リフレッシュ上書きをトリガーします。

    • 論理パーティションを持つ動的テーブル：アクティブパーティションは、次回の自動更新中に自動的に Refresh Overwrite をトリガーします。履歴パーティションには手動更新が必要です。

    クエリ定義を変更した後、クエリに増分更新でサポートされていない演算子が含まれている場合、リフレッシュの動作は次のようになります:

    リフレッシュモード	新しいクエリ定義が増分更新をサポート	新しいクエリ定義が増分更新をサポートしない
    auto_refresh_mode = 'auto'	テーブル作成時に指定された refresh_mode が保持されます。	refresh_mode は自動的に完全更新に変更されます。
    auto_refresh_mode = 'incremental'	増分更新が保持されます。	リフレッシュは失敗します。手動でモードを完全更新に変更する必要があります。
    auto_refresh_mode = 'full'	完全更新が保持されます。	完全更新が保持されます。

• 例

  1. サンプルデータを準備します。

     -- ソーステーブルを準備します。
     CREATE TABLE employees (
         department_id INT,
         employee_name VARCHAR
     );
     -- データを挿入します。
     INSERT INTO employees (department_id, employee_name) VALUES
     (1, 'John'),
     (1, 'Jane'),
     (1, 'John'),  -- 重複値
     (2, 'Alice'),
     (2, 'Bob'),
     (2, 'Alice'); -- 重複値
     
     -- 動的テーブルを作成します。
     CREATE  DYNAMIC TABLE dt_employees
     WITH (
       -- 動的テーブルのプロパティ
       freshness = '1 minutes', 
       auto_refresh_mode = 'auto',
       distribution_key = 'department_id'
     )
     AS 
     SELECT
         department_id
     FROM employees   
     GROUP BY department_id;
     
     -- 動的テーブルのデータをクエリします。
     SELECT * FROM dt_employees;

  2. 動的テーブルに列を追加します。

     -- 列を追加します。
     ALTER DYNAMIC TABLE dt_employees
     AS 
     SELECT
         department_id,
        STRING_AGG(DISTINCT employee_name, ', ') AS unique_employees
     FROM employees   
     GROUP BY department_id;
     

     文が正常に実行された後、動的テーブルのデータをクエリできます。新しい列のデータは NULL です。

     department_id	｜unique_employees
     -----------｜--------
     1	｜\N
     2	｜\N

     次回の更新が成功すると、新しい列のデータが更新されます。

     department_id	｜unique_employees
     -------------｜---------
     1	｜Jane, John
     2 ｜	Bob, Alice

V3.0 構文

Hologres V3.0 はクエリ定義の変更をサポートしています。構文は次のとおりです。現在、完全更新モードでの変更のみがサポートされており、増分更新モードでの変更はサポートされていません。

ALTER DYNAMIC TABLE [IF EXISTS] [<schema>.]<table_name> SET (task_definition = $$<new_query>$$);