Schéma :: ACCOUNT_USAGE

Vue TABLES¶

Cette vue Utilisation du compte affiche une ligne pour chaque table et vue du compte.

Voir aussi :: Vue COLUMNS, Vue VIEWS, Vue TABLES (Information Schema)

Colonnes¶

Nom de la colonne	Type de données	Description
TABLE_ID	NUMBER	Identifiant interne généré par Snowflake pour la table.
TABLE_NAME	TEXT	Nom de la table.
TABLE_SCHEMA_ID	NUMBER	Identifiant interne, généré par Snowflake, du schéma de la table.
TABLE_SCHEMA	TEXT	Schéma auquel la table appartient.
TABLE_CATALOG_ID	NUMBER	Identifiant interne généré par Snowflake de la base de données pour la table.
TABLE_CATALOG	TEXT	Base de données à laquelle la table appartient.
TABLE_OWNER	TEXT	Nom du rôle qui possède la table.
TABLE_TYPE	TEXT	Indique le type de table. Les valeurs valides sont `BASE TABLE`, `TEMPORARY TABLE`, `EXTERNAL TABLE`, `EVENT TABLE`, `VIEW`, ou `MATERIALIZED VIEW`.
IS_TRANSIENT	TEXT	Indique si la table est transitoire.
CLUSTERING_KEY	TEXT	Colonne (s) et/ou expression(s) constituant la clé de clustering de la table.
ROW_COUNT	NUMBER	Nombre de lignes de la table.
BYTES	NUMBER	Nombre d’octets déterminé lors de l’analyse de la table.
RETENTION_TIME	NUMBER	Nombre de jours de conservation des données historiques pour Time Travel.
SELF_REFERENCING_COLUMN_NAME	TEXT	Non applicable pour Snowflake.
REFERENCE_GENERATION	TEXT	Non applicable pour Snowflake.
USER_DEFINED_TYPE_CATALOG	TEXT	Non applicable pour Snowflake.
USER_DEFINED_TYPE_SCHEMA	TEXT	Non applicable pour Snowflake.
USER_DEFINED_TYPE_NAME	TEXT	Non applicable pour Snowflake.
IS_INSERTABLE_INTO	TEXT	Non applicable pour Snowflake.
IS_TYPED	TEXT	Non applicable pour Snowflake.
COMMIT_ACTION	TEXT	Non applicable pour Snowflake.
CREATED	TIMESTAMP_LTZ	Date et 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.
DELETED	TIMESTAMP_LTZ	Date et heure à laquelle la table a été supprimée.
AUTO_CLUSTERING_ON	TEXT	Statut du clustering automatique d’une table. Pour plus de détails, voir Affichage du statut du clustering automatique d’une table.
COMMENT	TEXT	Commentaire pour la table.
OWNER_ROLE_TYPE	TEXT	Type de rôle qui possède l’objet, par exemple `ROLE`. . Si une Snowflake Native App est propriétaire de l’objet, la valeur est `APPLICATION`. . Snowflake renvoie NULL si vous supprimez l’objet, car un objet supprimé n’a pas de rôle propriétaire.
INSTANCE_ID	NUMBER	Identificateur interne/généré par le système pour l’instance à laquelle l’objet appartient.
IS_ICEBERG	TEXT	Indique si la table est une table Iceberg. Les valeurs valides sont `YES` ou `NO`.
IS_DYNAMIC	TEXT	Indique si la table est une table dynamique. Les valeurs valides sont `YES` ou `NO`.

Notes sur l’utilisation¶

La latence pour la vue peut aller jusqu’à 90 minutes.

La vue ne reconnaît pas le privilège MANAGE GRANTS et peut par conséquent afficher moins d’informations par rapport à une commande SHOW exécutée par un utilisateur détenteur du privilège MANAGE GRANTS.
La requête SUM(BYTES) d’une table ne représente pas l’utilisation totale du stockage, car la quantité n’inclut pas l’utilisation de Time Travel et Fail-safe.
Utiliser la valeur de la colonne LAST_ALTERED pour Time Travel n’est pas recommandé et peut renvoyer des résultats inattendus pour les raisons suivantes :
- Time Travel ne peut être utilisé que pour interroger des données historiques modifiées par une opération DML.
- La colonne LAST_ALTERED comprend à la fois les opérations DML et DDL (voir les notes sur l’utilisation suivantes).
- Pour les opérations DML, la valeur de la colonne LAST_ALTERED est l’horodatage au début de l’exécution de l’instruction plutôt que l’heure de validation de la transaction contenant cette instruction.
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 taille totale (en octets) de toutes les tables actives de tous les schémas de votre compte :

SELECT table_schema, SUM(bytes)
    FROM SNOWFLAKE.ACCOUNT_USAGE.TABLES
    WHERE deleted IS NULL
    GROUP BY table_schema;

Copy