履歴ページを使用してクエリを監視

History 履歴タブ ページでは、過去14日間に実行されたすべてのクエリの詳細を表示およびドリルダウンできます。このページには、 SnowSQL または他の SQL クライアントから実行されたクエリを含む、クエリの履歴リストが表示されます。

注釈

Snowsight でのクエリ履歴のレビューの詳細については、 クエリ履歴でクエリのアクティビティをモニターする をご参照ください。

各クエリに対して表示されるデフォルト情報は次のとおりです:

  • クエリの現在のステータス:キューで待機中、実行中、成功、失敗。

  • クエリのSQL テキスト。

  • クエリID。

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

  • クエリの開始時間と終了時間、および期間。

  • スキャンされたバイト数や返された行数など、クエリに関する情報。

注釈

Start Time 列と End Time 列には、ログインしているユーザーのタイムゾーンの時刻が表示されます。この設定を変更するオプションはありません。セッションパラメーターはこの設定に影響しません。

このトピックの内容:

機能の概要

従来のコンソール内の履歴ページ

注釈

History ページ列は QUERY_HISTORY ビューから派生しています。列の説明などの詳細については QUERY_HISTORY ビュー をご参照ください。

History ページで次のタスクを実行できます:

  • 右上の auto-refresh チェックボックスを使用して、セッションの自動更新を有効/無効にします。選択すると、ページは10秒ごとに更新されます。 Refresh アイコンをクリックして、いつでも表示を更新することもできます。

  • Show/Hide Filters トグルを使用してパネルを開閉し、ページに表示されるクエリを制御する1つ以上のフィルターを指定できます。指定したフィルターは、現在のセッションに対してアクティブです。

  • SQL ワークシートの外部のウェブインターフェイスセッションで実行される SQL ステートメントを表示または非表示にするには、 Include client-generated statements チェックボックスを使用します。たとえば、ユーザーが Warehouses ウェアハウスタブ に移動するたびに、Snowflakeはバックグラウンドで SHOW WAREHOUSES ステートメントを実行します。 Include client-generated statements チェックボックスをオフにして、表示されたクエリのリストでこの「ノイズ」を非表示にします。

  • Include queries executed by user tasks チェックボックスを使用して、ユーザータスクによって実行される SQL ステートメントまたはストアドプロシージャを表示または非表示にします。

  • 表示されたクエリのリストをスクロールします。リストには、フィルターに一致する最初のクエリ(最大)100、または最新の100クエリ(フィルタが適用されていない場合)が含まれます。リストの下部で、さらにクエリが利用可能な場合、検索を続行できます。これにより、次の一致するクエリの(最大)100がリストに追加されます。

  • 任意の列ヘッダーをクリックして、列でページを並べ替えたり、画面の列を追加/削除します。

  • クエリのテキストをクリック(またはクエリを選択して View SQL をクリック)すると、クエリの完全な SQL が表示されます。

  • まだ完了していないクエリを選択し、 Abort をクリックしてクエリを中止します。

  • クエリの ID をクリックして、クエリの結果やクエリプロファイルなど、クエリの詳細を表示します。

注釈

History ページには、最近のクエリから始めて、過去14日間に実行されたクエリが表示されます。 End Time フィルターを使用して、指定した日付に基づいてクエリを表示できます。ただし、過去14日より前の日付を指定した場合、結果は返されません。

クエリの詳細と結果の表示

Snowflakeは一定期間クエリの結果を保持し、その後、結果はパージされます。この制限は調整できません。詳細については、 保存済みのクエリ結果の使用 をご参照ください。

特定のクエリの詳細と結果を表示するには、 History ページの Query ID をクリックします。クエリ実行の詳細、そしてクエリ結果(まだ利用可能な場合)を表示できる Query Detail ページが表示されます(以下を参照)。

従来のコンソールのクエリ詳細ページ

Export Result ボタンを使用して、クエリの結果(まだ利用可能な場合)をファイルにエクスポートすることもできます。

注釈

実行したクエリの結果のみを表示できます。別のユーザーが実行したクエリを表示する権限がある場合、 Query Detail ページにはクエリの詳細が表示されますが、データプライバシー上の理由により実際のクエリ結果は表示されません。

クエリ結果のエクスポート

クエリの結果を表示できるインターフェイスの任意のページ(例: WorksheetsQuery Detail)では、クエリ結果がまだ利用可能な場合、結果をファイルにエクスポートできます。

クエリの Export Result ボタンをクリックすると、ファイル名と形式を指定するよう求められます。Snowflakeは、クエリのエクスポートで次のファイル形式をサポートしています:

  • コンマ区切り値(CSV)

  • タブ区切り値(TSV)

注釈

  • 結果を表示できるクエリ(つまり、実行したクエリ)の結果のみをエクスポートできます。クエリを実行しなかった場合、またはクエリ結果が利用できなくなった場合、クエリの Export Result ボタンは表示されません。

  • ウェブインターフェイスは、サイズが最大100 MB までの結果のエクスポートのみをサポートします。クエリ結果がこの制限を超えた場合、エクスポートを続行するかどうかを尋ねられます。

  • エクスポートプロンプトは、ブラウザによって異なる場合があります。たとえば、Safariでは、エクスポート形式(CSVまたはTSV)のみを求められます。エクスポートが完了すると、エクスポートされた結果を新しいウィンドウにダウンロードするよう求められます。このウィンドウでは、 Save Page As... ブラウザーオプションを使用して結果をファイルに保存できます。

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

従来のコンソールのクエリプロファイルページ

Snowflakeは、クエリの詳細と結果に加えて、クエリを構成する個々の実行コンポーネントなど、クエリの統計と詳細を分析するための Query Profile を提供します。詳細については、 クエリプロファイルを使用したクエリの分析 をご参照ください。

Snowflake Native App からマスキングされたクエリ履歴データ

Snowflake Native App に関連するクエリでは、以下のコンテキストで クエリ履歴 から query_texterror_message フィールドがマスクキングされます。

  • クエリは、アプリがインストールまたはアップグレードされたときに実行される。

  • アプリが所有するストアドプロシージャの子ジョブから発生するクエリ。

これらの状況では、 Snowsight のクエリ履歴のセルは空白になります。