카테고리:: Information Schema , 테이블 함수

DBT_PROJECT_EXECUTION_HISTORY¶

:doc:`Snowflake에서 dbt 프로젝트</user-guide/data-engineering/dbt-projects-on-snowflake>`의 실행 기록을 반환합니다.

이 함수를 호출하여 현재 시간으로부터 7일 이내에 이전 dbt 프로젝트 실행의 메타데이터와 결과를 가져옵니다. 선택적으로 결과를 필터링하는 기준이 되는 값을 지정합니다.

이 함수를 다음 시스템 함수와 함께 사용하여 dbt 아티팩트 및 로그에 프로그래밍 방식으로 액세스합니다.

자세한 내용은 프로그래밍 방식으로 dbt 아티팩트 및 로그에 액세스 섹션을 참조하십시오.

참고 항목:: CREATE DBT PROJECT, EXECUTE DBT PROJECT

구문¶

DBT_PROJECT_EXECUTION_HISTORY (
  [ OBJECT_NAME => '<name>' ]
  [ , OBJECT_TYPE = { WORKSPACE | DBT PROJECT }]
  [ , START_TIME_RANGE_START => <start_time> ]
  [ , START_TIME_RANGE_END => <end_time>  ]
  [ , RESULT_LIMIT = <integer> ]
  [ , COMMAND = <dbt_command> ]
  [ , USER_NAME = <user_name> ]
  [ , DATABASE = <db_name> ]
  [ , SCHEMA = <schema_name> ]
)

Copy

인자¶

OBJECT_NAME = <name>

해당 실행이 속한 작업 공간 또는 dbt 프로젝트의 이름입니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

OBJECT_TYPE = { WORKSPACE | DBT PROJECT }

해당 실행이 속한 오브젝트의 유형(WORKSPACE 또는 DBT PROJECT)입니다.

START_TIME_RANGE_START | START_TIME_RANGE_END = timestamp

dbt 프로젝트 실행 범위를 필터링하는 타임스탬프입니다.

RESULT_LIMIT = integer

함수가 반환하는 최대 행 수를 지정하는 정수로, 1~10,000(포함)입니다.

기본값: 100

COMMAND = dbt_command

dbt 프로젝트를 실행하는 데 사용되는 `dbt 명령`_을 지정합니다.

USER_NAME = user_name

dbt 프로젝트 오브젝트 실행을 시작한 사용자의 이름입니다.

DATABASE = db_name

지정된 데이터베이스에 대한 레코드만 반환합니다.

SCHEMA = schema_name

지정된 스키마에 대한 레코드만 반환합니다.

출력¶

이 함수는 다음 열을 반환합니다.

이러한 열을 보려면 MONITOR 권한이 있는 역할을 사용해야 합니다.

열 이름	데이터 타입	설명
QUERY_ID	TEXT	쿼리의 ID입니다.
QUERY_START_TIME	TIMESTAMP_LTZ	쿼리가 시작된 시간입니다.
QUERY_END_TIME	TIMESTAMP_LTZ	쿼리가 종료된 시간입니다.
USER_NAME	TEXT	dbt 프로젝트를 생성한 사용자입니다.
OBJECT_NAME	TEXT	해당 실행이 속한 작업 공간 또는 dbt 프로젝트의 이름입니다.
OBJECT_TYPE	TEXT	오브젝트 유형(예: WORKSPACE 또는 DBT PROJECT)입니다.
DATABASE_NAME	TEXT	오브젝트의 데이터베이스입니다.
SCHEMA_NAME	TEXT	오브젝트의 스키마입니다.
COMMAND	TEXT	오브젝트에 대해 실행된 명령입니다.
ARGS	TEXT	오브젝트에 대한 실행에 사용된 인자입니다.
ERROR_CODE	NUMBER	해당하는 경우, 실행에 대한 오류 코드입니다.
ERROR_MESSAGE	TEXT	해당하는 경우, 실행이 실패한 이유를 설명하는 오류 메시지입니다.
WAREHOUSE	TEXT	오브젝트에 사용되는 웨어하우스입니다.
STATE	TEXT	실행 상태(예: HANDLED_ERROR 또는 SUCCESS)입니다.

액세스 제어 요구 사항¶

이 테이블 함수에는 다음 권한이 있는 작업 공간 및 dbt 프로젝트의 실행만 포함됩니다.

작업 공간에 대한 OWNERSHIP 또는 USAGE
dbt 프로젝트에 대한 OWNERSHIP, USAGE 또는 MONITOR

사용법 노트¶

정확한 dbt 프로젝트 이름을 사용합니다(따옴표로 묶은 경우 대/소문자 구분). 일치하는 행이 없으면(잘못된 dbt 프로젝트 이름 또는 아직 실행되지 않은 경우) Inputs may not be null. 오류가 발생할 수 있습니다.

예¶

DBT_PROJECT_EXECUTION_HISTORY 테이블 함수의 사용 예제는 프로그래밍 방식으로 dbt 아티팩트 및 로그에 액세스 섹션을 참조하세요.