ExternalDistributed

ExternalDistributed エンジンは、リモートサーバーの MySQL または PostgreSQL に保存されたデータに対して SELECT クエリを実行することを可能にします。シャーディングが可能なように、引数として MySQL または PostgreSQL エンジンを受け入れます。

テーブルの作成

CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1] [TTL expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2] [TTL expr2],
    ...
) ENGINE = ExternalDistributed('engine', 'host:port', 'database', 'table', 'user', 'password');

CREATE TABLE クエリの詳細な説明を参照してください。

テーブルの構造は元のテーブルの構造と異なる場合があります：

カラム名は元のテーブルと同じである必要がありますが、これらのカラムの一部のみを使用し、任意の順序で指定することができます。
カラムタイプは元のテーブルのものと異なる場合があります。ClickHouse は cast 関数を使用して値を ClickHouse データ型に変換しようとします。

エンジンのパラメータ

engine — テーブルエンジン MySQL または PostgreSQL。
host:port — MySQL または PostgreSQL サーバーのアドレス。
database — リモートデータベース名。
table — リモートテーブル名。
user — ユーザー名。
password — ユーザーパスワード。

実装の詳細

複数のレプリカをサポートしており、| でリストされる必要があります。また、シャードは , でリストされる必要があります。例えば：

CREATE TABLE test_shards (id UInt32, name String, age UInt32, money UInt32) ENGINE = ExternalDistributed('MySQL', `mysql{1|2}:3306,mysql{3|4}:3306`, 'clickhouse', 'test_replicas', 'root', 'clickhouse');

レプリカを指定すると、読み取り時に各シャードの利用可能なレプリカのうちの1つが選択されます。接続が失敗した場合は、次のレプリカが選択され、全てのレプリカに対してそのように続けられます。もし全てのレプリカの接続試行が失敗した場合、同様の方法で数回試行されます。

各シャードに対して任意の数のシャードおよびレプリカを指定できます。

関連情報

テーブルの作成​

実装の詳細​

テーブルの作成

実装の詳細