CREATE CONNECTION

CREATE CONNECTION

계정에 새 커넥션(connection)을 만드는 명령이에요. 커넥션은 조직(organization)의 여러 계정 간에 데이터·객체·서비스를 복제하기 위한 논리적 그룹을 가리키며, 기본 커넥션(primary)과 보조 커넥션(secondary)을 만들 수 있어요.

출처: 문서

본문

계정에 새 커넥션을 만들어요.

함께 보기: ALTER CONNECTION, DROP CONNECTION, SHOW CONNECTIONS

구문 (Syntax)

기본 커넥션 (Primary Connection)

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  [ COMMENT = '<string_literal>' ]

보조 커넥션 (Secondary Connection)

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  AS REPLICA OF <organization_name>.<account_name>.<name>
  [ COMMENT = '<string_literal>' ]

필수 매개변수 (Required parameters)

name 커넥션의 식별자(즉, 이름)를 지정하는 문자열이에요. 다음 규칙을 따라야 해요.

  • 반드시 알파벳 문자로 시작해야 하며, 문자·십진 숫자(0-9)·밑줄(_)만 포함할 수 있어요.
  • 기본 커넥션의 이름은 조직 내 커넥션 이름과 계정 이름 전체에서 고유해야 해요.
  • 보조 커넥션의 이름은 기본 커넥션의 이름과 일치해야 해요.

보조 커넥션 매개변수 (Secondary connection parameters)

AS REPLICA OF organization_name.account_name.name 복제본(즉 보조 커넥션)을 만들 기본 커넥션의 식별자를 지정해요.

  • organization_name: 조직의 식별자를 지정해요.
  • account_name: 계정의 식별자를 지정해요.
  • name: 기본 커넥션의 식별자를 지정해요.

선택 매개변수 (Optional parameters)

COMMENT = 'string_literal' 커넥션에 대한 설명(comment)을 지정해요.

  • 기본값: 값 없음

접근 제어 요구 사항 (Access control requirements)

계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 SQL 명령을 실행할 수 있어요.

사용 메모 (Usage notes)

Snowflake 서비스에 대한 프라이빗 연결(private connectivity)이 계정에서 활성화되어 있다면, 네트워크 관리자가 DNS CNAME 레코드를 만들고 관리해야 해요. 자세한 내용은 Snowflake 서비스 프라이빗 연결을 위한 DNS 설정 구성을 참고해요.

메타데이터에 관해서는 다음 사항에 주의해요.

⚠️ 주의: 고객은 Snowflake 서비스를 사용할 때 (User 객체를 제외하고) 개인 데이터·민감 데이터·수출 통제 데이터·기타 규제 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고해요.

예시 (Examples)

커넥션을 만들어요. 이 예시에서는 조직 myorg의 계정 myaccount1에 접속해 있다고 가정해요.

CREATE CONNECTION IF NOT EXISTS myconnection;

기본 커넥션의 복제본으로 보조 커넥션을 만들어요. 매개변수에 사용할 정규화된 이름(full qualified name)에 자신의 계정과 조직 값을 대입해요. SHOW CONNECTIONS 출력의 primary 컬럼에서 사용할 정규화된 값을 얻을 수 있어요.

CREATE CONNECTION myconnection AS REPLICA OF myorg.myaccount1.myconnection;

더 알아보기 (Learn more)