SHOW TASKS

アクセス権限があるタスクをリストします。このコマンドを使用して、現在の/指定されたデータベースまたはスキーマのタスクを一覧表示するか、アカウント全体にわたって一覧表示できます。

出力は、データベース、スキーマ、およびタスク名によって辞書順に並べられたタスクメタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。

こちらもご参照ください。

CREATE TASKALTER TASKDROP TASKDESCRIBE TASK

構文

SHOW [ TERSE ] TASKS [ LIKE '<pattern>' ]
                     [ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]
                     [ STARTS WITH '<name_string>' ]
                     [ ROOT ONLY ]
                     [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

パラメーター

TERSE

出力列のサブセットのみを返します。

  • created_on

  • name

  • kind (すべてのタスクレコードの NULL を表示)

  • database_name

  • schema_name

  • schedule

LIKE 'pattern'

オブジェクト名でコマンド出力をフィルターします。フィルターは、 SQL ワイルドカード文字(% および _)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは同じ結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
IN ACCOUNT | DATABASE [ db_name ] | SCHEMA [ schema_name ]

必要に応じて、コマンドのスコープを指定します。これはコマンドが、現在/指定されたデータベースまたはスキーマの記録のみをリストするか、アカウント全体に表示するかを決定します。

キーワード ACCOUNT を指定すると、コマンドは、現在のアカウントのデータベースすべてにあるすべてのスキーマの記録を取得します。

キーワード DATABASE を指定すると、次のようになります。

  • <database_name> を指定すると、コマンドは、指定されたデータベースのスキーマすべての記録を取得します。

  • <database_name> を指定しない場合は、次のようになります。

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとスキーマの記録を取得します。

キーワード SCHEMA を指定すると、次のようになります。

  • 修飾されたスキーマ名(例: my_database.my_schema)を指定すると、コマンドは、指定されたデータベースとスキーマの記録を取得します。

  • 修飾されていない <schema_name> を指定すると、次のようになります。

    • 現在のデータベースがある場合、コマンドは、現在のデータベースにある指定されたスキーマの記録を取得します。

    • 現在のデータベースがない場合、コマンドは、エラー SQL compilation error: Object does not exist, or operation cannot be performed を表示します。

  • <schema_name> を指定しない場合は、次のようになります。

    • 現在のデータベースがある場合は、次のようになります。

      • 現在のスキーマがある場合、コマンドは、現在のデータベースにある現在のスキーマの記録を取得します。

      • 現在のスキーマがない場合、コマンドは、現在のデータベースにあるスキーマすべての記録を取得します。

    • 現在のデータベースがない場合、コマンドは、アカウントにあるすべてのデータベースとすべてのスキーマの記録を取得します。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

  • データベース: DATABASE がデフォルトです(つまり、コマンドはデータベースで表示する権限を持つオブジェクトを返します)。

  • データベースなし: ACCOUNT はデフォルトです(つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返します)。

STARTS WITH 'name_string'

オブジェクト名の先頭に表示される文字列に基づいてコマンド出力をフィルターします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次の結果は 異なる 結果を返します。

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
ROOT ONLY

コマンド出力をフィルターして、ルートタスク(先行タスクを持たないタスク)のみを返します。

LIMIT rows [ FROM 'name_string' ]

オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があります(例:既存のオブジェクトの数が指定された制限より少ない)。

オプションの FROM 'name_string' サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。

  • 文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します

  • 文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

デフォルト:値なし(出力に制限は適用されない)

注釈

STARTS WITH 'name_string'FROM 'name_string' の両方は、同じステートメントで組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合は、相互にキャンセルされ、結果が返されません。

さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM 'name_string' は、 STARTS WITH 'name_string' によって返される行よりも辞書式の値が大きい行のみを返します。

例:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' は結果を返しません。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' は結果を返しません。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' は結果を返します(入力文字列に一致する行がある場合)。

使用上の注意

  • タスクの所有者(つまり、タスクの OWNERSHIP 権限を持つロール) または タスクの MONITOR または OPERATE 権限を持つロールの行のみを返します。

  • このコマンドは、稼働中のウェアハウスを必要としません。

  • LIMIT rows の値は 10000 を超えることはできません。 LIMIT rows が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

出力

コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。

| created_on | name | id | database_name | schema_name | owner | comment | warehouse | schedule | predecessors| state| definition| condition | allow_overlapping_execution | error_integration | last_committed_on | last_suspended_on |
Copy

説明

created_on

タスクが作成された日時。

name

タスクの名前。

id

各タスクの一意の識別子。タスクを( CREATE OR REPLACE TASK を使用して)再作成すると、基本的に、新しい ID を持つ新しいタスクが作成されることに注意してください。

database_name

タスクが格納されているデータベース。

schema_name

タスクが格納されているスキーマ。

owner

タスクを所有するロール(つまり、タスクに対する OWNERSHIP 権限を持つ)

comment

タスクのコメント。

warehouse

タスクを実行するために必要なリソースを提供するウェアハウス。

schedule

タスクを実行するスケジュール。スケジュールが指定されていない場合、 NULL を表示します。

predecessors

JSON タスクの AFTER パラメーターで識別されたタスク(つまり、先行タスク)の配列。正常に実行されて完了すると、これらのタスクが現在のタスクをトリガーします。配列内の個々のタスク名は完全修飾されています(つまり、コンテナーデータベースとスキーマ名が含まれます)。 . . タスクに先行するタスクがない場合は空の配列が表示されます。

state

タスクの現在の状態に基づいて「開始」または「一時停止」。

definition

タスクの実行時に実行される SQL ステートメント。

condition

タスクのWHEN句で指定された条件。

allow_overlapping_execution

DAG 内のルートタスクの場合、DAGの重複実行が明示的に許可されている場合はTRUEを表示します。DAG内の子タスクの場合、NULLを表示します。

error_integration

Amazon Simple Notification Service(SNS)にアクセスしてタスクのエラー通知を中継するために使用される、通知統合の名前。

last_committed_on

タスクの バージョン が最後に設定されたときのタイムスタンプ。バージョンが設定されていない場合(つまり、タスクが作成された後に再開されていないか、手動で実行されていない場合)、値は NULL です。

last_suspended_on

タスクが最後に一時停止されたときのタイムスタンプ。タスクがまだ一時停止されていない場合、値は NULL です。

タスクに指定できるプロパティの詳細については、 CREATE TASK をご参照ください。

tpch.public スキーマで表示する権限がある、名前が line で始まるすべてのタスクを表示します。

SHOW TASKS LIKE 'line%' IN tpch.public;
Copy

tpch.public スキーマで表示する権限を持つタスクすべてを表示します。

SHOW TASKS IN tpch.public;
Copy