Importer des métadonnées depuis Oracle

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment importer des métadonnées d'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, sur Google Cloud, ou dans d'autres environnements cloud.

Avant de pouvoir importer des métadonnées d'Oracle, effectuez les tâches suivantes :

1. Attribuez les rôles et autorisations requis.
2. Activez les API Knowledge Catalog et Service de transfert de données BigQuery.
3. Respectez les prérequis Oracle.
4. Respectez les prérequis de mise en réseau.

Rôles et autorisations IAM

Pour créer et gérer une tâche de connecteur Knowledge Catalog, vous avez besoin de rôles Identity and Access Management (IAM) qui accordent des autorisations pour Knowledge Catalog et 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 tâches 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 Service de transfert de données BigQuery ([e-mail]) l'autorisation dataplex.entryGroups.import ou le rôle importateur de groupe d'entrées Dataplex (roles/dataplex.entryGroupImporter). Vous pouvez accorder 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.

Activer les API

Prérequis pour Oracle

Assurez-vous de respecter les prérequis pour les transferts Oracle. Pour en savoir plus, consultez la section Prérequis Oracle dans la documentation du Service de transfert de données BigQuery.

En plus des prérequis du Service de transfert de données BigQuery, votre instance Oracle doit répondre aux exigences suivantes :

• Version minimale : Oracle version 12 ou ultérieure est requise pour prendre en charge les attributs de métadonnées de base de données, tels que type et parentContainer.

• Privilèges minimaux : vous devez accorder les privilèges suivants à l'utilisateur de la base de données :

  Autorisations de base (requises pour toutes les configurations) :

  GRANT SELECT_CATALOG_ROLE TO USER_NAME;
  GRANT CREATE SESSION TO USER_NAME;
  GRANT SELECT ON SYS.COL$ TO USER_NAME;
  

  Autorisations d'accès à un schéma spécifique (Oracle version 23 et ultérieure) :

  GRANT SELECT ANY TABLE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT EXECUTE ANY PROCEDURE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT EXECUTE ANY TYPE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT ALTER ANY TRIGGER ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  

  Autorisations d'accès à tous les autres schémas :

  GRANT SELECT ANY TABLE TO USER_NAME;
  GRANT EXECUTE ANY PROCEDURE TO USER_NAME;
  GRANT EXECUTE ANY TYPE TO USER_NAME;
  GRANT ALTER ANY TRIGGER TO USER_NAME;
  

  Remplacez les éléments suivants :

  • USER_NAME : utilisateur de la base de données que vous souhaitez configurer.
  • TARGET_SCHEMA : nom du schéma Oracle auquel vous souhaitez accéder.

Conditions préalables de mise en réseau

Un rattachement de réseau pour la connexion via Private Service Connect est requis 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 de réseau n'est pas requis.

Configurer un connecteur Oracle

Configurez un connecteur Oracle à l'aide de la Google Cloud console ou de l'API.

Console

1. Dans la Google Cloud console, accédez à la page Knowledge Catalog.

   Accéder à Knowledge Catalog

2. Dans le menu de navigation, dans la section Gérer, cliquez sur Connecteurs.

3. Cliquez sur Ajouter une connexion.

4. Dans la liste Connecteurs, sélectionnez la fiche Oracle.

5. Dans la section Data source details (Détails de la source de données), fournissez les informations de connexion pour votre instance Oracle :

   • Sous Network attachment (Rattachement de réseau), sélectionnez un rattachement de réseau existant si nécessaire, ou créez-en un.
   • Saisissez le Host (Hôte), le Port, le Database name (Nom de la base de données), le Connection type (Type de connexion), le Username (Nom d'utilisateur) et le Password (Mot de passe).
   • Si vous utilisez TLS, sélectionnez un TLS Mode (Mode TLS) et fournissez un Trusted PEM Certificate (Certificat PEM approuvé). Pour en savoir plus, consultez Configuration TLS.
   • Pour Oracle metadata objects to import (Objets de métadonnées Oracle à importer), cliquez sur Browse (Parcourir) pour sélectionner objets.

6. Dans la section Destination settings (Paramètres de destination) :

   • Cliquez sur Browse (Parcourir) et sélectionnez un Knowledge Catalog entry group (Groupe d'entrées Knowledge Catalog) existant pour stocker les métadonnées importées, ou cliquez sur Create new entry group (Créer un groupe d'entrées).
   • Choisissez si vous souhaitez définir les autorisations sur le groupe d'entrées maintenant ou plus tard. Nous vous recommandons de définir des autorisations afin que les utilisateurs puissent afficher les métadonnées importées. Si vous n'avez pas accordé le rôle importateur de groupe d'entrées Dataplex (roles/dataplex.entryGroupImporter) ou l' dataplex.entryGroups.import autorisation à l'agent de service Service de transfert de données BigQuery ([e-mail]) au niveau du projet, vous devez l'accorder au niveau du groupe d'entrées.

7. Dans la section Connector config name (Nom de la configuration du connecteur), sous Display name (Nom à afficher), saisissez un nom pour la tâche d'importation de métadonnées.

8. Dans la section Schedule options (Options de programmation), configurez la fréquence de la tâche d'importation de métadonnées. Si vous sélectionnez On-demand (À la demande), la tâche ne s'exécute que lorsque vous la déclenchez manuellement.

9. Facultatif : dans la section Notification options (Options de notification), configurez les notifications par e-mail ou Pub/Sub en cas d'échec de la tâche.

10. Facultatif : dans la section Advanced options (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 la clé est utilisée pour chiffrer toutes les données transitoires mises en scène avant de démarrer les tâches d'importation de métadonnées Knowledge Catalog. Elle n'est pas utilisée pour chiffrer les métadonnées dans le groupe d'entrées Knowledge Catalog de destination.

11. Cliquez sur Enregistrer.

REST

Utilisez la projects.locations.transferConfigs.create méthode. Dans la TransferConfig ressource, configurez les champs suivants :

• Définissez le champ dataSourceId sur "oracle".
• Dans le champ metadataDestination, remplissez l'dataplexConfiguration objet avec le chemin d'accès à la ressource du groupe d'entrées Knowledge Catalog cible : projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

Une fois la tâche créée, Knowledge Catalog planifie la première exécution en fonction de votre configuration, ou vous pouvez la démarrer manuellement.

Rechercher et afficher des métadonnées Oracle

1. Dans la Google Cloud console, accédez à la page Rechercher de Knowledge Catalog.

   Accéder à la recherche

2. Dans le panneau Filters (Filtres), vous pouvez filtrer les composants Oracle à l'aide des Project (Projet), System (Système) et Type aliases (Alias de type). Dans la section System (Système), sélectionnez Imported Context (Contexte importé). La sélection de ce filtre ouvre une sous-section Managed Connectors (Connecteurs gérés). Sélectionnez Oracle pour filtrer toutes les métadonnées Oracle.

3. Vous pouvez utiliser le champ de recherche pour effectuer des requêtes de recherche. Vous pouvez effectuer une recherche par mots clés ou en langage naturel. Par exemple, pour afficher toutes les tables Oracle via une recherche par mots clés, saisissez system=ORACLE AND type=TABLE.

   Pour en savoir plus sur la recherche de ressources, consultez Rechercher des ressources dans Knowledge Catalog. Pour en savoir plus sur les expressions que vous pouvez utiliser dans le champ de recherche, consultez Syntaxe de recherche pour Knowledge Catalog.

4. Vous pouvez également utiliser l' LookupContext pour récupérer le contexte LLM pour des ressources Oracle spécifiques.

Étape suivante

• Découvrez comment gérer les tâches de connecteur.