ワークシートをはじめるにあたり¶
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 でワークシートを開く¶
ワークシートを開くには、 Recent などのワークシートのリストのいずれかから選択します。ワークシートを開いた後、 内容を更新し、 SQL ステートメントを実行し 、または Pythonコードを記述して、ワークシートを管理できます。
ワークシートの表示と管理¶
ワークシートを開くと、 Worksheets エクスプローラーで他のワークシートを表示できます。他のワークシートを検索し、 Worksheets エクスプローラーからワークシートを管理できます。
ワークシートの名前にカーソルを合わせると表示される ... 詳細メニューを使用し、次の方法でワークシートを管理します。
ワークシートの名前を変更します。
ワークシートをフォルダーまたはダッシュボードに移動します。
ワークシートを複製します。
ワークシートを削除します。
ワークシートが開いている場合は、ワークシートの名前を選択して、その特定のワークシートに対して同じアクションを実行できます。
ワークシートをフォルダーに整理する¶
Snowsight にサインインします。
Worksheets を選択します。
ワークシートを選択して開きます。
ワークシートの ... その他のメニューを選択します。
ドロップダウンリストで Move を選択し、ワークシートの移動先のフォルダーまたはダッシュボードを選択するか、作成します。
ワークシートとフォルダーの共有¶
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 <オブジェクト> ステートメントはこれらの内部オブジェクトを返しません。