연결 수정하기

연결 수정하기 (ALTER CONNECTION)

이 기능은 중화인민공화국에서는 사용할 수 없어요.

이 명령은 client redirect 기능의 일부예요. Business Critical Edition(이상)이 필요해요. 업그레이드에 대해 문의하려면 Snowflake Support에 연락해 주세요.

클라이언트 리디렉션을 account replication 기능과 함께 사용하여 비즈니스 연속성과 재해 복구를 지원할 수 있어요.

기존 connection의 속성을 수정해요.

참조:

CREATE CONNECTION , DROP CONNECTION , SHOW CONNECTIONS

출처: 문서

본문

구문

ALTER CONNECTION [ IF EXISTS ]  ENABLE FAILOVER TO ACCOUNTS . [ , . ... ]
                        [ IGNORE EDITION CHECK ]

ALTER CONNECTION [ IF EXISTS ]  DISABLE FAILOVER [ TO ACCOUNTS . [ , . ... ] ]

ALTER CONNECTION [ IF EXISTS ]  PRIMARY

ALTER CONNECTION [ IF EXISTS ]  SET COMMENT = ''

ALTER CONNECTION [ IF EXISTS ]  UNSET COMMENT

매개변수

name

변경할 연결의 식별자예요.

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

조직 내 계정 목록을 쉼표로 구분해서 지정해요. 이 기본 연결에 대한 보조 연결이 기본 연결로 승격될 수 있는 계정들이에요. 목록의 각 계정에 조직 이름을 포함해야 해요.

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

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

이 기본 연결에 대한 장애 조치(failover)를 비활성화해요. 즉, 이 기본 연결에 대한 보조 연결은 기본 연결로 승격될 수 없어요.

모든 계정이 아니라 선택한 계정에 대한 장애 조치만 비활성화하려면 해당 계정 목록을 쉼표로 구분해서 지정해요.

PRIMARY

연결을 기본 연결로 승격해요.

SET ...

연결에 설정할 속성을 지정해요:

COMMENT = 'string'

연결에 주석을 추가하거나 기존 주석을 덮어써요.

UNSET ...

연결에서 설정을 해제할 속성을 지정해요. 이 속성은 기본값으로 다시 설정돼요.

현재 설정을 해제할 수 있는 유일한 속성은 COMMENT예요. 이 속성은 연결에 주석이 있으면 해당 주석을 제거해요.

사용 참고 사항

계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 SQL 명령을 실행할 수 있어요.
Snowflake 계정에 Snowflake 서비스에 대한 프라이빗 연결(private connectivity)이 활성화되어 있다면, 연결이 기본 연결로 승격될 때 네트워크 관리자가 연결 URL의 DNS CNAME 레코드를 업데이트해야 해요. 자세한 내용은 를 참조해요.
메타데이터 관련:

고객은 Snowflake 서비스를 사용할 때 메타데이터에 개인 데이터(User 객체에 대한 데이터 제외), 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터를 입력하지 않도록 해야 해요. 자세한 내용은 Metadata fields in 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;

연결 수정하기