Importer des métadonnées depuis Oracle

Knowledge Catalog (anciennement Dataplex Universal Catalog) vous permet d'extraire et d'importer des métadonnées à partir de bases de données Oracle à l'aide d'un connecteur géré. Vous pouvez ensuite rechercher et découvrir vos éléments Oracle ainsi que vos autres données cataloguées, et récupérer le contexte des charges de travail de grand modèle de langage (LLM).

Ce connecteur est compatible avec les instances Oracle hébergées sur site, sur Google Cloudou dans d'autres environnements cloud. Pour en savoir plus sur le fonctionnement des connecteurs, consultez À propos des connecteurs de métadonnées.

Avant de commencer

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

  1. Accordez les rôles et autorisations requis.
  2. Activez l'API Dataplex et l'API du service de transfert de données BigQuery.
  3. Remplissez les conditions préalables pour Oracle.
  4. Remplissez les conditions préalables de mise en réseau.

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 :

De plus, vous devez accorder à l'agent de service du 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 l'API Dataplex et l'API Service de transfert de données BigQuery.

Activer les API

Prérequis pour Oracle

Assurez-vous de remplir les conditions préalables pour les transferts Oracle. Pour en savoir plus, consultez Prérequis pour Oracle dans la documentation du service de transfert de données BigQuery.

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

  • typeparentContainer

  • Droits minimaux : vous devez accorder les droits 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érieures) :

    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 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 lors de la connexion sécurisée à des bases de données externes ou à des sources de données cloud tierces avec une adresse IP privée au sein d'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, aucun rattachement de réseau n'est requis.

Configurer un connecteur Oracle

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

Console

  1. Dans la console Google Cloud , 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 Détails de la source de données, fournissez les détails de connexion de votre instance Oracle :

    • Pour 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 Configuration TLS.
    • Pour Objets de métadonnées Oracle à importer, cliquez sur Parcourir pour sélectionner des objets.

  6. 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.
    • Choisissez de 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 attribué le rôle Importateur de groupes d'entrées Dataplex (roles/dataplex.entryGroupImporter) ou l'autorisation dataplex.entryGroups.import à l'agent de service du 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.

  7. Dans la section Nom de la configuration du connecteur, sous Nom à afficher, saisissez un nom pour le job d'importation des métadonnées.

  8. Dans la section Options de programmation, configurez la fréquence du job d'importation des métadonnées. Si vous sélectionnez À la demande, le job ne s'exécute que lorsque vous le déclenchez manuellement.

  9. Facultatif : dans la section 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 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 qu'elle est utilisée pour chiffrer toutes les données temporaires préparées avant de lancer les jobs d'importation des 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 méthode projects.locations.transferConfigs.create. Dans la ressource TransferConfig, configurez les champs suivants :

  • Définissez le champ dataSourceId sur "oracle".
  • Dans le champ metadataDestination, renseignez l'objet dataplexConfiguration 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 le job créé, 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 console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

    Accéder à la recherche

  2. Dans le panneau Filtres, vous pouvez filtrer les éléments Oracle à l'aide des sections Projet, Système et Alias de type. Dans la section Système, sélectionnez Contexte importé. La sélection de ce filtre ouvre une sous-section 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 mot clé ou en langage naturel. Par exemple, pour afficher toutes les tables Oracle via une recherche par mot clé, 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'API LookupContext pour récupérer le contexte LLM pour des ressources Oracle spécifiques.

Étapes suivantes