Zusammenfassung der Schritte:
- Kopieren Sie die tnsnames.ora Datei zu einem Speicherort, auf den der Tableau-Benutzer Zugriff hat
- Stellen Sie die Berechtigungen auf der Datei ein.
- Aktualisieren Sie falls nötig die TNS_ADMIN-Umgebungsvariable, sodass sie zum Directory in Schritt (1) weist.
Schritt 1: Kopieren Sie die tnsnames.ora Datei zu einem Directory, auf das der unbefugte Benutzer (Tableau) Zugriff hat.
Für Versionen 2019.3.x und höher:
Kopieren Sie die tnsnames.ora Datei zum /etc Directory.
Für Versionen 2019.2.x und früher:
Standardmäßig wird der unbefugte Benutzer 'Tableau' genannt. Alle Tableau Server-Prozesse, die mit diesem Konto ausgeführt werden, müssen dazu fähig sein, die tnsnames.ora Datei zu finden, um Sie zu verwenden.
Falls Sie den Oracle-Connector bereits installiert haben, empfehlen wir Ihnen, die Datei zum Directory /opt/tableau/tableau_driver/oracle zu kopieren.
Sie können bestätigen, dass das Directory dem Benutzer zugänglich ist, indem Sie 'su' verwenden, um zum Konto zu wechseln und zum Directory zu wechseln. Beispiel:
sudo su tableau
cd /opt/tableau/tableau_driver/oracle
Falls diese Schritte in einem „Zugriff verweigert“ Fehler resultieren, müssen Sie die Berechtigungen im Directory, das Sie verwenden, updaten.
Schritt 2: Stellen Sie die Berechtigungen für die Datei „tnsnames.ora“ ein.
2019.2.x und früher, befolgen Sie die Schritte unten:
- Navigieren Sie zum Verzeichnis, in dem sich die Datei tnsnames.ora befindet.
- Gewähren Sie über den folgenden Befehl Berechtigungen für die Datei: chmod 666 tnsnames.ora
- Prüfen Sie die Dateiberechtigungen über folgenden Befehl: ls -l
Hinweis: Der Umgebungspfad sollte
keinen nachgestellten Schrägstrich haben. Falls das Format des Pfads fehlerhaft ist, können Benutzer möglicherweise auf einen ORA-12154 Fehler stoßen.
2019.3 und neuer:Platzieren Sie die tsnames.ora-Datei im
/etc-Verzeichnis auf dem Linux-Computer. Keine Umgebungsvariable benötigt.
Version 2020.2 und neuer:Erstellen Sie eine /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/oracle.properties-Datei mit dem folgenden Text:
Beispiel:
oracle.net.tns_admin=/etcÄndern Sie bei Bedarf den
/etc-Pfad, um auf den Pfad der Datei „tnsnames.ora“ im Dateisystem auf Ihrem Server zu verweisen.
Weitere Informationen zu JDBC-Eigenschaftendateien finden Sie hier:
https://kb.tableau.com/articles/howto/Customizing-JDBC-Connections?lang=de-de
Schritt 3: Stellen Sie die TNS_ADMIN-Umgebungsvariable so ein, dass sie zum Verzeichnis in Schritt (1) weist.
Für Versionen 2019.3.x und höher: Sie können diesen Schritt überspringen. Keine Umgebungsvariable wird erfordert.
Für Versionen 2019.2.x und früher:
- Öffnen Sie in einem Texteditor die Datei, die Ihrer Version von Tableau Server entspricht:
- Tableau Server 2018.1.x - 2019.2 -- /var/opt/tableau/tableau_server/.local/share/systemd/user/tabsvc_0.service
- Fügen Sie die folgende Zeile hinzu, wo "/path/to/file-folder" das Directory ist, zu dem Sie tnsnames.ora in Schritt 1 kopiert haben:
- Environment=TNS_ADMIN=/path/to/file-folder
- Speichen Sie die Änderungen an der Datei.
Hinweis: Der Umgebungspfad darf keinen nachgestellten Schrägstrich haben. Wenn das Format des Pfads nicht korrekt ist, können Benutzer einen ORA-12154-Fehler erhalten.
ZUM ANZEIGEN DER LÖSUNG KLICKEN
Alle Umgebungen
Optionale Schritte
Finden von tnsnames.ora Dateien
Falls der Oracle-Client auf Ihrem Server installiert ist, befindet sich die tnsnames.ora Datei im folgenden Verzeichnis: $ORACLE_HOME/network/admin.
Sie können mit den folgenden Befehlen überprüfen, ob diese Datei existiert:
echo $ORACLE_HOME
druckt den Dateipfad aus.
sudo find / -iname tnsnames.ora
listet die Speicherorte aller tnsnames.ora-Dateien in Ihrem Dateisystem auf.
Hinweis: Der Oracle-Client muss nicht installiert sein, um „tnsnames.ora“ mit Tableau Server zu verwenden. Dieser Schritt besteht, um Ihnen zu helfen mit einer bestehenden Installation zu arbeiten.
Eine neue tnsnames.ora Datei vom Beginn an erstellen
Falls keine tnsnames.ora Datei auf diesem Computer vorhanden ist und Sie keine aus einem Client-Arbeitsplatz kopieren können, können Sie diese mit einem Texteditor erstellen. Beachten Sie die folgenden Einschränkungen:
-
Bei der Datei „tnsnames.ora“ wird die Groß- und Kleinschreibung berücksichtigt, die Bezeichnung muss komplett in Kleinbuchstaben erfolgen.
-
Die Datei sollte keine Tabulatorabstände verwenden.
Unten sehen Sie eine mögliche Vorlage für den Eintrag. Die Elemente in eckigen Klammern müssen durch Werte ersetzt werden, die Sie von Ihrem Datenbankadministrator erhalten.
Hinweis: Für die Datei „TNSNames.ora“ ist unter Windows oder Mac kein ADDRESS_LIST-Eintrag erforderlich. Unter Linux wird diese Variable in der Datei „tnsnames.ora“ allerdings benötigt.
[net_service_name]=
(DESCRIPTION=
(ADDRESS_LIST=
(ADDRESS=[protocol_address_information])
)
(CONNECT_DATA=
(SERVICE_NAME=[service_name])
)
)
Beispiel:
Production =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = prod.corp.com)(PORT = 1521)
)
(CONNECT_DATA =
(SERVICE_NAME = orcl)
)
)