Snowsight でタスクとタスクグラフを表示する¶

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

Snowsight でタスク履歴を表示するには、 TASK_HISTORY 関数を実行するのに必要な権限と同じ権限が必要です。つまり、タスクで以下のロールまたは権限のいずれかを含むロールを使用する必要があります。

• ACCOUNTADMIN ロール。

• タスクの OWNERSHIP 権限を持つロール (つまりタスクの所有者)。

• タスクに対する MONITOR または OPERATE 権限。

• MONITOR EXECUTION グローバル権限。

使用するロールは、Account Usage TASK_HISTORY ビューをクエリできる必要があります。共有SNOWFLAKEデータベースのUSAGE_VIEWERデータベースロールを使用するロールに付与できます。

たとえば、特定のタスク mytask の履歴を表示するには、次の SQL コマンドを実行することで、タスクに OWNERSHIP 権限を、共有 Snowflake データベースに USAGE_VIEWER データベースロールを付与できます。

GRANT OWNERSHIP ON TASK mytask TO ROLE myrole;
GRANT DATABASE ROLE USAGE_VIEWER TO ROLE myrole;

詳細については、以下をご参照ください。

• ACCOUNT_USAGE スキーマ SNOWFLAKE データベースロール

• GRANT DATABASE ROLE

タスクの実行履歴をレビューする¶

タスク実行履歴には、特定のタスクの各実行に関する詳細が含まれます。スケジュールの実行時間、ステータス、戻り値、タスクの所要時間、その他の情報を表示できます。

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

• スケジュールされた実行時間：スケジュールされたタスクが実行された時間。

• ステータス：タスク実行の直近のステータス。

• 継続時間：タスクの実行時間（秒）。

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

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

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

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

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

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

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

アカウントレベルのタスク履歴をレビューする¶

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

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

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

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

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

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

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

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

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

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

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

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

タスク履歴ページの表示¶

Task History ページでタスクグラフの実行履歴を確認し、失敗したタスク、長時間実行中のタスク、その他のモニタリングやデバッグのケースを識別します。タスクグラフの履歴を表示します。

タスクグラフの実行を表示するには、以下の手順を実行します。

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

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

   

Task Graphs タブでは、以下のことができます。

• Previous Runs カウンターにカーソルを合わせると、時系列で最新のランのステータスが表示されます。

• Duration Trend グラフは、最小-最大範囲内の中央線を強調表示することで、（選択された日付範囲に基 づいて）時間の経過とともにタスクの実行時間を視覚化します。これにより、タスク時間が安定しているのか、変動しているのか、トレンドがあるのかを素早く評価し、個々の異常値を特定することができます。

• グラフの手動実行、ルートタスクの編集（スケジュールやパラメーターの変更など）、グラフの中断／再開には、省略記号メニューを使用します。

ページをフィルターして関連情報を表示することができます。大容量アカウントのロード時間を短縮するために、データベースとスキーマでフィルターをかけることをお勧めします。

• 過去7日間のタスク履歴を表示するには、 Date Range フィルターを選択します（デフォルト設定）。1日に変更できます。日付範囲フィルターは、前回のランカウンターとランタイム期間のトレンドにのみ適用されることに注意してください。

• Last Run Status フィルターを選択すると、 Succeeded、 Failed、 Canceled、 Skipped など、直近の実行における1つまたは複数のステータスのタスクグラフが表示されます。このフィルターはタスクグラフの最新の完了した実行にのみ適用されます。

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

• 検索フィールドを使ってルートタスク名でフィルターをかけます。

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

タスクグラフを選択すると、常に最新の実行の詳細が表示されます。以前のランの詳細を見たい場合は、特定のグラフランページで Open previous runs を選択します。

タスクオブジェクトページからのタスクグラフへのアクセス¶

このプレビューでは、タスクがタスクグラフの一部である場合、特定のラン履歴ページから Task Graph ページにアクセスすることもできます。

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

2. Data » Databases を選択します。

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

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

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

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

7. タスクがタスクグラフに関連付けられている場合、 Task の隣に Task Graph タブがあります。

   タスクグラフの詳細を表示するには、 Task Graph を選択します。

   

考慮事項と制約¶

• この関数でタスクグラフを表示するには、以下の権限の少なくとも1つを持つロールが必要です。

  • タスクに対する OWNERSHIP 権限（つまりタスク所有者）。

  • タスクに対する MONITOR または OPERATE 権限。

  • MONITOR EXECUTION グローバル権限。

  • ACCOUNTADMIN ロール。

  ロールにはタスクを格納するデータベースとスキーマの USAGE 権限も必要です。そうでない場合、出力の DATABASE_NAME と SCHEMA_NAME の値は NULL になります。