SYSTEM$DISABLE_FEATURE_GROUPS

SYSTEM$DISABLE_FEATURE_GROUPS

현재 계정에 대해 기능 그룹(feature group)의 모든 기능을 비활성화해요.

참고: 이 함수는 요청 시 사용 가능해요. 계정에서 활성화하려면 Snowflake 지원팀에 문의하세요. 활성화 전에 Snowflake 지원팀이 영향을 받는 그룹의 기능에 대한 현재 계정 수준 매개 변수 재정의(override)를 스냅샷으로 저장하므로, 나중에 특정 기능별 설정을 되돌려야 할 경우 개별 설정을 복원할 수 있어요.

출처: Snowflake SYSTEM$DISABLE_FEATURE_GROUPS 함수 문서

본문

참고 항목: SYSTEM$ENABLE_FEATURE_GROUPS, SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW, SYSTEM$DISABLE_PREVIEW_ACCESS

구문 (Syntax)

SYSTEM$DISABLE_FEATURE_GROUPS( '<group_name>' )

인자 (Arguments)

  • group_name — 비활성화할 기능 그룹의 이름이에요. 대소문자를 구분하지 않아요. 현재 지원되는 유일한 값은 다음과 같아요.

    그룹 범위
    AI_FEATURES Cortex Search, Cortex Agent, Cortex Analyst, Cortex REST API, Snowsight의 AI/ML 사용자 인터페이스, 미세 조정(fine-tuning), Document AI, Snowflake Marketplace AI 제품, 그리고 AI_COMPLETE, AI_CLASSIFY, AI_FILTER, AI_EMBED 같은 AI SQL 내장 함수.

    그룹이 다루는 정확한 기능 집합은 새로운 AI 기능이 추가됨에 따라 시간이 지나면서 달라질 수 있어요.

반환 값 (Returns)

기능 그룹이 비활성화되었음을 나타내는 VARCHAR 상태 메시지를 반환해요.

+----------------------------------------------+
| SYSTEM$DISABLE_FEATURE_GROUPS('AI_FEATURES') |
+----------------------------------------------+
| Successfully disabled groups: AI_FEATURES.   |
+----------------------------------------------+

접근 제어 요구 사항 (Access Control Requirements)

  • 계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 함수를 실행할 수 있어요.

사용 참고 (Usage Notes)

  • 그룹 이름은 대소문자를 구분하지 않아요(예: ai_features와 AI_FEATURES는 동일해요).
  • 이 함수는 현재 계정에 대해 동작해요. 다른 계정을 대상으로는 사용할 수 없어요.
  • 이 함수는 멱등(idempotent)이에요. 이미 비활성화된 그룹에 호출해도 여전히 성공 메시지를 반환해요.
  • 이 함수는 그룹 전체를 비활성화하는 것 외에도, 같은 작업의 일부로 그룹 내 개별 기능에 설정한 계정 수준 매개 변수 재정의를 모두 해제해요. Snowflake 지원팀은 셀프 서비스 액세스를 활성화하기 전에 이러한 재정의를 스냅샷으로 저장하며(앞의 참고 참조), 이는 나중에 개별 기능별 설정을 복원해야 할 경우의 롤백 경로예요.
  • 그룹이 비활성화된 후 해당 그룹의 개별 기능에 대한 매개 변수 재정의를 설정하면 그룹 수준 상태는 변경하지 않고 해당 기능 하나만 다시 활성화돼요.

예제 (Examples)

현재 계정의 모든 AI 기능을 비활성화해요:

USE ROLE ACCOUNTADMIN;
SELECT SYSTEM$DISABLE_FEATURE_GROUPS('AI_FEATURES');

그룹의 현재 상태를 확인해요. 출력은 그룹 수준 매개 변수의 값(예: 위 호출 이후의 DISABLE_ALL)을 보여주며, 그룹 내 개별 기능 목록은 보여주지 않아요.

SHOW PARAMETERS LIKE 'AI_FEATURES' IN ACCOUNT;

그룹을 다시 활성화해요:

SELECT SYSTEM$ENABLE_FEATURE_GROUPS('AI_FEATURES');

더 알아보기