SHOW TASKS¶

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

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

こちらもご参照ください。: CREATE TASK、 ALTER TASK、 DROP TASK、 DESCRIBE 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>' ] ]

パラメーター¶

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' ]

返される rows の最大数を制限することにより、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があることに注意してください（例えば、オブジェクトの数が指定された制限より少ない場合）。

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

文字列は一重引用符で囲む必要があり、大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。

注釈

FROM 同じステートメントで STARTS WITH と組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、 FROM は、 STARTS WITH によって返される行よりも辞書式の値が大きい行のみを返します。

例：

... 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 |

列	説明
`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;

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

SHOW TASKS IN tpch.public;