CREATE SERVER server_name
    FOREIGN DATA WRAPPER wrapper_name
    OPTIONS (option [, option] ...)

option:
  { HOST character-literal
  | DATABASE character-literal
  | USER character-literal
  | PASSWORD character-literal
  | SOCKET character-literal
  | OWNER character-literal
  | PORT numeric-literal }

このステートメントは FEDERATED ストレージエンジンと共に利用するためのサーバーの定義を作成します。CREATE SERVER ステートメントは mysql データベース内の servers テーブル内の新しい行を作成します。このステートメントは SUPER 権限を必要とします。

server_name は、サーバーへの一意の参照である必要があります。特定のデータベースにサーバー定義を適応するのは不可能です。server_name は最長 64 文字の長さを持ち (64 文字以上の名前は静かに切り捨てられる)、大文字と小文字を区別しません。この名前は、引用文字列として指定できます。

wrapper_name は mysql となる必要があり、そして 1 つの引用句を利用して引用されます。wrapper_name のほかの値は現在、サポートされていません。

各 option について、文字リテラルまたは数値リテラルのどちらかを指定する必要があります。文字リテラルは UTF-8 であり、64 文字の最大長をサポートし、デフォルトでは空白 (空の) 文字列になります。文字列定数は静かに 64 文字まで切り捨てられます。数値定数は 0 から 9999 の間の数字である必要があり、デフォルト値は 0 です。

CREATE SERVER ステートメントは mysql.server テーブル内に FEDERATED テーブルを作成するときに CREATE TABLE ステートメントと共に利用することができるエントリを作成します。指定するオプションは mysql.server テーブル内にカラムを投入するために利用されます。テーブルカラムは Server_name、Host、Db、Username、Password、Port そして Socket です。

例 :

CREATE SERVER s
FOREIGN DATA WRAPPER mysql
OPTIONS (USER 'Remote', HOST '192.168.1.106', DATABASE 'test');

テーブルに格納されたデータは FEDERATED テーブルへの接続を作成するときに利用できます。

CREATE TABLE t (s1 INT) ENGINE=FEDERATED CONNECTION='s';

詳細は The FEDERATED Storage Engine をご覧ください。

CREATE SERVER は自動コミットを引き起こしません。

CREATE SERVER は、MySQL 5.1.15 で追加されました。