ALTER CORTEX SEARCH SERVICE¶
기존 Cortex Search Service 의 속성을 수정합니다.
구문¶
ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name>
{ SUSPEND | RESUME } [ { INDEXING | SERVING } ]
ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name> SET
[ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' } ]
[ WAREHOUSE = <warehouse_name> ]
[ COMMENT = '<string_literal>' ];
매개 변수¶
name
변경할 Cortex Search Service의 식별자를 지정합니다.
식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
{ SUSPEND | RESUME } ...
Cortex Search Service의 인덱싱이나 제공 또는 두 가지 모두를 일시 중단하거나 재개합니다. 다음 키워드 중 하나를 지정하여 일시 중단하거나 재개할 레이어를 나타낼 수 있습니다.
INDEXING
Cortex Search Service의 인덱싱 레이어를 나타내는 대상입니다. 자세한 내용은 사용법 노트 섹션을 참조하십시오.
SERVING
Cortex Search Service의 제공 레이어를 나타내는 대상입니다. 자세한 내용은 사용법 노트 섹션을 참조하십시오.
어느 키워드도 지정하지 않으면 인덱싱 레이어와 제공 레이어가 모두 일시 중단되거나 재개됩니다.
SET ...
Cortex Search Service를 위해 설정할 하나 이상의 지정된 속성 또는 매개 변수를 설정합니다.
TARGET_LAG = 'num { seconds | minutes | hours | days }'
Cortex Search Service 콘텐츠가 원본 쿼리에 지정된 기본 테이블에 대한 업데이트보다 지연되어야 하는 최대 시간을 지정합니다.
WAREHOUSE = warehouse_name
원본 쿼리 실행, 검색 인덱스 작성, TARGET_LAG 대상별로 새로 고침 상태를 유지하는 데 사용할 웨어하우스를 지정합니다.
COMMENT = 'string_literal'
검색 서비스에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.
액세스 제어 요구 사항¶
권한 |
오브젝트 |
---|---|
OWNERSHIP |
속성을 수정하려는 Cortex Search Service입니다. |
스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.
INDEXING 및 SERVING 상태¶
INDEXING은 Cortex Search Service의 인덱싱 레이어를 나타내는 대상입니다. RUNNING 상태에서는 서비스의 원본 쿼리에서 참조하는 기본 테이블이 변경될 경우 검색 인덱스의 일부로 저장된 구체화된 데이터를 새로 고치라는 메시지가 표시됩니다. 이러한 새로 고침 실행 시 웨어하우스 컴퓨팅 및 벡터 임베딩의 형태로 비용이 발생합니다. SUSPENDED 상태에서는 기본 테이블이 변경되어도 새로 고침이 수행되지 않으며, Cortex Search Service의 쿼리 가능한 데이터에 변경 사항이 반영되지도 않습니다.
SERVING은 Cortex Search Service의 제공 레이어를 나타내는 대상입니다. 서비스를 쿼리할 수 있으려면 이 대상이 RUNNING 상태여야 합니다. Cortex Search Service가 일시 중단된 상태에서는 Cortex Search 제공 비용의 형식으로 요금이 청구되지 않습니다.
자세한 비용 고려 사항은 비용 고려 사항 섹션을 참조하십시오.
Cortex Search Service의 INDEXING 및 SERVING 레이어는 독립적으로 관리할 수 있습니다. 예를 들어, INDEXING이 일시 중단된 상태에서 SERVING이 실행 중인 상태인 경우에도 계속 서비스를 쿼리할 수 있습니다. 하지만 서비스는 INDEXING이 재개되고 새로 고침이 성공적으로 완료될 때까지 TARGET_LAG에 관계없이 기본 데이터의 변경 사항을 반영하지 않습니다.
반대로, SERVING이 일시 중단된 상태에서 INDEXING이 실행 중인 경우에는 인덱스가 계속 새로 고쳐집니다. SERVING이 재개되는 경우 쿼리 가능하게 로드된 인덱스는 최신 원본 데이터를 반영하게 됩니다.
SERVING 키워드와 INDEXING 키워드가 모두 지정되지 않은 경우 두 대상 모두 지정된 작업의 영향을 받습니다.
예¶
다음 예에서는 mysvc
라는 Cortex Search Service에서 사용하는 웨어하우스를 my_new_wh
로 변경합니다.
ALTER CORTEX SEARCH SERVICE mysvc SET WAREHOUSE = my_new_wh;
다음 예에서는 mysvc
라는 Cortex Search Service의 주석 필드를 new_comment
로 설정합니다.
ALTER CORTEX SEARCH SERVICE mysvc SET COMMENT = 'new_comment';
다음 예에서는 mysvc
라는 Cortex Search Service의 목표 새로 고침 지연 시간을 1 hour
로 변경합니다.
ALTER CORTEX SEARCH SERVICE mysvc SET TARGET_LAG = '1 hour';
다음 예에서는 mysvc
라는 Cortex Search Service를 위한 제공을 일시 중단합니다.
ALTER CORTEX SEARCH SERVICE mysvc SUSPEND SERVING;