SHOW REGIONS

SHOW REGIONS

계정을 만들 수 있는 모든 리전(region)을 나열하는 명령이에요. Snowflake Region 이름, 계정을 호스팅하는 클라우드 공급자(AWS, Google Cloud Platform, Microsoft Azure), 그리고 공급자가 부르는 리전 이름을 반환해요.

출처: 문서

본문

계정을 만들 수 있는 모든 리전을 나열해요. 이 명령은 Snowflake Region 이름, 계정을 호스팅하는 클라우드 공급자(AWS, Google Cloud Platform, Microsoft Azure), 그리고 클라우드 공급자의 리전 이름을 반환해요.

구문

SHOW REGIONS [ LIKE '<pattern>' ]

매개변수

LIKE 'pattern'

선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:

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

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

출력

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

컬럼 설명
region_group 계정이 위치한 리전 그룹이에요. 참고: 이 컬럼은 여러 리전 그룹에 걸친 조직에만 표시돼요.
snowflake_region 계정이 위치한 Snowflake Region이에요. Snowflake Region은 클라우드 플랫폼 리전 내의 고유한 위치로, 다른 Snowflake Region과 격리되어 있어요. Snowflake Region은 멀티 테넌트일 수도 있고(Virtual Private Snowflake 계정의 경우) 단일 테넌트일 수도 있어요.
cloud 계정을 호스팅하는 클라우드 공급자의 이름이에요.
region 계정이 위치한 리전(클라우드 공급자가 부르는 리전 이름)이에요.
display_name 사람이 읽을 수 있는 클라우드 리전 이름이에요. 예: US West (Oregon)

사용 메모

  • 이 명령은 실행에 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.

더 알아보기 (Learn more)