SHOW SNAPSHOT POLICIES — 사용되지 않음(Deprecated)

액세스 권한이 있는 계정의 모든 스냅샷 정책(snapshot policy)을 나열하는 명령이에요.

출처: 문서

본문

Standard & Business Critical 기능: 스냅샷은 모든 Snowflake 에디션에서 사용할 수 있어요. 보존 잠금(retention lock)이 있는 스냅샷과 법적 보류(legal hold)가 있는 스냅샷은 Business Critical Edition(또는 그 이상)에서 사용할 수 있어요. 업그레이드 문의는 Snowflake 지원팀에 연락해요.

사용되지 않음(Deprecated): SHOW SNAPSHOT POLICIES 명령은 더 이상 사용되지 않아요. SHOW BACKUP POLICIES를 참고해요.

액세스 권한이 있는 계정의 모든 스냅샷 정책을 나열해요.

구문

SHOW SNAPSHOT POLICIES
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> [ FROM '<name_string>' ]
   ]

매개변수

LIKE 'pattern'

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

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

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

[ IN ... ]

선택적으로 명령의 범위를 지정해요. 다음 중 하나를 지정해요:

ACCOUNT 키워드를 지정하면, 명령은 현재 계정의 모든 데이터베이스에 있는 모든 스키마에 대한 레코드를 검색해요.
DATABASE 키워드를 지정하면:
- db_name을 지정하면, 명령은 지정된 데이터베이스의 모든 스키마에 대한 레코드를 검색해요.
- db_name을 지정하지 않으면: 현재 데이터베이스가 있으면 현재 데이터베이스의 모든 스키마에 대한 레코드를 검색해요. 현재 데이터베이스가 없으면 계정의 모든 데이터베이스와 스키마에 대한 레코드를 검색해요.
SCHEMA 키워드를 지정하면:
- 정규화된 스키마 이름(예: my_database.my_schema)을 지정하면, 명령은 지정된 데이터베이스와 스키마에 대한 레코드를 검색해요.
- 정규화되지 않은 schema_name을 지정하면: 현재 데이터베이스가 있으면 현재 데이터베이스의 지정된 스키마에 대한 레코드를 검색해요. 현재 데이터베이스가 없으면 명령은 SQL compilation error: Object does not exist, or operation cannot be performed. 오류를 표시해요.
- schema_name을 지정하지 않으면: 현재 데이터베이스가 있으면, 현재 스키마가 있으면 현재 데이터베이스의 현재 스키마에 대한 레코드를 검색하고, 현재 스키마가 없으면 현재 데이터베이스의 모든 스키마에 대한 레코드를 검색해요. 현재 데이터베이스가 없으면 계정의 모든 데이터베이스와 모든 스키마에 대한 레코드를 검색해요.

STARTS WITH 'name_string'

선택적으로 객체 이름의 시작 부분에 나타나는 문자를 기준으로 명령 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하고 대소문자를 구분해요. 예를 들어 다음 문자열들은 다른 결과를 반환해요:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

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

LIMIT [ FROM 'name_string' ]

선택적으로 반환되는 최대 행 수를 제한하면서 결과의 "페이지 매김"도 가능하게 해요. 반환되는 실제 행 수는 지정된 제한보다 적을 수 있어요. 선택적 FROM 'name_string' 하위 절은 결과의 "커서" 역할을 해요. 지정된 문자열과 일치하는 객체 이름을 가진 첫 행 다음부터 지정된 수의 행을 가져올 수 있게 해줘요. 문자열은 작은따옴표로 묶어야 하고 대소문자를 구분해요. 전체 객체 이름을 포함할 필요는 없고 부분 이름도 지원돼요. 기본값: 값 없음(출력에 제한이 적용되지 않음).

참고: FROM 'name_string'과 STARTS WITH 'name_string' 절을 모두 지원하는 SHOW 명령에서는 같은 문장에서 두 절을 모두 조합할 수 있어요. 그러나 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름으로 사전순으로 반환되므로 FROM 'name_string'은 STARTS WITH 'name_string'이 반환한 행보다 사전순 값이 더 높은 행만 반환해요.

사용 메모

이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개 제한을 초과하는 레코드는 필터가 적용돼도 반환되지 않아요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.
스냅샷 정책이 어떤 스냅샷 세트와 연결되어 있는지 확인하려면 SHOW SNAPSHOT SETS 명령을 사용해요.
스냅샷 정책은 특정 스키마와 데이터베이스 안에 있는 객체예요. 따라서 그 정책을 포함하는 스키마와 데이터베이스에 대해 복제, 드롭, 언드롭 등의 작업이 수행되면 정책도 함께 수행돼요. 어떤 스냅샷 세트와 연결되어 있어서 스냅샷 정책을 드롭할 수 없다면, 그 정책을 포함하는 스키마나 데이터베이스도 드롭할 수 없어요.

출력

컬럼	설명
created_on	스냅샷 정책이 생성된 타임스탬프예요.
name	스냅샷 정책의 이름이에요.
database_name	스냅샷 정책을 포함하는 데이터베이스의 이름이에요.
schema_name	스냅샷 정책을 포함하는 스키마의 이름이에요.
owner	스냅샷 정책에 대한 OWNERSHIP 권한이 있는 역할의 이름이에요.
comment	스냅샷 정책에 대한 주석이에요.
schedule	스냅샷 생성 일정이에요.
expire_after_days	스냅샷 생성 후 만료까지의 일 수예요.
has_retention_lock	정책에 보존 잠금이 포함되는지 여부를 나타내요. 있으면 Y, 없으면 N이에요. 자세한 내용은 보존 잠금(Retention lock)을 참고해요.
owner	스냅샷 세트에 대한 OWNERSHIP 권한이 있는 역할의 이름이에요.
owner_role_type	스냅샷 정책에 대한 OWNERSHIP 권한이 있는 역할의 유형이에요.

예제

현재 계정에서 권한이 있는 모든 스냅샷 정책 나열:

SHOW SNAPSHOT POLICIES IN ACCOUNT;

더 알아보기 (Learn more)

See also: CREATE SNAPSHOT POLICY — Deprecated, ALTER SNAPSHOT POLICY — Deprecated, DROP SNAPSHOT POLICY — Deprecated