仮想ウェアハウスを管理することで、コンピューティングリソースを分離し、同時実行をコントロールし、複数のワークロードにわたるクエリパフォーマンスを最適化できます。 Hologres コンソールまたは SQL コマンドを使用して、仮想ウェアハウスの作成、スケール、停止、および削除を行います。
前提条件
開始する前に、以下を満たしていることを確認してください。
-
V2.0.4 以降の Hologres インスタンス。お使いのインスタンスが V2.0.4 未満のバージョンの場合は、アップグレードしてください。
-
操作に必要な権限。詳細については、以下の権限セクションをご参照ください。
権限
|
オペレーション |
必要な権限 |
|
作成、削除、停止、再開、再起動、名前の変更 |
Alibaba Cloud アカウント、またはインスタンスの |
|
スケール (V3.0.28 より前) |
Alibaba Cloud アカウント、またはインスタンスの |
|
スケール (V3.0.28 以降) |
Alibaba Cloud アカウント、RAM ユーザー ( |
注意事項
-
仮想ウェアハウスの最大数:各インスタンスは、最大 10 個の仮想ウェアハウスをサポートします。
-
仮想ウェアハウスあたりの CU 範囲:最小 32 CU、最大 512 CU (ステップサイズ:16)。V3.0.10 以降、最大値は 1024 CU に増加します。V3.0.27 以降、最大仕様の制限は撤廃されます。
-
初期ウェアハウス:仮想ウェアハウス インスタンスを購入すると、Hologres は自動的に
init_warehouseという名前のデフォルト仮想ウェアハウスを作成します。各インスタンスには、デフォルトの仮想ウェアハウスが 1 つだけ存在します。SQL コマンドによるデフォルト仮想ウェアハウスの削除、停止、再開はできませんが、変更は可能です。すべてのユーザーに、デフォルト仮想ウェアハウスを使用する権限があります。 -
DDL のサポート:DDL は、任意の仮想ウェアハウスで実行できます。
-
リソースグループ:仮想ウェアハウス インスタンスは、リソースグループをサポートしていません。リソースグループは段階的に廃止されています。リソースを隔離するには、代わりに複数の仮想ウェアハウスを作成してください。詳細については、「リソース管理」をご参照ください。
-
課金:「課金」をご参照ください。
仮想ウェアハウスの作成
仮想ウェアハウスの作成は非同期です。SQL コマンドの実行後、使用する前に hg_get_warehouse_status を使用して、ウェアハウスが実行中であることを確認してください。
コンソールの使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
仮想ウェアハウスの新規追加 をクリックします。ダイアログボックスで、次のパラメーターを設定し、OK をクリックします。詳細については、「リソースの弾力性の概要」をご参照ください。
パラメーター
説明
[計算グループ名]
作成する仮想ウェアハウスの名前です。
[仮想ウェアハウスの単一クラスターの仕様]
仮想ウェアハウス内のクラスターごとに予約するリソース量です。
[仮想ウェアハウスの予約済みクラスター数]
初期クラスター数です。予約済みクラスターのリソースは、インスタンスの予約済みリソースプールから割り当てられます。
SQLの使用
構文
CALL hg_create_warehouse ('<warehouse_name>', <cu>, <cluster_count>);
パラメーター
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
新しい仮想ウェアハウスの名前です。数字、英字、アンダースコア ( |
|
|
INTEGER |
シングルクラスターあたりの CU 数です。 |
仮想ウェアハウスの削除
デフォルトの仮想ウェアハウス (init_warehouse) や、テーブルグループのリーダーウェアハウスである仮想ウェアハウスは削除できません。削除する前に、仮想ウェアハウスを停止する必要があります。
削除は非同期で行われます。SQL コマンドを実行した後、hg_get_warehouse_status を使用して削除が完了したことを確認してください。
コンソールを使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの 操作 列で、停止 をクリックします。確認し、ウェアハウスが停止するまで待ちます。
-
操作列の削除をクリックして、仮想ウェアハウスを削除します。
SQL を使用
構文
CALL hg_drop_warehouse ('<warehouse_name>');
パラメーター
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
削除する仮想ウェアハウスの名前。 |
仮想ウェアハウスのスケーリング
スケーリング操作は非同期で実行されます。後続の操作に進む前に、hg_get_warehouse_status で完了を確認してください。
弾力的スケーリングの仕組みの詳細については、「リソースの弾力性の概要」をご参照ください。
スケールアップ (垂直スケーリング)
スケールアップは、仮想ウェアハウスあたりの CU 割り当てを増やします。仮想ウェアハウスをスケールアップする前に、インスタンスに十分な未割り当てのリソースが必要です。必要に応じて、まずインスタンスをスケールアップしてください。
実行中のクエリと書き込みへの影響
インスタンスリソースの増加は、現在実行中のクエリと書き込みに影響しません。仮想ウェアハウスへのリソース割り当てには、次の影響があります。
-
V3.0.28 以降:スケールアップおよびスケールアウト中、クエリと書き込みは中断されません。Flink タスクは失敗して再試行する場合があります。
-
V2.2 - V3.0.28:自動リバランスにより、クエリと書き込みが約 15 秒間中断されます。
-
V2.2 より前:手動リバランス後、クエリと書き込みが約 15 秒間中断されます。
バージョンに関係なく、複数行 DML トランザクションはスケールアップ中に中断されます。これには、hg_experimental_enable_transaction が有効になっているトランザクション、ネイティブ INSERT OVERWRITE ステートメント、および ダイナミックテーブルの増分更新が含まれます。
コンソールによる操作 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの操作列で設定の調整をクリックし、仮想ウェアハウスの単一クラスターの仕様を目的の値に引き上げ、OKをクリックします。
-
(任意) 操作 列の Rebalance をクリックして、新しく追加されたポッドにシャードを再分散します。
SQLによる操作
-
仮想ウェアハウスをスケールアップします。
パラメーター
タイプ
説明
warehouse_nameTEXT
変更する仮想ウェアハウスの名前。
cuINTEGER
目標 CU 数。最小:32。最大:512。ステップサイズ:16。
CALL hg_alter_warehouse ('<warehouse_name>', <cu>); -
スケールアップのステータスを確認します。
-- 現在のステータスを確認します (完了時に Running を返します) select hg_get_warehouse_status('<warehouse_name>'); -- または、ウェアハウスが Running 状態になるまで待機します select wait_until_warehouse_running('<warehouse_name>', <timeout_seconds>);timeout_seconds(INTEGER、オプション) :タイムアウト期間 (秒単位) です。 -
スケールアップされたウェアハウスにシャードを再分散します。
SELECT hg_rebalance_warehouse ('<warehouse_name>'); -
リバランスのステータスを確認します。
-- 現在のステータスを確認します (完了時に DONE を返します) SELECT hg_get_rebalance_warehouse_status ('<warehouse_name>'); -- または、リバランスが完了するまで待機します select hg_wait_until_rebalance_warehouse_done('<warehouse_name>', <timeout_seconds>);timeout_seconds(INTEGER、オプション) :タイムアウト期間 (秒単位) です。
例: read_warehouse_1 を 64 CU にスケールアップします。
-- ウェアハウスをスケールアップします
CALL hg_alter_warehouse ('read_warehouse_1', 64);
-- ウェアハウスが実行中になるまで待機します
SELECT wait_until_warehouse_running ('read_warehouse_1');
-- シャードを再分散します
SELECT hg_rebalance_warehouse ('read_warehouse_1');
-- リバランスが完了するまで待機します
SELECT hg_wait_until_rebalance_warehouse_done ('read_warehouse_1');
スケールダウン (垂直スケーリング)
スケールダウンは、まずシャードのリバランスをトリガーし、オフラインになる Pod からシャードを移行してから、それらの Pod を削除します。解放されたリソースは、インスタンスの未割り当てリソースプールに戻ります。
実行中のクエリと書き込みへの影響
-
V3.1 以降 (ベータ) :主要なクエリと書き込みは中断されません。次の場合にのみ、エラーまたは一時的な切断が発生します。
-
V3.1 では、オフラインになる Pod 上のすべての接続が数秒間切断されます。V4.0 以降では、一時テーブルを作成した接続とバイナリログを消費する接続のみが切断されます。
-
Flink および Holo Client ジョブは失敗して再試行する場合があります。
-
複数行 DML トランザクションは中断されます。これには、
hg_experimental_enable_transactionが有効になっているトランザクション、ネイティブ INSERT OVERWRITE ステートメント、および ダイナミックテーブルの増分更新が含まれます。 -
スケールダウンの開始時に大規模なクエリ、大規模な書き込み、または長時間実行されるトランザクションが進行中で、完了までに 60 分以上必要な場合、スケールダウン開始から 60 分後に失敗します。
-
-
V3.1 より前:スケールダウン中、クエリと書き込みが数分間中断されます。
スケールダウン後、解放されたリソースを使用して、新しい仮想ウェアハウスを作成したり、他のウェアハウスをスケールアップしたり、インスタンスからリソースを解放したりできます。
コンソールによる操作 (推奨)
スケールアップ と同じ手順に従いますが、仮想ウェアハウスの単一クラスターの仕様 をターゲット値まで減らします。
SQLによる操作
-
仮想ウェアハウスをスケールダウンします。
パラメーター
タイプ
説明
warehouse_nameTEXT
変更する仮想ウェアハウスの名前。
cuINTEGER
目標 CU 数。最小:32。最大:512。ステップサイズ:16。
CALL hg_alter_warehouse ('<warehouse_name>', <cu>); -
ウェアハウスが実行中の状態に戻ったことを確認します。
select hg_get_warehouse_status('<warehouse_name>');戻り値が
Runningの場合、スケールダウンが完了したことを示します。
スケールアウト (水平スケーリング)
スケールアウトは、仮想ウェアハウスにクラスターを追加します。スケールアップと同じ注意事項が適用されます。
コンソールによる操作
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの 操作 列で 設定の調整 をクリックし、仮想ウェアハウスの予約済みクラスター数 を目的の数まで増やしてから OK をクリックします。
スケールイン (水平スケーリング)
スケールインは、仮想ウェアハウス内のクラスター数を減らします。スケールダウンと同じ注意事項が適用されます。
コンソールによる操作
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの 操作 列で、設定の調整 をクリックします。仮想ウェアハウスの予約済みクラスター数 を目的の数まで減らし、OK をクリックします。
仮想ウェアハウスの運用保守
仮想ウェアハウスの表示
-- 現在のインスタンス内のすべての仮想ウェアハウスを表示
SELECT * FROM hologres.hg_warehouses;
-- 現在使用中の仮想ウェアハウスを表示
SELECT current_warehouse();
hologres.hg_warehouses システムテーブルには、以下の列が含まれます。
|
フィールド |
データ型 |
説明 |
例 |
|
|
INTEGER |
仮想ウェアハウスの一意の ID です。 |
|
|
|
TEXT |
仮想ウェアハウスの名前です。 |
|
|
|
INTEGER |
CPU コア数です。 |
|
|
|
INTEGER |
メモリ (単位:GB) です。 |
|
|
|
INTEGER |
シャードの最小数です。 |
|
|
|
INTEGER |
シャードの最大数です。 |
|
|
|
INTEGER |
仮想ウェアハウスのターゲットステータスです。ステータスの変更は非同期で行われるため、このフィールドには目標とする最終状態が記録されます。有効な値: |
|
|
|
INTEGER |
現在のステータスです。有効な値: |
|
|
|
TEXT |
現在のステータスに関する詳細情報です。 |
— |
|
|
BOOLEAN |
デフォルトの仮想ウェアハウスであるかどうか。 |
|
|
|
TEXT |
仮想ウェアハウスの構成です。 |
— |
|
|
TEXT |
仮想ウェアハウスに関する注釈です。 |
— |
仮想ウェアハウスの停止
デフォルトの仮想ウェアハウス (init_warehouse) や、テーブルグループにセカンダリ仮想ウェアハウスを持つプライマリ仮想ウェアハウスは停止できません。
停止は非同期で実行されます。hg_get_warehouse_status を使用して、ウェアハウスが停止したことを確認してください。
コンソールを使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの 操作 列で、停止 をクリックして確認します。
SQLを使用
CALL hg_suspend_warehouse ('<warehouse_name>');
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
停止する仮想ウェアハウスの名前。 |
仮想ウェアハウスの再開
仮想ウェアハウスの再開は非同期で実行されます。クエリを送信する前に、hg_get_warehouse_status を使用してウェアハウスが実行中であることを確認してください。
コンソールを使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの操作列で、起動をクリックして確認します。
SQLを使用
CALL hg_resume_warehouse ('<warehouse_name>');
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
再開する仮想ウェアハウスの名前。 |
仮想ウェアハウスの再起動
仮想ウェアハウスの再起動は非同期で実行されます。クエリを送信する前に、hg_get_warehouse_status を使用してウェアハウスが実行中であることを確認してください。
コンソールを使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
対象の仮想ウェアハウスの 操作 列で、再起動 をクリックして確認します。
SQLを使用
CALL hg_restart_warehouse('<warehouse_name>');
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
再起動する仮想ウェアハウスの名前。 |
仮想ウェアハウスのステータス確認
すべての作成、スケーリング、停止、再開、および再起動の操作は非同期で実行されます。ステータスを監視するには、以下の関数を使用してください。
-- 仮想ウェアハウスの現在のステータスを取得
select hg_get_warehouse_status('<warehouse_name>');
仮想ウェアハウスが実行中の状態になるまで待機するには、wait_until_warehouse_running を使用します。
select wait_until_warehouse_running('<warehouse_name>', <timeout_seconds>);
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
仮想ウェアハウスの名前。 |
|
|
INTEGER |
(任意) タイムアウト期間 (秒単位)。 |
例: データロードの前に warehouse_1 をスケールアップし、その後スケールダウンします。
-- 64 CU にスケールアップ
CALL hg_alter_warehouse ('warehouse_1', 64);
-- 実行中になるまで待機
SELECT wait_until_warehouse_running('warehouse_1');
-- データロードを実行
INSERT INTO res_data SELECT * FROM org_data;
-- 32 CU にスケールダウン
CALL hg_alter_warehouse ('warehouse_1', 32);
仮想ウェアハウスの名前変更
コンソールを使用 (推奨)
-
Hologres コンソールにログインし、インスタンスが存在するリージョンを選択します。
-
左側のナビゲーションペインで、インスタンス一覧 をクリックし、目的の インスタンス ID をクリックします。
-
製品ページの左側のナビゲーションペインで、計算グループ管理 をクリックし、仮想ウェアハウスリソース管理 タブに移動します。
-
計算グループ名 列で、
アイコンをクリックしてウェアハウスの名前を変更します。
SQLを使用
CALL hg_rename_warehouse('<org_warehouse_name>', '<new_warehouse_name>');
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
仮想ウェアハウスの現在の名前。 |
|
|
TEXT |
新しい名前。 |
高度な操作
仮想ウェアハウスのリバランス
仮想ウェアハウス内のワーカーノードは、通常、シャードメタデータを均等にロードします。高速リカバリ、スケールアップ、またはスケールアウト後、シャードの分散が不均等になる場合があります。リバランスをトリガーするとシャードが再分散され、各ワーカーノードがほぼ同数のシャードをロードするようになります。
-
V2.1 以降では、ウェアハウスに空のワーカーノードがある場合、Hologres は自動的にリバランスをトリガーします。
-
V2.2 以降では、リバランス中に実行される SELECT クエリは自動的に再試行されるため、
ERROR: fail to execute query internal error: Get rundown is not allowed in recovering stateなどのエラーが防止されます。
リバランス操作は通常 2〜3 分かかりますが、テーブルグループの数によって異なります。リバランス中、書き込み操作は約 15 秒間中断されます。
構文
SELECT hg_rebalance_warehouse ('<warehouse_name>');
|
パラメーター |
タイプ |
説明 |
|
|
TEXT |
リバランスする仮想ウェアハウスの名前。 |
戻り値
|
値 |
意味 |
|
|
リバランスが正常にトリガーされました。 |
|
|
リバランスは不要です。シャードはすでにバランスが取れています。 |
|
エラー |
リバランスのトリガーに失敗しました (例:Pod に障害がある場合など)。 |
各ワーカーノードがロードするシャード数の差が 1 以下になると、リバランスの完了を示します。例:
-
ワーカーが 2 つ、シャードが 2 つの場合:各ワーカーが 1 つのシャードをロードします。
-
ワーカーが 2 つ、シャードが 3 つの場合:1 つのワーカーが 1 つのシャードをロードし、もう 1 つのワーカーが 2 つのシャードをロードします。
リバランスは非同期で行われるため、次のコマンドを使用して進行状況を監視してください。
SELECT hg_get_rebalance_warehouse_status('<warehouse_name>');
DOING はリバランスが進行中であることを意味します。DONE は完了したことを意味します。
仮想ウェアハウスのステートメントタイムアウトの設定
仮想ウェアハウスレベルのタイムアウトは、セッションレベルおよびデータベースレベルの構成よりも優先度が低くなります。ウェアハウスレベルの設定を有効にするには、まずデータベースレベルの構成をリセットしてください。
-- データベースレベルの設定をリセット
ALTER DATABASE <db_name> RESET statement_timeout;
-- 仮想ウェアハウスのタイムアウトを設定 (値はミリ秒単位)
CALL hg_alter_warehouse ('<warehouse_name>', <cu>, '{"configs":{"gucs":{"statement_timeout":"600000"}}}');
statement_timeout およびその他の GUC パラメーターの詳細については、「GUC パラメーター」をご参照ください。