SHOW CONNECTIONS

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

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

참고 항목:

CREATE CONNECTION , ALTER CONNECTION , DROP CONNECTION

구문

SHOW CONNECTIONS [ LIKE '<pattern>' ]
Copy

매개 변수

LIKE 'pattern'

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

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

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

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

출력

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

열

설명

region_group

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

snowflake_region

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

created_on

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

account_name

계정의 이름입니다. 조직 관리자가 계정 이름을 변경할 수 있습니다.

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 섹션을 참조하십시오.

사용법 노트

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

  • 이 명령은 현재 사용자의 현재 역할에 하나 이상의 액세스 권한이 부여된 오브젝트만 반환합니다.

  • MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

예

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

SHOW CONNECTIONS LIKE 'test%';
Copy
언어: 한국어