カテゴリ:

データパイプライン DDL

SHOW TASKS

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

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

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

CREATE TASKDROP TASK

構文

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行より大きい場合、コマンドはエラーになります。

    10Kを超えるレコードが存在する結果を表示するには、 LIMIT を含めるか、 情報スキーマ の対応するビューをクエリします。

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

出力

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

| created_on | name | id | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition

説明

created_on

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

name

タスクの名前。

id

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

database_name

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

schema_name

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

owner

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

comment

タスクのコメント。

warehouse

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

schedule

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

predecessors

正常に実行されたときにこのタスクをトリガーするタスク。先行タスクが指定されていない場合、 NULL を表示します。

state

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

definition

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

condition

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

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

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

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

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

SHOW TASKS IN tpch.public;