Snowsightを使用したファイルのステージング¶
Snowsight を使用すると、 SQL を記述することなく名前付きステージを作成および管理できます。名前付き内部ステージにファイルをロードすると、ファイルを表示したり、Pythonワークシートでファイルを参照したり、 ファイルからテーブルにデータをロード したりできます。
Snowsight を使用して、ユーザーステージやテーブルステージにファイルをアップロードすることはできません。ステージの詳細については、 データのロードの概要 をご参照ください。
このトピックの内容:
ステージの作成¶
Snowsight を使用して、名前付きの内部または外部ステージを作成できます。
注釈
ステージを格納するデータベースおよびスキーマに対する USAGE 権限と、スキーマに対する CREATE STAGE 権限が付与または継承されたロールを使用する必要があります。
CREATE STAGE については、 アクセス制御の要件 をご参照ください。
名前付きの内部ステージを作成する¶
Snowsight を使用して名前付き内部ステージを作成するには、次を実行します。
Snowsight にサインインします。
Data » Databases を選択します。
ステージを作成するデータベースとスキーマを選択します。
Create » Stage » Snowflake Managed を選択します。
Stage Name を入力します。
オプションで、 Directory table の選択を解除します。ディレクトリテーブルを使用すると、ステージ上のファイルを確認できますが、ウェアハウスが必要になるためコストがかかります。現時点ではこのオプションの選択を解除し、後でディレクトリテーブルを有効にすることもできます。
ステージ上のすべてのファイルでサポートされている Encryption の種類を選択します。詳細については、 内部ステージの暗号化 をご参照ください。ステージを作成した後に暗号化タイプを変更することはできません。
注釈
データアクセスを有効にする場合は、サーバー側の暗号化を選択することをお勧めします。そうしないと、ステージングされたファイルはデフォルトによりクライアント側で暗号化され、ダウンロード時に読み取れません。詳細については、 非構造化データアクセスのサーバー側の暗号化 をご参照ください。
フィールドに入力してステージを説明します。詳細については、 CREATE STAGE をご参照ください。
Create を選択します。
名前付き外部ステージを作成する¶
Snowsight を使用して名前付き外部ステージを作成するには、次を実行します。
Snowsight にサインインします。
ナビゲーションメニューで Data » Databases を選択します。
ステージを作成するデータベースとスキーマを選択します。
Create » Stage を選択します。
使用するファイルのある、サポートされているクラウドストレージサービスを選択します。
Stage Name を入力します。
外部クラウドストレージの場所の URL を入力します。
外部ストレージが公開されていない場合は、 Authentication を有効にして詳細を入力します。詳細については、 CREATE STAGE をご参照ください。
オプションで、 Directory table の選択を解除します。ディレクトリテーブルを使用すると、ステージ上のファイルを確認できますが、ウェアハウスが必要になるためコストがかかります。現時点ではこのオプションの選択を解除し、後でディレクトリテーブルを有効にすることもできます。
Directory table を有効にすると、オプションで Enable auto-refresh を選択して、イベント通知または通知統合を選択し、ファイルが追加または削除されたときにディレクトリテーブルを自動的にリフレッシュします。詳細については、 ディレクトリテーブルのメタデータ自動更新 をご参照ください。
ファイルが暗号化されている場合は、 Encryption を有効にして詳細を入力します。
必要に応じて、 SQL Preview を展開し、生成された SQL ステートメントを表示します。AUTO_REFRESH などのステージの追加オプションを指定するには、ワークシートでこの SQL プレビューを開きます。
Create を選択します。
ステージへのファイルのアップロード¶
Snowsight を使用して、名前付き内部ステージにファイルをアップロードできます。
Amazon S3、Microsoft Azure、Google Cloud Storageなどのサービスの外部ステージにファイルをアップロードするには、これらのクラウドサービスのツールを使用します。
名前付き内部ステージにファイルをアップロードする¶
注釈
最大ファイルサイズは250 MB です。
これらのステップを実行するには、データベースとスキーマに対する USAGE 権限とステージに対する WRITE 権限が付与または継承されたロールを使用する必要があります。 ステージ権限 をご参照ください。
ファイルをステージにアップロードするには、次を実行します。
Snowsight にサインインします。
Data » Databases を選択します。
ステージを作成したデータベーススキーマを選択し、ステージを選択します。
ステージにファイルをアップロードするには、 + Files を選択します。
表示される Upload Your Files ダイアログで、アップロードするファイルを選択します。複数のファイルを一度にアップロードできます。
必要に応じて、ステージ内でファイルを保存するパスを選択または作成します。
Upload を選択します。
ファイルをステージにアップロードした後、ファイルに応じて次のアクションのいずれかを実行できます。
Pythonワークシート内のファイルを使用する。 ステージからワークシートにPythonファイルを追加する をご参照ください。
ステージングされたファイルからターゲットテーブルにデータをコピーする。 ステージから既存のテーブルにファイルをロードする または 内部ステージからのデータのコピー をご参照ください。
ステージのデータをクエリする。 ステージングされたファイルのデータのクエリ をご参照ください。
ステージングされたファイルの表示¶
Snowsight を使用して、ステージングされたファイルを表示できます。内部ステージと外部ステージの両方からファイルを表示できます。
注釈
これらのステップを実行するには、データベースとスキーマに対する USAGE 権限とステージに対する READ 権限が付与または継承されたロールを使用する必要があります。
Snowsight にサインインします。
Data » Databases を選択します。
ステージを含んでいるデータベースとスキーマを選択します。
Stages を選択し、ファイルを表示するステージを選択します。
プロンプトが表示されたら、 Enable Directory Table を選択してステージのディレクトリテーブルを有効にし、ファイルを表示できるようにします。
プロンプトが表示されたら、ウェアハウスを選択してディレクトリテーブルを更新します。
ステージ上のディレクトリテーブルを更新するには、更新アイコンを選択します。
ステージングされたファイルの管理¶
Snowsight を使用すると、ステージングされたファイルで次のアクションを実行できます。
» Load into table を選択して、 ステージからテーブルにファイルをロードします。- » Copy path を選択して、ワークシートなど、他の場所で使用するためにファイルへのパスをコピーします。
内部ステージ上のファイルについては、次のアクションも可能です。
- » Download を選択して、ステージからファイルをダウンロードします。
- » Remove を選択して、ステージからファイルを削除します。
注釈
外部ステージからファイルをダウンロードするには、 Snowsightでステージングされたファイルのダウンロード をご参照ください。
ステージの管理¶
Snowsight のステージを管理するには、次を実行します。
注釈
これらのステップを実行するには、データベースとスキーマに対する USAGE 権限とステージに対する OWNERSHIP 権限が付与または継承されたロールを使用する必要があります。
Snowsight にサインインします。
Data » Databases を選択します。
ステージを含んでいるデータベースとスキーマを選択します。
Stages を選択し、ステージを選択します。
Stage Details を選択します。
ステージは次の方法で管理できます。
- » Edit を選択して、ステージオブジェクトのプロパティを編集したり、ディレクトリテーブルを有効にしたりします。
- » Clone を選択して、ステージをクローンします。
ステージをドロップまたは削除するには、
» Drop を選択します。ステージの OWNERSHIP 権限を別のロールに譲渡するには、
» Transfer Ownership を選択します。
ステージの権限を管理する場合は、 Privileges セクションを使用して権限を表示、付与、取り消します。
トラブルシューティング¶
ファイルが外部ステージに表示されない¶
この問題は、外部ステージでディレクトリテーブルが有効になっていない場合や、外部ストレージの場所に関する情報が正しくない場合に発生する可能性があります。
この問題を解決するには、次を試してください。
ステージの所有者がステージ上で ディレクトリテーブル を有効にしていることを確認する。
ディレクトリテーブルが更新されていることを再確認する。ディレクトリテーブルを更新するには、 Snowsight でステージを選択し、更新アイコンを選択します。
クラウドプロバイダーの URL が正しいことを確認する。URL にサブパスが含まれている場合は、後続スラッシュがあることを確認します。