Hologres:テーブルグループとシャードの管理

制限事項

• Hologres V0.10 以降が必要です。バージョンは [Instance Details] ページで確認できます。それより前のバージョンの場合は、インスタンスをアップグレードするか、オンラインサポートをご利用ください。

• リシャーディング中はすべての書き込みを停止してください。読み取りは影響を受けません。Hologres V1.1 以降では、set table readonly を使用して、リアルタイム書き込みタスクの自動フェイルオーバーが可能です。

• リシャーディングは CPU を消費し、一時的にストレージを増加させます。オフピーク時に実行してください。

• リシャーディングの前にテーブルのバイナリログを無効にし、後で再度有効にしてください。詳細については、「Hologres バイナリログのサブスクライブ」をご参照ください。

• SERIAL フィールドを持つテーブルはリシャーディングできません。DEFAULT 値を持つテーブルは、リシャーディング後に DEFAULT 属性を失います。

• テーブルはビューなどの他のオブジェクトに依存していてはなりません。リシャーディングの前に依存関係を削除してください。さもないと、Hologres は "ERROR: resharding table xxx can not executed because other objects depend on it." を返します。ビューの依存関係をバイパスするには、set hg_experimental_hg_insert_overwrite_enable_view=on; を設定します。

• リシャーディングは Simple Permission Model (SPM) にのみ適用されます。詳細については、「Hologres 権限モデル」をご参照ください。

• リシャーディングでは、自動パーティション化プロパティは保持されません。

• Hologres V2.0 以降、リシャーディング中に列コメントが保持されます。それより前のバージョンでは、列コメントを手動でバックアップおよび復元してください。

構文

Hologres V2.0.24 以降の場合：HoloWeb を使用して、グラフィカルインターフェイス経由でリシャーディングを実行します。詳細については、「テーブルのリシャーディング」をご参照ください。

それより前のバージョンの場合：以下の SQL コマンドを実行します。

-- V1.1 以降の場合：
CALL HG_MOVE_TABLE_TO_TABLE_GROUP('<table_name>', '<new_table_group_name>');

-- V0.10 以降の場合：
CALL HG_UPDATE_TABLE_SHARD_COUNT('<table_name>', '<new_table_group_name>');

リシャーディング例外の処理

リシャーディングは、OOM エラーや手動での終了によって中断されることがあります。中断された場合、元のテーブルは読み取り専用になり、<initial_table_name>_xxxxxxxx という名前の一時テーブルが表示されます。

Hologres V2.0.24 以降のインスタンスの場合：

• HoloWeb： UI からリシャーディングを続行またはキャンセルします。詳細については、「テーブルのリシャーディング」をご参照ください。

• SQL：以下の手順に従ってください。

以前のバージョンのインスタンスの場合:まず V2.0.24 以降にアップグレードしてください。

リシャーディングを再開するには、根本原因を解決し、HG_MOVE_TABLE_TO_TABLE_GROUP コマンドを再度実行してください。

リシャーディングをキャンセルして元の状態に戻すには、以下のコマンドを順番に実行してください：

-- 1. 元のテーブルから読み取り専用フラグを削除します。
CALL set_table_property('<schema_name>.<table_name>', 'readonly', 'false');

-- 2. 一時テーブルの名前を見つけます。
-- パーティションテーブルの場合：
SELECT schema_name, target_temp_table_name
FROM hologres.hg_resharding_properties
WHERE reshard_table_name = '<schema_name>.<table_name>' AND is_parent_table IS TRUE;

-- 非パーティション化テーブルの場合：
SELECT schema_name, target_temp_table_name
FROM hologres.hg_resharding_properties
WHERE reshard_table_name = '<schema_name>.<table_name>'
  AND is_parent_table IS FALSE AND is_sub_table IS FALSE;

-- 3. 一時テーブルを削除します。
DROP TABLE IF EXISTS <schema_name>.<target_temp_table_name>;

-- 4. リシャーディングの進捗記録をクリアします。
CALL hologres.hg_internal_clear_resharding_properties('<schema_name>.<table_name>');