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

バックエンドを追加

説明​

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

構文​

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

必須パラメータ​

1.

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

2. <heartbeat_port>

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

オプションパラメータ​

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

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

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

アクセス制御要件​

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

PrivilegeObjectNotes
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を参照してください。