SHOW CONNECTIONS

SHOW CONNECTIONS

SHOW CONNECTIONS 명령은 접근 권한(privilege)이 있는 연결(connection) 목록을 보여주는 명령이에요. 클라이언트 리다이렉트(client redirect) 기능의 일부로, 비즈니스 연속성·재해 복구(BCDR)를 위해 계정 복제 기능과 함께 사용돼요.

출처: 문서

본문

이 명령은 접근 권한이 있는 연결들을 나열해요. 출력은 연결 이름순으로 정렬된 연결 메타데이터와 속성을 반환해요 (출력 컬럼 설명은 본문의 Output 참고). 제공된 필터로 결과를 필터링하려면 이 정렬 순서를 유념해야 해요.

기능 상태: Business Critical 기능. 이 명령은 클라이언트 리다이렉트 기능의 일부이며 Business Critical Edition 이상이 필요해요. 업그레이드 문의는 Snowflake 지원에 연락해요. 클라이언트 리다이렉트는 비즈니스 연속성·재해 복구를 위해 계정 복제 기능과 함께 사용해요.

관련 명령: CREATE CONNECTION, ALTER CONNECTION, DROP CONNECTION.

구문 (Syntax)

SHOW CONNECTIONS [ LIKE '<pattern>' ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 필터는 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 예를 들어 ... LIKE '%testing%' ...와 ... LIKE '%TESTING%' ...는 같은 결과를 반환해요. 기본값: 없음 (필터링 없음).

출력 (Output)

명령 출력은 연결 속성과 메타데이터를 다음 컬럼으로 제공해요. 여러 리전 그룹에 걸친 조직의 명령 출력에는 추가 region_group 컬럼이 포함돼요.

  • region_group — 계정이 위치한 리전 그룹. 참고: 이 컬럼은 여러 리전 그룹에 걸친 조직에서만 표시돼요.
  • snowflake_region — 계정이 위치한 Snowflake 리전. Snowflake 리전은 클라우드 플랫폼 리전 내의 구별된 위치로 다른 Snowflake 리전과 격리돼요. 멀티 테넌트이거나 (Virtual Private Snowflake 계정의 경우) 단일 테넌트일 수 있어요.
  • created_on — 연결이 생성된 날짜·시간.
  • account_name — 계정 이름. 조직 관리자가 계정 이름을 변경할 수 있어요.
  • name — 연결 이름.
  • comment — 연결에 대한 주석.
  • is_primary — 연결이 기본(primary) 연결인지 여부.
  • primary — 기본 연결의 조직 이름, 계정 이름, 연결 이름. 이 값은 보조 연결을 만들 때 CREATE CONNECTION 명령의 AS REPLICA OF 절에 복사할 수 있어요.
  • failover_allowed_to_accounts — 기본 연결이 리다이렉트할 수 있는 계정 목록.
  • connection_url — 사용자가 클라이언트에 전달해 Snowflake에 연결하는 연결 URL.
  • organization_name — Snowflake 조직 이름.
  • account_locator — 리전 내의 계정 로케이터.

연결에 대해 지정할 수 있는 속성에 대한 자세한 내용은 CREATE CONNECTION을 참고해요.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스(warehouse)를 요구하지 않아요.
  • 현재 사용자의 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요 (SHOW 출력 컬럼은 소문자이므로).

예제 (Examples)

이름이 test로 시작하는 모든 연결을 표시해요:

SHOW CONNECTIONS LIKE 'test%';

더 알아보기 (Learn more)