DESCRIBE TASK

작업의 열을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

DROP TASK , ALTER TASK , CREATE TASK , SHOW TASKS

구문

DESC[RIBE] TASK <name>
Copy

매개 변수

name

설명할 작업의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

출력

명령 출력은 다음 열에 작업 속성 및 메타데이터를 제공합니다.

열 이름

설명

created_on

작업이 생성된 날짜와 시간입니다.

이름

작업의 이름입니다.

id

작업에 대한 글로벌 고유 식별자(GUID)입니다.

데이터베이스_이름

작업을 포함하는 데이터베이스의 이름입니다.

스키마_이름

작업을 포함하는 스키마의 이름입니다.

owner

작업을 소유한 역할의 이름입니다.

comment

작업에 대한 설명(있는 경우)을 입력합니다.

웨어하우스

작업 실행을 위한 컴퓨팅 리소스를 제공하는 가상 웨어하우스의 이름입니다.

schedule

작업을 주기적으로 실행하기 위한 예약(있는 경우), 크론 식입니다. 예: USING CRON 0 9-17 * * SUN America/Los_Angeles.

predecessors

현재 작업에 대한 이전 작업의 이름(있는 경우)입니다.

상태

다음 중 하나에 해당합니다.

  • SCHEDULED - 실행이 예약되어 있습니다.

  • EXECUTING - 현재 실행 중입니다.

  • SUCCEEDED - 실행에 성공했습니다.

  • FAILED - 실행이 실패하고 작업이 시간 초과되었습니다.

  • FAILED_AND_AUTO_SUSPENDED - 실행에 실패하여 작업이 자동으로 일시 중단되었습니다.

  • CANCELLED - 실행이 취소되었습니다.

  • SKIPPED - 작업 실행이 시작되었지만, WHEN 조건이 false로 평가되어 실행이 실행되지 않았음을 나타냅니다.

definition

예약 또는 트리거 시 작업이 실행되는 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 입니다.

구성

작업 그래프의 루트 작업에만 적용됩니다. 구성이 있는 경우 구성을 표시합니다.

예산

오브젝트가 예산으로 모니터링되는 경우 예산 의 이름입니다. 그렇지 않으면 NULL입니다.

task_relations

루트 작업과 해당 종료자 작업 간의 관계를 표시합니다.

last_suspended_reason

작업이 일시 중단된 이유를 표시합니다. 가능한 이유에는 다음이 포함됩니다.

  • USER_SUSPENDED - 사용자가 alter task <name> 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