ALTER ONLINE FEATURE TABLE¶
기존 :doc:`온라인 기능 테이블</sql-reference/sql/create-online-feature-table>`의 속성을 수정합니다.
- 참고 항목:
CREATE ONLINE FEATURE TABLE , DESCRIBE ONLINE FEATURE TABLE, DROP ONLINE FEATURE TABLE , SHOW ONLINE FEATURE TABLES
구문¶
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> { SUSPEND | RESUME }
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> REFRESH
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET
[ TARGET_LAG = '<num> { seconds | minutes | hours | days }' ]
[ WAREHOUSE = <warehouse_name> ]
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> <tagAction>
매개 변수¶
name변경할 온라인 기능 테이블의 식별자를 지정합니다.
식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
RENAME TO new_name온라인 기능 테이블의 이름을 :samp:`{new_name}`으로 변경합니다. 새 식별자는 스키마에 대해 고유한 식별자여야 합니다.
식별자에 대한 자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
오브젝트의 이름이 바뀌면 그 오브젝트를 참조하는 다른 오브젝트도 새 이름으로 업데이트해야 합니다.
SUSPEND | RESUME테이블에 있는 데이터의 주기적 백그라운드 새로 고침을 일시 중단할지 또는 재개할지를 지정합니다.
SUSPEND온라인 기능 테이블의 주기적 백그라운드 새로 고침을 일시 중단합니다.
RESUME온라인 기능 테이블의 주기적 백그라운드 새로 고침을 재개합니다.
REFRESH온라인 기능 테이블을 수동으로 새로 고쳐야 함을 지정합니다.
SET ...온라인 기능 테이블에 대해 하나 이상의 지정된 속성 또는 매개 변수를 설정합니다.
TARGET_LAG = 'num { seconds | minutes | hours | days }'백그라운드 새로 고침 일정을 정의하는 데 사용할 새 목표 지연을 지정합니다.
10초에서 8일(경계값 포함) 사이의 값이어야 합니다.
WAREHOUSE = warehouse_name온라인 기능 테이블을 새로 고치기 위한 컴퓨팅 리소스를 제공하는 새 웨어하우스의 이름을 지정합니다.
COMMENT = 'string_literal'온라인 기능 테이블에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.
tagAction온라인 기능 테이블에 태그를 설정하거나 설정 해제합니다.
tagAction ::= { SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] | UNSET TAG <tag_name> [ , <tag_name> ... ] }
SET TAG온라인 기능 테이블에 지정된 태그와 태그 값을 설정합니다.
UNSET TAG온라인 기능 테이블에 지정된 태그를 설정 해제합니다.
액세스 제어 요구 사항¶
권한 |
오브젝트 |
참고 |
|---|---|---|
OWNERSHIP |
온라인 기능 테이블 |
온라인 기능 테이블에 대한 OWNERSHIP 권한이 있는 역할입니다. |
USAGE |
웨어하우스 |
웨어하우스 변경 시 필수 |
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
메타데이터 관련:
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.
예¶
다음 예에서는 이름이 ``my_online_feature_table``인 온라인 기능 테이블에 대한 주기적 백그라운드 새로 고침을 일시 중단합니다.
ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND;
다음 예에서는 ``my_online_feature_table``이라는 온라인 기능 테이블을 수동으로 새로 고칩니다.
ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH;
다음 예에서는 이름이 ``my_online_feature_table``인 온라인 기능 테이블의 목표 지연을 변경합니다.
ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute';
다음 예에서는 온라인 기능 테이블 ``my_online_feature_table``의 이름을 ``my_new_online_feature_table``로 변경합니다.
ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table;