SHOW DATA MOVEMENT POLICIES

SHOW DATA MOVEMENT POLICIES

SHOW DATA MOVEMENT POLICIES 명령은 접근 권한(privilege)이 있는 데이터 이동 정책(data movement policy) 목록을 보여주는 명령이에요. 정책의 생성 날짜, 데이터베이스·스키마 이름, 소유자, 주석을 반환해요.

출처: 문서

본문

이 명령은 접근 권한이 있는 데이터 이동 정책을 나열해요. 세션의 현재 데이터베이스·스키마, 지정한 데이터베이스·스키마, 또는 전체 계정의 객체를 나열할 수 있어요. 각 객체의 메타데이터와 속성이 출력에 포함되며, 객체는 데이터베이스, 스키마, 객체 이름 기준 사전 순으로 정렬돼요.

기능 상태: Enterprise Edition 기능. 이 기능에는 Enterprise Edition 이상이 필요해요. 업그레이드 문의는 Snowflake 지원에 연락해요.

관련 명령: CREATE DATA MOVEMENT POLICY, ALTER DATA MOVEMENT POLICY, DROP DATA MOVEMENT POLICY, DESCRIBE DATA MOVEMENT POLICY, CREATE DATA MOVEMENT RULE, ALTER DATA MOVEMENT RULE, DROP DATA MOVEMENT RULE.

구문 (Syntax)

SHOW DATA MOVEMENT POLICIES [ LIKE '<pattern>' ]
                            [ IN
                                 {
                                   ACCOUNT                  |

                                   DATABASE                 |
                                   DATABASE <database_name> |

                                   SCHEMA                   |
                                   SCHEMA <schema_name>     |
                                   <schema_name>
                                 }
                            ]

파라미터 (Parameters)

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

  • [ IN ... ] — 명령의 범위를 선택적으로 지정해요:

    • ACCOUNT — 전체 계정의 레코드 반환.
    • DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환. 데이터베이스가 사용 중이 아닌데 db_name 없이 지정하면 키워드가 출력에 영향을 주지 않아요.
    • SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환.
    • IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.

출력 (Output)

명령 출력은 객체의 속성과 메타데이터를 설명하는 다음 컬럼을 포함해요:

  • created_on (TIMESTAMP_LTZ) — 정책이 생성된 날짜·시간.
  • name (VARCHAR) — 정책 이름.
  • database_name (VARCHAR) — 정책이 저장된 데이터베이스.
  • schema_name (VARCHAR) — 정책이 저장된 스키마.
  • owner (VARCHAR) — 정책을 소유한 역할 이름.
  • comment (VARCHAR) — 정책에 대한 주석(있을 경우).
  • owner_role_type (VARCHAR) — 정책을 소유한 역할 유형.

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

SHOW 명령은 나열하는 객체에 대한 권한을 요구하지 않아요. 출력에는 명령을 실행하는 역할에 표시되는 데이터 이동 정책만 포함돼요.

사용 참고 사항 (Usage notes)

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

예제 (Examples)

mydb 데이터베이스의 PUBLIC 스키마에 있는 데이터 이동 정책을 나열해요:

USE DATABASE mydb;

SHOW DATA MOVEMENT POLICIES;

더 알아보기 (Learn more)