Hologres:物理パーティションテーブルから論理パーティションテーブルへの移行

移行のタイミング

ご利用の物理パーティションテーブルが次のいずれかの条件を満たす場合は、論理パーティションテーブルへの移行を検討してください。

• テーブルグループに 10,000 個を超える子テーブルが含まれており、メタデータが大規模になっている。

• 新しいパーティションが毎日追加され、DDL 操作が頻繁に発生している。

移行アプローチの選択

デュアルライト検証による移行（推奨）

このアプローチでは、移行中に古いテーブルと新しいテーブルを並行して実行し、業務への影響を最小限に抑えます。

CALL hg_clone_to_logical_partition('user_profile', 'user_profile_logical');

SET statement_timeout = 0;
ASYNC CALL hg_clone_to_logical_partition('user_profile', 'user_profile_logical');

BEGIN;
ALTER TABLE <source_table_name> RENAME TO <source_table_name_archive>;
ALTER TABLE <target_table_name> RENAME TO <source_table_name>;
COMMIT;

REBUILD を使用した移行（非推奨）

REBUILD 完了後、物理パーティションテーブルは tmp_rebuild_old_<query_id>_<unique_id>_<table_name> という名前に変更されます。タスクの適応が完了するまで、関連タスクでエラーが発生する可能性があります。

1. 物理パーティションテーブルへの書き込みタスクを停止します。

2. テーブルを変換するために REBUILD を実行します。

   -- パーティションフィールドに NOT NULL 制約を追加します。
   ASYNC REBUILD TABLE user_profile ALTER ds SET NOT NULL;
   
   -- 物理パーティションテーブルを論理パーティションテーブルに変換します（元のテーブルは保持されます）。
   ASYNC REBUILD TABLE user_profile WITH (keep_source) TO logical partition;

   詳細については、「REBUILD」をご参照ください。

3. 書き込みタスクを更新して再起動します。

4. クエリタスクを新しい論理パーティションテーブルに適応させます。

5. O&M タスクを新しい論理パーティションテーブルに適応させます。

テーブルスキーマの変換

既存の物理パーティションテーブルの DDL から論理パーティションテーブルを作成する際は、以下の変更を行ってください。

• PARTITION BY の前に LOGICAL キーワードを追加します。

• パーティションキー列に NOT NULL を追加します。

• （オプション）2 番目のパーティションキーを追加します。物理パーティションテーブルは 1 つのパーティションキーのみをサポートしますが、論理パーティションテーブルは最大 2 つまでサポートします。

物理パーティションテーブル：

BEGIN;
CREATE TABLE user_profile (
    a TEXT,
    b TEXT,
    ds TEXT
)
PARTITION BY LIST (ds);
CREATE TABLE user_profile_202503 PARTITION OF user_profile FOR VALUES IN ('202503');
CREATE TABLE user_profile_202504 PARTITION OF user_profile FOR VALUES IN ('202504');
COMMIT;

論理パーティションテーブル — パーティションキーが 1 つの場合：

CREATE TABLE user_profile_lp_1 (
    a TEXT,
    b TEXT,
    ds TEXT NOT NULL)
LOGICAL PARTITION BY LIST (ds);

論理パーティションテーブル — パーティションキーが 2 つの場合（ds を年用の yy と月用の mm に分割）：

CREATE TABLE user_profile_lp_2 (
    a TEXT,
    b TEXT,
    yy TEXT NOT NULL,
    mm TEXT NOT NULL)
LOGICAL PARTITION BY LIST (yy, mm);

インポートタスクの適応

インポートタスクが Fixed Plan 経由で物理パーティションテーブルに書き込んでいる場合：変更は不要です。

インポートタスクが子テーブル（パーティション）に書き込んでいる場合： 以下の変更を行ってください。

• 子テーブルを作成する文を削除します。論理パーティションテーブルには物理パーティションが存在しません。

• ターゲットテーブル名を子テーブル名から親テーブル名に変更します。

-- 元のタスク：物理パーティションテーブルへのデータインポート
CREATE TABLE user_profile_202505 PARTITION OF user_profile FOR VALUES IN ('202505');
INSERT INTO user_profile_202505 SELECT a, b, ds FROM <source_table> WHERE ds = '202505';

-- 更新後のタスク：論理パーティションテーブルへのデータインポート
INSERT INTO user_profile_lp_1 SELECT a, b, ds FROM <source_table> WHERE ds = '202505';

-- 元の形式：物理パーティションテーブル（一時テーブル方式）
CREATE TABLE tmp_user_profile_202505(a text, b text, ds text);
INSERT INTO tmp_user_profile_202505 SELECT a, b, ds FROM <source_table> WHERE ds = '202505';

BEGIN;
DROP TABLE IF EXISTS user_profile_202505;
ALTER TABLE tmp_user_profile_202505 RENAME TO user_profile_202505;
ALTER TABLE user_profile ATTACH PARTITION user_profile_202505 FOR VALUES IN ('202505');
COMMIT;

-- 元の形式：物理パーティションテーブル（hg_insert_overwrite 方式）
CALL hg_insert_overwrite('user_profile', '202505', $$SELECT a, b, mm FROM <source_table> WHERE ds='202505'$$);

-- 更新後の形式：論理パーティションテーブル（ネイティブ INSERT OVERWRITE）
INSERT OVERWRITE user_profile_lp_1 PARTITION (ds = '202505') SELECT a, b, ds FROM <source_table> WHERE ds='202505';

クエリタスクの適応

クエリが親テーブルを対象としている場合： 変更は不要です。

クエリが子テーブルを対象としている場合： 親テーブルをクエリ対象に変更し、パーティションフィルター条件を追加してください。

-- 元の形式：物理パーティションテーブル
SELECT * FROM user_profile_202504;

-- 更新後の形式：論理パーティションテーブル
SELECT * FROM user_profile_lp_1 WHERE ds = '202504';

O&M タスクの適応

一部の O&M 操作では、論理パーティションテーブル向けに異なるシステムテーブルまたは関数を使用します。

プロパティおよびパラメーターのマッピング

以下の表は、物理パーティションテーブルと論理パーティションテーブル間での自動パーティション管理パラメーターおよびその他のテーブルプロパティの対応関係を示しています。