ワークシートをはじめるにあたり¶
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 にインポートするには、次を実行します。
Snowsight にサインインします。
Worksheets を選択します。
... その他のメニュー » Import Worksheets を選択します。
確認ダイアログで、 Import を選択します。
Snowflakeは Import YYYY-MM-DD という名前のフォルダーを作成し、 Classic Console のすべてのワークシートをそのフォルダーに配置します。
重要
Snowsight ワークシートの最大サイズは 1MB です。1MB より大きいワークシートはインポートできません。 Snowsight へのアップグレードに関する問題のトラブルシューティング をご参照ください。
ワークシートのインポート後¶
ワークシートは Snowsight と Classic Console の間では同期されません。 Snowsight で SQL ワークシートを更新しても、その変更は Classic Console に反映されず、その逆も同様です。
Snowsight でワークシートを作成する¶
Snowsight でワークシートを作成するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
+ を選択し、 SQL Worksheet または Python Worksheet を選択してワークシートを作成します。
同じウィンドウにワークシートが開き、デフォルトのタイトルとして作成日時が表示されます。
その後、ワークシートでの記述を開始します。SQL ワークシートの場合、 クエリの作成を開始します。Pythonワークシートの場合は、 コードの記述を開始します。
既存の SQL ファイルから SQL ワークシートを作成するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
... その他のメニュー » Create Worksheet from SQL File を選択します。
アップロードする SQL ファイルを参照します。
ファイル名と一致するタイトルの新しいワークシートが開きます。
SQL ファイルを既存の SQL ワークシートに追加することもできます。 既存のワークシートに SQL スクリプトを追加する をご参照ください。
タブでのワークシートの展開¶
タブを使用すると、 Snowsight で SQL ステートメントまたはPythonコードを記述しながら、複数のアクティブなワークシートを参照し、Snowflakeのデータベースとスキーマを探索できます。スクロール位置が各タブに保持されるため、ワークシート間の比較が容易になります。ワークシートのタブはセッションをまたいで保持されるため、中断したところから作業を再開できます。
Snowsight ワークシートをタブで開くには、次を実行します。
Snowsight にサインインします。
Worksheets を選択します。
既存のワークシートを選択するか、 + Worksheet を選択して新しいワークシートを開きます。ワークシートがタブで開きます。
ワークシートを実行するロールを選択し、クエリのコンピューティングリソースを割り当てるウェアハウスを選択します。
Worksheets メニューで既存のワークシートを選択するか、 + を選択して新しいワークシートタブを開きます。デフォルトでは、新しいワークシートは既定のロールとウェアハウスを使用します。
(オプション)新しいワークシートの実行に使用するロールまたはウェアハウスを変更します。
ワークシートを開いた後、 内容を更新し、 SQL ステートメントを実行し 、または Pythonコードを記述して、ワークシートを管理できます。
開いているワークシートの管理¶
ワークシートを開いた後、ワークシートのタブにカーソルを合わせると表示される を選択すると、開いているワークシートを次の方法で管理できます。
ワークシートの名前を変更します。
ワークシートをフォルダーまたはダッシュボードに移動します。
ワークシートを複製します。
ワークシートを削除します。
ワークシートを開いている間、 Worksheets エクスプローラーで他のワークシートを表示および管理することもできます。
ワークシートのフォルダーへの整理¶
Snowsight を使用して、フォルダーにワークシートを整理および管理できます。
ワークシートとフォルダーの共有¶
Snowsight で、ワークシートとフォルダーをアカウント内の他のSnowflakeユーザーと共有して、所有するワークシートとフォルダーを表示または実行できます。以前に Snowsight にサインインしたことがあるユーザーとのみ直接共有できます。
注釈
Snowsight のワークシートは、ワークシートのコンテキストで割り当てられた特定のロールとウェアハウスを持つ、一意のセッションを使用します。ワークシートの実行に使用したのと同じロールを持っていないユーザーとワークシートを共有すると、そのユーザーはワークシートを複製して、自分のロールのいずれかで実行できます。
ワークシートを共有するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
ワークシートを開きます。
ワークシートの右上隅で、 Share を選択します。
ワークシートを使用するために招待する、Snowflakeユーザーの名前またはユーザー名を入力します。リストには、以前に Snowsight にサインインしたことがあるユーザーのみが表示されます。まだ Snowsight にログインしたことのない人と共有する場合は、代わりにリンクを共有します。
必要に応じて、リンクのあるユーザーによるワークシートの操作方法を設定します。デフォルトでは、リンクのある人はワークシートを表示できません。たとえば、ワークシートの結果を表示することは許可しても、ワークシートでクエリを実行することは許可しないように選択できます。
必要に応じて、 Get Link を選択して、他のユーザーと共有できるワークシートへのリンクを取得します。
Done を選択します。
注釈
ドラフトワークシート、またはまだ実行していない変更を含むワークシートを共有する場合、共有ワークシートのバージョンは最後に実行されたバージョンです。
フォルダー内のすべてのワークシートを含むフォルダーを共有するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
フォルダーを開きます。
Worksheets page の右上隅で、 Share を選択します。
フォルダーに招待する、Snowflakeユーザーの名前またはユーザー名を入力します。リストには、以前に Snowsight にサインインしたことがあるユーザーのみが表示されます。まだ Snowsight にログインしたことのない人と共有する場合は、代わりにリンクを共有します。
必要に応じて、リンクのあるユーザーによるフォルダーとフォルダー内のワークシートの操作方法を設定します。デフォルトでは、リンクのある人はフォルダーまたはその内容を表示できません。たとえば、ワークシートの結果を表示することは許可しても、ワークシートを実行することは許可しないように選択できます。
必要に応じて、 Get Link を選択して、他のユーザーと共有できるフォルダーへのリンクを取得します。
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 <オブジェクト> ステートメントはこれらの内部オブジェクトを返しません。