Cluster

​

データベースの作成

CREATE DATABASE cluster_db
ENGINE = Cluster('cluster_name', 'database');

• cluster_name — サーバー設定で定義されたクラスターの名前 (クラスターを参照) 。Distributed テーブルエンジンと同様に、{cluster} などのマクロを使用でき、アクセスのたびに展開されます。
• database — クラスター上のデータベース名。

• テーブルが現在、前述のリモートレプリカへのフォールバックによって提供されている場合 (分片のローカルレプリカにデータベースまたはテーブルがない場合) 。クラスター全体を対象とする Distributed テーブルではこのフォールバックは行われず、フォールバック先となるクラスターの一部には固有の名前がありません。
• データベースのクラスター名にマクロが含まれる場合。Cluster はアクセスのたびにマクロを展開しますが、Distributed はテーブルの作成時にのみ展開します。そのため、マクロ式と現在の展開結果のどちらを使って再作成しても、設定変更後には元とは異なる動作になります。
• 設定の再読み込みによって、1つの分片からなるクラスターが複数の分片からなるクラスターに変わる場合。稼働中のプロキシには INSERT 行を分散するための暗黙的な rand() キーが追加されますが、再読み込み前にシリアライズされたテーブルにはキーがありません。キーを常にシリアライズしても同等にはなりません。独立した Distributed テーブルでは、そのキーが読み取り時の不要な分片の除外にも使用されるためです。CREATE TABLE には、挿入専用のシャーディングキーを表現する方法がありません。

​

補足事項

• このエンジンは、クラスターの状態を読み取り専用で参照するためのビューです。Cluster データベースに対する CREATE TABLE、DROP TABLE、ALTER などの DDL ステートメントはサポートされていません。スキーマは、ON CLUSTER を使用した DDL クエリなどで、クラスター上で直接管理してください。
• アクセス権は、クラスター定義に設定されたユーザー (クラスターがサーバー間通信用のシークレットを使用する場合は現在のユーザー) に対して、リモートサーバー側で適用されます。ローカル側では、データベースとそのテーブルに対する通常の権限が適用されます。
• Remote データベースエンジンの動作に関する詳細 (ローカルの分片にあるテーブルの可視性に関する規則、一覧表示の網羅性、使用不可のクラスターに関するエラーの報告、プロキシデータベースのチェーン) は、Cluster エンジンにも当てはまります。詳しくは、Remote データベースエンジンの補足事項を参照してください。

​

例

CREATE DATABASE cluster_db
ENGINE = Cluster('test_shard_localhost', 'default');

SHOW TABLES FROM cluster_db;

┌─name─┐
│ t    │
└──────┘

SELECT * FROM cluster_db.t;