Use the sample database¶

サンプルデータベース SNOWFLAKE_SAMPLE_DATA は、アカウントで作成するデータベースと同じですが、読み取り専用である点が異なります。そのため、次の操作は許可されていません。

データセットスキーマでは DDL を実行できません（テーブルやその他のデータベースオブジェクトを追加、削除、または変更できません）。
スキーマ内のテーブルで DML を実行できません。
データベースまたはデータベース内のスキーマ/テーブルに対して、複製や Time Travelを実行することはできません。

ただし、同じコマンドと構文をすべて使用して、サンプルデータベース、スキーマ、およびテーブルを表示したり、テーブルに対してクエリを実行したりできます。

重要

サンプルデータベースは、新しいアカウントに対してデフォルトで作成されます。アカウント用にデータベースが作成されておらず、データベースにアクセスする場合は、 ACCOUNTADMIN ロールをアクティブにして次の SQL ステートメントを実行します。

-- 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;

View the sample database¶

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

Snowsight:

ナビゲーションメニューで Catalog » Database Explorer » SNOWFLAKE_SAMPLE_DATA を選択します。

SQL:

SHOW DATABASES コマンドを実行します。

関連する SHOW <オブジェクト> コマンドを使用して、サンプルデータベース内のオブジェクトを表示することもできます。

例えば、 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              |
+-------------------------------+-----------------------+------------+------------+-------------------------+--------------+---------+---------+----------------+

この例では、サンプルデータベース SNOWFLAKE_SAMPLE_DATA がSnowflakeによってアカウントと共有されていることを示しています。

SHOW DATABASES 出力の origin 列（またはインターフェイスの Databases ページの Origin 列）には、共有データベースの完全修飾名 SFC_SAMPLES が表示されます。SAMPLE_DATA は、SFC_SAMPLES アカウントから（サンプルデータを共有するためにSnowflakeが使用）に起因することを示しています。

Query tables and views in the sample database¶

サンプルデータベースでテーブルまたはビューを使用するには、次のいずれかを実行します。

クエリでテーブルの完全修飾名を参照します（snowflake_sample_data.schema_name.object_name の形式）。

OR
USE DATABASE または USE SCHEMA コマンドを使用して、セッションのサンプルデータベース（およびスキーマ）を指定します。

次の2つの例は、両方のアプローチを使用して tpch_sf1 スキーマの lineitem テーブルをクエリする方法を示しています。

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

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

use schema snowflake_sample_data.tpch_sf1;

select count(*) from lineitem;

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

注釈

クエリを実行するには、セッションで実行中の現在のウェアハウスが必要です。USE WAREHOUSE コマンドを使用して（またはウェブインターフェイスのワークシート内で）セッションで現在のウェアハウスを設定します。