Vue EXTERNAL_TABLES¶

Cette vue Schéma d’information affiche une ligne pour chaque table externe définie dans la base de données spécifiée (ou actuelle).

Voir aussi :: Vue COLUMNS, Vue VIEWS

Colonnes¶

Nom de la colonne	Type de données	Description
TABLE_CATALOG	TEXT	Base de données à laquelle la table appartient
TABLE_SCHEMA	TEXT	Schéma auquel la table appartient
TABLE_NAME	TEXT	Nom de la table
TABLE_OWNER	TEXT	Nom du rôle propriétaire de la table
CREATED	TIMESTAMP_LTZ	Heure de création de la table
LAST_ALTERED	TIMESTAMP_LTZ	Date et heure de la dernière modification de l’objet par un DML, un DDL ou une opération de métadonnées en arrière-plan. Consultez Notes sur l’utilisation.
LAST_DDL	TIMESTAMP_LTZ	Horodatage de la dernière opération DDL effectuée sur la table ou la vue. Toutes les opérations de table/vue DDL prises en charge mettent à jour ce champ : { CREATE \| ALTER \| DROP \| UNDROP } TABLE { CREATE \| ALTER \| DROP } VIEW Toutes les opérations effectuées sur ALTER TABLE mettent à jour ce champ, y compris la définition ou la suppression d’un paramètre de table (par exemple, COMMENT, DATA_RETENTION_TIME, etc.) et les modifications apportées aux colonnes de la table (ADD / MODIFY / RENAME / DROP). Pour plus d’informations, consultez les notes sur l’utilisation ci-dessus.
LAST_DDL_BY	TEXT	Le nom d’utilisateur actuel de l’utilisateur qui a exécuté la dernière opération DDL. Si l’utilisateur a été exclu, affichez `DROPPED_USER(<l’identifiant>)`. Pour les utilisateurs exclus, vous pouvez joindre `<l'identifiant >` à la colonne USER_ID dans Vue USERS.
AUTO_CLUSTERING_ON	BOOLEAN	Si le clustering automatique est activé pour la table
COMMENT	TEXT	Commentaire pour cette table
LOCATION	TEXT	Zone de préparation externe où sont mis en zone de préparation les fichiers contenant des données à lire
FILE_FORMAT_NAME	TEXT	Format de fichier nommé qui décrit les fichiers de données mis en zone de préparation à analyser lors de l’interrogation de la table externe
FILE_FORMAT_TYPE	TEXT	Type de format des fichiers de données mis en zone de préparation à analyser lors de l’interrogation de la table externe

Notes sur l’utilisation¶

La vue n’affiche que les objets pour lesquels le rôle actuel de la session s’est vu accorder des privilèges d’accès. La vue n’honore pas le privilège MANAGE GRANTS et peut donc afficher moins d’informations qu’une commande SHOW lorsque les deux sont exécutées par un utilisateur qui détient le privilège MANAGE GRANTS.
La vue n’inclut pas les tables externes qui ont été détruites.
Pour afficher uniquement les tables externes dans vos requêtes, filtrez à l’aide d’une clause WHERE, par ex. :

... WHERE table_schema != 'INFORMATION_SCHEMA'
La colonne LAST_ALTERED est mise à jour lorsque les opérations suivantes sont effectuées sur un objet :
- DDL opérations.
- DML opérations (pour les tables uniquement). Cette colonne est mise à jour même si aucune ligne n’est affectée par l’instruction DML.
- Opérations de maintenance des métadonnées en arrière-plan effectuées par Snowflake.
Pour les vues et les tables, utilisez la colonne LAST_DDL pour connaître l’heure de la dernière modification d’un objet.
La valeur de la colonne LAST_DDL est mise à jour comme suit :
- Lors de la création d’une table ou d’une vue, l’horodatage LAST_DDL est identique à l’horodatage CREATED.
- Lorsqu’une table ou une vue est exclue, l’horodatage LAST_DDL est identique à l’horodatage DELETED.
- Les dernières données DDL ne sont pas disponibles pour les opérations qui ont eu lieu avant que les colonnes ne soient ajoutées. Les nouveaux champs DDL contiennent null jusqu’à ce qu’une opération DDL soit exécutée.
- Pour les bases de données répliquées, les champs LAST_DDL et LAST_DDL_BY ne sont mis à jour que pour les objets de la base de données principale. Après le basculement, les champs LAST_DDL et LAST_DDL_BY sont mis à jour pour les opérations DDL pour les tables et les vues de la base de données principale nouvellement promue. Ces champs resteront inchangés pour les objets de la base de données désormais secondaire.
- Pour les objets des bases de données secondaires qui sont nouvellement créés lors d’une opération d’actualisation, ces champs sont null.
La colonne LAST_ALTERED n’indique pas nécessairement l’heure de la dernière actualisation pour les tables externes. Pour récupérer l’heure de la dernière actualisation d’une table externe actualisée automatiquement, vous pouvez utiliser la fonction SYSTEM$EXTERNAL_TABLE_PIPE_STATUS qui renvoie des informations telles que l’horodatage du dernier fichier enregistré par Snowflake.

Exemples¶

Récupérez la liste de toutes les tables externes dans tous les schémas de la base de données mydatabase :

SELECT table_name, last_altered FROM mydatabase.information_schema.external_tables;

Copy