SHOW CONNECTIONS

액세스 권한이 있는 연결을 나열합니다.

출력은 연결 이름별로 정렬된 연결 메타데이터 및 속성을 반환합니다(출력 열에 대한 설명은 이 항목의 출력 참조). 제공된 필터를 사용해 결과를 필터링하려는 경우 이 점에 유의해야 합니다.

참고 항목:

CREATE CONNECTION , ALTER CONNECTION , DROP CONNECTION

구문

SHOW CONNECTIONS [ LIKE '<pattern>' ]
Copy

매개 변수

LIKE 'pattern'

오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(%_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.

예를 들어, 다음 패턴은 같은 결과를 반환합니다.

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 기본값: 값 없음(출력에 필터링이 적용되지 않음).

사용법 노트

  • 이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

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

출력

명령 출력은 다음 열에 연결 속성 및 메타데이터를 제공합니다. 여러 리전 그룹 에 걸쳐 있는 조직에 대한 명령 출력은 region_group 열을 추가로 포함합니다.

설명

region_group

계정이 있는 리전 그룹 입니다. 참고: 이 열은 여러 리전 그룹에 걸쳐 있는 조직에 대해서만 표시됩니다.

snowflake_region

계정이 있는 Snowflake Region입니다. Snowflake Region은 다른 Snowflake Region과 격리된 클라우드 플랫폼 리전 내의 별도 위치입니다. Snowflake Region은 다중 tenant 또는 단일 tenant(Virtual Private Snowflake 계정용)일 수 있습니다.

created_on

연결이 만들어진 날짜 및 시간입니다.

account_name

계정의 이름입니다. 조직 관리자(즉, ORGADMIN 역할이 있는 사용자)는 계정 이름을 변경할 수 있습니다.

name

연결의 이름입니다.

comment

연결에 대한 설명입니다.

is_primary

연결이 기본 연결인지 여부를 나타냅니다.

primary

기본 연결의 조직 이름, 계정 이름, 연결 이름입니다. 이 값은 보조 연결을 만들 때 CREATE CONNECTION 명령의 AS REPLICA OF 절에 복사할 수 있습니다.

failover_allowed_to_accounts

기본 연결이 리디렉션될 수 있는 계정 목록입니다.

connection_url

Snowflake에 대한 연결을 설정하기 위해 사용자가 클라이언트에 전달하는 연결 URL입니다.

organization_name

Snowflake 조직의 이름입니다.

account_locator

리전의 계정 로케이터입니다.

연결에 지정할 수 있는 속성에 대한 자세한 내용은 CREATE CONNECTION 섹션을 참조하십시오.

이름이 test 로 시작하는 모든 연결을 표시합니다.

SHOW CONNECTIONS LIKE 'test%';
Copy