Avant de pouvoir utiliser Knowledge Catalog (anciennement Dataplex Universal Catalog), vous devez activer les API nécessaires dans votre Google Cloud projet. Ce document vous explique comment activer l'API Dataplex et d'autres services requis.
Par mesure de sécurité, une organisation peut contrôler qui est autorisé à activer les API. Dans certains cas, l'activation des API entraîne le début de la facturation. Les organisations peuvent donc restreindre l'accès pour contrôler les coûts. Pour obtenir plus d'informations sur Service Usage dans Google Cloud, consultez Activer et désactiver des services.
Une fois les API activées, Knowledge Catalog ingère automatiquement et maintient les métadonnées à jour à partir des sources de données Google Cloud prises en charge.
Avant de commencer
Pour activer et désactiver l'API Dataplex, vous devez disposer du rôle Propriétaire (
roles/owner), Éditeur (roles/editor) ou Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Pour en savoir plus sur les rôles et les autorisations, consultez Gérer l'accès avec IAM.
Activer Knowledge Catalog
Vous pouvez utiliser un projet existant avec Knowledge Catalog ou en créer un. Nous vous recommandons de créer un projet. Si vous utilisez un nouveau Google Cloud projet ou un projet dans lequel l'API BigQuery est activée, l'API Dataplex est activée par défaut. Toutefois, vous devez toujours activer l'API Dataproc et l'API Dataproc Metastore.
Pour que les ressources créées par le lac restent dans votre projet et soient séparées les unes des autres, créez un projet par instance de lac.
Pour créer un projet et activer Knowledge Catalog, procédez comme suit :
- Dans la Google Cloud console, sélectionnez ou créez un projet.
- Assurez-vous que la facturation est activée pour votre projet.
-
Activez les API Dataplex, Managed Service pour Apache Spark et Dataproc Metastore.
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation
serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.
Désactiver Knowledge Catalog
Si vous utilisez Knowledge Catalog dans un projet qui utilise également BigQuery, tenez compte des effets sur le comportement de BigQuery lorsque vous désactivez Knowledge Catalog.
Pour éviter des frais supplémentaires, effectuez les étapes suivantes avant de désactiver Knowledge Catalog :
Dans la Google Cloud console, supprimez chaque instance de lac de votre projet. Pour supprimer un lac de données, vous devez d'abord supprimer les éléments et les zones individuels. Pour en savoir plus, consultez
projects.locations.lakes.delete.Dans la Google Cloud console, supprimez tous les groupes d'entrées personnalisés de votre projet. La suppression d'un groupe d'entrées entraîne celle de toutes les entrées qui lui appartiennent. Pour en savoir plus, consultez Supprimer un groupe d'entrées.
Sélectionnez le projet dans lequel désactiver l'API Dataplex.
Accédez à la page API et services activés.
Cliquez sur API Cloud Dataplex.
Cliquez sur Désactiver l'API. Confirmez l'opération lorsque vous y êtes invité.
Si vous avez également activé l'API Data Lineage, répétez les étapes pour la désactiver. La désactivation de l'API Dataplex ne désactive pas l'API Data Lineage ni n'arrête ses frais de traitement Premium. Pour en savoir plus, consultez Désactiver la traçabilité des données.
Étape suivante
- Découvrez comment rechercher des ressources.
- Découvrez comment mesurer la qualité des données.
- Découvrez les métadonnées dans Knowledge Catalog.
- Suivez un guide de démarrage rapide : Suivre la traçabilité des données pour une table BigQuery.
- Découvrez les cas d'utilisation de Knowledge Catalog.