<budget_name>!ADD_SHARED_RESOURCE¶

구문¶

<budget_name>!ADD_SHARED_RESOURCE( '<domain>' [ , '<instance>' ] )

인자¶

'domain'

예산에 추가되는 리소스의 유형입니다. 유효한 값:

• AI FUNCTION

• CORTEX CODE

• CORTEX AGENT

• SNOWFLAKE INTELLIGENCE

두 번째 인자를 지정하지 않는 한, 예산은 지정된 도메인 내의 모든 리소스에 대한 사용량을 추적합니다.

'instance'

선택 사항입니다. 선택한 domain 내에서 예산에 추가할 특정 리소스를 지정합니다.

인스턴스 수준 선택을 지원하는 도메인의 경우(예: AI FUNCTION 및 CORTEX CODE), 이 인자를 사용하면 특정 함수 또는 인터페이스를 추적할 수 있습니다.

두 번째 인자를 지정하지 않으면 예산은 도메인 내의 모든 인스턴스를 추적합니다.

예:

• AI 함수: AI_CLASSIFY, AI_COMPLETE

• Cortex Code: CORTEX_CODE_CLI, CORTEX_CODE_SNOWSIGHT

인스턴스 수준 선택은 모든 도메인에 적용할 수 있는 것은 아닙니다. 예를 들어 ,``CORTEX AGENT`` 및 SNOWFLAKE INTELLIGENCE 는 현재 도메인 수준에서만 추적됩니다.

반환¶

리소스가 예산에 성공적으로 추가되었는지 여부를 나타내는 VARCHAR 값을 반환합니다.

리소스를 예산에 추가할 수 없는 경우 이 함수는 오류 메시지를 반환합니다.

액세스 제어 요구 사항¶

사용자 지정 예산에 대해 이 메서드를 호출하려면 다음 권한과 역할이 필요합니다.

• 예산 인스턴스에 대한 ADMIN 인스턴스 역할.

• 예산 인스턴스가 포함된 데이터베이스와 스키마에 대한 USAGE 권한.

• 추가 중인 리소스가 포함된 데이터베이스 및 스키마에 대한 USAGE 권한(스키마 오브젝트의 경우).

자세한 내용은 예산 역할 및 권한 섹션을 참조하십시오.

사용법 노트¶

• 사용자 지정 예산 에는 공유 리소스만 추가할 수 있습니다.

• 메서드의 결과를 확인하려면 GET_BUDGET_SCOPE 메서드를 호출합니다.

• 지정된 엔터티 유형의 모든 오브젝트가 추가되는 경우(예: 모든 AI 함수), 해당 유형의 개별 리소스를 추가할 수 없습니다.

• 이 메서드를 호출해도 오브젝트는 반환되지 않습니다. 이로 인해, 메서드 연결을 사용하여 이 메서드의 반환값으로 다른 메서드를 호출할 수 없습니다. 대신, 별도의 SQL 문에서 각 메서드를 호출합니다.

예¶

예산에 모든 AI 함수를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION');

예산에 특정 AI 함수를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION', 'AI_CLASSIFY');

예산에 모든 Cortex Code 워크로드를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE');

예산에 Cortex Code CLI 워크로드를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_CLI');

예산에 Cortex Code Snowsight 워크로드를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_SNOWSIGHT');

예산에 Cortex Agent 워크로드를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX AGENT');

예산에 모든 Snowflake Intelligence 워크로드를 추가합니다.

CALL finance_budget!ADD_SHARED_RESOURCE('SNOWFLAKE INTELLIGENCE');