ALTER STORAGE LIFECYCLE POLICY

기존 :doc:`저장소 수명 주기 정책</user-guide/storage-management/storage-lifecycle-policies>`의 속성을 수정합니다.

주의

저장소 수명 주기 정책에 대한 변경 사항은 연결된 모든 테이블에 상당한 영향을 미칠 수 있습니다. ACCOUNT_USAGE 스키마의 QUERY_HISTORY 뷰를 사용하여 정책 변경 사항을 정기적으로 감사합니다. 자세한 내용은 QUERY_HISTORY 뷰 섹션을 참조하십시오.

참고 항목:

CREATE STORAGE LIFECYCLE POLICY , DESCRIBE STORAGE LIFECYCLE POLICY , DROP STORAGE LIFECYCLE POLICY , SHOW STORAGE LIFECYCLE POLICIES

구문

ALTER STORAGE LIFECYCLE POLICY [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER STORAGE LIFECYCLE POLICY [ IF EXISTS ] <name> SET

  BODY -> <expression_on_arg_name>
  | ARCHIVE_TIER = { COOL | COLD }
  | ARCHIVE_FOR_DAYS = <number_of_days>
  | COMMENT = '<string_literal>'
  | TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER STORAGE LIFECYCLE POLICY [ IF EXISTS ] <name> UNSET
  ARCHIVE_FOR_DAYS
  | COMMENT
  | TAG <tag_name> [ , <tag_name> ... ]
Copy

매개 변수

name

변경할 정책의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

RENAME TO new_name

정책에 대한 새 식별자를 지정합니다. 정책은 스키마에 대해 고유해야 합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

선택적으로 오브젝트의 이름을 바꾸는 동안 오브젝트를 다른 데이터베이스 및/또는 스키마로 이동할 수 있습니다. 그러려면 각각 db_name.schema_name.object_name 또는 schema_name.object_name 형식으로 새 데이터베이스 및/또는 스키마 이름을 포함하는 정규화된 new_name 값을 지정하십시오.

참고

  • 대상 데이터베이스 및/또는 스키마가 이미 있어야 합니다. 또한, 새 위치에 이름이 같은 오브젝트가 있으면 안 됩니다. 그렇지 않으면 문이 오류를 반환합니다.

  • 오브젝트 소유자(즉, 오브젝트에 대한 OWNERSHIP 권한이 있는 역할) 역시 대상 스키마를 소유하지 않는 한 오브젝트를 관리되는 액세스 스키마로 이동하는 것은 금지됩니다.

오브젝트의 이름이 바뀌면 그 오브젝트를 참조하는 다른 오브젝트도 새 이름으로 업데이트해야 합니다.

SET ...

정책에 대해 설정할 속성을 하나 이상 지정합니다.

BODY -> expression_on_arg_name

만료할 행을 결정하는 SQL 식입니다.

데이터를 변환하려면 조건식 함수 또는 :doc:`사용자 정의 함수</developer-guide/udf/udf-overview>`(UDFs)와 같은 기본 제공 함수를 사용하면 됩니다.

참고

현재, 저장소 수명 주기 정책 본문에서는 SQL 및 JavaScript UDFs만 지원됩니다.

ARCHIVE_TIER = { COOL | COLD }

ARCHIVE_FOR_DAYS가 설정되지 않은 만료 정책을 아카이브 정책으로 변환할 저장소 계층을 지정합니다.

  • :code:`COOL`을 사용하려면 보관 기간(ARCHIVE_FOR_DAYS)을 90일 이상으로 설정해야 합니다.

  • :code:`COLD`를 사용하려면 보관 기간(ARCHIVE_FOR_DAYS)을 180일 이상으로 설정해야 합니다.

ARCHIVE_FOR_DAYS = number_of_days

아카이브 저장소에 정책 식과 일치하는 행을 보관할 일수를 지정합니다. 설정한 경우 Snowflake는 ARCHIVE_TIER에 대해 선택한 값에 따라 데이터를 아카이브 저장소로 이동합니다. 설정하지 않은 경우 Snowflake는 데이터를 보관하지 않고 테이블에서 행을 만료합니다.

값:

  • ARCHIVE_TIER = COOL: 90 - 2147483647

  • ARCHIVE_TIER = COLD: 180 - 2147483647

기본값: 설정 해제

COMMENT = 'string_literal'

정책에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

기본값: 값 없음

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

태그 이름과 태그 문자열 값을 지정합니다.

태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.

문에서 태그를 지정하는 방법에 대한 자세한 내용은 Tag quotas 섹션을 참조하십시오.

UNSET ...

정책에 대해 설정 해제할 속성을 지정하여 속성을 기본값으로 재설정합니다.

  • ARCHIVE_FOR_DAYS

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

단일 ALTER 문으로 여러 속성 또는 매개 변수의 설정을 해제하려면 각 속성 또는 매개 변수를 쉼표로 구분합니다.

속성이나 매개 변수를 설정 취소할 때는 속성이나 매개 변수 이름만 지정하십시오(위의 구문에서 값을 지정해야 한다고 명시된 경우는 제외). 값을 지정하면 오류가 반환됩니다.

액세스 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한

오브젝트

참고

OWNERSHIP

저장소 수명 주기 정책

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 특정 권한을 부여받은 역할은 해당 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 기존 정책을 업데이트하고 정책의 현재 정의를 확인해야 할 경우 GET_DDL 함수를 호출하거나 DESCRIBE STORAGE LIFECYCLE POLICY 명령을 실행합니다.

  • 이 명령으로는 정책 서명을 변경할 수 없습니다. 서명을 변경하려면 DROP STORAGE LIFECYCLE POLICY 명령을 사용한 후 새 정책을 만듭니다.

  • 정책에 대한 ARCHIVE_TIER를 설정한 후에는 변경할 수 없습니다. 예를 들어, 이 명령을 사용하여 정책에 대한 ARCHIVE_TIER를 COOL에서 COLD로 변경할 수 없습니다.

  • 정책에 대한 ARCHIVE_FOR_DAYS 설정을 해제하는 경우 저장소 계층은 변경되지 않습니다. 나중에 정책에 대해 아카이브 저장소를 다시 활성화하는 경우 저장소 계층을 수정할 수 없습니다.

  • 정책 본문에 하나 이상의 :doc:`하위 쿼리</user-guide/querying-subqueries>`를 포함하면 오류가 발생할 수 있습니다. 가능하면 하위 쿼리 수를 제한하고 JOIN 작업 수를 제한하며 WHERE 절 조건을 단순화하십시오.

  • 메타데이터 관련:

    주의

    고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

예

다음 예제에서는 30일 후에 해지된 계정을 만료하도록 저장소 수명 주기 정책을 업데이트합니다.

ALTER STORAGE LIFECYCLE POLICY expire_storage_for_closed_accounts
  SET BODY ->
    event_ts < DATEADD(DAY, -30, CURRENT_TIMESTAMP())
    AND EXISTS (
      SELECT 1 FROM closed_accounts
      WHERE id = account_id
    );
Copy
언어: 한국어