SHOW MANAGED ACCOUNTS

SHOW MANAGED ACCOUNTS

SHOW MANAGED ACCOUNTS 명령은 계정에 대해 생성된 관리 계정(managed account) 목록을 보여주는 명령이에요. 현재 데이터 제공자가 소비자를 위한 리더 계정(reader account)을 만들 때 사용돼요.

출처: 문서

본문

이 명령은 계정에 대해 생성된 관리 계정을 나열해요. 자세한 내용은 리더 계정 관리를 참고해요.

참고: 제공자 공유(provider sharing)는 모든 계정에 대해 활성화되어 있지 않아요. 대부분 계정에서 기본 활성화되지만 일부는 아닐 수 있어요. 소비자와 데이터를 공유하려다 오류가 발생하면 기능이 활성화되지 않은 것일 수 있어요. 활성화 문의는 Snowflake 지원에 연락해요.

관련 명령: CREATE MANAGED ACCOUNT, DROP MANAGED ACCOUNT.

구문 (Syntax)

SHOW MANAGED ACCOUNTS [ LIKE '<pattern>' ]

파라미터 (Parameters)

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

사용 참고 사항 (Usage notes)

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

출력 (Output)

명령 출력은 관리 계정 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • account_name — 계정 이름.
  • cloud — 관리 계정이 위치한 클라우드. 리더 계정의 경우 항상 제공자 계정의 클라우드와 동일.
  • region — 관리 계정이 위치한 리전. 리더 계정의 경우 항상 제공자 계정의 리전과 동일.
  • account_locator — 계정의 레거시 식별자.
  • created_on — 관리 계정이 생성된 날짜·시간.
  • account_url — 계정 이름 형식으로 계정에 연결하는 데 사용하는 계정 URL. 이 형식의 계정 식별자는 <orgname>-<account_name> 패턴을 따름.
  • account_locator_url — 레거시 계정 로케이터 형식으로 연결하는 데 사용하는 계정 URL.
  • is_reader — 관리 계정이 (데이터 공유용) 리더 계정인지 여부.
  • comment — 관리 계정에 대한 주석.
  • region_group — 관리 계정이 위치한 리전 그룹.
  • old_account_url — 계정 이름 변경 시 원래 계정 URL이 저장되었다면 그 원래 URL을 제공. 원래 URL이 삭제되었으면 NULL.
  • account_old_url_saved_on — 계정 이름 변경 시 원래 계정 URL이 저장되었다면 그 저장 날짜·시간.
  • account_old_url_last_used — 계정 이름 변경 시 원래 계정 URL을 저장했다면, 원래 URL로 계정에 마지막으로 접근한 시간.
  • organization_old_url — 조직 변경으로 새 계정 URL이 생기고 원래 계정 URL이 저장되었다면 원래 계정 URL 제공. 원래 URL이 삭제되었으면 NULL.
  • organization_old_url_saved_on — 조직 변경으로 원래 계정 URL이 저장되었다면 그 저장 날짜·시간.
  • organization_old_url_last_used — 조직 변경으로 원래 계정 URL이 저장되었다면, 원래 URL로 계정에 마지막으로 접근한 시간.

예제 (Examples)

모든 관리 계정을 표시해요:

SHOW MANAGED ACCOUNTS;

더 알아보기 (Learn more)