COMPLETE_TASK_GRAPHS¶

構文¶

COMPLETE_TASK_GRAPHS(
      [ RESULT_LIMIT => <integer> ]
      [, ROOT_TASK_NAME => '<string>' ]
      [, ERROR_ONLY => { TRUE | FALSE } ] )

引数¶

すべての引数はオプションです。

RESULT_LIMIT => integer

関数によって返される行の最大数を指定する数です。結果は、 COMPLETED_TIME の降順で返されることに注意してください。一致する行の数がこの制限よりも大きい場合は、指定された制限まで、最新の完了タイムスタンプを持つグラフ実行が返されます。

範囲: 1 ～ 10000

デフォルト: 1000

ROOT_TASK_NAME => string

ルートタスクの名前を指定する大文字と小文字を区別しない文字列。非修飾タスク名のみがサポートされています。指定されたタスクのグラフ実行のみが返されます。複数のタスクが同じ名前を持っている場合、関数はこれらの各タスクのグラフ実行を返します。

ERROR_ONLY => TRUE | FALSE

TRUE に設定すると、この関数は失敗したかキャンセルされたグラフ実行のみを返します。

使用上の注意¶

• ACCOUNTADMIN ロール、タスク所有者（つまり、タスクに対する OWNERSHIP 権限を持つロール）、またはグローバル MONITOR EXECUTION 権限を持つロールの結果のみを返します。ロールが、 MONITOR EXECUTION 権限に加えて、タスクを保存するデータベースとスキーマに対する USAGE 権限を持つ場合以外は、出力の DATABASE_NAME および SCHEMA_NAME 値は NULL であることに注意してください。

• この関数は、 RESULT_LIMIT 引数値に設定されている行数を返します。最大値は10,000行です。デフォルト値は 1000 です。この制限を回避するには、 COMPLETE_TASK_GRAPHS ビュー （Account Usage）を使用します。

• COMPLETE_TASK_GRAPHS 関数がクエリされると、そのタスク名と結果制限引数が 最初 に適用され、指定されている場合には、それぞれ WHERE 句と LIMIT 句が続くことに注意してください。さらに、関数は COMPLETED_TIME の降順で記録を返します。

  実際には、過去1時間にアカウントで多くのタスクグラフの実行が完了され、特に RESULT_LIMIT 値が比較的低い場合は、関数によって返される結果に期待される記録が含まれない可能性があります。

• Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマ または 完全修飾の関数名が必要です。詳細については、 Snowflake Information Schema をご参照ください。

出力¶

この関数は、次の列を返します。

例¶

アカウントにある完了したグラフ実行の最新1000件を取得します。関数によって返される行の最大数は、デフォルトで1000に制限されていることに注意してください。返される行数を変更するには、 RESULT_LIMIT 引数の値を変更します。

select *
  from table(information_schema.complete_task_graphs())
  order by scheduled_time;

Copy

過去1時間以内に指定されたタスクグラフに対して実行された完了したグラフの最新10件を取得します。

select *
  from table(information_schema.complete_task_graphs (
    result_limit => 10,
    root_task_name=>'MYTASK'));

Copy