Snowsight でのタスク履歴の表示

タスクを使用すると、 SQL コードの実行をスケジュールできます。タスクの有向非巡回グラフ(DAG)を作成して、ルートタスクと一連の依存タスクで指定された SQL コードを実行する方法を指定できます。タスクは、特定のデータベースとスキーマに関連付けられています。タスクの詳細については、 タスクの紹介 をご参照ください。

Snowsight を使用すると、いくつかの異なる方法でタスクの実行履歴を確認できます。

  • アカウントで実行されたすべてのタスクの実行履歴を表示して、たとえば、実行に失敗した重要なタスク、長時間実行されているタスク、またはコストを増加させているタスクを特定します。

  • 特定のタスクの実行履歴を表示して、タスクに関する詳細情報を収集します。

このトピックの内容:

タスク履歴を表示するために必要な権限

Snowsight でタスク履歴を表示するには、 TASK_HISTORY および COMPLETE_TASK_GRAPHS テーブル関数を実行するのに必要な権限と同じ権限が必要です。

次のいずれかを使用する必要があります。

  • ACCOUNTADMIN ロール。

  • タスクに対する OWNERSHIP 権限を持つロール。

  • MONITOR EXECUTION グローバル権限と、タスクを格納するデータベースとスキーマに対する USAGE 権限を持つロール。

個別のタスクグラフの表示

タスクグラフを確認して、ルートタスクとその依存タスクを DAG の形式で表示します。タスクグラフを確認すると、次のことができます。

  • ルートタスクおよび選択した依存タスクごとのステータスを含む、タスク情報を表示する。

  • グラフ内のルートタスクと依存タスクを含む、タスクグラフを調べる。 タスクのDAG をご参照ください。

  • グラフでタスクを選択すると、先行タスク、タスクの実行に使用されたウェアハウス、タスクを所有するロールなどの追加の詳細が表示されます。

Example task graph shown in Snowsight, with annotations showing the navigation to view the task graph as described in the following task.

特定のデータベーススキーマのタスクグラフを表示するには、次を実行します。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data » Databases を選択します。

  3. オブジェクトエクスプローラーを使用して、表示するタスクを含むデータベースとスキーマを見つけます。

  4. 選択したスキーマについて、 Tasks を選択します。

  5. 特定のタスクを選択します。

    タスクの詳細が表示され、追加の Graph および Run History タブが表示されます。

  6. Graph タブを選択して、タスクグラフを表示します。

    タスクグラフが表示され、タスクの階層が表示されます。

  7. タスクを選択して、グラフのコンテキストで詳細を表示します。

注釈

タスク履歴データは、過去7日間にタスクが実行された場合にのみ利用できます。

タスクの実行履歴を確認する

タスク実行履歴には、特定のタスクの各実行に関する詳細が含まれます。スケジュールされた時間、実際の開始時間、タスクの期間、およびその他の情報を表示できます。

Snowsight task history page with annotations for each section.

各インスタンスについて、以下を表示できます。

  • スケジュールされた開始時刻: タスクの次回の実行スケジュール。

  • ステータス: 最新の実行のステータス。

  • 期間: 最新の実行の時間(秒単位)。

  • クエリ: タスククエリプロファイルまたはタスクステートメントをワークシートに表示する。

実行履歴を表示するには、

  1. Snowsight ナビゲーションメニューで Data » Databases をクリックします。

  2. 右側のペインで、オブジェクトエクスプローラーを使用して、データベースとスキーマに移動します。

  3. 選択したスキーマについて、 Tasks を選択して展開します。

  4. タスクを選択します。 Task DetailsGraph、および Run History サブタブを含むタスク情報が表示されます。

  5. Run History タブを選択します。

注釈

タスク履歴データは、過去7日間にタスクが実行された場合にのみ利用できます。

アカウントレベルのタスク履歴を確認する

タスク実行のアカウントレベルの履歴を確認して、失敗したタスク、実行時間の長いタスク、および特定の1つのタスクだけではなく、アカウント全体のその他のモニターとデバッグのケースを特定します。

タスクのアカウントレベルの履歴を表示するには、次を実行します。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Activity » Task History を選択します。

  3. 個別のタスク実行を表示するには、フィルターから View » Task Runs を選択します。

タスク実行の履歴を選択した後、ページをフィルターして関連情報を表示できます。

  • Date Range フィルターを選択して、前日から過去12か月までのタスク履歴、またはカスタム範囲を表示します。

  • Task status フィルターを選択して、 SucceededFailedCancelled、または Skipped などのステータス1つ以上のタスク履歴を表示します。

  • タスクの名前でフィルターして、特定のタスクのステータスまたは期間のパターンを経時的に表示します。

  • タスクを含むデータベースまたはスキーマの名前でフィルターします。

たとえば、実行時間の長いタスクを識別するには、 Status フィルターを選択して成功したタスクのみを表示し、 Duration フィールドを降順で並べ替えます。高度なデバッグを行うには、 Open in worksheets ボタンを使用して、フィルター済みおよび並べ替え済みのテーブルをワークシートで開くことができます。次に、 LIMIT / FETCH および GROUP BY 引数を使用して SQL ステートメントを変更し、実行時間の長い上位25個のタスクを持つデータベースとスキーマを特定できます。

特定のタスクを選択して、詳細をドリルダウンすることもできます。