Utilisation de références pour autoriser l’accès aux objets¶

Objets identifiés par leur nom¶

Une référence identifie un objet par son nom. Cela signifie que si un objet est renommé après la création d’une référence, celle-ci n’est pas valide. Toutefois, si un nouvel objet portant le même nom est créé, la référence peut être valide. Par exemple, un rôle my_role crée une référence my_ref1 pour la table my_table1 avec le privilège SELECT. Une fois la référence créée, la table my_table1 est supprimée et une nouvelle table nommée my_table1 est créée. La référence my_ref1 identifie une table portant le nom my_table1. Dans ce cas, elle identifie la nouvelle table my_table1.

Si le rôle utilisé pour créer la référence et le(s) privilège(s) accordé(s) sur my_table1 sont toujours valides, l’accès à la nouvelle my_table1 est autorisé lors de l’utilisation de la référence.

Si le rôle et les privilèges contenus dans la référence ne sont plus valables, l’accès à la table my_table1 ne peut être autorisé et une nouvelle référence doit être créée pour la nouvelle table.

Privilèges vérifiés au moment de l’exécution¶

Les privilèges accordés au rôle qui a créé la référence sont vérifiés au moment de l’utilisation de la référence. Par exemple, un rôle my_role crée une référence à une table t1 avec le privilège SELECT. Si my_role est supprimé ou si le privilège SELECT sur la table t1 est révoqué à partir de my_role, les privilèges encapsulés dans la référence ne sont plus valides. Lorsque la référence est transmise à une procédure stockée qui requiert le privilège SELECT sur la table, la procédure stockée échoue avec une erreur de permission.

Types de références et durée de vie des références¶

La durée de vie d’une référence peut être spécifiée au moment de la création.

• Une référence transitoire a une durée de vie limitée, soit pour la durée de l’appel dans lequel la référence est transmise, soit pour la durée de la session.

• Une référence persistante a une durée de vie illimitée. La référence reste valide jusqu’à ce que l’objet qu’elle référence soit supprimé, que la référence soit désactivée ou qu’elle devienne non valide.

  Pour des exemples de références non paramétrées, voir Annuler une référence persistante pour une application.

  Une référence peut devenir non valide pour l’une des raisons suivantes :

  • L’objet auquel il fait référence est renommé.

  • Le rôle qui a créé la référence est supprimé.

  • Le rôle qui a créé la référence n’a plus de privilèges sur l’objet.

  Pour plus d’informations, voir Objets identifiés par leur nom et Privilèges vérifiés au moment de l’exécution.

Références pour les procédures stockées de droits du propriétaire¶

Une procédure stockée des droits du propriétaire s’exécute avec les privilèges du propriétaire plutôt qu’avec les privilèges de l”appelant qui exécute la procédure stockée. Pour effectuer des actions sur une table, une vue ou une fonction à laquelle l’appelant a des privilèges d’accès, l’appelant doit transmettre une référence à la table, à la vue ou à la fonction. La référence permet à la procédure stockée d’effectuer des actions sur l’objet que la référence identifie avec les privilèges du créateur de la référence (dans ce cas, l’appelant).

Références pour les applications et les classes¶

Par nature, les applications et les classes n’ont pas accès aux objets du compte dans lequel l’application est installée ou une instance d’une classe est créée. Les utilisateurs peuvent autoriser l’accès à des objets à une application ou à une instance de classe en créant une référence.

Types d’objets pris en charge et privilèges pour les références¶

Le tableau suivant répertorie les types d’objets qu’une référence peut inclure, le type de référence qui peut être créé et les privilèges autorisés pour chaque objet :

Références de la requête¶

Une référence de requête est un type de référence transitoire. Elle fait référence à une instruction SELECT qui peut être utilisée dans la clause FROM d’une autre instruction SQL dans une procédure stockée. Vous pouvez créer une référence de requête en utilisant la fonction SYSTEM$QUERY_REFERENCE.

Pour plus d’informations, consultez Utilisation des références de requête.

Exemples¶

Créez une référence transitoire avec une portée de session vers la table t1 avec le privilège SELECT :

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'SESSION', 'SELECT');

Pour créer une référence à la même table pendant toute la durée de vie de la portée dans laquelle elle est référencée (par exemple, si vous la transmettez à une procédure stockée, sa durée de vie sera celle du bloc le plus externe de la procédure stockée), exécutez l’instruction suivante :

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'CALL', 'SELECT');

Créer une référence persistante à une table t1 avec le privilège INSERT à transmettre à une application :

SELECT SYSTEM$REFERENCE('TABLE', 't1', 'PERSISTENT', 'INSERT');

Créer une référence de requête à transmettre à une procédure stockée. La durée de vie de cette référence transitoire est celle du bloc le plus éloigné de la procédure stockée à laquelle vous transmettez la référence :

SELECT SYSTEM$QUERY_REFERENCE('SELECT id FROM my_table', FALSE);

Pour d’autres exemples :

• Exemple de procédure stockée, voir Un exemple simple.

• Exemple d’application Native App Framework, voir Associer la référence à l’application.

• Exemple d’instance de classe, voir Entraînement d’un modèle de détection d’anomalies avec des données balisées.