DESCRIBE TASK¶

タスクの列を説明します。

DESCRIBE は DESC に短縮できます。

こちらもご参照ください。: DROP TASK、 ALTER TASK、 CREATE TASK、 SHOW TASKS

構文¶

DESC[RIBE] TASK <name>

Copy

パラメーター¶

name: 記述するタスクの識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

出力¶

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

列名	説明
created_on	タスクが作成された日時。
name	タスクの名前。
ID	タスクのグローバル一意識別子（GUID）。
database_name	タスクを含むデータベースの名前。
schema_name	タスクを含むスキーマの名前。
owner	タスクを所有するロールの名前。
comment	タスクのコメント（ある場合）。
ウェアハウス	タスクを実行するためのコンピューティングリソースを提供する仮想ウェアハウスの名前。
スケジュール	タスクを定期的に実行するスケジュールがある場合は、cron式で指定します。例: `USING CRON 0 9-17 * * SUN America/Los_Angeles`。
先行タスク	現在のタスクの先行タスクがある場合は、その名前。
状態	次のいずれか。 SCHEDULED - 実行予定。 EXECUTING - 現在実行中。 SUCCEEDED - 実行成功。 FAILED - 実行に失敗し、タスクはタイムアウト。 FAILED_AND_AUTO_SUSPENDED - 実行に失敗し、タスクは自動的に中断。 CANCELLED - 実行中止。 SKIPPED - タスクの実行が開始されたが、オプションの `WHEN` 条件がfalseに評価され、実行されなかったことを示す。
定義	SQL スケジュールまたはトリガー時にタスクが実行するステートメント。
条件	タスクが実行されるためにtrueと評価される必要のある `WHEN` 条件のテキスト。
allow_overlapping_execution	TRUE または FALSE。ルートタスクにのみ適用されます。TRUE はルートタスクの複数のインスタンスが同時に実行できることを示します。FALSE がデフォルトです。
error_integration	Amazon SNS、 MS Azure Event Grid、またはGoogle Pub/Subと通信するために使用される通知統合の名前。指定がない場合は `null` を返します。
last_committed_on	該当する場合は、タスクのバージョンが最後に設定されたタイムスタンプ。詳細については、タスク実行のバージョニングをご参照ください。
last_suspended_on	該当する場合は、タスクが最後に中断されたタイムスタンプ。
owner_role_type	オブジェクトを所有するロールの型。例: `ROLE`。Snowflake Native Appがオブジェクトを所有している場合、値は `APPLICATION` になります。
構成	タスクグラフのルートタスクにのみ適用されます。構成がある場合は、それを表示します。
budget	オブジェクトが予算によって監視されている場合、予算の名前です。それ以外の場合は、 NULL です。
task_relations	ルートタスクと対応するファイナライザタスクの関係を表示します。
last_suspended_reason	タスクが中断された理由を表示します。考えられる理由は次のとおりです。 USER_SUSPENDED - ユーザーが `alter task <名前> suspend` コマンドを実行してタスクを中断しました。 SCHEMA_OR_DATABASE_DELETED: タスクのスキーマまたはデータベースがドロップされました。 GRANT_OWNERSHIP - ユーザーが `grant ownership` コマンドを実行してタスクの所有権を別のロールに移譲しました。 SUSPENDED_DUE_TO_ERRORS - タスクが一定回数連続して失敗し、中断されました。このタスクを中断するために必要な失敗の回数は、 SUSPEND_TASK_AFTER_NUM_FAILURES パラメーターで設定できます。 CHILD_BECAME_ROOT - このタスクは以前、タスクグラフの子タスクでしたが、子タスクのすべての先行タスクが削除され、子タスクがルートタスクになりました。 FINALIZER_BECAME_ROOT - このタスクは以前、タスクグラフのファイナライザータスクでしたが、ファイナライズが削除され、タスクがルートタスクになりました。 MATCHING_OWNER_NOT_FOUND - タスクの複製中に、タスクを所有するロールがセカンダリデータベースに見つかりませんでした。

使用上の注意¶

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

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

例¶

サンプルタスクを作成します。

CREATE TASK mytask ( ... );

Copy

タスク内のテーブルの列を説明します。

DESC TASK mytask;

Copy