Utilisation de la base de données d’échantillon

La base de données d’échantillon, SNOWFLAKE_SAMPLE_DATA, est identique aux bases de données que vous créez dans votre compte, sauf qu’elle est en lecture seule. Ainsi, les opérations suivantes ne sont pas autorisées :

  • Aucun DDL ne peut être exécuté sur les schémas d’ensembles de données (c’est-à-dire que les tables et autres objets de base de données ne peuvent pas être ajoutés, détruits ou modifiés).

  • Aucun DML ne peut être effectué sur les tables des schémas.

  • Aucun clonage ou « Time Travel » ne peut être effectué sur la base de données ou sur tout schéma/table de la base de données.

Toutefois, vous pouvez utiliser les mêmes commandes et la même syntaxe pour visualiser la base de données d’échantillon, les schémas et les tables, ainsi que pour exécuter des requêtes sur les tables.

Important

La base de données d’échantillon est créée par défaut pour les nouveaux comptes. Si la base de données n’a pas été créée pour votre compte et que vous souhaitez y accéder, exécutez les instructions SQL suivantes avec le rôle ACCOUNTADMIN actif :

-- Create a database from the share.
CREATE DATABASE SNOWFLAKE_SAMPLE_DATA FROM SHARE SFC_SAMPLES.SAMPLE_DATA;

-- Grant the PUBLIC role access to the database.
-- Optionally change the role name to restrict access to a subset of users.
GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE_SAMPLE_DATA TO ROLE PUBLIC;
Copy

Dans ce chapitre :

Voir la base de données d’échantillon

Vous pouvez voir la base de données d’échantillon et son contenu soit dans l’interface Web, soit en utilisant SQL :

Snowsight

Sélectionnez Data » Databases » SNOWFLAKE_SAMPLE_DATA.

Classic Console

Cliquez sur Databases Databases tab » SNOWFLAKE_SAMPLE_DATA :

  • Cliquez sur un onglet d’objet pour voir des informations sommaires sur les objets de la base de données.

  • Cliquez sur le nom d’un objet pour voir les détails concernant l’objet.

SQL

Exécutez une commande SHOW DATABASES.

Vous pouvez également utiliser les commandes SHOW <objets> correspondantes pour voir les objets de la base de données d’échantillon.

Par exemple, dans SQL :

show databases like '%sample%';

+-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------+
| created_on                    | name                  | is_default | is_current | origin                  | owner        | comment | options | retention_time |
|-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------|
| 2016-07-14 14:30:21.711 -0700 | SNOWFLAKE_SAMPLE_DATA | N          | N          | SFC_SAMPLES.SAMPLE_DATA | ACCOUNTADMIN |         |         | 1              |
+-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------+
Copy

Notez que cet exemple illustre la base de données d’échantillon, SNOWFLAKE_SAMPLE_DATA a été partagé avec votre compte par Snowflake.

La colonne origin de la sortie SHOW DATABASES (ou la colonne Origin de la page Databases Databases tab dans l’interface) affiche le nom complet de la base de données partagée, SFC_SAMPLES.SAMPLE_DATA, indiquant qu’elle provient du compte SFC_SAMPLES (utilisé par Snowflake pour partager les données d’échantillon).

Requêtes des tables et des vues dans la base de données exemple

Pour utiliser une table ou une vue dans la base de données exemple, vous pouvez soit :

  • Référencer le nom complet de la table dans votre requête (sous la forme snowflake_sample_data.schema_name.object_name).

    OR

  • Spécifier la base de données exemple (et le schéma) pour votre session en utilisant les commandes USE DATABASE et/ou USE SCHEMA.

Les deux exemples suivants illustrent l’utilisation des deux approches servent à interroger la table lineitem dans le schéma tpch_sf1 :

select count(*) from snowflake_sample_data.tpch_sf1.lineitem;

+----------+
| COUNT(*) |
|----------|
|  6001215 |
+----------+

use schema snowflake_sample_data.tpch_sf1;

select count(*) from lineitem;

+----------+
| COUNT(*) |
|----------|
|  6001215 |
+----------+
Copy

Note

Vous devez disposer d’un entrepôt en cours d’exécution dans votre session pour effectuer des requêtes. Vous définissez l’entrepôt actuel de la session à l’aide de la commande USE WAREHOUSE (ou dans la feuille de calcul de l’interface Web).

Utilisation des scripts des tutoriels SQL

Snowflake fournit un ensemble de tutoriels, qui sont des instructions SQL annotées qui interrogent les échantillons de données pour répondre à un ensemble de questions pratiques.

Pour accéder aux tutoriels :

  1. Dans la page Worksheets Worksheet tab, cliquez sur la flèche vers le bas à côté des onglets de la feuille de travail, et sélectionnez Open Tutorials

    ../_images/ui-sql-worksheet-ws-menu.png
  2. La boîte de dialogue Open Worksheet affiche la liste des tutoriels disponibles. Dans la boîte de dialogue, sélectionnez un tutoriel et cliquez sur le bouton Open :

    ../_images/ui-sql-worksheet-ws-dialog.png
  3. Une nouvelle feuille de travail contenant le contenu du tutoriel se crée :

    ../_images/ui-sql-worksheet-ws-tutorial.png

Vous pouvez ensuite exécuter les requêtes dans le tutoriel comme vous le feriez dans n’importe quelle feuille de calcul. Vous pouvez également modifier le tutoriel dans la feuille de calcul et l’enregistrer en tant que feuille de calcul personnalisée.