Use the sample database

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

View the sample database

You can view the sample database and its contents either in Snowsight or using SQL:

Snowsight:

Dans le menu de navigation, sélectionnez Catalog » Database Explorer » SNOWFLAKE_SAMPLE_DATA.

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 Onglet Bases de données 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).

Query tables and views in the sample database

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