ワークシートをはじめるにあたり

Snowsight でワークシートを表示、管理、共有します。ワークシートを作成し、 Classic Console から既存のワークシートをインポートできます。

SQL ワークシートを使用すると、SQL ステートメントを記述して実行し、クエリ結果を調べてフィルター処理し、結果を視覚化できます。 ワークシートを使用したデータのクエリワークシートデータの視覚化 をご参照ください。ワークシートにSnowpark Pythonを記述することもできます。 PythonワークシートでSnowparkコードを記述する をご参照ください。

ワークシートのバージョン履歴を確認し、Snowflakeを使用している同僚とワークシートを共有できます。 Snowsightでのワークシートの使用 をご参照ください。

このトピックの内容:

Snowsight でのワークシートの表示

Snowsight にサインインすると、アカウントにワークシートが表示されます。ワークシートが表示されないときは、 Classic Console からワークシートをインポートすることが必要になる場合があります。 Classic Console からワークシートをインポートする をご参照ください。

オプションを使用して、自分が最近開いたワークシート、同僚が共有したワークシート、自分が作成して所有しているワークシート、自分が作成したか同僚が共有したフォルダーを表示できます。

任意のワークシートまたはワークシートフォルダーについて、タイトル、ワークシートまたはフォルダーが最後に表示または更新されたおおよその日時、およびワークシートまたはフォルダーに関連付けられたロールを確認できます。各行には、ワークシートまたはフォルダーを所有するユーザーのイニシャルが表示されます。テーブル内の任意の列で並べ替えることができます。

Search オプションを使用して、アクセスできるワークシートとダッシュボードのタイトルとコンテンツを検索します。

Classic Console からワークシートをインポートする

SQL ワークシートを Classic Console から Snowsight 内の Snowsight にインポートできます。

SQL ワークシートをインポートして、別のウェブインターフェイスやセッションに切り替えることなく、過去に作成したクエリや SQL ステートメントを簡単に参照できるようにします。

注釈

Classic Console にアクセスできなくなった場合でも、ワークシートを Snowsight にインポートできます。

SQL ワークシートを Snowsight にインポートするには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択します。

  3. ... その他のメニュー » Import Worksheets を選択します。

  4. 確認ダイアログで、 Import を選択します。

Snowflakeは Import YYYY-MM-DD という名前のフォルダーを作成し、 Classic Console のすべてのワークシートをそのフォルダーに配置します。

重要

Snowsight ワークシートの最大サイズは 1MB です。1MB より大きいワークシートはインポートできません。 Snowsight へのアップグレードに関する問題のトラブルシューティング をご参照ください。

ワークシートのインポート後

ワークシートは Snowsight と Classic Console の間では同期されません。 Snowsight で SQL ワークシートを更新しても、その変更は Classic Console に反映されず、その逆も同様です。

Snowsight でワークシートを作成する

Snowsight でワークシートを作成するには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択して、ワークシートのリストを開きます。

  3. + を選択し、 SQL Worksheet または Python Worksheet を選択してワークシートを作成します。

同じウィンドウにワークシートが開き、デフォルトのタイトルとして作成日時が表示されます。

その後、ワークシートでの記述を開始します。SQL ワークシートの場合、 クエリの作成を開始します。Pythonワークシートの場合は、 コードの記述を開始します

既存の SQL ファイルから SQL ワークシートを作成するには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択して、ワークシートのリストを開きます。

  3. ... その他のメニュー » Create Worksheet from SQL File を選択します。

  4. アップロードする SQL ファイルを参照します。

  5. ファイル名と一致するタイトルの新しいワークシートが開きます。

SQL ファイルを既存の SQL ワークシートに追加することもできます。 既存のワークシートに SQL スクリプトを追加する をご参照ください。

タブでのワークシートの展開

タブを使用すると、 Snowsight で SQL ステートメントまたはPythonコードを記述しながら、複数のアクティブなワークシートを参照し、Snowflakeのデータベースとスキーマを探索できます。スクロール位置が各タブに保持されるため、ワークシート間の比較が容易になります。ワークシートのタブはセッションをまたいで保持されるため、中断したところから作業を再開できます。

Snowsight ワークシートをタブで開くには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択します。

  3. 既存のワークシートを選択するか、 + Worksheet を選択して新しいワークシートを開きます。ワークシートがタブで開きます。

  4. ワークシートを実行するロールを選択し、クエリのコンピューティングリソースを割り当てるウェアハウスを選択します。

  5. Worksheets メニューで既存のワークシートを選択するか、 + を選択して新しいワークシートタブを開きます。デフォルトでは、新しいワークシートは既定のロールとウェアハウスを使用します。

  6. (オプション)新しいワークシートの実行に使用するロールまたはウェアハウスを変更します。

ワークシートを開いた後、 内容を更新しSQL ステートメントを実行し 、または Pythonコードを記述して、ワークシートを管理できます。

開いているワークシートの管理

ワークシートを開いた後、ワークシートのタブにカーソルを合わせると表示される more actions for worksheet を選択すると、開いているワークシートを次の方法で管理できます。

  • ワークシートの名前を変更します。

  • ワークシートをフォルダーまたはダッシュボードに移動します。

  • ワークシートを複製します。

  • ワークシートを削除します。

ワークシートを開いている間、 Worksheets エクスプローラーで他のワークシートを表示および管理することもできます。

  • 他のワークシートを検索します。

  • ワークシートの名前変更、複製、削除、または移動には、ワークシートの名前の上にマウスを置くと表示される More options を選択します。

  • ワークシートアイコンを使用して、タブで開いているワークシートを特定します。塗りつぶされたアイコンは、ワークシートがタブで開かれていることを示します。

ワークシートのフォルダーへの整理

Snowsight を使用して、フォルダーにワークシートを整理および管理できます。

  1. Snowsight にサインインします。

  2. Worksheets を選択します。

  3. ワークシートを選択して開きます。

  4. ワークシートのタブにカーソルを合わせて、 more actions for worksheet を選択します。

  5. ドロップダウンリストで Move を選択し、ワークシートの移動先のフォルダーまたはダッシュボードを選択するか、作成します。

ワークシートとフォルダーの共有

Snowsight で、ワークシートとフォルダーをアカウント内の他のSnowflakeユーザーと共有して、所有するワークシートとフォルダーを表示または実行できます。以前に Snowsight にサインインしたことがあるユーザーとのみ直接共有できます。

注釈

Snowsight のワークシートは、ワークシートのコンテキストで割り当てられた特定のロールとウェアハウスを持つ、一意のセッションを使用します。ワークシートの実行に使用したのと同じロールを持っていないユーザーとワークシートを共有すると、そのユーザーはワークシートを複製して、自分のロールのいずれかで実行できます。

ワークシートを共有するには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択して、ワークシートのリストを開きます。

  3. ワークシートを開きます。

  4. ワークシートの右上隅で、 Share を選択します。

  5. ワークシートを使用するために招待する、Snowflakeユーザーの名前またはユーザー名を入力します。リストには、以前に Snowsight にサインインしたことがあるユーザーのみが表示されます。まだ Snowsight にログインしたことのない人と共有する場合は、代わりにリンクを共有します。

  6. 必要に応じて、リンクのあるユーザーによるワークシートの操作方法を設定します。デフォルトでは、リンクのある人はワークシートを表示できません。たとえば、ワークシートの結果を表示することは許可しても、ワークシートでクエリを実行することは許可しないように選択できます。

  7. 必要に応じて、 Get Link を選択して、他のユーザーと共有できるワークシートへのリンクを取得します。

  8. Done を選択します。

注釈

ドラフトワークシート、またはまだ実行していない変更を含むワークシートを共有する場合、共有ワークシートのバージョンは最後に実行されたバージョンです。

フォルダー内のすべてのワークシートを含むフォルダーを共有するには、次を実行します。

  1. Snowsight にサインインします。

  2. Worksheets を選択して、ワークシートのリストを開きます。

  3. フォルダーを開きます。

  4. Worksheets page の右上隅で、 Share を選択します。

  5. フォルダーに招待する、Snowflakeユーザーの名前またはユーザー名を入力します。リストには、以前に Snowsight にサインインしたことがあるユーザーのみが表示されます。まだ Snowsight にログインしたことのない人と共有する場合は、代わりにリンクを共有します。

  6. 必要に応じて、リンクのあるユーザーによるフォルダーとフォルダー内のワークシートの操作方法を設定します。デフォルトでは、リンクのある人はフォルダーまたはその内容を表示できません。たとえば、ワークシートの結果を表示することは許可しても、ワークシートを実行することは許可しないように選択できます。

  7. 必要に応じて、 Get Link を選択して、他のユーザーと共有できるフォルダーへのリンクを取得します。

  8. Done を選択します。

ワークシートの内部Snowflakeオブジェクト

Snowflakeは、 Snowsight のワークシートの使用をサポートするために次の内部オブジェクトを作成します。

オブジェクト型

名前

セキュリティ統合

WORKSHEETS

BLOB

WORKSHEETS_APP

データベース

WORKSHEETS_APP

ユーザー

WORKSHEETS_APP_USER

ロール

APPADMIN, WORKSHEETS_APP_RL

これらの内部オブジェクトは、アカウントの内部ステージでクエリ結果をキャッシュするために使用されます。このキャッシュされたデータは暗号化され、アカウントのキー階層によって保護されます。

内部ロールに付与された制限付き権限は、Snowsightが内部ステージにアクセスしてそれらの結果を保存することのみを許可します。ロールは、アカウント内のオブジェクトを一覧表示したり、テーブル内のデータにアクセスしたりすることは できません

SNOWFLAKE 共有データベースの ACCOUNT_USAGE スキーマで、それぞれ USERS ビューと ROLES ビューをクエリすると、Snowsightのユーザーとロールが返されます。 SHOW <オブジェクト> ステートメントはこれらの内部オブジェクトを返しません。