メインコンテンツへスキップ
メインコンテンツへスキップ

合成可能なプロトコル

概要​

Composable プロトコルを使用すると、ClickHouse サーバーへの TCP アクセスをより柔軟に設定できます。この設定は、従来の設定と併用することも、置き換えることもできます。

コンポーザブルプロトコルの設定​

コンポーザブルプロトコルは XML 設定ファイルで設定できます。protocols セクションは、XML 設定ファイル内で protocols タグで表されます。

<protocols>

</protocols>

プロトコルレイヤーの設定​

プロトコルレイヤーは基本モジュールを使用して定義できます。たとえば、HTTP レイヤーを定義するには、protocols セクションに新しい基本モジュールを追加します。

<protocols>

  <!-- plain_http module -->
  <plain_http>
    <type>http</type>
  </plain_http>

</protocols>

モジュールは次の項目で構成できます:

  • plain_http - 別のレイヤーから参照される名前
  • type - データを処理するためにインスタンス化されるプロトコルハンドラを示します。 あらかじめ定義されているプロトコルハンドラは次のとおりです:
    • tcp - ネイティブな ClickHouse プロトコルハンドラ
    • http - HTTP ClickHouse プロトコルハンドラ
    • tls - TLS 暗号化レイヤー
    • proxy1 - PROXYv1 レイヤー
    • mysql - MySQL 互換プロトコルハンドラ
    • postgres - PostgreSQL 互換プロトコルハンドラ
    • prometheus - Prometheus プロトコルハンドラ
    • interserver - ClickHouse インターサーバープロトコルハンドラ
注記

gRPC プロトコルハンドラは Composable protocols では実装されていません。

エンドポイントの設定​

エンドポイント（待ち受けポート）は <port> と、任意の <host> タグで指定します。 例えば、先ほど追加した HTTP レイヤーに対してエンドポイントを設定するには、 次のように設定を変更します。

<protocols>

  <plain_http>

    <type>http</type>
    <!-- endpoint -->
    <host>127.0.0.1</host>
    <port>8123</port>

  </plain_http>

</protocols>

<host> タグが省略された場合は、ルート設定の <listen_host> が使用されます。

レイヤーシーケンスの設定​

レイヤーシーケンスは <impl> タグを使用し、別のモジュールを参照することで定義します。例えば、plain_http モジュールの上に TLS レイヤーを構成するには、設定を次のようにさらに変更できます。

<protocols>

  <!-- httpモジュール -->
  <plain_http>
    <type>http</type>
  </plain_http>

  <!-- plain_httpモジュール上にTLSレイヤーとして設定されたhttpsモジュール -->
  <https>
    <type>tls</type>
    <impl>plain_http</impl>
    <host>127.0.0.1</host>
    <port>8443</port>
  </https>

</protocols>

レイヤーにエンドポイントを関連付ける​

エンドポイントは任意のレイヤーに関連付けることができます。たとえば、HTTP（ポート 8123）および HTTPS（ポート 8443）向けのエンドポイントを定義できます。

<protocols>

  <plain_http>
    <type>http</type>
    <host>127.0.0.1</host>
    <port>8123</port>
  </plain_http>

  <https>
    <type>tls</type>
    <impl>plain_http</impl>
    <host>127.0.0.1</host>
    <port>8443</port>
  </https>

</protocols>

追加のエンドポイントの定義​

追加のエンドポイントは、任意のモジュールを参照し、<type> タグを省略することで定義できます。たとえば、plain_http モジュールに対する another_http エンドポイントを次のように定義できます。

<protocols>

  <plain_http>
    <type>http</type>
    <host>127.0.0.1</host>
    <port>8123</port>
  </plain_http>

  <https>
    <type>tls</type>
    <impl>plain_http</impl>
    <host>127.0.0.1</host>
    <port>8443</port>
  </https>

  <another_http>
    <impl>plain_http</impl>
    <host>127.0.0.1</host>
    <port>8223</port>
  </another_http>

</protocols>

追加のレイヤーパラメータの指定​

一部のモジュールには、追加のレイヤーパラメータが含まれる場合があります。たとえば、TLS レイヤーでは 秘密鍵ファイル（privateKeyFile）および証明書ファイル（certificateFile）を 次のように指定できます。

<protocols>

  <plain_http>
    <type>http</type>
    <host>127.0.0.1</host>
    <port>8123</port>
  </plain_http>

  <https>
    <type>tls</type>
    <impl>plain_http</impl>
    <host>127.0.0.1</host>
    <port>8443</port>
    <privateKeyFile>another_server.key</privateKeyFile>
    <certificateFile>another_server.crt</certificateFile>
  </https>

</protocols>