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. 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).

    • 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.

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