- カテゴリ:
SHOW TASKS¶
アクセス権限があるタスクをリストします。このコマンドを使用して、現在の/指定されたデータベースまたはスキーマのタスクを一覧表示するか、アカウント全体にわたって一覧表示できます。
出力は、データベース、スキーマ、およびタスク名によって辞書順に並べられたタスクメタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。
- こちらもご参照ください。
構文¶
SHOW [ TERSE ] TASKS [ LIKE '<pattern>' ]
[ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
TERSE
出力列のサブセットのみを返します。
created_on
name
kind
(すべてのタスクレコードの NULL を表示)database_name
schema_name
schedule
LIKE 'パターン'
オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%
および_
)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは同じ結果を返します。
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
IN ACCOUNT | [ DATABASE ] データベース名 | [ SCHEMA ] スキーマ名
コマンドのスコープを指定します。これは、コマンドが現在/指定されたデータベースまたはスキーマのレコードのみを一覧表示するか、アカウント全体に表示するかを決定します。
DATABASE
またはSCHEMA
キーワードは必須ではありません。データベースまたはスキーマ名のみを指定して、スコープを設定できます。同様に、セッションで現在使用中のデータベースがある場合、データベース名またはスキーマ名は必要ありません。DATABASE
またはSCHEMA
が名前なしで指定され、セッションで現在使用中のデータベースがない場合、パラメーターは出力に影響しません。SCHEMA
が名前で指定され、セッションで現在使用中のデータベースがない場合、スキーマ名はデータベース名で完全修飾する 必要があります (例:testdb.testschema
)。
デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。
データベース:
DATABASE
はデフォルトです(つまり、コマンドは、データベースで表示する権限を持つオブジェクトを返す)。データベースなし:
ACCOUNT
はデフォルトです(つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返す)。
STARTS WITH '名前文字列'
オブジェクト名の先頭に表示される文字列に基づいてコマンド出力をフィルターします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次の結果は 異なる 結果を返します。
... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
LIMIT 行 [ FROM '名前文字列' ]
返される
行
の最大数を制限することにより、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があることに注意してください(例えば、オブジェクトの数が指定された制限より少ない場合)。この句には、結果の「カーソル」として効果的に機能する
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 行
の値は10000
を超えることはできません。LIMIT 行
が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。
| created_on | name | id | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition | allow_overlapping_execution |
列 |
説明 |
---|---|
|
タスクが作成された日時。 |
|
タスクの名前。 |
|
各タスクの一意の識別子。タスクを( CREATE OR REPLACE TASK を使用して)再作成すると、基本的に、新しい ID を持つ新しいタスクが作成されることに注意してください。 |
|
タスクが格納されているデータベース。 |
|
タスクが格納されているスキーマ。 |
|
タスクを所有するロール(つまり、タスクに対する OWNERSHIP 権限を持つ) |
|
タスクのコメント。 |
|
タスクを実行するために必要なリソースを提供するウェアハウス。 |
|
タスクを実行するスケジュール。スケジュールが指定されていない場合、 NULL を表示します。 |
|
正常に実行されたときにこのタスクをトリガーするタスク。先行タスクが指定されていない場合、 NULL を表示します。 |
|
タスクの現在の状態に基づいて「開始」または「一時停止」。 |
|
タスクの実行時に実行される SQL ステートメント。 |
|
タスクのWHEN句で指定された条件。 |
|
ツリー内のルートタスクの場合、ツリーの重複実行が明示的に許可されている場合はTRUEを表示します。ツリー内の子タスクの場合、NULLを表示します。 |
タスクに指定できるプロパティの詳細については、 CREATE TASK をご参照ください。
例¶
tpch.public
スキーマで表示する権限がある、名前が line
で始まるすべてのタスクを表示します。
SHOW TASKS LIKE 'line%' IN tpch.public;
tpch.public
スキーマで表示する権限を持つタスクすべてを表示します。
SHOW TASKS IN tpch.public;