SYSTEM$GET_PREDECESSOR_RETURN_VALUE
SYSTEM$GET_PREDECESSOR_RETURN_VALUE (선행 작업 반환 값 조회)
테스크 그래프(task graph)에서 선행 작업(predecessor task)의 반환 값을 검색해요. 반환 값은 선행 작업이 SYSTEM$SET_RETURN_VALUE 함수를 호출해 명시적으로 설정해요.
출처: Snowflake SQL Reference - SYSTEM$GET_PREDECESSOR_RETURN_VALUE
본문
구문
SYSTEM$GET_PREDECESSOR_RETURN_VALUE('<task_name>')
인자
'task_name'
검색할 반환 값을 설정하는 선행 작업의 식별자예요.
-
작업에 활성화된 선행 작업이 여러 개 있으면 이 인자는 필수예요.
-
작업에 활성화된 선행 작업이 하나뿐이면 이 인자는 선택 사항이에요. 이 인자를 생략하면, 함수는 유일한 활성 선행 작업의 반환 값을 검색해요.
-
직접 선행 작업 이름이 요청한 작업 이름과 일치하지 않지만 조상 선행 작업이 작업 이름과 일치하면, 일치하는 조상의 반환 값이 반환돼요.
-
작업 이름 인자에는 데이터베이스 이름이나 스키마 이름이 포함되면 안 돼요. 그래프의 모든 작업은 같은 스키마 안에 있어야 하므로, 다른 스키마의 작업을 참조할 필요는 없어요. 예를 들어
MYDATABASE.MYSCHEMA.MYTASK대신MYTASK를 이 함수의 입력으로 사용해야 해요.
사용 시 참고 사항
-
작업 이름은 대소문자를 구분해요.
-
작업 이름을 지정하면 활성 선행 작업과 일치해야 하며, 그렇지 않으면 호출이 실패해요.
예시
이 함수의 전체 예시는 SYSTEM$SET_RETURN_VALUE를 참고하세요.