기존 dbt 프로젝트에 대한 정보 보기 및 관리¶

이 항목에서는 기존 dbt 프로젝트 오브젝트의 구조와 메타데이터를 탐색하는 방법을 다룹니다. 여기에는 프로젝트의 DAG 보기, 모델 및 소스 세부 정보 검사, dbt 프로젝트 실행이 포함됩니다.

프로젝트 DAG를 탐색하여 모델 계보 및 종속성 확인하기¶

Directed Acyclic Graph(DAG)는 dbt 모델이 서로 어떻게 의존하는지 보여주며 데이터 계보를 시각화하여 다음을 수행할 수 있습니다.

모델이 빌드된 위치(database.schema), 구체화 방법, 어떤 업스트림 및 다운스트림 종속성이 있는지 확인합니다.
더 나은 성능과 확장성을 지원하기 위해 비효율적인 모델 설계를 찾아내고 개선합니다.

Snowsight 에서 DAG 프로젝트를 찾아보려면 Databases » 데이터베이스 » 스키마 » dbt Projects 로 이동하여 프로젝트를 선택합니다. 프로젝트 세부 정보 페이지에는 프로젝트의 Description, dbt Project definition, Privileges 와 함께 모델의 Graph 및 해당 관계가 표시됩니다.

Graph 에서 모델 노드를 클릭하여 DAG에서 직접 모델, 소스 또는 테스트 세부 정보(예: 컴파일된 SQL 및 구성)를 검사합니다.

팁

작업 공간에서 작업하는 경우 작업 공간 편집기에서 Connect » View project 를 선택하여 프로젝트 세부 정보 페이지로 이동할 수도 있습니다. 자세한 내용은 Workspaces for dbt Projects on Snowflake 섹션을 참조하십시오.

DAG에서 모델 세부 정보 검사¶

DAG에서 모델 노드를 선택하면 모델 세부 정보 뷰가 열리고 다음이 표시됩니다.

모델의 유형, 파일 경로, 대상 오브젝트, 행 수, 열 수.
모델에 대한 설명(dbt 프로젝트에 정의된 경우).
모델 계보, 업스트림 및 다운스트림 종속성(해당 종속성 간에 이동할 수 있는 링크 포함).
소스 및 컴파일된 SQL(모델의 경우).

DAG에서 모델 실행¶

모델 노드에서 … 메뉴를 선택하여 DAG에서 직접 dbt 프로젝트의 하위 세트를 실행할 수 있습니다. 다음 실행 옵션을 사용할 수 있습니다.


메뉴 옵션	실행 항목	해당 `--select` 플래그
Execute model	선택한 모델만	`--select model_name`
Execute model+	모델 및 모든 다운스트림 종속 항목	`--select model_name+`
Execute +model	모델 및 모든 업스트림 상위 항목	`--select +model_name`
Execute +model+	모델, 해당 상위 모델, 해당 하위 모델	`--select +model_name+`

옵션을 선택하면 Additional flags 필드에 해당 --select 값이 미리 채워진 Execute dbt project 대화 상자가 열립니다. 대화 상자에서 다음을 수행할 수 있습니다.

Run, Test, Build 등의 작업을 선택합니다.
프로필 대상을 선택합니다(예: dev 또는 prod).
선택 항목을 구체화하려면 실행하기 전에 플래그를 편집합니다.

SQL 및 Snowflake CLI의 + 그래프 연산자와 함께 동일한 --select 구문을 사용할 수 있습니다.

EXECUTE DBT PROJECT my_dbt_project
  ARGS = 'build --select +stg_customers+ --target dev';

지원되는 dbt 명령 및 플래그에 대한 자세한 내용은 지원되는 dbt 명령 및 플래그 섹션을 참조하세요.

dbt 프로젝트 오브젝트 속성 보기¶

Snowflake가 dbt 프로젝트 오브젝트에 대해 저장하는 메타데이터를 확인하여 이름, 소유자, 기본값 버전, Snowflake의 내부 snow://dbt/... 스테이지에서 해당 파일의 위치를 확인합니다.

특정 dbt 프로젝트의 속성(예: 이름, 소유자, 설명)을 보려면 다음 예제와 같이 DESCRIBE DBT PROJECT 명령을 사용합니다.

DESCRIBE DBT PROJECT my_dbt_project;

출력에는 오브젝트의 이름, 소유자, 설명, 버전 관리 세부 정보, 외부 액세스 통합이 표시됩니다. 자세한 내용은 DESCRIBE DBT PROJECT 섹션을 참조하십시오.

모든 dbt 프로젝트 보기¶

액세스할 수 있는 모든 dbt 프로젝트 오브젝트와 키 메타데이터를 보려는 경우 SHOW DBT PROJECTS를 사용합니다.

SHOW DBT PROJECTS IN DATABASE mydb;

출력에는 각 오브젝트의 데이터베이스, 스키마, 소유자, 설명, 오브젝트가 생성되고 마지막으로 업데이트된 시간, 버전 관리 세부 정보, 외부 액세스 통합이 표시됩니다. 자세한 내용은 SHOW DBT PROJECTS 섹션을 참조하십시오.

또는 snow dbt list 명령을 사용합니다. 자세한 내용은 사용 가능한 모든 dbt 프로젝트 오브젝트 나열 섹션을 참조하십시오.