履歴ページを使用してクエリを監視¶
History ページでは、過去14日間に実行されたすべてのクエリの詳細を表示して詳細を確認できます。このページには、 SnowSQL または他の SQL クライアントから実行されたクエリを含む、クエリの履歴リストが表示されます。各クエリに対して表示されるデフォルト情報は次のとおりです:
クエリの現在のステータス:キューで待機中、実行中、成功、失敗。
クエリのSQL テキスト。
クエリID。
クエリの実行に使用されるウェアハウスに関する情報。
クエリの開始時間と終了時間、および期間。
スキャンされたバイト数や返された行数など、クエリに関する情報。
このトピックの内容:
機能の概要¶
History ページで次のタスクを実行できます:
右上の auto-refresh チェックボックスを使用して、セッションの自動更新を有効/無効にします。選択すると、ページは10秒ごとに更新されます。 Refresh アイコンをクリックして、いつでも表示を更新することもできます。
Show/Hide Filters トグルを使用してパネルを開閉し、ページに表示されるクエリを制御する1つ以上のフィルターを指定できます。指定したフィルターは、現在のセッションに対してアクティブです。
Use the Include client-generated statements checkbox to show or hide SQL statements run by web interface sessions outside of SQL worksheets. For example, whenever a user navigates to the Warehouses
, Snowflake executes a SHOW WAREHOUSES statement in the background. Clear the Include client-generated statements checkbox to hide this "noise" in the list of displayed queries.
Use the Include queries executed by user tasks checkbox to show or hide SQL statements executed or stored procedures called by user tasks.
表示されたクエリのリストをスクロールします。リストには、フィルターに一致する最初のクエリ(最大)100、または最新の100クエリ(フィルタが適用されていない場合)が含まれます。リストの下部で、さらにクエリが利用可能な場合、検索を続行できます。これにより、次の一致するクエリの(最大)100がリストに追加されます。
任意の列ヘッダーをクリックして、列でページを並べ替えたり、画面の列を追加/削除します。
クエリのテキストをクリックして(またはクエリを選択して View SQL をクリック)、クエリの完全な SQL を表示します。
まだ完了していないクエリを選択し、 Abort をクリックしてクエリを中止します。
クエリの ID をクリックして、クエリの結果やクエリプロファイルなど、クエリの詳細を表示します。
注釈
History ページには、最近のクエリから始めて、過去14日間に実行されたクエリが表示されます。 End Time フィルターを使用して、指定した日付に基づいてクエリを表示できます。ただし、過去14日より前の日付を指定した場合、結果は返されません。
クエリの詳細と結果の表示¶
Snowflakeは一定期間(現在は24時間)クエリの結果を保持し、その後、結果は削除されます。この制限は調整できません。
特定のクエリの詳細と結果を表示するには、 History ページの Query ID をクリックします。 Query Detail ページが表示され(以下を参照)、クエリ実行の詳細とクエリ結果(まだ利用可能な場合)を表示できます。
Export Result ボタンを使用して、クエリの結果(まだ利用可能な場合)をファイルにエクスポートすることもできます。
注釈
実行したクエリの結果のみを表示できます。別のユーザーが実行したクエリを表示する権限がある場合、 Query Detail ページにはクエリの詳細が表示されますが、データプライバシー上の理由から、ページには実際のクエリ結果は表示されません。
クエリ結果のエクスポート¶
クエリの結果を表示できるインターフェイスの任意のページ(例えば、 Worksheets、 Query Detail)で、クエリ結果がまだ利用可能な場合、結果をファイルにエクスポートできます。
クエリの Export Result ボタンをクリックすると、ファイル名と形式を指定するよう求められます。Snowflakeは、クエリのエクスポートで次のファイル形式をサポートしています:
コンマ区切り値(CSV)
タブ区切り値(TSV)
注釈
結果を表示できるクエリ(つまり、実行したクエリ)の結果のみをエクスポートできます。クエリを実行しなかった場合、またはクエリ結果が利用できなくなった場合、クエリの Export Result ボタンは表示されません。
ウェブインターフェイスは、サイズが最大100 MB までの結果のエクスポートのみをサポートします。クエリ結果がこの制限を超えた場合、エクスポートを続行するかどうかを尋ねられます。
エクスポートプロンプトは、ブラウザによって異なる場合があります。たとえば、Safariでは、エクスポート形式(CSVまたはTSV)のみを求められます。エクスポートが完了すると、エクスポートされた結果を新しいウィンドウにダウンロードするよう求められます。このウィンドウでは、 Save Page As... ブラウザーオプションを使用して結果をファイルに保存できます。
クエリプロファイルの表示¶
Snowflakeは、クエリの詳細と結果に加えて、クエリを構成する個々の実行コンポーネントなど、クエリの統計と詳細を分析するための Query Profile を提供します。詳細については、 クエリプロファイルを使用したクエリの分析 をご参照ください。