TASK_DEPENDENTS

TASK_DEPENDENTS

이 테이블 함수는 태스크 그래프(task graph)에서 주어진 루트 태스크에 대한 하위 태스크(child task) 목록을 반환해요.

출처: Snowflake SQL Reference - TASK_DEPENDENTS

본문

구문

TASK_DEPENDENTS(
      TASK_NAME = string
      [, RECURSIVE = Boolean ] )

인자

TASK_NAME = string 태스크를 지정하는 문자열이에요. 이 함수는 지정한 루트 태스크를 첫 번째 항목으로, 그 뒤에 하위 태스크 목록을 반환해요.

  • 이름이 정규화되어 있으면 데이터베이스와 스키마를 포함해 전체 이름을 작은따옴표로 묶어야 해요. 즉 db.schema.task_name 형태예요.
  • 태스크 이름이 대소문자를 구분하거나 특수 문자·공백을 포함하면 해당 대소문자/문자를 처리하기 위해 큰따옴표가 필요해요. 큰따옴표는 작은따옴표 안에 있어야 해요.

RECURSIVE = Boolean 출력을 직접 하위 태스크만으로 제한할지, 모든 재귀 하위 태스크를 포함할지를 지정해요.

값:

  • TRUE: 출력에 모든 재귀 하위 태스크(자식, 손자 등)를 반환해요.
  • FALSE: 출력에 직접 하위 태스크만 반환해요.

기본값: TRUE.

사용 시 유의사항

  • 태스크 소유자(즉 태스크에 OWNERSHIP 권한이 있는 역할) 또는 태스크에 MONITOR·OPERATE 권한이 있는 역할에 대해서만 행을 반환해요.
  • Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참고하세요.

출력

함수 출력은 다음 컬럼에 테이블 속성과 메타데이터를 제공해요:

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition |
Column Description
created_on 태스크가 생성된 날짜와 시간
name 태스크의 이름
database_name 태스크의 스키마에 대한 데이터베이스
schema_name 태스크에 대한 스키마
owner 태스크를 소유한 역할(즉 태스크에 OWNERSHIP 권한이 있는 역할)
comment 태스크에 대한 주석
warehouse 태스크 실행에 필요한 리소스를 제공하는 웨어하우스
schedule 태스크 실행 일정. 일정이 지정되지 않으면 NULL을 표시해요.
predecessors 태스크의 AFTER 파라미터에 식별된(즉 선행 태스크인) 태스크들의 JSON 배열. 이 태스크들이 성공적으로 완료되면 현재 태스크를 트리거해요. 배열의 개별 태스크 이름은 정규화되어 있어요(즉 컨테이너 데이터베이스·스키마 이름 포함). 태스크에 선행 태스크가 없으면 빈 배열을 표시해요.
state 태스크의 현재 상태에 따른 'Started' 또는 'Suspended'
definition 태스크 실행 시 수행되는 SQL 문
condition 태스크의 WHEN 절에 지정된 조건

예시

mydb.myschema.mytask 태스크의 직접 하위 태스크 목록을 검색해요:

select *
  from table(information_schema.task_dependents(task_name = mydb.myschema.mytask, recursive = false));

더 알아보기 (Learn more)