Dataplex Universal Catalog를 사용하면 메타데이터를 저장하고 관리할 수 있습니다.
Dataform 저장소는 Dataplex 범용 카탈로그에서 기본적으로 추가 구성 없이 사용할 수 있습니다.
Dataplex Universal Catalog는 Dataform 저장소에서 다음 메타데이터를 자동으로 검색합니다.
데이터 애셋 이름
데이터 애셋 상위 항목
데이터 애셋 위치
데이터 애셋 유형
해당 Google Cloud 프로젝트
서드 파티 저장소 소스
서비스 계정
시작하기 전에
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Dataplex Universal Catalog는 Dataform 저장소를 다음과 같은 항목 값을 사용해 항목으로 로깅합니다.
시스템 항목 그룹
Dataform 저장소의 시스템 항목 그룹은 @dataform입니다. Dataplex Universal Catalog에서 저장소 항목의 세부정보를 보려면 dataform 시스템 항목 그룹을 확인해야 합니다.
항목 그룹의 모든 항목 목록을 보는 방법에 관한 안내는 Dataplex Universal Catalog 문서의 항목 그룹 세부정보 보기를 참조하세요.
시스템 항목 유형
Dataform 저장소의 시스템 항목 유형은 dataform-repository입니다.
Dataform 저장소의 세부정보를 보려면 dataform-repository 시스템 항목 유형을 확인해야 합니다.
선택한 항목 유형의 세부정보를 보는 방법에 관한 안내는 Dataplex Universal Catalog 문서의 항목 유형의 세부정보 보기를 참고하세요.
선택한 항목의 세부정보를 보는 방법에 관한 안내는 Dataplex Universal Catalog 문서의 항목 세부정보 보기를 참고하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eDataplex automatically integrates with Dataform repositories, making their metadata accessible without extra configuration.\u003c/p\u003e\n"],["\u003cp\u003eDataplex retrieves key metadata details from Dataform repositories, including name, parent, location, type, Google Cloud project, third-party source, and service account.\u003c/p\u003e\n"],["\u003cp\u003eDataform repositories are logged as entries in Dataplex, categorized under the \u003ccode\u003e@dataform\u003c/code\u003e system entry group and the \u003ccode\u003edataform-repository\u003c/code\u003e system entry type.\u003c/p\u003e\n"],["\u003cp\u003eYou can enhance Dataform repository entries in Dataplex by annotating them with aspects, using \u003ccode\u003edataform-repository\u003c/code\u003e as the system aspect type.\u003c/p\u003e\n"],["\u003cp\u003eManaging Dataform file-level assets, such as tables and views, within Dataplex is currently not supported, however it is subject to Dataplex quotas, limits, and pricing.\u003c/p\u003e\n"]]],[],null,["# Manage metadata of Dataform repositories with Dataplex Universal Catalog\n\nThis document describes using [Dataplex Universal Catalog](/dataplex/docs/introduction) to view metadata of Dataform repositories and annotate them with aspects.\n\n\u003cbr /\u003e\n\nDataplex Universal Catalog lets you store and manage your metadata.\nDataform repositories are available in Dataplex Universal Catalog\nby default, without any additional configuration.\nDataplex Universal Catalog automatically retrieves\nthe following metadata from Dataform repositories:\n\n- Data asset name\n- Data asset parent\n- Data asset location\n- Data asset type\n- Corresponding Google Cloud project\n- Third-party repository source\n- Service account\n\nBefore you begin\n----------------\n\n1. In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n2.\n\n\n Enable the Dataplex API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=dataplex.googleapis.com)\n3. Ensure that you have the [necessary Identity and Access Management (IAM) permissions](#required-roles).\n\n### Required roles\n\nTo manage Dataform repositories in Dataplex Universal Catalog,\nyou need the [predefined Dataform roles](/dataform/docs/access-control#predefined-roles)\nthat give you access to Dataform resources, and required\n[Dataplex Universal Catalog roles](/dataplex/docs/iam-roles).\n\nManage metadata in Dataplex Universal Catalog\n---------------------------------------------\n\nDataplex Universal Catalog logs Dataform repositories as\n[entries](/dataplex/docs/ingest-custom-sources#entries) with the following\nentry values:\n\nSystem entry group\n: The [system entry group](/dataplex/docs/ingest-custom-sources#entry-groups)\n for Dataform repositories is `@dataform`. To view details of\n repository entries in Dataplex Universal Catalog, you need to view the `dataform`\n system entry group.\n For instructions about how to view a list of all entries in an entry group, see\n [View details of an entry group](/dataplex/docs/ingest-custom-sources#entry-group-details)\n in the Dataplex Universal Catalog documentation.\n\nSystem entry type\n: The [system entry type](/dataplex/docs/ingest-custom-sources#entry-types)\n for Dataform repositories is `dataform-repository`.\n To view details of Dataform repositories,\n you need to view the `dataform-repository` system entry type.\n For instructions about how to view details of a selected entry type, see\n [View details of an entry type](/dataplex/docs/ingest-custom-sources#entry-type-details)\n in the Dataplex Universal Catalog documentation.\n For instructions about how to view details of a selected entry, see\n [View details of an entry](/dataplex/docs/search-assets#view-entry-details)\n in the Dataplex Universal Catalog documentation.\n\n### Search for assets\n\nFor instructions about how to search for data assets in Dataplex Universal Catalog, see\n[Search for data assets in Dataplex Universal Catalog](/dataplex/docs/search-assets)\nin the Dataplex Universal Catalog documentation.\n\nAnnotate repositories\n---------------------\n\nTo provide additional context to Dataform repositories in\nDataplex Universal Catalog, you can annotate Dataform entries\nwith [aspects](/dataplex/docs/enrich-entries-metadata#aspects).\n\nThe system aspect type for Dataform repositories\nis `dataform-repository`.\n\nFor instructions about how to annotate entries with aspects, see\n[Manage aspects and enrich metadata](/dataplex/docs/enrich-entries-metadata)\nin the Dataplex Universal Catalog documentation.\n\nLimitations\n-----------\n\nManaging Dataform repositories in Dataplex Universal Catalog\nis available with the following limitations:\n\n- You cannot view or manage Dataform file-level assets in Dataplex Universal Catalog---for example, tables, or views.\n\nLocations\n---------\n\nYou can use Dataplex Universal Catalog to manage Dataform repositories\nfrom all [Dataform locations](/dataform/locations).\n\nQuotas\n------\n\nManaging Dataform repositories in Dataplex Universal Catalog\nis subject to [Dataplex Universal Catalog quotas and limits](/dataplex/docs/quotas).\n\nPricing\n-------\n\nManaging Dataform repositories in Dataplex Universal Catalog\nis subject to [Dataplex Universal Catalog pricing](/dataplex/pricing).\n\nWhat's next\n-----------\n\n- To learn more about Dataplex Universal Catalog, see [Dataplex Universal Catalog overview](/dataplex/docs/introduction) in the Dataplex Universal Catalog documentation."]]
