Gérer les métadonnées des dépôts Dataform avec Dataplex Universal Catalog
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document explique comment utiliser Dataplex Universal Catalog pour afficher les métadonnées des dépôts Dataform et les annoter avec des aspects.
Dataplex Universal Catalog vous permet de stocker et de gérer vos métadonnées.
Les dépôts Dataform sont disponibles dans Dataplex Universal Catalog par défaut, sans aucune configuration supplémentaire.
Dataplex Universal Catalog récupère automatiquement les métadonnées suivantes à partir des dépôts Dataform :
Nom de l'élément de données
Parent de l'élément de données
Emplacement de l'élément de données
Type d'élément de données
Projet Google Cloud correspondant
Source du dépôt tiers
Compte de service
Avant de commencer
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Gérer les métadonnées dans Dataplex Universal Catalog
Dataplex Universal Catalog enregistre les dépôts Dataform en tant qu'entrées avec les valeurs d'entrée suivantes :
Groupe d'entrées système
Le groupe d'entrées système pour les dépôts Dataform est @dataform. Pour afficher les détails des entrées de dépôt dans Dataplex Universal Catalog, vous devez afficher le groupe d'entrées système dataform.
Pour savoir comment afficher la liste de toutes les entrées d'un groupe d'entrées, consultez Afficher les détails d'un groupe d'entrées dans la documentation Dataplex Universal Catalog.
Type d'entrée système
Le type d'entrée système pour les dépôts Dataform est dataform-repository.
Pour afficher les détails des dépôts Dataform, vous devez afficher le type d'entrée système dataform-repository.
Pour savoir comment afficher les détails d'un type d'entrée sélectionné, consultez Afficher les détails d'un type d'entrée dans la documentation Dataplex Universal Catalog.
Pour savoir comment afficher les détails d'une entrée sélectionnée, consultez Afficher les détails d'une entrée dans la documentation Dataplex Universal Catalog.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]
