카테고리:

시스템 함수 (시스템 정보)

SYSTEM$LOCATE_DBT_ARCHIVE

지정된 dbt 프로젝트에 대해 압축된 dbt 실행 아티팩트를 검색할 수 있는 URL을 반환합니다.

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

구문

SYSTEM$LOCATE_DBT_ARCHIVE ( '<query_id>' )
Copy

인자

query_id

파일을 찾으려는 dbt 프로젝트 실행의 쿼리 ID입니다.

반환

이 함수는 지정된 dbt 프로젝트 결과의 압축된 내용을 검색할 수 있는 URL을 반환합니다.

자세한 내용과 예는 프로그래밍 방식으로 dbt 아티팩트 및 로그에 액세스 섹션을 참조하세요.

액세스 제어 요구 사항

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

  • 작업 공간에 대한 OWNERSHIP 또는 USAGE

  • dbt 프로젝트에 대한 OWNERSHIP, USAGE 또는 MONITOR

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트

  • 이 시스템 함수는 dbt 프로젝트 오브젝트에서만 작동하며 작업 공간에는 사용할 수 없습니다.

  • CREATE DBT PROJECT 또는 ALTER DBT PROJECT … ADD VERSION에서 생성된 쿼리 IDs는 이 시스템 함수에서 지원되지 않습니다.

  • 파일 내용의 직접 쿼리(예: 쿼리의 예)는 지원되지 않습니다.

  • :code:`query_id`가 NULL이거나 dbt 실행이 아닌 경우 오류가 발생합니다.

  • dbt 프로젝트 결과는 최대 14일 동안 사용할 수 있습니다.

  • 파일이 업로드되기 전에 실행 시간이 초과되거나 취소되거나 실패하면 파일을 사용하지 못할 수 있습니다. 이러한 경우 실행은 dbt 기록에 :code:`UNHANDLED ERROR`로 표시됩니다.

  • 로그 파일은 실행이 완료된 후에만 사용할 수 있으므로 진행 중인 실행에 대한 로그를 가져오는 데는 이 함수를 사용할 수 없습니다.

예

다음 예는 지정된 실행에 대한 압축된 아티팩트(예: dbt_artifacts.zip)의 :code:`snow://`URL을 반환합니다.

GET과 함께 이 URL을 사용하여 ZIP 파일을 다운로드할 수 있습니다(또는 COPY FILES을 사용하여 자체 스테이지로 이동). ZIP이 아닌 폴더 경로의 경우 :doc:`/sql-reference/functions/system_locate_dbt_artifacts`를 사용하세요.

SELECT SYSTEM$LOCATE_DBT_ARCHIVE($latest_query_id);
Copy

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

언어: 한국어