15.1.22 CREATE SERVER Statement

15.1.22 CREATE SERVER Statement

1CREATE SERVER server_name
2    FOREIGN DATA WRAPPER wrapper_name
3    OPTIONS (option [, option] ...)
4
5option: {
6    HOST character-literal
7  | DATABASE character-literal
8  | USER character-literal
9  | PASSWORD character-literal
10  | SOCKET character-literal
11  | OWNER character-literal
12  | PORT numeric-literal
13}

이 statement는 FEDERATED 스토리지 엔진과 함께 사용하기 위한 서버 정의를 생성합니다. CREATE SERVER statement는 mysql 데이터베이스의 servers 테이블에 새 row를 생성합니다. 이 statement를 실행하려면 SUPER 권한이 필요합니다.

server_name은 서버에 대한 고유한 참조여야 합니다. 서버 정의는 서버의 스코프 내에서 전역이며, 서버 정의를 특정 데이터베이스로 한정하는 것은 불가능합니다. server_name의 최대 길이는 64자입니다(64자를 초과하는 이름은 조용히 잘려 나가며), 대소문자를 구분하지 않습니다. 이름은 따옴표로 감싼 문자열로 지정할 수 있습니다.

wrapper_name은 식별자이며, 작은따옴표로 둘러싸서 지정할 수 있습니다.

각 option에 대해 문자 리터럴 또는 숫자 리터럴 중 하나를 지정해야 합니다. 문자 리터럴은 UTF-8이며, 최대 길이는 64자이고 기본값은 공백(빈) 문자열입니다. 문자열 리터럴이 64자를 초과하면 조용히 잘려 나갑니다. 숫자 리터럴은 0에서 9999 사이의 숫자여야 하며, 기본값은 0입니다.

참고

OWNER option은 현재 적용되지 않으며, 생성되는 서버 커넥션의 소유권이나 동작에 어떤 영향도 미치지 않습니다.

CREATE SERVER statement는 나중에 FEDERATED 테이블을 생성할 때 CREATE TABLE statement와 함께 사용할 수 있는 mysql.servers 테이블 내 엔트리를 생성합니다. 지정한 option들은 mysql.servers 테이블의 컬럼을 채우는 데 사용됩니다. 해당 테이블의 컬럼은 Server_name, Host, Db, Username, Password, Port, Socket입니다.

예를 들면 다음과 같습니다:

1CREATE SERVER s
2FOREIGN DATA WRAPPER mysql
3OPTIONS (USER 'Remote', HOST '198.51.100.106', DATABASE 'test');

서버에 대한 커넥션을 설정하는 데 필요한 모든 option을 반드시 지정해야 합니다. 사용자 이름, 호스트 이름, 데이터베이스 이름은 필수입니다. Password와 같은 다른 option도 필요할 수 있습니다.

테이블에 저장된 데이터는 FEDERATED 테이블에 대한 커넥션을 생성할 때 사용할 수 있습니다:

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

자세한 내용은 Section 18.8, “The FEDERATED Storage Engine”을 참조하십시오.

CREATE SERVER는 암시적 커밋을 발생시킵니다. Section 15.3.3, “Statements That Cause an Implicit Commit”을 참조하십시오.

CREATE SERVER는 사용 중인 로깅 포맷에 관계없이 바이너리 로그에 기록되지 않습니다.