<budget_name>!ADD_SHARED_RESOURCE¶

Sintaxe¶

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

Argumentos¶

'domain'

O tipo de recurso que está sendo adicionado ao orçamento. Valores válidos:

• AI FUNCTION

• CORTEX CODE

• CORTEX AGENT

• SNOWFLAKE INTELLIGENCE

A menos que você especifique um segundo argumento, o orçamento rastreia o consumo de todos os recursos do domínio especificado.

'instance'

Opcional. Especifica um recurso do domain selecionado para adicionar ao orçamento.

Para domínios compatíveis com a seleção no nível de instância (como``AI FUNCTION`` e CORTEX CODE), esse argumento permite rastrear uma função ou interface específica.

Se você não especificar um segundo argumento, o orçamento rastreará todas as instâncias do domínio.

Exemplos:

• Funções de AI: AI_CLASSIFY, AI_COMPLETE

• Cortex Code: CORTEX_CODE_CLI, CORTEX_CODE_SNOWSIGHT

A seleção em nível de instância não se aplica a todos os domínios. Por exemplo, atualmente, CORTEX AGENT e SNOWFLAKE INTELLIGENCE são rastreados apenas no nível do domínio.

Retornos¶

Retorna um valor VARCHAR que indica se o recurso foi adicionado ou não ao orçamento.

Se o recurso não puder ser adicionado ao orçamento, a função retornará uma mensagem de erro.

Requisitos de controle de acesso¶

Os seguintes privilégios e funções são necessários para chamar esse método para um orçamento personalizado:

• função de instância ADMIN <label-budgets_instance_roles> para a instância do orçamento.

• Privilégio USAGE no banco de dados e no esquema que contém a instância de orçamento.

• Privilégio USAGE no banco de dados e esquema que contém o recurso que está sendo adicionado (para objetos de esquema).

Para obter mais informações, consulte Funções e privilégios do Budgets.

Notas de uso¶

• Você só pode adicionar recursos compartilhados a orçamentos personalizados.

• Para verificar os resultados do método, chame o método GET_BUDGET_SCOPE.

• Quando todos os objetos do tipo de entidade especificado forem adicionados (por exemplo, todas as funções de AI), não será possível adicionar recursos individuais desse tipo.

• Chamar esse método não retorna o objeto. Por isso, você não pode usar o encadeamento de métodos para chamar outro método no valor de retorno deste método. Em vez disso, chame cada método em uma instrução SQL separada.

Exemplos¶

Adicionar todas as funções de AI ao orçamento:

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION');

Adicionar uma função de AI específica ao orçamento:

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

Adicionar todas as cargas de trabalho do Cortex Code ao orçamento:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE');

Adicionar a carga de trabalho da CLI do Cortex Code ao orçamento:

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

Adicionar a carga de trabalho do Cortex Code Snowsight ao orçamento:

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

Adicionar cargas de trabalho do Cortex Agent ao orçamento:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX AGENT');

Adicionar todas as cargas de trabalho do Snowflake Intelligence ao orçamento:

CALL finance_budget!ADD_SHARED_RESOURCE('SNOWFLAKE INTELLIGENCE');