ワークシートを使用したデータのクエリ

このトピックでは、 Snowsight, the Snowflake web interface でワークシートを使用して、クエリを記述および実行する方法について説明します。

このトピックの内容:

ワークシートの使用

Snowflakeは、ワークシートに移動して操作するためのいくつかのメソッドを Snowsight で提供します。

このセクションでは、ワークシートのナビゲーションと使用方法の概要を提供します。このセクションには、次のインターフェイス要素の例と説明が含まれています。

インターフェイス

説明

The text area for editing queries.

クエリエディター

ワークシートの中央にある クエリエディター は、 SQL クエリを作成および変更する場所です。

詳細については、 クエリの作成と実行 をご参照ください。

For assistive technology, the database selector is a button labeled with the currently-selected database and schema. The label changes based on the selected database and schema.

データベースセレクター

クエリエディターの最上部にある データベースセレクター を使用すると、クエリのデータベースとスキーマを検索して選択できます。データベースとスキーマを選択すると、クエリ内のオブジェクト名を完全に修飾しなくても、スキーマ内のオブジェクトを参照できます。

For assistive technology, the worksheet menu is a button labeled with the name of the currently-selected worksheet. By default, the name of the worksheet is the date and time when the worksheet was created.

ワークシートメニュー

ワークシートの左上隅にある ワークシートメニュー では、次を実行できます。

  • ワークシート名

    ワークシートの名前を変更する。

  • Import SQL from File

    デバイス上のファイルから SQL をインポートする。

  • Move to

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

  • Duplicate

    ワークシートを複製する。

  • Format query

    読みやすいようにクエリテキストをフォーマットする。

  • Delete worksheet

    ワークシートを削除する。

  • Show shortcuts

    ワークシートのキーボードショートカットを表示する。

For assistive technology, the worksheet and database explorer contains the worksheet and database tabs.

ワークシートとデータベースエクスプローラー

ワークシートの左側にある ワークシートとデータベースエクスプローラー を使用すると、次を実行できます。

  • フォルダーを探索してワークシートを開く。

  • データベースを探索し、オブジェクト名と列を SQL クエリに直接追加する。

For assistive technology, text inputs for search are included on both tabs. On the databases tab, the search input has the button role.

ワークシートとデータベースを検索する

ワークシートとデータベースエクスプローラーには、次を実行できる検索ボックスが含まれています。

  • ワークシートの名前と内容を検索する。

  • データベースとオブジェクトの名前を検索する。

詳細については、 ワークシートとデータベースの検索 をご参照ください。

Because the sql preview feature requires you to hover over other worksheets in the explorer, the feature might not be usable by some assistive technology.

ワークシート SQL をプレビューする

ワークシートが開いているときに、エクスプローラーで他のワークシートにカーソルを合わせると、開いているワークシートを離れることなく、他のワークシートから SQL をプレビューしてコピーできます。

詳細については、 ワークシートのプレビュー をご参照ください。

For assistive technology, the history button is usually labeled with a date range description, such as updated 3 days ago.

バージョン履歴

ワークシートに変更を加えてクエリを実行すると、 Snowsight は以前のバージョンのワークシートを保持します。チェックポイントを表示および変更するために、ワークシートの履歴バージョンに切り替えることができます。

詳細については、 ワークシートバージョンの切り替え をご参照ください。

For assistive technology, the filter button is labeled show and hide filters.

フィルターを表示するまたは非表示にする

ページの左上隅にある フィルターボタン を使用すると、カスタムフィルターを表示したり、非表示にしたり、管理したりできます。

詳細については、 カスタムフィルター をご参照ください。

For assistive technology, the context selector button is usually labeled with the currently-selected role and warehouse.

コンテキストセレクター

ページの右上隅にある コンテキストセレクター を使用すると、ワークシートセッションのロールとウェアハウスを設定できます。ワークシートは、将来のセッションのために選択したコンテキストを保持します。

詳細については、 セッションコンテキストの変更 をご参照ください。

Use the share button to share worksheets with other users.

ワークシートを共有する

ページの右上隅にある Share を使用して、クエリ結果を他のSnowflakeユーザーと共有します。共有ワークシートを実行するには、ワークシートセッションコンテキストで使用されるロールをユーザーに付与する必要があります。

For assistive technology, use the button labeled run-button to run your query.

クエリを実行する

ページの右上隅にある 実行 ボタンを使用すると、クエリを実行できます。スクリプトが変更された場合は、チェックポイントがワークシートのバージョン履歴に保存されます。

詳細については、 クエリの実行 をご参照ください。

Due to way the results table is rendered, the feature might not be usable by some assistive technology. To explore the results locally, download the results as a .csv file.

結果テーブル

ワークシートの最下部にある 結果テーブル は、クエリを実行した後に表示されます。

詳細については、 結果テーブルの探索 をご参照ください。

The query details contain various metrics.

クエリの詳細

結果テーブルの右側にある Query Details では、クエリの実行に関する統計が提供されます。

詳細については、 クエリの詳細の表示 をご参照ください。

Use the buttons labeled objects, query, results, and chart to show and hide worksheet sections.

セクションを表示するまたは非表示にする

ワークシートの対応するセクションを表示するまたは非表示にするには、クエリエディターの最下部にある ObjectsQueryResults、および Chart を使用します。

チャートの詳細については、 ワークシートデータの視覚化 をご参照ください。

Use the search input to explore results. Use the download as csv button to download the results as a .csv file. Use the toggle query statistics button to hide or show query details.

結果を検索してダウンロードする

ワークシートの右側で、検索して結果をダウンロードし、 Query Details を非表示にするまたは表示します。

キーボードのショートカット

Snowsight では、ワークシートのナビゲーションと編集を高速化するためのキーボードショートカットも提供されます。サポートされているキーボードショートカットのリストを表示するには、 [CMD]+[SHIFT]+[?] (Mac)または [CTRL]+[SHIFT]+[?] (Windows)を押します。

ワークシートとデータベースオブジェクトの探索

このセクションでは、 worksheet and database explorer を使用して、ワークシートとデータベースを操作する方法について説明します。

ワークシートの探索

ワークシートを開くには、 worksheet and database explorer で開くワークシートを選択します。

worksheet and database explorer の各ワークシートには、対応する options menu (For assistive technology, the options button.)があります。オプションメニューでは、次を実行できます。

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

  • ワークシートを複製する。

  • ワークシートを削除する。

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

データベースオブジェクトの探索

データベースオブジェクトを表示するには、 worksheet and database explorer でデータベースを選択します。

できること:

  • データベースをドリルダウンして、データベースオブジェクトを検索する。

  • テーブルとビューにカーソルを合わせ、プレビューしてピン留め(For assistive technology, the pin button.)する。

worksheet and database explorer の各オブジェクトには、対応する options menu (For assistive technology, the options button.)があります。オプションメニューでは、次を実行できます。

  • ワークシートのコンテキストを設定する(データベースとスキーマのみ)。

  • オブジェクトの名前を SQL に配置する。

  • オブジェクトから SQL に列を追加する(テーブルとビューのみ)。

  • オブジェクト定義を表示する(テーブルとビューのみ)。

ワークシートとダッシュボードの検索

ワークシートとデータベースを検索するには、 worksheet and database explorer で検索ボックスに用語を入力します。

ワークシートのプレビュー

ワークシートをプレビューするには、 worksheet and database explorer でワークシートにカーソルを合わせます。

ワークシート SQL をコピーするには、プレビューにカーソルを合わせて CopyFor assistive technology, the copy button.)を選択します。

ワークシートのバージョンの切り替え

ワークシートの別のバージョン に切り替えるには、ワークシートの最上部にあるタイムスタンプ、開くワークシートのバージョンの順に選択します。

クエリの作成と実行

Snowsight は、クエリの記述を可能な限りシンプルにし、必要なときに支援を提供しますが、通常は邪魔にならないようにします。

セッションコンテキストの変更

ワークシートセッションのロールとウェアハウスを選択または変更するには、 context selector を使用します。現在のロールは、そのロールに付与されているアクセス制御権限に基づいて、Snowflakeオブジェクトで実行できる操作を決定します。最初にロールを選択してから、そのロールが使用する権限を持つウェアハウスを選択します。

複数のロールは選択できないことに注意してください。つまり、コンテキストドロップダウンはセカンダリロールをサポートしていません。

ワークシートの現在のデータベースを選択(または変更)するには、クエリエディターの左上隅にあるデータベースのドロップダウンをクリックします。

注釈

各ワークシートは一意のセッションであり、 user menu で選択したロール(アクティブなロール)とは異なるロールを使用できます。アクティブなロールを変更しても、 context selector でワークシートに割り当てられたロールは変更されません。

クエリの記述

クエリエディターにスクリプトを入力すると、オートコンプリート機能が次を提案します。

  • SQL 関数やエイリアスなどの構文キーワードをクエリする。

  • スキーマ内のテーブル名または列名と一致する値。

関数を選択して、その構文と簡単な説明を表示します。

Snowflakeはテーブルエイリアスを追跡し、オートコンプリートオプションとして提案します。たとえば、 posts as p を使用するか、 posts p をエイリアスとして使用してクエリを実行する場合は、次回 p と入力すると、オートコンプリート機能によりエイリアスがオプションとして提案されます。

SQL スクリプトの既存ワークシートへの追加

既存ワークシートに SQL スクリプトを追加するには、 worksheet menuImport SQL from File を選択します。

ウェアハウスの再開とサイズ変更

ワークシートの右上隅で、 context selector を使用してウェアハウスを表示します。

アクティブなウェアハウスのサイズとステータスを変更するには、 context selector で Show Warehouse DetailsFor assistive technology, the show warehouse details button.)を選択します。

クエリの実行

同じワークシートで単一のクエリまたは複数のクエリを順番に実行できます。

単一のクエリを実行するには、 query editor でカーソルをクエリに置き、 run buttonFor assistive technology, use the button labeled run-button to run your query.)を選択します。

ワークシート全体を実行するには、 query editor 内のすべてのクエリを選択してから、 run button (For assistive technology, use the button labeled run-button to run your query.)を選択します。

結果テーブルの探索

結果テーブルは、任意の選択のコンテキスト情報を表示する、生成された統計を含むインタラクティブな機能をサポートします。

スプレッドシートの場合と同様に、キーボードの矢印キーを使用して、選択項目を移動します。

結果テーブルで列、セル、行、または範囲を選択します。すべての選択をコピーして貼り付けることができます。

結果には最大10,000行を表示できます。クエリが10,000行を超える場合でも、統計には結果セット全体が反映されます。

注釈

結果を.csvファイルとしてダウンロードすると、結果が10,000行を超えていても、完全な結果が含まれます。

自動コンテキスト統計

結果テーブルの列、セル、行、または範囲を選択して、選択したデータに関する関連情報をインスペクターペイン(結果テーブルの右側)に表示します。コンテキスト統計は、すべての列タイプに対して自動的に生成されます。統計は、データを一目で理解できるようにすることを目的としています。

列の概要には、各列の統計のプレビューが表示されます。詳細な列統計を表示するには、インスペクターまたは列ヘッダーから列を選択します。

統計ペインは、さまざまなタイプの列に対してさまざまなメトリックを生成します。統計ペインの項目を使用して、操作およびフィルターできます。

入力済み/空のメーター

すべての列では、何行が入力され空であるかを示します。電子メールや JSON などの一部のデータ型を表示する列でも、無効な行の数を示します。

ヒストグラム

すべての日付、時刻、および数値列について表示されます。

ヒストグラムは、特定の範囲に該当する行を示します。バーをクリックするか、ヒストグラムをドラッグして範囲を選択します。ヒストグラムの上にある値ラベルをクリックして特定の値を入力することにより、選択を微調整できます。

頻度分布

すべてのカテゴリ列に表示されます。カテゴリ列は、同じ値が複数回使用されるテキスト列です。

メールドメイン分布

メール列に表示されます。メールドメイン分布は、ドメイン名の出現頻度の分布を示します。

キー分布

JSON 列に表示されます。キー分布は、すべての行に JSON オブジェクトが含まれている場合、結果セットに存在する上位キーの頻度を示します。列に JSON 配列が含まれている場合、キー分布は列の JSON 値の相対的な型を示します。

クエリの詳細の表示

Query Details には、次のようなクエリの実行に関する情報が含まれます。

  • クエリ実行の期間。

  • 行の数。

  • 実行が完了した時。

  • クエリによってスキャンされたデータの量。

  • クエリの実行に使用されるロール。

  • クエリの実行に使用されるウェアハウス。

一部のクエリの詳細は、14日間のみ利用できます。

クエリプロファイルの表示

クエリの詳細なプロファイルにアクセスするには、 Query Details options menu (For assistive technology, the options button.)で View Query Profile を選択します。

結果のダウンロード

結果を.csvファイルとしてダウンロードするには、結果テーブルの右上隅にある Download as CSVFor assistive technology, the download as csv button.)を選択します。

Snowflakeは、結果に対して生成される CSV ファイルのサイズ制限を強制しません。CSV ファイルのサイズは、クエリによって返されるデータの量に基づいています。

以前のワークシートバージョンの格納された結果

ワークシートで実行されたクエリの結果は、最大1年間キャッシュされます。このキャッシュは、アカウントのデータストレージ使用量に含まれています。

フィルターの使用

次のシステムフィルターは、すべてのロールで使用できます。

  • :daterange

    列に日付範囲を適用できるようにします。

  • :datebucket

    集計データを時間の単位(たとえば、日ごと)でグループ化できます。

さらに、管理者はアカウントで使用するカスタムフィルターを作成できます。詳細については、 カスタムフィルター をご参照ください。

次の例を考えてみましょう:

SELECT
    COUNT(O_ORDERDATE) as orders, O_ORDERDATE as date
FROM
    SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
    O_ORDERDATE = :daterange
GROUP BY
    :datebucket(O_ORDERDATE), O_ORDERDATE
ORDER BY
    O_ORDERDATE

この例では、

  • WHERE 句に :daterange システムフィルターを含めます。

  • GROUP BY 句に :datebucket システムフィルターを含めます。

クエリにフィルターを含めると、対応するフィルターボタンがワークシートの最上部に表示されます。

For assistive technology, when the filter buttons appear, they follow the show and hide filters button in the tab order.

この例では、 Date bucket フィルターを day に設定し、 Date rangeAll time に設定するとします。

クエリを実行すると、結果は日ごとにグループ化されます。新しい日付範囲を選択して、結果をさらにフィルターできます。

The results table in this example includes two columns, orders and date. The orders column contains the aggregated number of orders on a given date.

カスタムフィルター

カスタムフィルターを使用すると、クエリを直接編集せずに、クエリまたは視覚化の結果を変更できます。フィルターは、クエリの実行で使用されるサブクエリまたは値のリストとして解決される、特別なキーワードとして実装されます。

カスタムフィルターを作成するための権限の付与

アカウント管理者(ACCOUNTADMIN のロールを持つユーザー)は、 ACCOUNTADMIN のロール自体を含む各ロールに、カスタムフィルターを作成する権限を付与する必要があります。

カスタムフィルターを作成する権限をロールに付与するには、

  1. filter buttonManage Filters の順に選択します。

    Filters ウィンドウが開きます。

  2. 右上隅の Edit Permission を選択します。

    Filter Permissions ウィンドウが開きます。

  3. フィルターを作成する権限を付与するロールを選択します。

  4. Save を選択します。

カスタムフィルターの作成

カスタムフィルターを作成するには、

  1. filter buttonManage Filters の順に選択します。

    Filters ウィンドウが開きます。

  2. 右上隅の Filter を選択します。

    Add Filter ウィンドウが開きます。

  3. 次を完了します。


    Display Name

    内部で他のユーザーに表示されるフィルターの名前。

    SQL Keyword

    クエリに挿入する一意のキーワード。スペースを入れずに、フォーマット :<文字列> を使用してください。例: :myfilter

    Description

    フィルターの説明。

    Role

    クエリから派生したフィルター値を更新するときに使用されるロール。

    Warehouse

    クエリから派生したフィルター値を更新するときに使用されるウェアハウス。

    Options via

    フィルター値がクエリまたは項目別リストから派生するかどうかを指定します。

  4. フィルターにオプションを追加します。

  5. Save を選択します。

最上部に戻る