SHOW ACCOUNTS

SHOW ACCOUNTS

조직의 모든 계정(관리 계정 제외)을 나열하는 명령이에요.

출처: 문서

본문

구문 (Syntax)

SHOW ACCOUNTS [ HISTORY ] [ LIKE '<pattern>' ]

파라미터

  • HISTORY — 아직 삭제되지 않은 삭제된(dropped) 계정을 선택적으로 포함해요. SHOW ACCOUNTS HISTORY의 출력에는 삭제된 계정과 관련된 추가 열이 포함돼요. 기본값: 없음(삭제된 계정은 출력에 포함되지 않음).
  • LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하는 대소문자 무시 패턴 매칭을 사용해요. 예를 들어 다음 패턴은 같은 결과를 반환해요: ... LIKE '%testing%' ..., ... LIKE '%TESTING%' .... 기본값: 없음(출력에 필터링이 적용되지 않음).

출력 (Output)

명령 출력은 다음 열에 전역 계정 속성과 메타데이터를 제공해요:

Column Description
organization_name 조직의 이름.
account_name 조직 내에서 계정을 식별하는 사용자 정의 이름.
region_group 계정이 위치한 지역 그룹. 참고: 이 열은 여러 지역 그룹에 걸친 조직에만 표시돼요.
snowflake_region 계정이 위치한 Snowflake 지역. Snowflake 지역은 다른 Snowflake 지역과 분리된 클라우드 플랫폼 지역 내의 별도 위치이며, Virtual Private Snowflake 계정의 경우 멀티 테넌트 또는 싱글 테넌트일 수 있어요.
edition 계정의 Snowflake 에디션.
account_url organization_name과 account_name의 값을 포함하는 선호 Snowflake 계정 URL.
created_on 계정이 생성된 날짜와 시간.
comment 계정에 대한 주석.
account_locator 계정의 시스템 할당 식별자.
account_locator_url region_name과 account_locator를 포함하는 레거시 Snowflake 계정 URL 구문.
managed_accounts 계정이 만든 관리 계정 수를 나타내요.
consumption_billing_entity_name 소비 과금 엔티티의 이름.
marketplace_consumer_billing_entity_name 마켓플레이스 소비자 과금 엔티티의 이름.
marketplace_provider_billing_entity_name 마켓플레이스 제공자 과금 엔티티의 이름.
old_account_url 계정 이름 변경 시 원래 계정 URL이 저장되었으면 원래 URL을 제공해요. 원래 계정 URL이 삭제되었으면 계정 이름이 변경되었더라도 값은 NULL이에요.
is_org_admin 계정에서 ORGADMIN 역할이 활성화되었는지 여부. TRUE면 역할이 활성화돼요.
dropped_on [1] 계정이 마지막으로 삭제된 날짜와 시간.
scheduled_deletion_time [1] 계정이 영구적으로 삭제되도록 예약된 날짜와 시간. 계정은 예약 시간 후 1시간 이내에 삭제돼요.
restored_on [1] 계정이 마지막으로 복원된 날짜와 시간.
account_old_url_saved_on 계정 이름 변경 시 원래 계정 URL이 저장되었으면, 원래 계정 URL이 저장된 날짜와 시간을 제공해요.
account_old_url_last_used 계정 이름 변경 시 원래 계정 URL이 저장되었으면, 원래 URL로 계정에 마지막으로 접근한 시간을 나타내요.
organization_old_url 계정의 조직이 새 계정 URL을 만드는 방식으로 변경되었고 원래 계정 URL이 저장되었으면 원래 계정 URL을 제공해요. 원래 계정 URL이 삭제되었으면 조직이 변경되었더라도 값은 NULL이에요.
organization_old_url_saved_on 계정의 조직이 새 계정 URL을 만드는 방식으로 변경되었고 원래 계정 URL이 저장되었으면, 원래 계정 URL이 저장된 날짜와 시간을 제공해요.
organization_old_url_last_used 계정의 조직이 새 계정 URL을 만드는 방식으로 변경되었고 원래 계정 URL이 저장되었으면, 원래 계정 URL로 계정에 마지막으로 접근한 시간을 나타내요.
moved_to_organization [1] 계정이 다른 조직으로 이동되었으면 그 조직의 이름을 제공해요.
moved_on [1] 계정이 다른 조직으로 이동된 날짜와 시간.
organization_URL_expiration_on [1] 계정의 조직이 새 계정 URL을 만드는 방식으로 변경되었고 원래 계정 URL이 저장되었으면, 원래 계정 URL이 삭제될 날짜와 시간을 제공해요. 삭제된 URL로는 계정에 접근할 수 없어요.
is_events_account 계정이 이벤트 계정인지 여부.
is_organization_account 계정이 조직 계정인지 여부.

접근 제어 요구사항 (Access control requirements)

조직 관리자가 이 명령을 실행하면 출력에 모든 열이 포함돼요. 다음 권한 중 하나가 있는 역할로도 명령을 실행할 수 있지만 일부 열만 반환돼요:

  • CREATE LISTING
  • CREATE DATA EXCHANGE LISTING
  • CREATE ORGANIZATION LISTING

사용 메모 (Usage notes)

  • 이 명령은 실행하는 데 실행 중인 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 접근 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 암시적으로 허용해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할 사용자)와 보안 관리자(SECURITYADMIN 역할 사용자)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 출력 열을 참조할 때는 열 이름에 큰따옴표로 묶은 식별자를 사용해요(예: SELECT "type"). SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.
  • 이 명령은 명령 실행에 사용되는 역할의 접근 권한에 따라 지정된 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 필터를 적용해도 1만 레코드 한도를 초과하는 레코드는 반환되지 않아요. 1만 레코드 이상이 있는 결과를 보려면 해당하는 Snowflake Information Schema 뷰를 쿼리해요.

예시 (Examples)

이름이 myaccount로 시작하는 모든 계정을 표시해요:

SHOW ACCOUNTS LIKE 'myaccount%';

더 알아보기 (Learn more)