Faça a gestão dos metadados dos repositórios do Dataform com o catálogo universal do Dataplex
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este documento descreve a utilização do catálogo universal do Dataplex
para ver metadados de repositórios do Dataform
e anotá-los com aspetos.
O catálogo universal do Dataplex permite-lhe armazenar e gerir os seus metadados.
Os repositórios do Dataform estão disponíveis no catálogo universal do Dataplex
por predefinição, sem configuração adicional.
O catálogo universal do Dataplex obtém automaticamente os seguintes metadados dos repositórios do Dataform:
Nome do recurso de dados
Recurso de dados principal
Localização 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.
Faça a gestão de metadados no catálogo universal do Dataplex
O catálogo universal do Dataplex regista 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 ver os detalhes das entradas do repositório no catálogo universal do Dataplex, tem de ver o dataformgrupo de entradas do sistema.
Para ver instruções sobre como ver uma lista de todas as entradas num grupo de entradas, consulte o artigo
Ver detalhes de um grupo de entradas
na documentação do catálogo universal do Dataplex.
Tipo de entrada do sistema
O tipo de entrada do sistema
para repositórios do Dataform é dataform-repository.
Para ver detalhes dos repositórios do Dataform,
tem de ver o tipo de entrada do sistema dataform-repository.
Para ver instruções sobre como ver os detalhes de um tipo de entrada selecionado, consulte o artigo
Ver detalhes de um tipo de entrada
na documentação do catálogo universal do Dataplex.
Para ver instruções sobre como ver os detalhes de uma entrada selecionada, consulte o artigo
Ver detalhes de uma entrada
na documentação do catálogo universal do Dataplex.
Para fornecer contexto adicional aos repositórios do Dataform no
catálogo universal do Dataplex, pode anotar as entradas do Dataform
com aspetos.
O tipo de aspeto do sistema para repositórios do Dataform é dataform-repository.
Para ver instruções sobre como anotar entradas com aspetos, consulte o artigo
Gerir aspetos e enriquecer metadados
na documentação do catálogo universal do Dataplex.
Limitações
A gestão de repositórios do Dataform no catálogo universal do Dataplex está disponível com as seguintes limitações:
Não pode ver nem gerir recursos ao nível do ficheiro do Dataform no
Catálogo universal do Dataplex, por exemplo, tabelas ou vistas.
Localizações
Pode usar o catálogo universal do Dataplex para gerir repositórios do Dataform
de todas as localizações do Dataform.
[[["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-08-21 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."]]
