Schémas :: ACCOUNT_USAGE

Vue SEMANTIC_TABLES¶

Cette vue ACCOUNT_USAGE affiche une ligne pour chaque table logique définie dans une vue sémantique.

Voir aussi ::: SEMANTIC_TABLES vue (Information Schema)

Colonnes¶


Nom de la colonne	Type de données	Description
`semantic_table_id`	NUMBER	Identificateur interne généré par Snowflake pour la table dans la vue sémantique.
`semantic_table_name`	VARCHAR	Nom de la table dans la vue sémantique.
`semantic_view_id`	NUMBER	Identificateur interne, généré par Snowflake, de la vue sémantique dans laquelle la table est définie.
`semantic_view_name`	VARCHAR	Nom de la vue sémantique dans laquelle la table est définie.
`semantic_view_schema_id`	NUMBER	Identificateur interne, généré par Snowflake, du schéma auquel appartient la vue sémantique.
`semantic_view_schema_name`	VARCHAR	Schéma auquel appartient la vue sémantique.
`semantic_view_database_id`	NUMBER	Identificateur interne, généré par Snowflake, de la base de données à laquelle appartient la vue sémantique.
`semantic_view_database_name`	VARCHAR	Base de données à laquelle appartient la vue sémantique.
`base_table_name`	VARCHAR	Nom de la table de base.
`base_table_schema_name`	VARCHAR	Schéma auquel appartient la table de base.
`base_table_database_name`	VARCHAR	Base de données à laquelle appartient la table de base.
`primary_keys`	ARRAY(VARCHAR)	Liste des colonnes de la clé primaire de la table.
`synonyms`	ARRAY(VARCHAR)	Liste des synonymes de la table.
`comment`	VARCHAR	Commentaire pour la table.
`distinct_ranges`	ARRAY(OBJECT)	Tableau de valeurs OBJECT, décrivant les contraintes pour la table logique contenant la plage. Chaque objet contient les paires clé-valeur suivantes : `constraint_name` : Nom de la contrainte. `end_column` : Nom de la colonne qui représente la fin de la plage. `start_column` : Nom de la colonne qui représente le début de la plage.
`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.
`deleted`	TIMESTAMP_LTZ	Date et heure à laquelle la table a été supprimée.

Notes sur l’utilisation¶

La latence pour la vue peut atteindre 120 minutes (2 heures).
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.

Exemples¶

Récupérer la liste de toutes les tables logiques pour la vue sémantique O_TPCH_SEMANTIC_VIEW dans la base de données MY_DB :

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.SEMANTIC_TABLES
  WHERE semantic_view_name = 'O_TPCH_SEMANTIC_VIEW'
    AND semantic_view_database_name = 'MY_DB';

+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+------------------+----------+-------------------------------+-------------------------------+---------+---------+
| SEMANTIC_TABLE_ID | SEMANTIC_TABLE_NAME | SEMANTIC_VIEW_ID | SEMANTIC_VIEW_NAME   | SEMANTIC_VIEW_SCHEMA_ID | SEMANTIC_VIEW_SCHEMA_NAME | SEMANTIC_VIEW_DATABASE_ID | SEMANTIC_VIEW_DATABASE_NAME | PRIMARY_KEYS     | SYNONYMS | CREATED                       | LAST_ALTERED                  | DELETED | COMMENT |
|-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+------------------+----------+-------------------------------+-------------------------------+---------+---------|
|               101 | LINEITEM            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.363 -0800 | 2025-02-28 16:16:04.363 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "L_ORDERKEY",  |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             |   "L_LINENUMBER" |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
|                99 | CUSTOMER            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.309 -0800 | 2025-02-28 16:16:04.309 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "C_CUSTKEY"    |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
|               100 | ORDERS              |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.321 -0800 | 2025-02-28 16:16:04.321 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "O_ORDERKEY"   |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
|               102 | SUPPLIER            |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.376 -0800 | 2025-02-28 16:16:04.376 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "S_SUPPKEY"    |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
|                98 | NATION              |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.294 -0800 | 2025-02-28 16:16:04.294 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "N_NATIONKEY"  |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
|                97 | REGION              |               49 | O_TPCH_SEMANTIC_VIEW |                      92 | MY_SCHEMA                 |                         7 | MY_DB                       | [                | NULL     | 2025-02-28 16:16:04.249 -0800 | 2025-02-28 16:16:04.249 -0800 | NULL    | NULL    |
|                   |                     |                  |                      |                         |                           |                           |                             |   "R_REGIONKEY"  |          |                               |                               |         |         |
|                   |                     |                  |                      |                         |                           |                           |                             | ]                |          |                               |                               |         |         |
+-------------------+---------------------+------------------+----------------------+-------------------------+---------------------------+---------------------------+-----------------------------+------------------+----------+-------------------------------+-------------------------------+---------+---------+