Snowsightでのワークシートの管理および使用¶
ワークシートは、SQL クエリまたはPythonコードを実行したり、他のSnowflakeデータの読み込み、定義、操作タスクを実行したりするための強力で多彩な方法を提供します。
Snowsight でワークシートを開いた後、次のいずれかを実行できます。
さらに、 SQL ステートメントを記述 し、 結果を視覚化 できます。 Pythonコードを記述する こともできます。
ワークシートから他のワークシートを参照する¶
ワークシートを開くと、 Worksheets エクスプローラーで他のワークシートを表示できます。他のワークシートを検索し、 Worksheets エクスプローラーからワークシートを管理できます。
ワークシートコンテンツのプレビュー¶
ワークシートの内容をプレビューするには、 Worksheets エクスプローラーでワークシートの名前にカーソルを合わせます。プレビューには、ワークシートの実行に使用されたロールも表示されます。
プレビューから、ワークシートのコンテンツをコピーすることもできます。ワークシートコンテンツのプレビューにカーソルを合わせ、表示される Copy ボタンを選択します。
キーボードショートカットでワークシートを更新する¶
Snowsight には、ワークシート内のクエリをすばやくナビゲートおよび編集するのに役立つキーボードショートカットが用意されています。たとえば、ホットキーを使用して、ワークシート内でカーソルを移動したり、検索と置換を実行したり、行をコピーしたり、クエリをフォーマットしたりできます。
使用可能なすべてのキーボードショートカットを表示するには、ワークシートを開いて、Macキーボードでは [CMD]+[SHIFT]+[?] キーを、Windowsキーボードでは [CTRL]+[SHIFT]+[?] キーを押します。
ワークシートのタブにカーソルを合わせて を選択し、次に Show Shortcuts を選択してショートカットを表示することもできます。
ワークシートのセッションコンテキストを変更する¶
ワークシートのセッションコンテキストを設定して、ワークシートのコンテンツを実行するために使用するロールとウェアハウスを定義します。ワークシートのコンテキストは、今後のセッションのために保持されます。
注釈
複数のロールは選択できません。コンテキストセレクターは、セカンダリロールをサポートしていません。SQL ワークシートで二次的なロールを有効にするには、 USE SECONDARY ROLES を実行します。
ワークシートのロールコンテキストは、そのロールに付与されているアクセス制御権限に基づいて、Snowflakeオブジェクトで実行できる操作を決定します。
ワークシートのセッションコンテキストを設定するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
ワークシートを開きます。
コンテキストセレクターを開きます。
ワークシートを実行するロールを選択します。
そのロールが使用する権限を持つウェアハウスを選択します。
ドロップダウン以外の場所を選択して、コンテキストセレクターを閉じます。
注釈
各ワークシートは一意のセッションであり、 user menu で選択したロール(アクティブなロール)とは異なるロールを使用できます。アクティブなロールを変更しても、 context selector でワークシートに割り当てられたロールは変更されません。
ウェアハウスの再開とサイズ変更¶
ワークシートを実行する前後に、ウェアハウスの再開またはサイズ変更が必要になる場合があります。
ウェアハウスの詳細を変更するには、ウェアハウスに対する MODIFY または OWNERSHIP 権限が必要です。
コンテキストセレクターを使用してウェアハウスの詳細を表示および調整するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
ワークシートを開きます。
コンテキストセレクターを開きます。
Show warehouse details アイコンを選択します。
Status オプションでは、ステータスを選択し、ウェアハウスが中断されている場合は Resume を選択します。
Size オプションでは、サイズを選択し、別のサイズを選択します。
ドロップダウン以外の場所を選択して、コンテキストセレクターを閉じます。
開いているワークシートの管理¶
ワークシートを開いた後、ワークシートのタブにカーソルを合わせると表示される を選択すると、開いているワークシートを次の方法で管理できます。
ワークシートの名前を変更します。
ワークシートを複製します。
ワークシートを削除します。
ワークシートを開いた状態で、 Worksheets エクスプローラーで他のワークシートを表示および管理することもできます。
他のワークシートを検索します。
ワークシートの名前の上にカーソルを合わせると表示される
を使用して、ワークシートの名前変更、複製、削除、または移動を実行します。
ワークシートアイコンを使用して、タブで開いているワークシートを特定します。塗りつぶされたアイコンは、ワークシートがタブで開かれていることを示します。
ワークシートのフォルダーへの整理¶
Snowsight を使用して、フォルダーにワークシートを整理および管理できます。
ワークシートとフォルダーの共有¶
ワークシートやワークシートのフォルダーは、アカウント内の他のSnowflakeユーザーと共有することができます。ワークシートを直接共有できるのは、 Snowsight にサインインしているユーザーのみです。まだ Snowsight にサインインしたことのない人と共有する場合は、代わりにリンクを共有します。
ワークシートまたはワークシートフォルダーを共有すると、そのワークシートで同僚と共同作業したり、共有ワークシートの受信者がワークシートの内容を編集または表示したり、結果を表示したり、ワークシートを実行したり、共有ワークシートを複製したりできます。 共有ワークシートの権限 をご参照ください。
アカウント間でのワークシートの共有¶
ワークシートはSnowflakeオブジェクトではないため、アカウント間で複製または共有することはできません。ワークシートのコンテンツを他のSnowflakeアカウントのユーザーと共有する場合は、コンテンツをコピーして、Snowflake外のアカウントのユーザーと共有します。
ワークシートの履歴およびバージョンの管理¶
変更を加えて SQL クエリまたはワークシートでコードを実行すると、ワークシートの新しいバージョンが保存されます。
ワークシートに変更を加えたり、ワークシートのバージョンを管理したりする場合は、以下を考慮してください。
ワークシートを他のユーザーと共有すると、編集権限を持つユーザーはワークシートの過去のバージョンを表示できます。ワークシートの表示および実行権限を持つユーザーは、ワークシートの最新バージョンの結果も表示できます。
権限を持つ誰かがワークシートを実行するたびに、ワークシートの新しいバージョンが保存されます。
ワークシートに変更を加えても消えてしまう場合は、バージョン履歴を使用して、変更が加えられた保存済みのドラフトを開きます。
ワークシートの最も最近実行されたバージョンが、共同作業者に表示されるバージョンです。
ワークシートを共有したユーザーに表示されるようにワークシートに変更を加えるには、ワークシートを実行する必要があります。
複数のユーザーが共有ワークシートを同時に編集および実行すると、ワークシートを実行するたびに新しいバージョンが作成されます。ワークシートを開いたりリフレッシュしたときに表示されるのは、最近実行されたバージョンのワークシートです。
ワークシートのバージョンの切り替え¶
過去のバージョンのワークシートとその結果を表示するには、次を実行します。
Snowsight にサインインします。
Worksheets を選択して、ワークシートのリストを開きます。
ワークシートを開きます。
ワークシートの Latest Code Version を選択します。
ワークシートバージョンのドロップダウンリストから、開くバージョンのタイムスタンプを選択します。
過去のワークシートバージョンの格納済み結果¶
ワークシートで実行されたクエリの結果は、最大90日間、または25個のワークシートバージョンのいずれか大きい方の期間キャッシュされます。このキャッシュは、アカウントのデータストレージ使用量に含まれています。
ワークシートの内部Snowflakeオブジェクト¶
Snowflakeは、 Snowsight のワークシートの使用をサポートするために次の内部オブジェクトを作成します。
オブジェクト型 |
名前 |
---|---|
セキュリティ統合 |
WORKSHEETS |
BLOB |
WORKSHEETS_APP |
データベース |
WORKSHEETS_APP |
ユーザー |
WORKSHEETS_APP_USER |
ロール |
APPADMIN, WORKSHEETS_APP_RL |
これらの内部オブジェクトは、アカウントの内部ステージでクエリ結果をキャッシュするために使用されます。このキャッシュされたデータは暗号化され、アカウントのキー階層によって保護されます。
内部ロールに付与された制限付き権限は、 Snowsight が内部ステージにアクセスしてそれらの結果を格納することのみを許可します。ロールは、アカウント内のオブジェクトを一覧表示したり、テーブル内のデータにアクセスしたりすることは できません。
SNOWFLAKE 共有データベースの ACCOUNT_USAGE スキーマで、それぞれ USERS ビューと ROLES ビューをクエリすると、 Snowsight のユーザーとロールが返されます。 SHOW <オブジェクト> ステートメントはこれらの内部オブジェクトを返しません。