Ce document explique comment afficher, mettre à jour et supprimer les jobs de connecteur Knowledge Catalog (anciennement Dataplex Universal Catalog) utilisés pour l'importation de métadonnées.
Avant de commencer
Pour gérer les jobs de connecteur, vous avez besoin des rôles IAM appropriés. Pour en savoir plus, consultez Rôles IAM.
- Pour afficher les jobs et l'historique des exécutions :
- Utilisateur BigQuery (
roles/bigquery.user) - Lecteur Dataplex (
roles/dataplex.viewer)
- Utilisateur BigQuery (
- Pour modifier, supprimer ou déclencher manuellement des tâches :
- Administrateur BigQuery (
roles/bigquery.admin) - Administrateur Dataplex (
roles/dataplex.admin) ou Éditeur Dataplex (roles/dataplex.editor)
- Administrateur BigQuery (
Vous devez activer le service de transfert de données BigQuery.
De plus, vous devez accorder à l'agent de service de transfert de données BigQuery (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) l'autorisation dataplex.entryGroups.import ou le rôle Importateur de groupes d'entrées Dataplex (roles/dataplex.entryGroupImporter). Il peut être accordé au niveau du projet ou du groupe d'entrées.
Afficher les tâches du connecteur
Dans la console Google Cloud , accédez à la page Knowledge Catalog.
Dans le menu de navigation, dans la section Gérer, cliquez sur Connecteurs. La page Connecteurs liste tous les jobs d'importation de métadonnées de votre projet.
Pour afficher les détails, l'historique d'exécution ou la configuration d'un job spécifique, cliquez sur son nom à afficher dans la liste.
Afficher l'historique d'exécution et les journaux des jobs
Pour n'importe quel job de connecteur, vous pouvez afficher l'historique de ses exécutions, y compris celles qui ont réussi et celles qui ont échoué. Les exécutions de jobs datant de plus de 90 jours sont automatiquement supprimées.
- Sur la page Connecteurs, cliquez sur le nom à afficher du job que vous souhaitez consulter.
- Cliquez sur l'onglet Historique d'exécution. Cet onglet affiche les exécutions de jobs récentes.
- Pour afficher les journaux d'une exécution spécifique, recherchez-la dans la liste, puis cliquez sur Afficher les détails.
Journalisation et surveillance
Les connecteurs de métadonnées Knowledge Catalog exportent les journaux et les métriques vers Cloud Monitoring et Cloud Logging afin d'offrir une observabilité sur vos configurations d'importation. Vous pouvez utiliser Monitoring pour configurer des tableaux de bord afin de surveiller les configurations d'importation de métadonnées, d'évaluer les performances d'exécution et d'afficher les messages d'erreur pour résoudre les échecs d'exécution. Vous pouvez utiliser Logging pour afficher les journaux liés à une exécution ou à une configuration.
Mettre à jour un job de connecteur
Vous pouvez modifier la configuration d'un job existant, y compris sa planification, son groupe d'entrées de destination, ses paramètres de notification et les objets sources à importer.
- Sur la page Connecteurs, cliquez sur le nom à afficher du job que vous souhaitez mettre à jour.
- Cliquez sur Modifier.
- Modifiez la configuration du job si nécessaire.
- Cliquez sur Enregistrer.
Désactiver ou activer un job de connecteur
Lorsque vous désactivez un job, son nom est mis à jour avec l'état disabled et aucune nouvelle exécution de job n'est planifiée. Toutes les exécutions déjà en cours sont terminées.
La désactivation d'un job ne supprime pas les métadonnées déjà importées dans Knowledge Catalog.
- Sur la page Connecteurs, recherchez le job que vous souhaitez désactiver ou activer.
- Cliquez sur Actions, puis sélectionnez Désactiver ou Activer.
Supprimer un job de connecteur
Lorsque vous supprimez un job, aucune nouvelle exécution n'est planifiée et toutes les exécutions en cours sont arrêtées. La suppression d'un job n'entraîne pas la suppression des métadonnées déjà importées dans Knowledge Catalog.
- Sur la page Connecteurs, recherchez le job que vous souhaitez supprimer.
- Cliquez sur Actions, puis sélectionnez Supprimer.
- Pour confirmer, saisissez
delete, puis cliquez sur Supprimer.
Déclencher manuellement un job
Vous pouvez démarrer une exécution de job en dehors de sa planification habituelle. On parle parfois de remplissage.
- Sur la page Connecteurs, cliquez sur le nom à afficher du job que vous souhaitez exécuter.
Cliquez sur Exécuter le transfert maintenant, puis sélectionnez Exécuter un transfert ponctuel.