Anpassen und Optimieren einer Verbindung
Anpassungen an den Parametern einer Verbindungszeichenfolge und an der Funktionalität einer Verbindung können Sie mithilfe einer TDC-Datei vornehmen. Dies gilt sowohl für ODBC- als auch für JDBC-Verbindungen.
Wenn Sie eine JDBC-basierte Verbindung anpassen, können Sie die Parameter einer Verbindungszeichenfolge auch in einer PROPERTIES-Datei ändern. Einzelheiten dazu finden Sie unter Verwenden einer PROPERTIES-Datei zum Anpassen einer JDBC-Verbindung.
Wichtig: TDC-Dateien können verwendet werden, um die Funktionalität einer Verbindung anzupassen oder um Probleme im Zusammenhang mit der Verbindung zu Ihren Daten zu diagnostizieren und zu lösen. Tableau ist nicht in der Lage, alle möglichen Änderungen, die Sie mit diesen Dateien vornehmen, gründlich zu testen. Das Erstellen und Verwenden von TDC-Dateien erfordert eine manuelle Bearbeitung. Deshalb ist es außerordentlich wichtig, sie gründlich zu testen, bevor sie in einer Produktionsumgebung eingesetzt werden.
Verwendung einer TDC-Datei zur Anpassung einer Verbindung
Hinweis: Pro Connector ist nur eine einzige TDC-Datei möglich. Wenn es mehrere TDC-Dateien gibt, die sich auf denselben Treiber beziehen, wird nur eine einzige angewendet.
TDC-Dateien (Tableau Datasource Customization) sind XML-Dateien mit der Dateinamenerweiterung ".tdc". Diese Dateien werden verwendet, um Tableau-spezifische Einstellungen anzupassen. Für ODBC-basierte Verbindungen können Sie auch eine TDC-Datei verwenden, um Teile der ODBC- und SQL-Standards zu definieren, die der ODBC-Treiber unterstützt.
Eine TDC-Datei enthält den Namen eines Anbieters, den Namen des Treibers und den Abschnitt <connection-customization> (der auch die Klasse enthält). Bei einem integrierten Connector müssen der Name und der Treibername des Herstellers mit dem Klassennamen des Connectors übereinstimmen. Normalerweise stimmt der Name des Anbieters mit dem Namen des Treibers überein. Für die Connectoren "Andere Datenbanken" werden zwei generische Klassennamen verwendet:
- Für den JDBC-Connector (Sonstige Datenbanken) ist der Klassenname "genericjdbc".
- Für den ODBC-Connector (Sonstige Datenbanken) ist der Klassenname "genericodbc".
Wenn eine vorhandene Arbeitsmappe oder Datenquellendatei bereits einen aktivierten Anpassungsabschnitt hat, verwendet Tableau nur die darin definierten Anpassungen und nicht die in der TDC-Datei definierten.
Struktur einer TDC-Datei
Jede TDC-Datei weist diese grundlegende Struktur auf:
<connection-customization class=DSCLASS enabled='true' version='10.0'>
<vendor name=VENDOR />
<driver name=DRIVER />
<customizations>
<customization name='CAP_FAST_METADATA' value='yes'/>
<customization name='CAP_SOMETHING_ELSE' value='yes'/>
...
</customizations>
</connection-customization>Eine TDC-Datei hat drei Hauptabschnitte:
- Verbindungsanpassungsvariablen
- Anbieter- und Treibernamen
- Die Anpassungen selbst
Der Abschnitt connection-customization enthält Folgendes:
- Class (Klasse) Die Datenquelle, mit der Sie eine Verbindung herstellen und die Sie konfigurieren möchten.
- Enabled (Aktiviert) Gibt an, ob die TDC-Dateiverbindungsanpassungen angewendet werden. Ist in der TDC-Datei immer auf "true" festgelegt.
- Version : Tableau ignoriert die Versionsnummer.
Der nächste Abschnitt ist von entscheidender Bedeutung, da er den Herstellernamen und den Treibernamen des Datenbankanbieters für die Datenquelle dieser TDC-Datei identifiziert. Jede TDC-Datei kann nur an einen Datenquellentyp gebunden werden. Für unsere nativen Datenquellen müssen diese Namen mit dem Namen der Datenquellenklasse übereinstimmen, also beispielsweise "teradata" für unsere Teradata-Verbindungen. Bei ODBC-Datenquellen müssen der Herstellername und der Treibername der TDC-Datei mit dem übereinstimmen, was Tableau von der Datenbank und dem Treiber gemeldet wird. z. B. "SQLite" bzw. "SQLite3 ODBC Driver".
Im letzten Abschnitt werden die tatsächlichen Verbindungsanpassungen aufgeführt.
Hier sind zwei Beispieldateien für TDC: Erstens eine generische ODBC-Verbindung und zweitens eine Modifikation einer nativen Salesforce-Verbindung. Beachten Sie, dass dies nur zur Veranschaulichung dient und die aufgeführten Konfigurationen nicht ausgewählt werden, um ein bestimmtes Ziel zu erreichen.
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='genericodbc' enabled='true' version='8.10'>
<vendor name='Gen_ODBC_Vendor'/>
<driver name='Gen_Driver'/>
<customizations>
<customization name='CAP_FAST_METADATA' value='yes' />
<customization name='CAP_ODBC_BIND_FORCE_MAX_STRING_BUFFERS' value='yes' />
<customization name='CAP_ODBC_BIND_PRESERVE_BOM' value='yes' />
</customizations>
</connection-customization>
<?xml version='1.0' encoding='utf-8' ?>
<connection-customization class='salesforce' enabled='true' version='8.10'>
<vendor name='salesforce'/>
<driver name='salesforce'/>
<customizations>
<customization name='CAP_ODBC_EXPORT_CONTINUE_ON_ERROR' value='yes' />
<customization name='CAP_ODBC_EXPORT_FORCE_SINGLE_ROW_BINDING' value='yes' />
<customization name='CAP_ODBC_EXPORT_SUPPRESS_STRING_WIDTH_VALIDATION' value='no' />
</customizations>
</connection-customization>Weitere Informationen über die verfügbaren Anpassungen finden Sie unter:
Verwendung einer PROPERTIES-Datei zum Anpassen einer JDBC-Verbindung
PROPERTIES-Dateien werden von JDBC verwendet und direkt an den JDBC-Treiber weitergeben. Dies sind Nur-Text-Dateien mit der Dateinamenerweiterung ".properties". Sie enthalten Schlüsselwertpaare für jeden Verbindungsparameter.
Die Verwendung einer PROPERTIES-Datei mit einer JDBC-Verbindung ähnelt der Verwendung des odbc-connect-string-extras-Parameters in einer TDC-Datei für ODBC-Verbindungen.
Hinweis: Eine PROPERTIES-Datei sollte im Latin-1-Format sein (siehe https://de.wikipedia.org/wiki/Java-Properties-Datei(Link wird in neuem Fenster geöffnet)). Solange sie jedoch nur ASCII-Zeichen enthält, können Sie die Datei sicher im UTF-8-Format ohne BOM (Byte Order Mark) speichern.
Platzieren Sie in der Datei jedes Schlüsselwertpaar in einer eigenen Zeile ohne Trennzeichen. Geben Sie der Datei denselben Namen wie dem entsprechenden Connector, jedoch mit der Dateinamenerweiterung ".properties". Die PROPERTIES-Datei für den SAP HANA-Connector zum Beispiel würde „saphana.properties“ heißen.
Installieren von TDC- und PROPERTIES-Dateien
Nachdem eine Anpassungsdatei (TDC- oder PROPERTIES-) erstellt wurde, muss sie in bestimmten „Datasource“-Verzeichnissen abgelegt werden, damit sie von Tableau-Produkten erkannt und verwendet werden kann. Wenn Benutzer beispielsweise Inhalte von Tableau Desktop in Tableau Server veröffentlichen werden, sollten die Anpassungen in beide Produktverzeichnisse kopiert werden.
Nachdem die Datei in die entsprechenden Verzeichnisse kopiert wurde, muss Tableau (einschließlich aller Knoten, wenn Tableau Server verwendet wird) neu gestartet werden, damit die Änderungen erkannt werden. Der Verzeichnispfad in einer Standardinstallation lautet wie folgt:
Tableau Desktop-Anwendungspfade
- Desktop/Windows:
C:\Users\myuser\My Tableau Repository\Datasources - Desktop/Mac:
~/Documents/My Tableau Repository/Datasources - Prep Builder/Windows:
C:\Users\myuser\Documents\My Tableau Prep Repository\Datasource - Prep Builder/Mac:
~/Documents/My Tableau Prep Repository/Datasources - Bridge/Windows:
C:\Users\myuser\Documents\My Tableau Bridge Repository\Datasources - Bridge/Linux:
/root/Documents/My_Tableau_Bridge_Repository/Datasources/
Tableau Server-Pfade
Hinweis: Anpassungsdateien müssen für jeden in Gebrauch befindlichen Serverknoten in das entsprechende Verzeichnis kopiert werden.
- Windows:
- Server:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - Virtuelle Verbindungen:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - Prep-Schemas:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - Prep-Webdokumenterstellung:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux:
- Server:
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - Virtuelle Verbindungen:
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - Prep-Schemas:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - Prep-Webdokumenterstellung:
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Nachdem Sie die angepasste TDC- oder PROPERTIES-Datei an dem korrekten Speicherort abgelegt und die Anwendungen neu gestartet haben, wird sie auf alle Verbindungen für Datenquellen dieses Typs angewendet.