<budget_name>!REMOVE_RESOURCE

Remova um objeto de um orçamento personalizado. O objeto deve ser removido por referência.

Consulte também:

<budget_name>!ADD_RESOURCE, <budget_name>!GET_LINKED_RESOURCES

Sintaxe

<budget_name>!REMOVE_RESOURCE( { '<object_reference>' | <reference_statement> } )
Copy

Argumentos

'object_reference'

A representação de cadeia de caracteres 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 o objeto a ser removido do orçamento.

Retornos

Successfully removed resource from resource group

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.

  • Privilégio USAGE no banco de dados e esquema que contém o objeto (para objetos de esquema).

  • Privilégio APPLYBUDGET no objeto sendo removido.

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

Remova a tabela t1 do orçamento my_budget no esquema budget_db.budget_schema usando um identificador como referência:

CALL budget_db.budget_schema.my_budget!REMOVE_RESOURCE(
  'ENT_REF_TABLE_5862683050074_5AEB8D58FB3ACF249F2E35F365A9357C46BB00D7');
Copy

Remova a tabela t1 do orçamento my_budget no esquema budget_db.budget_schema usando uma instrução SYSTEM$REFERENCE:

CALL budget_db.budget_schema.my_budget!REMOVE_RESOURCE(
  SELECT SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'APPLYBUDGET')
Copy

Mensagens de erro

Para obter uma lista de mensagens de erro comuns e suas causas e soluções, consulte Você não pode adicionar ou remover objetos de um orçamento personalizado.