Schéma d’information de Snowflake¶

Qu’est-ce que INFORMATION_SCHEMA ?¶

Chaque base de données créée dans votre compte inclut automatiquement un schéma intégré en lecture seule nommé INFORMATION_SCHEMA. Le schéma contient les objets suivants :

• Vues pour tous les objets contenus dans la base de données, ainsi que les vues pour les objets au niveau du compte (c’est-à-dire les objets autres que les bases de données tels que les rôles, les entrepôts virtuels et les bases de données).

• Fonctions de table pour les données historiques et les données d’utilisation de votre compte.

Vues du schéma d’information et fonctions de table¶

Notes générales sur l’utilisation¶

• Chaque schéma INFORMATION_SCHEMA est en lecture seule (c’est-à-dire que le schéma, et toutes les vues et fonctions de la table dans le schéma, ne peuvent être modifiés ou détruits).

• Les requêtes sur les vues INFORMATION_SCHEMA ne garantissent pas la cohérence par rapport aux DDL concurrentes. Par exemple, si un ensemble de tables est créé pendant qu’une requête INFORMATION_SCHEMA de longue durée est exécutée, le résultat de la requête peut inclure certaines, aucune ou toutes les tables créées.

• La sortie d’une fonction de vue ou de table dépend des privilèges accordés au rôle actuel de l’utilisateur. Lors de l’interrogation d’une fonction INFORMATION_SCHEMA de vue ou de table, seuls les objets pour lesquels le rôle courant a obtenu des droits d’accès sont retournés.

• Pour éviter les problèmes de performance, l’erreur suivante est retournée si les filtres spécifiés dans une requête INFORMATION_SCHEMA ne sont pas suffisamment sélectifs :

  Information schema query returned too much data. Please repeat query with more selective predicates.

• Les vues spécifiques à Snowflake sont susceptibles d’être modifiées. Évitez de sélectionner toutes les colonnes dans ces vues. À la place, sélectionnez les colonnes que vous voulez. Par exemple, si vous voulez la colonne name utilisez SELECT name, plutôt que SELECT *.

Considérations relatives au remplacement de commandes SHOW par des vues de schéma d’information¶

Les vues INFORMATION_SCHEMA fournissent une interface SQL aux mêmes informations que celles fournies par les commandes SHOW <objets>. Vous pouvez utiliser les vues pour remplacer ces commandes ; cependant, il existe quelques différences importantes à prendre en compte avant d’opérer le changement :

Qualification des noms des vues de schéma d’information et des fonctions de table dans les requêtes¶

Lors de l’interrogation d’une fonction de vue ou de table INFORMATION_SCHEMA, vous devez utiliser le nom qualifié de la fonction de vue/table ou le schéma INFORMATION_SCHEMA doit être utilisé pour la session.

Par exemple :

• Pour effectuer une requête en utilisant les noms complets de la fonction de vue et de table, sous la forme de database.information_schema.name :

  SELECT table_name, comment FROM testdb.INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(testdb.INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• Pour effectuer une requête en utilisant les noms qualifiés de la fonction de vue et de table, sous la forme de information_schema.name :

  USE DATABASE testdb;
  
  SELECT table_name, comment FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• Pour effectuer une requête avec le schéma INFORMATION_SCHEMA utilisé pour la session :

  USE SCHEMA testdb.INFORMATION_SCHEMA;
  
  SELECT table_name, comment FROM TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(LOGIN_HISTORY( ... ));
  

  Copy

  Note

  Si vous utilisez une base de données qui a été créée à partir d’un partage et que vous avez sélectionné INFORMATION_SCHEMA comme schéma actuel pour la session, l’instruction SELECT peut échouer avec l’erreur suivante :

  INFORMATION_SCHEMA does not exist or is not authorized

  Si cela se produit, sélectionnez un schéma différent pour le schéma actuel de la session.

Pour des exemples plus détaillés, reportez-vous à la documentation de référence de chaque fonction de vue/table.