Gerenciar metadados de repositórios do Dataform com o Dataplex Universal Catalog
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como usar o Dataplex Universal Catalog para visualizar metadados de repositórios do Dataform e adicionar aspectos a eles.
Com o Dataplex Universal Catalog, é possível armazenar e gerenciar seus metadados.
Os repositórios do Dataform estão disponíveis no Dataplex Universal Catalog
por padrão, sem nenhuma configuração extra.
O Dataplex Universal Catalog recupera automaticamente
os seguintes metadados dos repositórios do Dataform:
Nome do recurso de dados
Recurso de dados principal
Local do recurso de dados
Tipo de recurso de dados
Projeto Google Cloud correspondente
Origem do repositório de terceiros
Conta de serviço
Antes de começar
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
O Dataplex Universal Catalog registra repositórios do Dataform como entradas com os seguintes valores de entrada:
Grupo de entradas do sistema
O grupo de entrada do sistema
para repositórios do Dataform é @dataform. Para conferir os detalhes das entradas do repositório no Dataplex Universal Catalog, acesse o grupo de entradas do sistema dataform.
Para instruções sobre como conferir uma lista de todas as entradas em um grupo de entradas, consulte
Ver detalhes de um grupo de entradas
na documentação do Dataplex Universal Catalog.
Tipo de entrada do sistema
O tipo de entrada do sistema
para repositórios do Dataform é dataform-repository.
Para conferir os detalhes dos repositórios do Dataform,
é necessário acessar o tipo de entrada do sistema dataform-repository.
Para instruções sobre como ver detalhes de um tipo de entrada selecionado, consulte
Ver detalhes de um tipo de entrada
na documentação do Dataplex Universal Catalog.
Para instruções sobre como ver detalhes de uma entrada selecionada, consulte
Ver detalhes de uma entrada
na documentação do Dataplex Universal Catalog.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]