- Catégories :
Fonctions de table (Modélisation d’objet)
GET_OBJECT_REFERENCES¶
Renvoie une liste de tous les objets référencés par un objet spécifié. L’entrée est actuellement limitée au nom d’une vue.
Le tableau suivant identifie les types d’objets de bases de données actuellement renvoyés dans la sortie :
Type d’objet |
Renvoyé en sortie ? |
|---|---|
Tables |
Oui |
Vues (y compris les vues sécurisées) |
Oui |
Vues matérialisées |
Non |
Zones de préparation nommées (internes ou externes) |
Non |
Flux |
Non |
Fonctions définies par l’utilisateur (UDF)/Fonctions de table définies par l’utilisateur (UDTF) |
Non |
Syntaxe¶
Arguments¶
DATABASE_NAME => 'string'Nom de la base de données dans laquelle résident le schéma et l’objet.
SCHEMA_NAME => 'string'Nom du schéma dans lequel réside l’objet.
OBJECT_NAME => 'string'Nom de l’objet. Actuellement limité au nom d’une vue (sécurisée ou non sécurisée).
Renvoie¶
La fonction renvoie les colonnes suivantes :
Nom de la colonne |
Type de données |
Description |
|---|---|---|
DATABASE_NAME |
TEXT |
Nom de la base de données contenant l’objet interrogé. |
SCHEMA_NAME |
TEXT |
Nom du schéma contenant l’objet interrogé. |
OBJECT_NAME |
TEXT |
Nom de l’objet interrogé. |
REFERENCED_DATABASE_NAME |
TEXT |
Nom de la base de données contenant un objet référencé par l’objet interrogé. |
REFERENCED_SCHEMA_NAME |
TEXT |
Nom du schéma contenant un objet référencé par l’objet interrogé. |
REFERENCED_OBJECT_NAME |
TEXT |
Nom d’un objet référencé par l’objet interrogé. |
REFERENCED_OBJECT_TYPE |
TEXT |
Type d’objet identifié dans la colonne REFERENCED_OBJECT_NAME. Les valeurs incluent TABLE ou VIEW. |
Notes sur l’utilisation¶
Cette fonction requiert les privilèges suivants :
SELECT sur la vue. Pour obtenir des références pour une vue, le rôle utilisé ou un rôle accordé au rôle utilisé doit avoir le privilège SELECT sur la vue. Pour plus de détails, reportez-vous à Privilèges de table et Affichage des privilèges.
OWNERSHIP sur la vue sécurisée. Si la chaîne de dépendances fait référence à une vue sécurisée, le rôle utilisé ou un rôle accordé au rôle utilisé doit avoir le privilège OWNERSHIP sur la vue sécurisée. Sinon, Snowflake renvoie le message d’erreur suivant :
Les valeurs
DATABASE_NAME,SCHEMA_NAMEetOBJECT_NAMEdoivent être placées entre guillemets. De plus, si l’un de ces noms contient des espaces, des caractères en majuscules et minuscules ou des caractères spéciaux, le nom doit être entre guillemets doubles à l’intérieur des guillemets simples (p. ex.'"My DB"'vs'mydb').Si la vue fait référence à des zones de préparation, des UDFs ou à des vues matérialisées, cette fonction renvoie une erreur plutôt que de renvoyer une liste des tables et des vues référencées.
Exemples¶
Renvoie la liste des références pour une vue :