ALTER DYNAMIC TABLE

동적 테이블 의 속성을 수정합니다.

참고 항목:

CREATE DYNAMIC TABLE, DESCRIBE DYNAMIC TABLE, DROP DYNAMIC TABLE, SHOW DYNAMIC TABLES

이 항목의 내용:

구문

ALTER DYNAMIC TABLE <name> { SUSPEND | RESUME }

ALTER DYNAMIC TABLE <name> REFRESH

ALTER DYNAMIC TABLE <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }'  | DOWNSTREAM } ]
  [ WAREHOUSE = <warehouse_name> ]
Copy

매개 변수

name

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

SUSPEND | RESUME

동적 테이블에 대해 수행할 동작을 지정합니다.

  • SUSPEND 는 동적 테이블에서 새로 고침을 일시 중단합니다. 동적 테이블을 다른 동적 테이블에서 사용하는 경우에도 일시 중단됩니다.

  • RESUME 은 동적 테이블에서 새로 고침을 재개합니다. 재개 작업은 수동으로 일시 중단되지 않은 모든 다운스트림 동적 테이블로 순차적으로 넘어가며 진행됩니다.

동적 테이블 상태 표시에 대한 자세한 내용은 사용법 노트 섹션을 참조하십시오.

REFRESH

동적 테이블을 수동으로 새로 고쳐야 한다고 지정합니다. 사용자가 일시 중단한 동적 테이블과 자동으로 일시 중단된 동적 테이블은 모두 수동으로 새로 고칠 수 있습니다. 수동으로 새로 고친 동적 테이블에는 MANUAL이 새로 고침 활동으로 표시됩니다.

동적 테이블 상태 표시에 대한 자세한 내용은 사용법 노트 섹션을 참조하십시오. 동적 테이블 새로 고침 상태에 대한 자세한 내용은 DYNAMIC_TABLE_REFRESH_HISTORY 의 REFRESH_TRIGGER 열을 참조하십시오.

SET ...

테이블에 대해 설정할 하나 이상의 속성/매개 변수를 지정합니다(공백, 쉼표 또는 새 줄로 구분).

TARGET_LAG = { num { seconds | minutes | hours | days } | DOWNSTREAM }

동적 테이블의 지연을 지정합니다.

'num seconds | minutes | hours | days'

동적 테이블의 콘텐츠가 기본 테이블에 대한 업데이트보다 지연되어야 하는 최대 시간을 지정합니다.

예:

  • 동적 테이블의 데이터가 5분 이상 지연되면 안 될 경우 5 minutes 를 지정하십시오.

  • 동적 테이블의 데이터가 5시간 이상 지연되면 안 될 경우 5 hours 를 지정하십시오.

최소값은 1분입니다. 동적 테이블 A가 다른 동적 테이블 B에 종속된 경우 A의 최소 지연은 B의 지연보다 크거나 같아야 합니다.

DOWNSTREAM

다운스트림 상위 항목을 새로 고칠 경우 동적 테이블도 새로 고치도록 지정합니다.

WAREHOUSE = warehouse_name

동적 테이블을 새로 고치기 위한 컴퓨팅 리소스를 제공하는 웨어하우스의 이름을 지정합니다.

동적 테이블을 만들기 위해 이 웨어하우스에 대한 USAGE 권한이 있어야 합니다.

사용법 노트

  • 동적 테이블을 변경하려면 테이블에 대한 OPERATE 권한을 가진 역할을 사용해야 합니다.

  • 동적 테이블을 만든 후에는 마스킹 정책을 변경할 수 없습니다.

  • 기존 동적 테이블을 업데이트하려는데 현재 정의를 확인해야 하는 경우 GET_DDL 함수를 호출하십시오.

  • 동적 테이블 상태의 목록에 대해서는 동적 테이블 상태 섹션을 참조하십시오.

  • 다음 중 한 방법으로 동적 테이블 정보를 확인할 수 있습니다.

    • Snowsight 를 열고 Monitoring » Dynamic Tables 를 선택합니다.

    • DYNAMIC_TABLE_GRAPH_HISTORY 테이블 함수를 호출하고 결과를 검사합니다.

  • 메타데이터 관련:

    주의

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

product 라는 동적 테이블의 지연 시간을 1시간으로 변경합니다.

ALTER DYNAMIC TABLE product SET
  TARGET_LAG = '1 hour';
Copy