Metadaten aus Oracle importieren

Mit Knowledge Catalog (früher Dataplex Universal Catalog) können Sie Metadaten aus Oracle-Datenbanken mithilfe eines verwalteten Connectors extrahieren und importieren. Anschließend können Sie Ihre Oracle-Assets zusammen mit Ihren anderen katalogisierten Daten suchen und finden und Kontext für LLM-Arbeitslasten (Large Language Model) abrufen.

Dieser Connector unterstützt Oracle-Instanzen, die lokal, in Google Cloudoder in anderen Cloud-Umgebungen gehostet werden. Weitere Informationen zur Funktionsweise von Connectors finden Sie unter Metadaten-Connectors.

Hinweis

Bevor Sie Metadaten aus Oracle importieren können, müssen Sie die folgenden Aufgaben ausführen:

  1. Weisen Sie die erforderlichen Rollen und Berechtigungen zu.
  2. Aktivieren Sie die Dataplex API und die BigQuery Data Transfer Service API.
  3. Sie erfüllen die Voraussetzungen für Oracle.
  4. Netzwerkvoraussetzungen erfüllen

IAM-Rollen und -Berechtigungen

Zum Erstellen und Verwalten eines Knowledge Catalog-Connector-Jobs benötigen Sie IAM-Rollen (Identity and Access Management), die Berechtigungen für Knowledge Catalog und BigQuery Data Transfer Service gewähren.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren eines Oracle-Connectors benötigen:

Außerdem müssen Sie dem Dienst-Agent für BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) die Berechtigung dataplex.entryGroups.import oder die Rolle Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) zuweisen. Sie können diese Rolle entweder auf Projekt- oder auf Eintragsgruppenebene zuweisen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

APIs aktivieren

Aktivieren Sie die Dataplex API und die BigQuery Data Transfer Service API.

APIs aktivieren

Voraussetzungen für Oracle

Prüfen Sie, ob Sie die Voraussetzungen für Oracle-Übertragungen erfüllen. Weitere Informationen finden Sie in der Dokumentation zum BigQuery Data Transfer Service unter Voraussetzungen für Oracle.

Zusätzlich zu den Voraussetzungen für den BigQuery Data Transfer Service muss Ihre Oracle-Instanz die folgenden Anforderungen erfüllen:

  • Mindestversion: Oracle-Version 12 oder höher ist erforderlich, um Datenbank-Metadatenattribute wie type und parentContainer zu unterstützen.

  • Mindestberechtigungen: Sie müssen dem Datenbanknutzer die folgenden Berechtigungen gewähren:

    Grundlegende Berechtigungen (für alle Konfigurationen erforderlich):

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

    Berechtigungen für den Zugriff auf ein bestimmtes Schema (Oracle-Version 23 und höher):

    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;

    Berechtigungen für den Zugriff auf alle anderen Schemas:

    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;

    Ersetzen Sie Folgendes:

    • USER_NAME: Der Datenbanknutzer, den Sie konfigurieren möchten.
    • TARGET_SCHEMA: der Name des Oracle-Schemas, auf das Sie zugreifen möchten.

Netzwerkvoraussetzungen

Ein Netzwerkanhang für die Verbindung über Private Service Connect ist erforderlich, wenn Sie eine sichere Verbindung zu externen Datenbanken oder Cloud-Datenquellen von Drittanbietern mit einer privaten IP-Adresse in einem privaten Netzwerk herstellen, damit BigQuery Data Transfer Service auf Ihre Datenbank zugreifen kann.

Wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer lokalen Umgebung oder einer in der Cloud gehosteten Instanz herstellen, ist kein Netzwerkanhang erforderlich.

Oracle-Connector konfigurieren

Konfigurieren Sie einen Oracle-Connector über die Google Cloud Console oder die API.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Knowledge Catalog auf.

    Zu Knowledge Catalog

  2. Klicken Sie im Navigationsmenü im Bereich Verwalten auf Connectors.

  3. Klicken Sie auf Verbindung hinzufügen.

  4. Wählen Sie in der Liste Connectors die Karte Oracle aus.

  5. Geben Sie im Abschnitt Details zur Datenquelle Verbindungsdetails für Ihre Oracle-Instanz an:

    • Wählen Sie unter Netzwerkanhang bei Bedarf einen vorhandenen Netzwerkanhang aus oder erstellen Sie einen.
    • Geben Sie den Host, den Port, den Datenbanknamen, den Verbindungstyp, den Nutzernamen und das Passwort ein.
    • Wenn Sie TLS verwenden, wählen Sie einen TLS-Modus aus und geben Sie ein vertrauenswürdiges PEM-Zertifikat an. Weitere Informationen finden Sie unter TLS-Konfiguration.
    • Klicken Sie unter Zu importierende Oracle-Metadatenobjekte auf Durchsuchen, um Objekte auszuwählen.

  6. Im Abschnitt Zieleinstellungen:

    • Klicken Sie auf Durchsuchen und wählen Sie eine vorhandene Knowledge Catalog-Eintragsgruppe aus, um die importierten Metadaten zu speichern, oder klicken Sie auf Neue Eintragsgruppe erstellen.
    • Wählen Sie aus, ob Sie die Berechtigungen für die Eintragsgruppe jetzt oder später festlegen möchten. Wir empfehlen, die Berechtigungen so festzulegen, dass Nutzer die importierten Metadaten aufrufen können. Wenn Sie dem Dienst-Agent für BigQuery Data Transfer Service (service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com) auf Projektebene nicht die Rolle Dataplex Entry Group Importer (roles/dataplex.entryGroupImporter) oder die Berechtigung dataplex.entryGroups.import zugewiesen haben, müssen Sie sie auf der Ebene der Eintraggruppe zuweisen.

  7. Geben Sie im Abschnitt Konfigurationsname für Connector als Anzeigename einen Namen für den Metadatenimportjob ein.

  8. Konfigurieren Sie im Abschnitt Zeitplanoptionen die Häufigkeit für den Metadatenimportjob. Wenn Sie On-Demand auswählen, wird der Job nur ausgeführt, wenn Sie ihn manuell auslösen.

  9. Optional: Konfigurieren Sie im Abschnitt Benachrichtigungsoptionen E‑Mail- oder Pub/Sub-Benachrichtigungen für Jobfehler.

  10. Optional: Konfigurieren Sie im Abschnitt Erweiterte Optionen die Verschlüsselungseinstellungen. Wenn Sie einen kundenverwalteten Verschlüsselungsschlüssel (CMEK) auswählen, wird der Schlüssel zum Verschlüsseln aller temporären Daten verwendet, die vor dem Start der Knowledge Catalog-Metadatenimportjobs bereitgestellt werden. Er wird nicht zum Verschlüsseln der Metadaten in der Ziel-Eintragsgruppe des Knowledge Catalog verwendet.

  11. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode projects.locations.transferConfigs.create. Konfigurieren Sie in der Ressource TransferConfig die folgenden Felder:

  • Setzen Sie das Feld dataSourceId auf "oracle".
  • Geben Sie im Feld metadataDestination für das Objekt dataplexConfiguration den Ressourcenpfad der Knowledge Catalog-Zieleintragsgruppe an: projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

Nachdem Sie den Job erstellt haben, plant Knowledge Catalog die erste Ausführung gemäß Ihrer Konfiguration. Sie können sie aber auch manuell starten.

Oracle-Metadaten suchen und ansehen

  1. Rufen Sie in der Google Cloud Console die Seite Knowledge Catalog Suchen auf.

    Zur Suche

  2. Im Bereich Filter können Sie nach Oracle-Assets filtern. Verwenden Sie dazu die Abschnitte Projekt, System und Typ-Aliasse. Wählen Sie im Bereich System die Option Importierter Kontext aus. Wenn Sie diesen Filter auswählen, wird der Unterabschnitt Verwaltete Connectors geöffnet. Wählen Sie Oracle aus, um nach allen Oracle-Metadaten zu filtern.

  3. Über das Suchfeld können Sie Suchanfragen ausführen. Sie können eine Suche mit Suchbegriffen oder in natürlicher Sprache durchführen. Wenn Sie beispielsweise alle Oracle-Tabellen über die Keyword-Suche aufrufen möchten, geben Sie system=ORACLE AND type=TABLE ein.

    Weitere Informationen zur Suche nach Ressourcen finden Sie unter Ressourcen in Knowledge Catalog suchen. Weitere Informationen zu den Ausdrücken, die Sie im Suchfeld verwenden können, finden Sie unter Suchsyntax für Knowledge Catalog.

  4. Sie können auch die LookupContext API verwenden, um LLM-Kontext für bestimmte Oracle-Ressourcen abzurufen.

Nächste Schritte