Gestionar los metadatos de los repositorios de Dataform con Dataplex Universal Catalog
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
En este documento se describe cómo usar Dataplex Universal Catalog para ver los metadatos de los repositorios de Dataform y añadirles anotaciones con aspectos.
Dataplex Universal Catalog te permite almacenar y gestionar tus metadatos.
Los repositorios de Dataform están disponibles en Dataplex Universal Catalog de forma predeterminada, sin necesidad de ninguna configuración adicional.
Dataplex Universal Catalog recupera automáticamente los siguientes metadatos de los repositorios de Dataform:
Nombre del recurso de datos
Recurso de datos principal
Ubicación del recurso de datos
Tipo de recurso de datos
Proyecto Google Cloud correspondiente
Fuente de repositorio de terceros
Cuenta de servicio
Antes de empezar
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Dataplex Universal Catalog registra los repositorios de Dataform como entradas con los siguientes valores de entrada:
Grupo de entradas del sistema
El grupo de entradas del sistema
de los repositorios de Dataform es @dataform. Para ver los detalles de las entradas del repositorio en Dataplex Universal Catalog, debes ver el dataform
grupo de entradas del sistema.
Para obtener instrucciones sobre cómo ver una lista de todas las entradas de un grupo de entradas, consulta Ver los detalles de un grupo de entradas en la documentación de Dataplex Universal Catalog.
Tipo de entrada del sistema
El tipo de entrada del sistema
de los repositorios de Dataform es dataform-repository.
Para ver los detalles de los repositorios de Dataform, debes consultar el tipo de entrada del sistema dataform-repository.
Para obtener instrucciones sobre cómo ver los detalles de un tipo de entrada seleccionado, consulta el artículo Ver los detalles de un tipo de entrada de la documentación de Universal Catalog de Dataplex.
Para obtener instrucciones sobre cómo ver los detalles de una entrada seleccionada, consulta la sección Ver los detalles de una entrada de la documentación de Dataplex Universal Catalog.
Buscar recursos
Para obtener instrucciones sobre cómo buscar recursos de datos en Dataplex Universal Catalog, consulta el artículo Buscar recursos de datos en Dataplex Universal Catalog de la documentación de Dataplex Universal Catalog.
Anotar repositorios
Para proporcionar contexto adicional a los repositorios de Dataform en Dataplex Universal Catalog, puedes anotar las entradas de Dataform con aspectos.
El tipo de aspecto del sistema de los repositorios de Dataform es dataform-repository.
Para obtener instrucciones sobre cómo anotar entradas con aspectos, consulta el artículo Gestionar aspectos y enriquecer metadatos de la documentación de Dataplex Universal Catalog.
Limitaciones
La gestión de repositorios de Dataform en Dataplex Universal Catalog está disponible con las siguientes limitaciones:
No puedes ver ni gestionar recursos a nivel de archivo de Dataform en Dataplex Universal Catalog (por ejemplo, tablas o vistas).
Ubicaciones
Puedes usar Dataplex Universal Catalog para gestionar repositorios de Dataform desde todas las ubicaciones de Dataform.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
