카테고리:

계정 및 세션 DDL

ALTER CONNECTION

기존 연결의 속성을 수정합니다.

참고 항목:

CREATE CONNECTION , DROP CONNECTION , SHOW CONNECTIONS

이 항목의 내용:

구문

ALTER CONNECTION <name> ENABLE FAILOVER TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] [ IGNORE EDITION CHECK ]

ALTER CONNECTION <name> DISABLE FAILOVER [ TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] ]

ALTER CONNECTION <name> PRIMARY

ALTER CONNECTION [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER CONNECTION [ IF EXISTS ] <name> UNSET COMMENT

매개 변수

name

변경할 연결의 식별자입니다.

ENABLE FAILOVER TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ]

이 기본 연결에 대한 보조 연결을 기본 연결로 사용하도록 승격할 수 있는 조직의 계정 목록을 쉼표로 구분하여 지정합니다. 목록에 각 계정에 대한 조직 이름을 포함합니다.

목록의 각 계정은 기본 연결이 있는 계정과 다른 리전에 있어야 합니다. 그렇지 않으면 명령이 실패합니다.

DISABLE FAILOVER [ TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ] ]

이 기본 연결에 대한 장애 조치를 비활성화합니다. 즉, 이 기본 연결에 대한 보조 연결을 기본 연결로 사용하도록 승격할 수 없습니다.

모든 계정이 아닌 선택한 계정에 대한 장애 조치를 비활성화하려면 해당 계정의 쉼표로 구분된 목록을 지정하십시오.

PRIMARY

기본 연결로 사용할 연결을 승격합니다.

SET ...

연결에 대해 설정할 속성을 지정합니다.

COMMENT = 'string'

설명을 추가하거나 연결에 대한 기존 설명을 덮어씁니다.

UNSET ...

연결에 대해 설정 해제할 속성을 지정하여 다시 기본값으로 재설정합니다.

현재, 설정 해제할 수 있는 유일한 속성은 COMMENT 이며, 이는 연결에 대한 설명(있는 경우)을 제거합니다.

사용법 노트

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

  • Snowflake 계정에 대해 Snowflake 서비스에 비공개 연결 가 활성화된 경우, 네트워크 관리자는 연결이 기본 연결의 역할을 하도록 승격될 때 연결 URL에 대한 DNS CNAME 레코드를 업데이트해야 합니다. 자세한 내용은 Snowflake 서비스에 대한 비공개 연결을 위한 DNS CNAME 레코드 구성하기 섹션을 참조하십시오.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

myorg 조직의 myaccount2myaccount3 계정이 myconnection 연결에 대한 보조 연결을 각각 저장할 수 있도록 허용합니다.

ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;

연결에 대한 설명을 추가합니다.

ALTER CONNECTION myconnection SET COMMENT = 'New comment for connection';

보조 연결을 기본 연결로 승격합니다.

ALTER CONNECTION myconnection PRIMARY;
맨 위로 이동