メインコンテンツまでスキップ
バージョン: 26.x

BACKEND を追加

デスクリプション​

ADD BACKENDは、Dorisクラスターに1つ以上のBEノードを追加するために使用されます。このコマンドにより、管理者は新しいBEノードのホストとポートを指定し、その動作を設定するためのオプションプロパティを指定できます。

Syntax​

ALTER SYSTEM ADD BACKEND "<host>:<heartbeat_port>"[,"<host>:<heartbeat_port>" [, ...]] [PROPERTIES ("<key>"="<value>" [, ...] )]

必須パラメータ​

1.

BEノードのホスト名またはIPアドレスを指定できます。

2. <heartbeat_port>

BEノードのheartbeatポートです。デフォルトは9050です。

オプションパラメータ​

1. PROPERTIES ("<key>"="<value>" [, ... ] )

BEノードの追加プロパティを定義するために使用されるキーと値のペアのセットです。これらのプロパティは、追加されるBEの設定をカスタマイズするために使用できます。利用可能なプロパティには以下が含まれます：

  • tag.location: ストレージ・コンピューティング統合モードにおいて、BEノードが属するResource Groupを指定するために使用されます。
  • tag.compute_group_name: ストレージ・コンピューティング分離モードにおいて、BEノードが属するcompute groupを指定するために使用されます。
  • tag.public_endpoint: 外部アクセス用のBEノードのpublic endpointを指定するために使用されます（例：11.10.20.12:8010）。これは通常、外部ユーザーアクセス用のロードバランサーのドメイン名またはパブリックIPです。
  • tag.private_endpoint: プライベートネットワークアクセス用のBEノードのprivate endpointを指定するために使用されます（例：10.10.10.9:8020）。これは通常、VPC内部アクセスまたはクラスタ内のKubernetes Service IPに使用されます。

アクセス制御要件​

このSQLを実行するユーザーは、少なくとも以下の権限を持っている必要があります：

権限オブジェクト注記
NODE_PRIV

使用上の注意​

  1. 新しいBEノードを追加する前に、ノードが正しく設定され実行されていることを確認してください。
  2. Resource Groupを使用することで、クラスタ内のBEノードをより適切に管理・整理できます。
  3. 複数のBEノードを追加する場合、効率を向上させるために1つのコマンドでそれらを指定できます。
  4. BEノードを追加した後、SHOW BACKENDS を使用して、それらが正常に追加され正常な状態にあるかを確認してください。
  5. クラスタの可用性と障害耐性を向上させるために、異なる物理的な場所やラックにBEノードを追加することを検討してください。
  6. 新しく追加されたBEノードが適切に利用されるように、クラスタ内の負荷を定期的にチェックしバランスを取ってください。

例​

  1. 追加プロパティなしでBEノードを追加

    ALTER SYSTEM ADD BACKEND "192.168.0.1:9050,192.168.0.2:9050";

このコマンドは2つのBEノードをクラスターに追加します：

  • 192.168.0.1、ポート9050
  • 192.168.0.2、ポート9050 追加のプロパティは指定されていないため、デフォルト設定が適用されます。

  1. 統合ストレージ・コンピューティングモードで、指定されたResource GroupにBEノードを追加する

    ALTER SYSTEM ADD BACKEND "doris-be01:9050" PROPERTIES ("tag.location" = "groupb");

このコマンドは、単一のBEノード（ホスト名doris-be01、ポート9050）をクラスター内のResource Group groupbに追加します。

  1. ストレージとコンピューティングの分離モードでは、指定されたコンピュートグループにBEノードを追加します

    ALTER SYSTEM ADD BACKEND "192.168.0.3:9050" PROPERTIES ("tag.compute_group_name" = "cloud_groupc");

このコマンドは、クラスタ内のコンピュートグループcloud_groupcに単一のBEノード（IP 192.168.0.3、ポート9050）を追加します。

  1. 複雑なネットワーク環境向けにパブリックエンドポイントとプライベートエンドポイントを設定したBEノードを追加する

    ALTER SYSTEM ADD BACKEND "192.168.1.1:9050" PROPERTIES (
        "tag.public_endpoint" = "11.10.20.12:8010",
        "tag.private_endpoint" = "10.10.10.9:8020"
    );

このコマンドは、複数のネットワークエンドポイントを持つBEノードを追加します:

  • 192.168.1.1:9050: クラスタ通信用の内部アドレス（be_host）
  • 11.10.20.12:8010: ロードバランサーを通じた外部ユーザーアクセス用のパブリックエンドポイント
  • 10.10.10.9:8020: VPC内部またはKubernetesクラスタ間アクセス用のプライベートエンドポイント

この構成は、BEノードが異なるネットワークコンテキストからアクセス可能である必要があるクラウド環境やKubernetesクラスタにおいて有用です。詳細については、Stream Load in Complex Network Environmentsを参照してください。