Verbindung zu Compute herstellen

In diesem Abschnitt wird beschrieben, wie Sie Compute in Ihrer AI Data Platform Workbench mit anderen Business-Intelligence-Tools verbinden.

Themen:

Verbindungen

Sie können Ihre AI Data Platform Workbench mit Oracle Analytics Cloud oder anderen Business-Intelligence-Tools verbinden.

Mit einem benutzerdefinierten JDBC oder ODBC, das von der AI Data Platform Workbench bereitgestellt wird, können Sie über verschiedene Business-Intelligence-Tools eine Verbindung zu Oracle AI Data Platform Workbench herstellen. AI Data Platform Workbench unterstützt auch Verbindungen von kommerziellen BI-Tools von Drittanbietern (Tableau, Power BI) oder Open-Source-BI-Tools wie DBeaver. Um über diese Tools eine Verbindung herzustellen, benötigen Sie die Verbindungsdetails des Compute-Clusters in Ihrer AI Data Platform Workbench. Diese finden Sie auf der Registerkarte "Verbindungsdetails". Die erforderlichen Informationen variieren je nach Produkt, mit dem Sie eine Verbindung herstellen.


Registerkarte "Verbindungsdetails" für das Compute-Cluster Dev_cluster_1

Oracle Analytics mit AI Data Platform Workbench verbinden

Sie können über eine Oracle Analytics Cloud-Instanz eine Verbindung zu dem Katalog oder den Tabellen herstellen, die von Ihrer AI Data Platform Workbench-Instanz verwaltet werden.

Um eine Verbindung von Oracle Analytics zu Oracle AI Data Platform Workbench herzustellen, müssen Sie die folgenden Schritte ausführen:

  1. API-Schlüssel von OCI abrufen.
  2. Oracle Analytics-Verbindungskonfigurationsdatei abrufen.
  3. Kombinieren Sie den API-Schlüssel und die Konfigurationsdatei, um die Verbindung zu erstellen. Siehe Oracle Analytics-Verbindungsdatei erstellen.
  4. Verwenden Sie die Verbindung in Oracle Analytics Cloud. Siehe Oracle AI Data Platform Workbench mit Oracle Analytics verbinden.

Sie können die Schritte 1 und 2 in beliebiger Reihenfolge ausführen, müssen jedoch beide ausgeführt werden, bevor Sie fortfahren.

Oracle empfiehlt, einen Benutzer in OCI zu erstellen, der für den Oracle Analytics-Anwendungsfall dediziert ist. Dieser Benutzer muss über die entsprechenden Berechtigungen für die Tabellen in AI Data Platform Workbench verfügen, auf die Sie von Oracle Analytics zugreifen möchten. Generieren Sie den erforderlichen API-Schlüssel in OCI, und laden Sie die PEM-Datei für den zu diesem Zweck erstellten Benutzer herunter.

Hinweis:

  • Um über Oracle Analytics eine Verbindung zu AI Data Platform Workbench herzustellen, müssen Sie den Katalognamen beim Verbindungssetup angeben.
  • Der Katalog ist derzeit erforderlich, damit das System das richtige Schema und die richtigen Datenobjekte im AI Data Platform-Cluster findet.
  • Diese Anforderung wird in einem zukünftigen Release gemindert.

API-Schlüssel von OCI abrufen

Sie benötigen einen API-Schlüssel von OCI für einen Benutzer, der Zugriff auf Oracle AI Data Platform Workbench hat, wenn Sie eine Verbindung zu Oracle Analytics herstellen.

Der Benutzer, für den Sie den API-Schlüssel erstellen, muss der Ersteller der AI Data Platform Workbench-Instanz sein oder Admin-Berechtigungen für die Instanz haben. Außerdem muss ein gültiges AI Data Platform Workbench-Cluster in der Instanz vorhanden sein.
  1. Klicken Sie in OCI auf das Benutzersymbol und dann auf Benutzereinstellungen.

    OCI-Homepage mit geöffnetem Benutzerprofil und hervorgehobenen Benutzereinstellungen

  2. Klicken Sie unter Mein Profil auf Token und Schlüssel und dann auf API-Schlüssel hinzufügen.

    OCI-Benutzerprofil mit hervorgehobenem Benutzernamen, API-Schlüsseln und Hinzufügen von API-Schlüsseln geöffnet

  3. Wählen Sie API-Schlüsselpaar generieren aus, und klicken Sie auf Private Key herunterladen.

    Seite "API-Schlüssel hinzufügen" geöffnet, wobei "API-Schlüsselpaar generieren" ausgewählt und "Private Key herunterladen" markiert ist

  4. Klicken Sie auf "Hinzufügen".
Speichern Sie den Private Key (Pem-Datei), den Sie erhalten, an einem sicheren und persistenten Speicherort. Sie ist für Verbindungen erforderlich und kann nur einmal heruntergeladen werden. Diese Datei wird als Fingerprint verwendet, wenn Sie Oracle Analytics mit AI Data Platform Workbench verbinden.

Konfigurationsdatei für Oracle Analytics-Verbindung abrufen

Um eine Verbindung zu Oracle Analytics herzustellen, müssen Sie eine config.json-Datei aus der Oracle AI Data Platform Workbench-Instanz herunterladen.

Sie benötigen ein Compute Cluster mit mindestens 2 OCPUs, 32 GB Arbeitsspeicher für Treiber- und Worker-Knoten und mindestens 2 Worker.
  1. Navigieren Sie zu Ihrem Workspace, und klicken Sie auf Compute.

    Compute-Seite geöffnet mit hervorgehobenem Cluster für Cluster_High Compute

  2. Klicken Sie auf das Cluster, mit dem Sie eine Verbindung zu Oracle Analytics herstellen möchten.
  3. Klicken Sie auf der Registerkarte Verbindungsdetails unter dem Oracle Analytics Cloud-Logo auf das Symbol Herunterladen. Eine config.json-Datei wird auf Ihren Rechner heruntergeladen.

    Compute-Seite für Cluster "Cluster_High" geöffnet, Registerkarte "Verbindungsdetails" und hervorgehobener Oracle Analytics Cloud-Download

In der heruntergeladenen Datei config.json fehlt das Schlüsselwertpaar für den Fingerprint. Er muss mit dem Fingerprint-Schlüsselwert aus einem API-Schlüssel kombiniert werden, der zu einem OCI-Benutzer gehört, der die AI Data Platform Workbench erstellt hat, oder einem Benutzer mit Admin-Berechtigungen.
Inhalt der config.json-Datei, einschließlich Benutzername, Mandant, Region und dsn

Oracle Analytics-Verbindungsdatei erstellen

Sie müssen das Fingerprint-Schlüsselwertpaar manuell zur Datei config.json hinzufügen, die von Oracle AI Data Platform Workbench heruntergeladen wurde, damit die Datei für die Verbindung zu Oracle Analytics verwendet werden kann.

Sie müssen einen API-Schlüssel für einen OCI-Benutzer erstellt haben, der die AI Data Platform Workbench-Instanz erstellt hat oder Admin-Berechtigungen für die Instanz hat. Sie müssen auch die config.json aus dem Cluster heruntergeladen haben, mit dem Sie eine Verbindung zu Oracle Analytics herstellen möchten.
  1. Öffnen Sie die Datei config.json und die Konfigurationsdatei des API-Schlüssels.
  2. Bearbeiten Sie config.json, um den Fingerprint-Wert aus der API-Schlüsselkonfigurationsdatei hinzuzufügen.

    API-Schlüssel mit hervorgehobenem Benutzer, Fingerprint, Mandant und Region sowie hervorgehobenem Kopieren

  3. Speichern Sie die Änderungen in der Datei config.json.

    config.json-Datei mit Fingerabdruckschlüsselpaar geöffnet

In einem zukünftigen Release enthält die config.json den Fingerprint des Public Keys des API-Schlüssels, und Sie müssen ihn nicht mehr manuell hinzufügen. In diesem Release wird der neueste für den Benutzer verfügbare API-Schlüssel in der config.json verwendet.

Oracle AI Data Platform Workbench mit Oracle Analytics verbinden

Sie können über eine Oracle Analytics-Instanz eine Verbindung zu dem Katalog oder den Tabellen herstellen, die von Ihrer AI Data Platform Workbench-Instanz verwaltet werden.

Oracle Analytics-Verbindungen zu AI Data Platform Workbench-Instanzen unterstützen nur einen Katalog pro Verbindung. Sie müssen zusätzliche Verbindungen erstellen, um mehrere Kataloge zu verwenden.
  1. Klicken Sie auf der Homepage von Oracle Analytics auf Erstellen und dann auf Verbindung.

    Oracle Analytics-Homepage mit hervorgehobener Option "Erstellen und Verbindung"

  2. Klicken Sie auf Oracle AI Data Platform.

    Dialogfeld "Verbindung erstellen" geöffnet, in dem Oracle AI Data Platform hervorgehoben ist

  3. Geben Sie einen Namen und die Beschreibung für die Verbindung ein.

    Verbindung für Oracle AI Data Platform erstellen, wobei Verbindungsdetails, Katalog und privater API-Schlüssel hervorgehoben sind

  4. Klicken Sie unter "Verbindungsdetails" auf Auswählen, navigieren Sie zur Datei config.json, und klicken Sie auf Öffnen. Weitere Informationen finden Sie unter Oracle Analytics-Verbindungsdatei erstellen.
  5. Wählen Sie API-Schlüssel als Authentifizierungstyp aus.
  6. Geben Sie den Katalognamen ein, der in Ihren Datensets verwendet werden soll.
  7. Klicken Sie unter "Private API Key" auf Auswählen, und navigieren Sie zu Ihrem privaten API-Schlüssel (. PEM-Datei), und klicken Sie auf Öffnen. Weitere Informationen finden Sie unter API-Schlüssel von OCI abrufen.
  8. Klicken Sie auf Speichern.
  9. Testen Sie die neue Verbindung, indem Sie ein neues Dataset erstellen. Weitere Informationen finden Sie unter Dataset aus einer Verbindung erstellen.

Wenn Sie die Anweisungen befolgt haben und weiterhin Probleme beim Speichern der Verbindung oder beim Auflisten der Schemas haben, ist möglicherweise ein Clusterneustart erforderlich.

JDBC-Treiber herunterladen

Sie können den JDBC-Treiber auf der Registerkarte "Verbindungsdetails" herunterladen und für verschiedene BI-Tools konfigurieren.

  1. Navigieren Sie zu Ihrem Workspace, und klicken Sie auf Compute.
  2. Klicken Sie auf das Cluster, das Sie mit einem JDBC-kompatiblen BI-Tool verbinden möchten, und klicken Sie auf Verbindungen.
  3. Klicken Sie auf JDBC-Treiber herunterladen.

DBeaver konfigurieren

Sie müssen DBeaver installieren und Dateien vorbereiten, die von Oracle AI Data Platform Workbench heruntergeladen wurden, bevor Sie es mit einem Compute-Cluster in AI Data Platform Workbench verbinden können.

  1. Herunterladen und DBeaver-Client installieren Sie können Community- oder Enterprise-Versionen verwenden, müssen jedoch mindestens 22.x sein. DBeaver ist nur für Windows, Mac OS X, Eclipse-Plug-in und Linux verfügbar.
  2. Dekomprimieren Sie die Datei aus JDBC-Treiber herunterladen.
  3. Entpacken Sie die Treiberdatei simbaSpark.zip aus den entpackten Dateien.

DBeaver mit dem Spark Simba JDBC-Treiber konfigurieren

Sie können DBeaver so konfigurieren, dass eine Verbindung zu einem Compute-Cluster in Oracle AI Data Platform Workbench hergestellt wird.

Sie müssen DBeaver installiert und die von AI Data Platform Workbench heruntergeladenen Dateien simbaSpark.zip extrahiert haben.
  1. Öffnen Sie DBeaver.
  2. Klicken Sie auf Database Navigator.
  3. Klicken Sie auf Treibermanager.
  4. Klicken Sie auf Neu.
  5. Geben Sie AI Data Platform als Treibernamen ein.
  6. Klicken Sie auf Librarys.
  7. Klicken Sie auf Ordner hinzufügen.
  8. Navigieren Sie zum Speicherort des sparkSimba.zip-Extrakts.
  9. Klicken Sie auf Klasse suchen.
  10. Wählen Sie OK aus.
  11. Setzen Sie Treiberklasse auf com.simba.spark.jdbc.Driver.
  12. Klicken Sie auf Einstellungen.
  13. Setzen Sie Klassenname auf com.simba.spark.jdbc.Driver.
  14. Klicken Sie auf OK.

Datenbankverbindung in DBeaver erstellen

Um DBeaver mit einem Compute-Cluster in Oracle AI Data Platform Workbench zu verbinden, müssen Sie zunächst eine Datenbankverbindung in DBeaver erstellen.

Sie müssen DBeaver mit dem von AI Data Platform Workbench heruntergeladenen Spark Simba-JDBC-Treiber konfiguriert haben. Weitere Informationen finden Sie unter DBeaver mit dem Spark Simba JDBC-Treiber konfigurieren.
  1. Öffnen Sie DBeaver.
  2. Klicken Sie auf Datenbank.
  3. Klicken Sie auf Neue Datenbankverbindung.
  4. Klicken Sie auf Alle.
  5. Wählen Sie AI Data Platform aus.
  6. Klicken Sie auf Weiter.
  7. Geben Sie die URL des JDBC-Treibers ein. Die JDBC-URL finden Sie auf der Registerkarte Verbindungsdetails des Compute-Clusters in AI Data Platform Workbench.
  8. Klicken Sie auf Fertig stellen.

DBeaver über JDBC mit Oracle AI Data Platform Workbench verbinden

Nachdem DBeaver konfiguriert wurde und eine Datenbankverbindung zu AI Data Platform Workbench besteht, können Sie die Verbindung zwischen DBeaver und AI Data Platform Workbench herstellen.

  1. Öffnen Sie DBeaver.
  2. Klicken Sie auf Verbinden.
  3. Wählen Sie aus, ob eine Verbindung mit einem Autorisierungstoken oder einem API-Schlüssel hergestellt werden soll.
    • Verbindung mit Autorisierungstoken herstellen
      • Verwenden Sie ein Token, indem Sie kein Profil in der URL angeben, wenn Sie kein DEFAULT-Profil haben. Beispiel: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5

        Die URL öffnet ein Browserfenster.

        Melden Sie sich bei dem Mandanten an, in dem die AI Data Platform Workbench-Instanz erstellt wird.

        Weitere Informationen finden Sie unter Tokenbasierte Authentifizierung für die CLI.

    • Verbinden Sie sich mit einem API-Schlüssel, indem Sie das OCI-Profil mit ociProfile=<profile_name> in der Verbindungs-URL angeben.

      • Verwenden Sie die API-Schlüsselauthentifizierung, um eine Verbindung zu einer AI Data Platform Workbench-Instanz herzustellen.

        Verwenden Sie den API-Schlüssel, indem Sie das OCI-Profil mit ociProfile=<profile_name> in der Verbindungs-URL angeben. Beispiel: So verwenden Sie die Demo des OCI-Profilnamens: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo

        Weitere Informationen finden Sie unter Erforderliche Schlüssel und OCIDs.

  4. DBeaver erstellt eine Verbindung zum Lesen von Metadaten und eine Verbindung für alle anderen Vorgänge. Wenn Sie auf Verbindungen beschränkt sind, können Sie die zweite Verbindung deaktivieren, sodass DBeaver eine Verbindung für alle Vorgänge verwendet.
    1. Klicken Sie auf Voreinstellungen.
    2. Klicken Sie auf Allgemein.
    3. Klicken Sie auf Metadaten.
    4. Deaktivieren Sie die Option Separate Verbindung für Metadatenlesevorgänge öffnen.

Verbindung von Tableau mit AI Data Platform über JDBC herstellen

Sie können Daten in Ihrer AI Data Platform mit Tableau verbinden, um sie mit ihren Analysen und Visualisierungen zu verwenden.

  1. Navigieren Sie zu Ihrem Workspace, und klicken Sie auf Compute.
  2. Klicken Sie auf das Cluster, mit dem Sie eine Verbindung zu Tableau herstellen möchten, und klicken Sie auf die Registerkarte Verbindungsdetails.
  3. Klicken Sie auf JDBC-Treiber herunterladen.
  4. Extrahieren Sie die Dateien aus der heruntergeladenen ZIP-Datei.
  5. Öffnen Sie den Hauptordner aus den extrahierten Dateien, und extrahieren Sie je nach Betriebssystemtyp die Simba-JAR-Datei in den folgenden Ordner:
    • Linux: /opt/tableau/tableau_driver/jdbc
    • MacOS: ~/Library/Tableau/Drivers/
    • Fenster: C:\Program Files\Tableau\Driver
    Beispiel: In MacOS lautet der Speicherort der JAR-Datei ~/Library/Tableau/Drivers/SparkJDBC42.jar.
  6. Öffnen Sie den Tableau-Client.
  7. Suchen Sie in der Liste Verbindung zu einem Server herstellen nach JDBC-Datenbanken.
  8. Kopieren Sie die JDBC-URL.
  9. Wählen Sie SQL92 als Dialekt aus.
  10. Authentifizieren Sie Ihre Verbindung mit einer der folgenden Methoden:
    • Mit einem API-Schlüssel authentifizieren
      • Verwenden Sie die OCI-Standardkonfigurationsdatei und das Standardprofil. Beispiel:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0
      • Wenn Sie den Standardspeicherort nicht verwenden, hängen Sie den Speicherort der OCI-Konfigurationsdatei in der JDBC-URL der Verbindung an. Beispiel:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>
      • Wenn Sie das Standardprofil nicht verwenden, hängen Sie das OCI-Profil an die JDBC-URL der Verbindung an. Beispiel:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0;OCIConfigFile=<config_file_absolute_path>OCIProfile=<profile_name>
    • Authentifizierung mit einem Autorisierungstoken:
      • Um ein Autorisierungstoken zu verwenden, haben Sie keine Konfigurationsdatei im Standardpfad (z.B. /Users/xyz/.oci/config), und geben Sie kein Profil in der URL an. Beispiel:
        jdbc:spark://gateway.datalake.uk-london-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/1ee500ba-faad-4267-adcb-b6c7ce08d5a0

      Weitere Informationen finden Sie unter Tokenbasierte Authentifizierung für die CLI.

  11. Klicken Sie auf Anmelden.
  12. Optional: Wenn Sie die tokenbasierte Authentifizierung verwenden, melden Sie sich beim Mandanten an, in dem Ihre AI Data Platform im angezeigten Browserfenster erstellt wurde.

ODBC-Treiber herunterladen

Sie können den ODBC-Treiber auf der Registerkarte "Verbindungsdetails" herunterladen und für verschiedene BI-Tools konfigurieren.

  1. Navigieren Sie zu Ihrem Workspace, und klicken Sie auf Compute.
  2. Klicken Sie auf das Cluster, das Sie mit einem ODBC-kompatiblen BI-Tool verbinden möchten, und klicken Sie auf Verbindungen.
  3. Klicken Sie auf ODBC-Treiber herunterladen.
  4. Wählen Sie das entsprechende Betriebssystem aus der Liste aus.

    ODBC Driver OS Dropdown mit Mac, Windows und Linx Optionen geöffnet