<nom_budget>!REMOVE_RESOURCE

Retirer un objet d’un budget personnalisé. L’objet doit être supprimé par référence.

Voir aussi :

<nom_budget>!ADD_RESOURCE, <nom_budget>!GET_LINKED_RESOURCES

Syntaxe

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

Arguments

'object_reference'

La représentation sérialisée de la chaîne qui se résout en un objet. Cette chaîne est la sortie de la fonction SYSTEM$REFERENCE.

reference_statement

Une instruction SYSTEM$REFERENCE qui crée une référence pour l’objet à retirer du budget.

Renvoie

Successfully removed resource from resource group

Exigences en matière de contrôle d’accès

Les privilèges et rôles minimaux suivants sont nécessaires pour appeler cette méthode sur un budget personnalisé :

  • Rôle d’instance ADMIN <label-budgets_instance_roles> pour l’instance de budget.

  • Privilège USAGE sur la base de données et le schéma contenant l’instance de budget.

  • Privilège USAGE sur la base de données et le schéma qui contiennent l’objet (pour les objets de schéma).

  • Privilège APPLYBUDGET sur l’objet en cours de retrait.

Pour plus d’informations, voir Rôles et privilèges Budgets.

Notes sur l’utilisation

  • Cette méthode ne peut être appelée que pour les instances de budget personnalisé.

  • Le fait d’appeler cette méthode ne renvoie pas l’objet. Pour cette raison, vous ne pouvez pas utiliser le chaînage de méthodes pour appeler une autre méthode sur la valeur de retour de cette méthode. Au lieu de cela, appelez chaque méthode dans une instruction SQL distincte.

Exemples

Supprimer la table t1 du budget my_budget dans le schéma budget_db.budget_schema en utilisant un identificateur comme référence :

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

Supprimer la table t1 du budget my_budget dans le schéma budget_db.budget_schema en utilisant une instruction SYSTEM$REFERENCE :

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

Messages d’erreur

Pour une liste des messages d’erreur courants ainsi que leurs causes et solutions, voir Vous ne pouvez pas ajouter ou supprimer des objets d’un budget personnalisé.