<budget_name>!REMOVE_TAG

Remove uma combinação de tag/valor de um orçamento personalizado. A tag deve ser removida por referência.

Consulte também:

<budget_name>!ADD_TAG, <budget_name>!GET_LINKED_TAGS

Sintaxe

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

Argumentos

'tag_reference'

A representação de string serializada que resolve uma tag. 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 removida do orçamento.

'tag_value'

Especifica o valor da combinação de tag/valor que você está removendo do orçamento.

Se a tag foi adicionada ao orçamento com um valor diferente, a tag continuará associada ao orçamento após remover esta combinação específica de tag/valor.

Retornos

Retorna um valor VARCHAR que indica se a combinação de tag/valor foi ou não removida com êxito do orçamento.

Se não foi possível remover a tag do orçamento, a função retornará uma mensagem de erro.

Requisitos de controle de acesso

Os seguintes privilégios e funções mínimos são necessários para chamar esse método em 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 removida.

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.

Exemplos

Recupere a referência da tag antes de chamar o método para remover a combinação de tag/valor.

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!REMOVE_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 não rastreará mais objetos marcados com a combinação de tag/valor team_tag = 'finance'.

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