Tableau über ODBC mit einem Data Flow-SQL-Endpunkt verbinden
Laden Sie ODBC unter MAC-BS oder Windows herunter, installieren und konfigurieren Sie es, um Tableau mit einem Data Flow-SQL-Endpunkt zu verbinden.
Herunterladen und Installieren des ODBC-Treibers unter Mac OS
Führen Sie diese Schritte aus, um einen ODBC-Treiber herunterzuladen und zu installieren, der mit Tableau unter Mac OS verwendet werden kann.
-
Laden Sie den ODBC-Treiber herunter.
- Suchen Sie in der globalen Suchleiste nach
Data Flow
, und wählen Sie Data Flow-Service aus. - Wählen Sie in der Navigation auf der linken Seite die Option SQL-Endpunkte aus.
- Wählen Sie einen beliebigen SQL-Endpunkt aus der Liste aus. Die Detailseite für diesen SQL-Endpunkt wird angezeigt.
- Wählen Sie unter Verbinden die Option Treiber aus.
- Wählen Sie unter ODBC die Option ODBC-Treiber herunterladen aus.
- Wählen Sie Mac aus. Der Download beginnt.
- Wenn der Download abgeschlossen ist, extrahieren Sie die heruntergeladene ZIP-Datei.
- Suchen Sie in der globalen Suchleiste nach
-
Doppelklicken Sie, um den Treiber zu installieren.
Das Installationsfenster wird geöffnet.
-
Wählen Sie Fortfahren.
Lesen Sie den angezeigten Lizenzvertrag.
- Wählen Sie Zustimmen aus.
- (Optional) Um das Installationsverzeichnis vom Standardverzeichnis zu ändern, wählen Sie Installationsspeicherort ändern, navigieren Sie zu dem Installationsverzeichnis, und wählen Sie OK aus.
- Wählen Sie Weiter, um das Installationsverzeichnis zu bestätigen.
- Wählen Sie Install aus.
-
Wenn die Installation abgeschlossen ist, wählen Sie Fertigstellen.
Das Installationsverzeichnis des Treibers lautet:
/Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
- (Optional) Installieren Sie ODBC Manager.
ODBC Manager ist ein Tool zum Konfigurieren von Treibern sowie zum Erstellen und Verwalten von DSNs. Das Tool ist optional, da Sie DSNs auch manuell erstellen können, indem Sie die entsprechende
odbc.ini
-Datei bearbeiten.- Laden Sie den ODBC Manager von der Downloadsite herunter.
- Doppelklicken Sie auf die heruntergeladene Datei
.dmg
. - Doppelklicken Sie auf die Datei
ODBC Manager.pkg
. - Befolgen Sie die Anweisungen zur Installation.
ODBC-Treiber unter Mac OS konfigurieren
Führen Sie diese Schritte aus, um den ODBC-Treiber unter Mac OS zu konfigurieren.
Sie können Benutzer-DSNs erstellen (auf die nur der Benutzer zugreifen kann, der sie auf der Workstation erstellt hat) oder System-DSNs (auf die jeder Benutzer zugreifen kann, der bei der Workstation angemeldet ist).
-
Ruft den Hostnamen für den SQL-Endpunkt ab, mit dem eine Verbindung hergestellt werden soll.
- Öffnen Sie die Seite "Details" für den SQL-Endpunkt, wenn er aktiv ist.
- Wählen Sie Treiber.
- Wählen Sie unter ODBC-Treiber die Option Details anzeigen aus. Ein Popup-Fenster wird angezeigt.
- Wählen Sie in der Zeichenfolge Hostname die Option Anzeigen aus. Der vollständige Hostname wird angezeigt.
- Wählen Sie in der Zeichenfolge Hostname die Option Kopieren aus. Der vollständige Hostname wird in die Zwischenablage kopiert.
- Speichern Sie den Hostnamen zur späteren Verwendung.
- (Optional) Erstellen Sie einen DSN mit ODBC Manager.
-
Starten Sie ODBC Manager.
-
Wählen Sie je nach Bedarf Benutzer-DSN oder System-DSN aus.
-
Klicken Sie auf Hinzufügen.
-
Wählen Sie
Simba OCI Spark ODBC Driver
aus. -
Wählen Sie OK.
-
Geben Sie den Namen des DSN ein, z.B.
Data Flow SQL Endpoint
, und fügen Sie optional eine Beschreibung hinzu. -
Erstellen Sie ein Schlüsselwortwertpaar für jeden DSN-Parameter.
-
Wählen Sie Hinzufügen aus, um ein Schlüsselwortwertpaar zu erstellen.
-
Wählen Sie Schlüsselwort aus, und ersetzen Sie es durch den Parameternamen.
-
Wählen Sie Wert aus, und ersetzen Sie ihn durch den Wert für den Parameter.
- Wiederholen Sie die Schritte g bis j für jeden Parameter.
- Fügen Sie die Verbindungsauthentifizierungsdetails hinzu:
- Um eine Verbindung zu einem SQL-Endpunkt mit einem API-Signaturschlüssel herzustellen, der sich nicht am Standardspeicherort
~/.oci/config
befindet, fügen Sie den folgenden Parameter hinzu:
Dabei istOCIConfigFile=ConfigFileLocation
ConfigFileLocation
der absolute Pfad zur OCI-Konfigurationsdatei, die mit der Verbindung verwendet werden soll.Legen Sie optional im Feld OCIProfile den Namen des OCI-Profils in der Konfigurationsdatei fest, das mit der Verbindung verwendet werden soll:
Wenn kein Profil angegeben ist, versucht der Connector, das Profil DEFAULT zu verwenden:OCIProfile=<profile_to_use>
OCIProfile=<profile_to_use>
- Um eine Verbindung zu einem SQL-Endpunkt mit einem Token (über den Browser) herzustellen, lassen Sie den Parameter
OCIConfigFile
aus der DSN-Konfiguration aus.
- Um eine Verbindung zu einem SQL-Endpunkt mit einem API-Signaturschlüssel herzustellen, der sich nicht am Standardspeicherort
-
Wählen Sie OK, um den DSN zu erstellen.
Hinweis
Wenn Sie den ersten Benutzer- oder System-DSN für den ODBC-Treiber erstellen, erstellt der ODBC-Manager die Dateiodbc.ini
im entsprechenden Verzeichnis für den Typ des erstellten DSN. Wenn Sie weitere DSNs erstellen, fügt ODBC Manager der vorhandenen Dateiodbc.ini
Einträge für jeden DSN hinzu. Die Dateiodbc.ini
befindet sich unter dem Verzeichnis~/Library/ODBC
für Benutzer-DSNs und/Library/ODBC
für System-DSNs. -
- (Optional) Erstellen Sie einen DSN, indem Sie einen Eintrag zu
odbc.ini
hinzufügen.Wenn bereits ein Benutzer-DSN oder ein System-DSN für den Treiber erstellt wurde, fügen Sie den neuen Eintrag zur vorhandenenodbc.ini
-Datei hinzu. Wenn Sie den ersten DSN für den Treiber erstellen, erstellen Sie die Dateiodbc.ini
manuell, und fügen Sie den Eintrag der Datei hinzu.- Wenn Sie den ersten DSN in der leeren Datei
odbc.ini
erstellen, erstellen Sie einen Abschnitt für ODBC-Datenquellen (nur zum ersten Mal), indem Sie die folgende Zeile zur Dateiodbc.ini
hinzufügen:[ODBC Data Sources]
-
Geben Sie für jeden DSN Folgendes an:
- Geben Sie unter
[ODBC Data Sources]
den DSN-Namen und den ODBC-Treibernamen (der Simba OCI Spark ODBC-Treiber ist) im Format<dsn_name> = <driver_name>
an. Beispiel:[ODBC Data Sources]dsn_name = Simba OCI Spark ODBC Driver
- Erstellen Sie einen Abschnitt für die DSN-Konfiguration, indem Sie
[dsn_name]
in einer neuen Zeile am Ende der Datei hinzufügen.[dsn_name]
- Geben Sie unter dem erstellten DSN-Abschnitt den Verzeichnispfad der Treiberdatei in folgender Form an:
Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib
-
Geben Sie die Verbindungsparameter wie Host und Konfigurationsdatei an. Die Verbindungsparameter, die Sie dem DSN hinzufügen, müssen nicht in der ODBC-Verbindungszeichenfolge angegeben werden.
- Fügen Sie zum Herstellen einer Verbindung zum SQL-Endpunkt mit einem API-Signaturschlüssel (nicht am Standardspeicherort von
~/.oci/config
) den folgenden Parameter hinzu:
Dabei istOCIConfigFile=ConfigFileLocation
ConfigFileLocation
der absolute Pfad zur OCI-Konfigurationsdatei, die für die Verbindung verwendet werden soll.Legen Sie optional im Feld
OCIProfile
den Namen des OCI-Profils in der Konfigurationsdatei fest, das für die Verbindung verwendet werden soll. Wenn kein Profil angegeben ist, versucht der Connector, das ProfilDEFAULT
zu verwenden:OCIProfile=PROFILE_TO_USE
- Um eine Verbindung zu einem SQL-Endpunkt mit einem Token (browserbasiert) herzustellen, können Sie den Parameter
OCIConfigFile
aus der DSN-Konfiguration weglassen.
- Fügen Sie zum Herstellen einer Verbindung zum SQL-Endpunkt mit einem API-Signaturschlüssel (nicht am Standardspeicherort von
- Alle anderen Parameter werden in Form von
<parameter_name> = <value>.
angegeben. Das folgende Beispiel zeigt eineodbc.ini
-Datei, die Datenquellen mit dem API-Schlüssel konfiguriert:[ODBC Data Sources] Data Flow SQL Endpoint = Simba OCI Spark ODBC Driver [Data Flow SQL Endpoint] Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib Description = Description of the connection Host = amaaaaaaezym32iajmhpmxybehc7plnvpxsmjhleiav37x5rm7pjx476ewqa.interactive.dataflowclusters.us-ashburn-1.oci.oc-test.com OCIConfigFile = /Users/username/.oci/config OCIProfile = OCIProfileToUse OCIIgnoreDriverNoPrompt = 1
- Geben Sie unter
- Vergewissern Sie sich, dass der Pfad der OCI-Konfigurationsdatei zur Verwendung des API-Signaturschlüssels für die Authentifizierung korrekt ist.
- Validieren Sie den Dateipfad des Private Keys in der Konfiguration.
- Wenn Sie den ersten DSN in der leeren Datei
ODBC-Treiber unter Windows herunterladen und installieren
Führen Sie diese Schritte aus, um einen ODBC-Treiber für Tableau unter Windows herunterzuladen und zu installieren/
-
Laden Sie den Windows ODBC-Treiber von . herunter
- Suchen Sie in der globalen Suchleiste nach
Data Flow
, und wählen Sie Data Flow-Service aus. - Wählen Sie in der Navigation auf der linken Seite die Option SQL-Endpunkte aus.
- Wählen Sie einen beliebigen SQL-Endpunkt aus der Liste aus. Die Detailseite für diesen SQL-Endpunkt wird angezeigt.
- Wählen Sie unter Verbinden die Option Treiber aus.
- Wählen Sie unter ODBC die Option ODBC-Treiber herunterladen aus.
- Wählen Sie Windows aus. Der Download beginnt.
- Wenn der Download abgeschlossen ist, extrahieren Sie die heruntergeladene ZIP-Datei.
- Suchen Sie in der globalen Suchleiste nach
-
Extrahieren Sie die Datei
.zip
. -
Doppelklicken Sie auf das 32-Bit-Installationsprogramm
Simba OCI Spark 2.6 32-bit.msi
, wenn das System 32-Bit ist, oder doppelklicken Sie auf das 64-Bit-InstallationsprogrammSimba OCI Spark 2.6 64-bit.msi
, wenn das System 64-Bit ist. - Wählen Sie Weiter aus.
- Akzeptieren Sie die Bedingungen der Lizenzvereinbarung.
- Wählen Sie Weiter aus.
- (Optional) So ändern Sie das Installationsverzeichnis vom Standardverzeichnis:
- Wählen Sie Ändern... aus.
- Navigieren Sie zum gewünschten Verzeichnis.
- Klicken Sie auf OK.
- Um das Installationsverzeichnis zu akzeptieren, wählen Sie Weiter.
- Wählen Sie Install aus.
- Wenn die Installation abgeschlossen ist, wählen Sie Fertigstellen.
ODBC-Treiber unter Windows konfigurieren
Führen Sie diese Schritte aus, um den ODBC-Treiber unter Windows zu konfigurieren.
Sie können Benutzer-DSNs erstellen (auf die nur der Benutzer zugreifen kann, der sie auf der Workstation erstellt hat) oder System-DSNs (auf die jeder Benutzer zugreifen kann, der bei der Workstation angemeldet ist).
-
Ruft den Hostnamen für den SQL-Endpunkt ab, mit dem eine Verbindung hergestellt werden soll.
- Öffnen Sie die Seite "Details" für den SQL-Endpunkt, wenn er aktiv ist.
- Wählen Sie Treiber.
- Wählen Sie unter ODBC-Treiber die Option Details anzeigen aus. Ein Popup-Fenster wird angezeigt.
- Wählen Sie in der Zeichenfolge Hostname die Option Anzeigen aus. Der vollständige Hostname wird angezeigt.
- Wählen Sie in der Zeichenfolge Hostname die Option Kopieren aus. Der vollständige Hostname wird in die Zwischenablage kopiert.
- Speichern Sie den Hostnamen zur späteren Verwendung.
-
DSN erstellen.
-
Öffnen Sie die ODBC-Datenquellen-App.
-
Wählen Sie je nach Bedarf Benutzer-DSN oder System-DSN aus.
-
Klicken Sie auf Hinzufügen.
-
Wählen Sie
Simba OCI Spark ODBC Driver
aus. -
Wählen Sie Fertig.
-
Geben Sie den Namen des DSN ein, z.B.
Data Flow SQL Endpoint
, und fügen Sie optional eine Beschreibung hinzu. -
Zur Authentifizierung können Sie einen API-Signaturschlüssel verwenden, um eine Verbindung zu einem SQL-Endpunkt herzustellen, oder Sie können ein Token (browserbasiert) verwenden, um eine Verbindung zu einem SQL-Endpunkt herzustellen.
- So verwenden Sie einen API-Signaturschlüssel
-
- Setzen Sie die OCI-Konfigurationsdatei auf den absoluten Pfad zur OCI-Konfigurationsdatei, die für die Verbindung verwendet werden soll.
- Legen Sie optional im Feld "OCI-Profil" den Namen des OCI-Profils fest, das für die Verbindung verwendet werden soll. Wenn kein Profil angegeben ist, versucht der Connector, das Profil
DEFAULT
zu verwenden. - Aktivieren Sie SQL_DRIVER_NOPROMPT ignorieren.
- Wählen Sie OK, um die Einstellungen zu speichern.
- So verwenden Sie ein Token (browserbasiert)
- Sie können DFI-Optionen nicht vollständig einrichten und nur den DSN (Schritt-IP) testen, oder DFI-Optionen auswählen und mit den folgenden Schritten fortfahren:
- Setzen Sie das Feld OCI-Konfigurationsdatei auf einen Pfad, der keine OCI-Konfigurationsdatei enthält, um die tokenbasierte Authentifizierung zu verwenden.
- Um einen Webbrowser anzuzeigen, mit dem der tokenbasierte Authentifizierungsfluss auch dann abgeschlossen wird, wenn
SQL_DRIVER_NOPROMPT
aktiviert ist, prüfen Sie SQL_ DRIVER_NOPROMPT ignorieren. - Wählen Sie OK, um die Einstellungen zu speichern.
- Um den DSN zu testen, wählen Sie Test aus.
-
Wählen Sie OK, um den DSN zu erstellen.
-
Verbindung von Tableau mit einem Data Flow SQL-Endpunkt über ODBC herstellen
Führen Sie diese Schritte aus, um Tableau über ODBC mit einem Data Flow SQL-Endpunkt zu verbinden.
- Öffnen Sie Tableau.
-
Wählen Sie Andere Datenbanken (ODBC) aus.
Ein neues Fenster wird geöffnet.
- Prüfen Sie DSN.
-
Wählen Sie den DSN
Data Flow SQL Endpoint
aus der Liste aus.Alle erforderlichen Verbindungsparameter werden automatisch aufgefüllt. - Wählen Sie Anmelden.