Knowledge Catalog로 Dataform 저장소의 메타데이터 관리

이 문서에서는 Knowledge Catalog를 사용하여 Dataform 저장소의 메타데이터를 보고 관점으로 주석을 추가하는 방법을 설명합니다.

Knowledge Catalog를 사용하면 메타데이터를 저장하고 관리할 수 있습니다. Dataform 저장소는 추가 구성 없이 기본적으로 Knowledge Catalog에서 사용할 수 있습니다. Knowledge Catalog는 Dataform 저장소에서 다음 메타데이터를 자동으로 검색합니다.

  • 데이터 애셋 이름
  • 데이터 애셋 상위 항목
  • 데이터 애셋 위치
  • 데이터 애셋 유형
  • 해당 Google Cloud 프로젝트
  • 서드 파티 저장소 소스
  • 서비스 계정

시작하기 전에

  1. Google Cloud 콘솔의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트를 선택하거나 만드는 데 필요한 역할

    • 프로젝트 선택: 프로젝트를 선택하는 데는 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택하면 됩니다.
    • 프로젝트 만들기: 프로젝트를 만들려면 resourcemanager.projects.create 권한이 포함된 프로젝트 생성자 역할(roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기

    프로젝트 선택기로 이동

  2. Dataplex API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기

    API 사용 설정하기

  3. 필요한 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

필요한 역할

Knowledge Catalog에서 Dataform 저장소를 관리하려면 Dataform 리소스에 대한 액세스 권한을 부여하는 사전 정의된 Dataform 역할과 필요한 Knowledge Catalog 역할이 있어야 합니다.

Knowledge Catalog에서 메타데이터 관리

Knowledge Catalog는 Dataform 저장소를 다음과 같은 항목 값을 사용해 항목으로 로깅합니다.

시스템 항목 그룹
Dataform 저장소의 시스템 항목 그룹은 @dataform입니다. Knowledge Catalog에서 저장소 항목의 세부정보를 보려면 dataform 시스템 항목 그룹을 확인해야 합니다. 항목 그룹의 모든 항목 목록을 보는 방법에 관한 안내는 Knowledge Catalog 문서의 항목 그룹 세부정보 보기를 참고하세요.
시스템 항목 유형
Dataform 저장소의 시스템 항목 유형은 dataform-repository입니다. Dataform 저장소의 세부정보를 보려면 dataform-repository 시스템 항목 유형을 확인해야 합니다. 선택한 항목 유형의 세부정보를 보는 방법에 관한 안내는 Knowledge Catalog 문서의 항목 유형의 세부정보 보기를 참고하세요. 선택한 항목의 세부정보를 보는 방법에 관한 안내는 Knowledge Catalog 문서의 항목 세부정보 보기를 참고하세요.

애셋 검색

Knowledge Catalog에서 데이터 애셋을 검색하는 방법에 관한 안내는 Knowledge Catalog 문서의 Knowledge Catalog에서 데이터 애셋 검색을 참고하세요.

저장소에 주석 추가

Knowledge Catalog에서 Dataform 저장소에 추가 컨텍스트를 제공하려면 측면을 사용하여 Dataform 항목에 주석을 달면 됩니다.

Dataform 저장소의 시스템 관점 유형은 dataform-repository입니다.

관점으로 항목에 주석을 추가하는 방법에 관한 안내는 Knowledge Catalog 문서의 관점 관리 및 메타데이터 보강을 참고하세요.

제한사항

Knowledge Catalog에서 Dataform 저장소를 관리하는 데는 다음과 같은 제한사항이 적용됩니다.

  • Knowledge Catalog에서 Dataform 파일 수준 애셋(예: 테이블 또는 뷰)을 보거나 관리할 수 없습니다.

위치

Knowledge Catalog를 사용하여 모든 Dataform 위치의 Dataform 저장소를 관리할 수 있습니다.

할당량

Knowledge Catalog에서 Dataform 저장소를 관리하는 경우 Knowledge Catalog 할당량 및 한도가 적용됩니다.

가격 책정

Knowledge Catalog에서 Dataform 저장소를 관리하는 경우 Knowledge Catalog 가격 책정이 적용됩니다.

다음 단계

  • Knowledge Catalog에 대해 자세히 알아보려면 Knowledge Catalog 문서의 Knowledge Catalog 개요를 참고하세요.