<budget_name>!GET_BUDGET_SCOPE

Retorna os recursos e as tags que foram adicionados a um orçamento personalizado. Ajuda a determinar qual consumo de recurso é rastreado pelo orçamento.

A lista não inclui:

  • Objetos adicionados automaticamente (por exemplo, pools de computação e warehouses criados e pertencentes a um Snowflake Native App).

  • Objetos adicionados quando uma tag foi adicionada ao orçamento.

Sintaxe

<budget_name>!GET_BUDGET_SCOPE()

Retornos

O método retorna um objeto JSON com as seguintes chaves:

resource_tags

As tags de recurso que foram adicionadas ao orçamento. Os recursos pertencem ao orçamento quando são marcados com essas tags. Contém os seguintes campos:

operator

A lógica correspondente usada para tags de recurso. Pode ser um dos seguintes valores:

  • UNION: um recurso será incluído no orçamento se for marcado com qualquer um dos pares tag-valor na matriz tags.

  • INTERSECTION: um recurso deve ser marcado com todos os pares tag-valor na matriz tags para ser incluído no orçamento.

tags

Uma matriz de objetos de tag, cada um com os seguintes campos:

tagId

Identificador interno da tag.

tagDatabase

Banco de dados que contém a tag.

tagSchema

Esquema que contém a tag.

tagName

Nome da tag.

tagValues

Matriz de valores de tag associados à tag.

resources

Uma matriz de recursos que foram adicionados diretamente ao orçamento. Cada objeto contém os seguintes campos:

resourceId

Identificador interno do recurso.

resourceName

Nome do recurso.

resourceDomain

Domínio do recurso (por exemplo, WAREHOUSE, DATABASE, TABLE).

schemaName

Esquema que contém o recurso.

databaseName

Banco de dados que contém o recurso.

Requisitos de controle de acesso

Os seguintes privilégios e funções mínimos são necessários para visualizar resultados de orçamentos personalizados:

  • 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.

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

Notas de uso

  • Este método só pode ser chamado em instâncias de orçamento personalizado.

  • 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.

Exemplo

Obter todos os recursos e as tags que foram adicionados ao orçamento budget_db.budget_schema.my_budget:

CALL budget_db.budget_schema.my_budget!GET_BUDGET_SCOPE();