SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW

SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW

현재 계정에 대해 기능 그룹(feature group)의 미리 보기 기능만 비활성화해요. 그룹의 일반 공개(GA, Generally Available) 기능은 계속 활성화 상태로 남아요.

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

출처: Snowflake SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW 함수 문서

본문

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

구문 (Syntax)

SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW( '<group_name>' )

인자 (Arguments)

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

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

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

반환 값 (Returns)

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

+----------------------------------------------------------------+
| SYSTEM$DISABLE_FEATURE_GROUPS_PREVIEW('AI_FEATURES')           |
+----------------------------------------------------------------+
| Successfully disabled preview features in groups: AI_FEATURES. |
+----------------------------------------------------------------+

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

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

사용 참고 (Usage Notes)

  • 그룹 이름은 대소문자를 구분하지 않아요(예: ai_features와 AI_FEATURES는 동일해요).
  • 이 함수는 현재 계정에 대해 동작해요. 다른 계정을 대상으로는 사용할 수 없어요.
  • 이 함수는 멱등이에요. 미리 보기가 이미 비활성화된 그룹에 호출해도 여전히 성공 메시지를 반환해요.
  • 그룹에서 현재 미리 보기 값(비공개 미리 보기 또는 공개 미리 보기)으로 설정된 기능만 영향을 받아요. 그룹의 일반 공개 기능은 계속 활성화 상태로 남아요.
  • 계정의 모든 기능(AI 기능뿐 아니라)에 대한 미리 보기 접근을 비활성화하려면 대신 SYSTEM$DISABLE_PREVIEW_ACCESS를 사용하세요.
  • 그룹에 대해 미리 보기가 비활성화된 후 해당 그룹의 개별 기능에 대한 매개 변수 재정의를 설정하면 그룹 수준 상태는 변경하지 않고 해당 기능 하나만 다시 활성화돼요.

예제 (Examples)

현재 계정의 AI_FEATURES 그룹에서 미리 보기 기능을 비활성화해요:

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

그룹을 다시 활성화해요:

SELECT SYSTEM$ENABLE_FEATURE_GROUPS('AI_FEATURES');

더 알아보기