前提条件¶
このチュートリアルでは、次を前提としています。
Amazon Web Services(AWS)を使用するように構成されたSnowflakeアカウントと、データベース、テーブル、および仮想ウェアハウスオブジェクトを作成するために必要な権限を付与するロールを持つユーザーがある。
SnowSQL がインストールされている。
これらの要件を満たす手順については、 Snowflakeを20分で紹介 をご参照ください。
Snowflakeは、このチュートリアルで使用するパブリックAmazon S3バケットにサンプルデータファイルを提供します。ただし、開始する前に、このチュートリアル用のデータベース、テーブル、および仮想ウェアハウスを作成する必要があります。これらは、Snowflakeのほとんどのアクティビティに必要となる基本的なSnowflakeオブジェクトです。
サンプルデータファイルについて¶
Snowflakeは、パブリックS3バケットにステージングされたサンプルデータファイルを提供します。
注釈
通常の使用では、 AWS 管理コンソール、 AWS コマンドラインインターフェイス、または同等のクライアントアプリケーションを使用して、独自のデータファイルをステージングします。 Amazon Web Services の手順のドキュメントをご参照ください。
サンプルデータファイルには、サンプルの連絡先情報が次の形式で含まれています。
CSV ヘッダー行と5つの記録を含むファイル。フィールド区切り文字はパイプ(
|
)文字です。次の例は、ヘッダー行と1つの記録を示しています。ID|lastname|firstname|company|email|workphone|cellphone|streetaddress|city|postalcode 6|Reed|Moses|Neque Corporation|eget.lacus@facilisis.com|1-449-871-0780|1-454-964-5318|Ap #225-4351 Dolor Ave|Titagarh|62631
1つの配列と3つのオブジェクトを含む JSON 形式の1つファイル。オブジェクトの1つを含む配列の例を次に示します。
[ { "customer": { "address": "509 Kings Hwy, Comptche, Missouri, 4848", "phone": "+1 (999) 407-2274", "email": "blankenship.patrick@orbin.ca", "company": "ORBIN", "name": { "last": "Patrick", "first": "Blankenship" }, "_id": "5730864df388f1d653e37e6f" } }, ]
データベース、テーブル、ウェアハウスの作成¶
次のステートメントを実行して、データベース、2つのテーブル(csvおよびJSONデータ用)、およびこのチュートリアルに必要な仮想ウェアハウスを作成します。チュートリアルの完了後に、これらのオブジェクトをドロップできます。
CREATE OR REPLACE DATABASE mydatabase;
CREATE OR REPLACE TEMPORARY TABLE mycsvtable (
id INTEGER,
last_name STRING,
first_name STRING,
company STRING,
email STRING,
workphone STRING,
cellphone STRING,
streetaddress STRING,
city STRING,
postalcode STRING);
CREATE OR REPLACE TEMPORARY TABLE myjsontable (
json_data VARIANT);
CREATE OR REPLACE WAREHOUSE mywarehouse WITH
WAREHOUSE_SIZE='X-SMALL'
AUTO_SUSPEND = 120
AUTO_RESUME = TRUE
INITIALLY_SUSPENDED=TRUE;
次に注意してください。
CREATE DATABASE
ステートメントはデータベースを作成します。データベースには、「public」という名前のスキーマが自動的に含まれます。CREATE TABLE
ステートメントは、 CSV および JSON データのターゲットテーブルを作成します。テーブルは仮のものです。つまり、テーブルはユーザー セッションの間だけ保持され、他のユーザーには表示されません。CREATE WAREHOUSE
ステートメントは、中断された初期状態のウェアハウスを作成します。このステートメントはAUTO_RESUME = true
も設定します。これにより、コンピューティングリソースを必要とする SQL ステートメントを実行すると、ウェアハウスが自動的に開始されます。