Hologres:仮想ウェアハウスの管理

注意

• Alibaba Cloud アカウントまたはインスタンスのスーパーユーザー権限を持つ RAM ユーザーのみが仮想ウェアハウスを作成できます。

• 仮想ウェアハウスの作成は、バックグラウンドで実行される非同期プロセスです。仮想ウェアハウスの準備ができたことを確認するには、hg_get_warehouse_status 関数を使用してそのステータスをクエリします。

手順

注意

• Alibaba Cloud アカウントまたはインスタンスのスーパーユーザー権限を持つ RAM ユーザーのみが仮想ウェアハウスを削除できます。

• インスタンスのデフォルトの仮想ウェアハウスは削除できません。

• SQL コマンドを使用してテーブルグループのリーダー仮想ウェアハウスを削除することはできません。

• 仮想ウェアハウスの削除は、バックグラウンドで実行される非同期プロセスです。削除されたことを確認するには、hg_get_warehouse_status 関数を使用して仮想ウェアハウスのステータスをクエリします。

手順

権限

• V3.0.28 より前は、Alibaba Cloud アカウントまたは RAM ユーザーのみが仮想ウェアハウスをスケーリングできました。V3.0.28 以降、RAM ロールもこの操作を実行できます。

• 仮想ウェアハウスをスケーリングするには、次の権限が必要です:

  • RAM ロールの権限: AliyunHologresWarehouseFullAccess または AliyunHologresFullAccess。

  • インスタンス内のスーパーユーザー権限。

仮想ウェアハウスのエラスティックスケーリングに関する情報については、「リソースのスケーラビリティの概要」をご参照ください。

仮想ウェアハウスのスケールアップ

-- 仮想ウェアハウスのリソースを増やす
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');

仮想ウェアハウスのスケールダウン

仮想ウェアハウスのスケールアウト (クラスターの追加)

仮想ウェアハウスのスケールイン (クラスターの削減)

仮想ウェアハウスの表示

• コマンド

  • hologres.hg_warehouses システムビューには、現在のインスタンス内のすべての仮想ウェアハウスに関する情報が格納されます。

    SELECT * FROM hologres.hg_warehouses;

  • 現在の仮想ウェアハウスを表示します:

    SELECT current_warehouse();

• パラメーター

  hologres.hg_warehouses システムビューには、次のフィールドが含まれます:

  フィールド	タイプ	説明	例
  warehouse_id	INTEGER	仮想ウェアハウスの一意の ID。	1
  warehouse_name	TEXT	仮想ウェアハウスの名前。	init_warehouse
  cpu	INTEGER	仮想ウェアハウスの vCPU。	32
  mem	INTEGER	仮想ウェアハウスのメモリ (GB)。	128
  cluster_min_count	INTEGER	仮想ウェアハウスの最小クラスター数。	1
  cluster_max_count	INTEGER	仮想ウェアハウスの最大クラスター数。	1
  target_status	INTEGER	仮想ウェアハウスの最終ステータス。非同期のステータス更新のため、このフィールドはターゲットステータスを反映します。可能な値: 1: 実行中 2: 手動で停止	1
  status	INTEGER	仮想ウェアハウスの現在のステータス。状態は次のとおりです: 0: 初期化中 1: 実行中 2: 手動で停止 3: 処理に失敗しました。失敗の原因については、status_detail フィールドを確認してください。 4: 処理中	1
  status_detail	TEXT	仮想ウェアハウスのステータスに関する詳細。
  is_default	BOOLEAN	これがデフォルトの仮想ウェアハウスであるかどうかを示します。 t: True f: False	t
  config	TEXT	仮想ウェアハウスの構成。
  comment	TEXT	仮想ウェアハウスのコメント。

仮想ウェアハウスの停止

仮想ウェアハウスの再開

仮想ウェアハウスの再起動

仮想ウェアハウスのステータスの取得

• 構文

  • 仮想ウェアハウスの現在のステータスを取得します:

    select hg_get_warehouse_status('<warehouse_name>');

  • 仮想ウェアハウスの作成やスケーリングなどの操作は非同期です。wait_until_warehouse_running 関数を使用して、仮想ウェアハウスが Running に達するのを待って結果を返します:

    select wait_until_warehouse_running('<warehouse_name>',<timeout_seconds>);

• パラメーター

  パラメーター	タイプ	説明
  warehouse_name	TEXT	仮想ウェアハウスの名前。
  timeout_seconds	INTEGER	オプション。タイムアウト期間 (秒)。

• 例

  次の例では、データをインポートする前に仮想ウェアハウスをスケールアップし、その後スケールダウンします。

  -- warehouse_1 を 64 CU にスケールアップします。
  CALL hg_alter_warehouse ('warehouse_1',64);
  
  -- warehouse_1 のスケールアップが完了するのを待ちます。
  SELECT wait_until_warehouse_running('warehouse_1');
  
  -- データを書き込みます。
  INSERT INTO res_data SELECT * FROM org_data；
  
  -- warehouse_1 を 32 CU にスケールダウンします。
  CALL hg_alter_warehouse ('warehouse_1',32);

仮想ウェアハウスの名前変更

手順

仮想ウェアハウスのリバランス

実行時、各 Hologres 仮想ウェアハウスのワーカーノードはシャードメタデータを均等にロードします。ただし、高速回復やスケールアップ操作の後など、一部のシナリオでは、シャードがワーカーノード間で不均等に分散されることがあります。その場合、リバランスをトリガーして、データシャードをワーカーノード間で均等に再配布できます。

• 権限

  リバランスをトリガーするには、インスタンスのスーパーユーザー権限が必要です。

• 注意

  • V2.1 以降: Hologres は、ワーカーノードにシャードがロードされていない仮想ウェアハウスに対して自動的にリバランスを開始します。

  • V2.2 以降: Hologres は、仮想ウェアハウスのリバランス中の SELECT クエリの自動再試行をサポートするようになりました。この機能により、クエリは実行時間がわずかに増加するだけで完了し、ERROR: fail to execute query internal error: Get rundown is not allowed in recovering state. のようなエラーを防ぐことができます。

• 構文

  SELECT hg_rebalance_warehouse ('<warehouse_name>');

• パラメーター

  パラメーター	タイプ	説明
  warehouse_name	TEXT	リバランスする仮想ウェアハウスの名前。

• 戻り値

  リバランスをトリガーすると、Hologres は次のいずれかの結果を返します:

  • true: リバランスは正常にトリガーされました。

  • false: リバランスは不要です。

  • エラー: Pod のエラーなどの原因でリバランスのトリガーに失敗しました。

  説明

  • リバランス中、Hologres は再配布の必要性を評価し、最適なシャード分散を目指します。具体的には、任意の 2 つのワーカーノード上のシャードの数が 1 を超えて異なることはありません。例:

    • 2 つのワーカーノードと 2 つのシャードがある場合、各ノードは 1 つのシャードを受け取ります。

    • 2 つのワーカーノードと 3 つのシャードがある場合、一方のノードは 1 つのシャードを、もう一方は 2 つのシャードを受け取ります。

  • リバランスは通常 2〜3 分かかり、ロードされたテーブルグループの数に応じて所要時間が増加します。このプロセス中、書き込みは約 15 秒間中断されます。

  • リバランスは非同期プロセスです。この SQL コマンドを使用して進行状況を確認します:

    SELECT hg_get_rebalance_warehouse_status('<warehouse_name>');

    このコマンドは、リバランスが進行中であることを示す DOING を返します。DONE はリバランスが完了したことを示します。

仮想ウェアハウスのタイムアウト期間の設定

タイムアウト期間は、statement_timeout パラメーターを使用して、セッション、データベース、または仮想ウェアハウスレベルで構成できます。詳細については、「GUC パラメーター」をご参照ください。

仮想ウェアハウスレベルのタイムアウト設定は、セッションレベルまたはデータベースレベルの構成よりも優先度が低くなります。有効にするには、まず既存のデータベースレベルのタイムアウト設定を削除します。

-- データベースレベルのタイムアウト設定を無効にします。
ALTER DATABASE <db_name> RESET statement_timeout;

-- 仮想ウェアハウスのタイムアウト期間を 600 秒に設定します。
CALL hg_alter_warehouse ('<warehouse_name>', <cu>, '{"configs":{"gucs":{"statement_timeout":"600000"}}}');