Ce document explique comment importer des métadonnées depuis Oracle dans Knowledge Catalog (anciennement Dataplex Universal Catalog) à l'aide d'un connecteur Knowledge Catalog.
Ce connecteur est compatible avec les instances Oracle hébergées sur site, surGoogle Cloudou dans d'autres environnements cloud.
Avant de commencer
Rôles et autorisations IAM
Pour créer et gérer un job de connecteur Knowledge Catalog, vous devez disposer de rôles Identity and Access Management (IAM) qui accordent des autorisations pour Knowledge Catalog et le service de transfert de données BigQuery.
Pour obtenir les autorisations nécessaires pour configurer un connecteur Oracle, demandez à votre administrateur de vous accorder les rôles IAM suivants :
- Pour créer et gérer des groupes d'entrées :
Administrateur de catalogue Dataplex
(
roles/dataplex.catalogAdmin), Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor) ou Propriétaire du groupe d'entrées Dataplex (roles/dataplex.entryGroupOwner) sur le projet. - Pour créer et gérer des jobs de transfert du service de transfert de données BigQuery :
Administrateur BigQuery
(
roles/bigquery.admin) sur le projet. - Pour afficher les journaux dans Cloud Logging :
Lecteur de journaux
(
roles/logging.viewer) sur le projet.
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). Vous pouvez attribuer ce rôle au niveau du projet ou du groupe d'entrées.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Activer les API
Activez les API Knowledge Catalog et Service de transfert de données BigQuery.
Prérequis pour Oracle
Assurez-vous de remplir les conditions préalables pour les transferts Oracle. Pour en savoir plus, consultez la section Conditions requises pour Oracle dans la documentation du service de transfert de données BigQuery.
Conditions préalables de mise en réseau
Une pièce jointe réseau pour la connexion via Private Service Connect est requise lorsque vous vous connectez de manière sécurisée à des bases de données externes ou à des sources de données cloud tierces avec une adresse IP privée dans un réseau privé, afin de permettre au service de transfert de données BigQuery d'accéder à votre base de données.
Si vous vous connectez à un environnement sur site ou à une instance hébergée dans le cloud à l'aide d'une adresse IP publique, un rattachement réseau n'est pas nécessaire.
Configurer un connecteur Oracle
Dans la console Google Cloud , accédez à la page Knowledge Catalog.
Dans le menu de navigation, dans la section Gérer, cliquez sur Connecteurs.
Cliquez sur Ajouter une connexion.
Dans la liste Connecteurs, sélectionnez la carte Oracle.
Dans la section Détails de la source de données, fournissez les informations de connexion pour votre instance Oracle :
- Sous Rattachement de réseau, sélectionnez un rattachement de réseau existant si nécessaire ou créez-en un.
- Saisissez l'hôte, le port, le nom de la base de données, le type de connexion, le nom d'utilisateur et le mot de passe.
- Si vous utilisez TLS, sélectionnez un mode TLS et fournissez un certificat PEM de confiance. Pour en savoir plus, consultez la section Configuration TLS.
- Pour les objets de métadonnées Oracle à importer, cliquez sur Parcourir pour sélectionner les objets.
Dans la section Paramètres de destination :
- Cliquez sur Parcourir et sélectionnez un groupe d'entrées Knowledge Catalog existant pour stocker les métadonnées importées, ou cliquez sur Créer un groupe d'entrées.
- Indiquez si vous souhaitez définir les autorisations du groupe d'entrées maintenant ou plus tard.
Nous vous recommandons de définir des autorisations permettant aux utilisateurs de consulter les métadonnées importées. Si vous n'avez pas attribué le rôle Importateur de groupes d'entrées Dataplex (
roles/dataplex.entryGroupImporter) ni l'autorisationdataplex.entryGroups.importà l'agent de service de transfert de données BigQuery (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) au niveau du projet, vous devez l'attribuer au niveau du groupe d'entrées.
Dans la section Nom de la configuration du connecteur, sous Nom à afficher, saisissez le nom du job d'importation de métadonnées.
Dans la section Options de programmation, configurez la fréquence du job d'importation de métadonnées. Si vous sélectionnez À la demande, le job ne s'exécute que lorsque vous le déclenchez manuellement.
Facultatif : Dans la section Options de notification, configurez les notifications par e-mail ou Pub/Sub en cas d'échec des jobs.
Facultatif : Dans la section Options avancées, configurez les paramètres de chiffrement. Si vous sélectionnez une clé de chiffrement gérée par le client (CMEK), notez que cette clé est utilisée pour chiffrer toutes les données transitoires préparées avant le début des tâches d'importation des métadonnées du Knowledge Catalog. Il n'est pas utilisé pour chiffrer les métadonnées dans le groupe d'entrées Knowledge Catalog de destination.
Cliquez sur Enregistrer.
Une fois le job créé, Knowledge Catalog planifie la première exécution en fonction de votre configuration. Vous pouvez également la démarrer manuellement.
Étapes suivantes
- Découvrez comment gérer les jobs de connecteur.