ALTER CONNECTION¶

구문¶

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 설정 구성하기 섹션을 참조하십시오.

• 메타데이터 관련:

  주의

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

예¶

myorg 조직의 myaccount2 및 myaccount3 계정이 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;