<budget_name>!ADD_TAG

Adiciona uma tag a um orçamento personalizado. A tag deve ser adicionada por referência.

Consulte também:

<budget_name>!REMOVE_TAG, <budget_name>!GET_LINKED_TAGS

Sintaxe

<budget_name>!ADD_TAG(
    { '<tag_reference>' | <reference_statement> },
    '<tag_value>')
Copy

Argumentos

'tag_reference'

A representação de string serializada que resolve um objeto. Esta cadeia de caracteres é a saída da função SYSTEM$REFERENCE.

reference_statement

Uma instrução SYSTEM$REFERENCE que cria uma referência para a tag a ser adicionada ao orçamento.

'tag_value'

O valor da tag que você está adicionando ao orçamento.

Retornos

Retorna um valor VARCHAR que indica se a tag foi ou não adicionada com êxito ao orçamento.

Se a tag não puder ser adicionada 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.

  • O privilégio USAGE no banco de dados e no esquema que contêm a tag.

  • O privilégio APPLYBUDGET na tag que está sendo adicionada.

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

Notas de uso

  • As tags podem ser adicionadas somente a orçamentos personalizados.

  • 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

Recupere a referência da tag antes de chamar o método para adicionar uma tag.

A instrução a seguir cria e retorna uma referência para a tag cost_center:

SELECT SYSTEM$REFERENCE(
  'TAG',
  'cost_mgmt_db.tags.cost_center',
  'SESSION',
  'APPLYBUDGET');
Copy

A instrução retorna a referência na saída.

ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2

A instrução a seguir usa o literal de string dessa referência para adicionar a tabela cost_center = 'sales' ao orçamento budget_db.budget_schema.my_budget:

CALL budget_db.budget_schema.my_budget!ADD_TAG(
  'ENT_REF_TAG_10382726315710_8A8626AE765E29446C38A217CAD093FCC9A454C2',
  'sales');
Copy
Incluir a função SYSTEM$REFERENCE no argumento diretamente

Após executar a instrução a seguir, o orçamento rastreará todos os objetos marcados com a combinação de tag/valor team_tag = 'finance'.

CALL budget_db.budget_schema.my_budget!ADD_TAG(
    (SELECT SYSTEM$REFERENCE('TAG', 'cost_mgmt_db.tags.team_tag', 'SESSION', 'APPLYBUDGET')),
    'finance');
Copy
Linguagem: Português