Help voor Tableau Desktop en webauthoring

Met gebruik van een TDC-bestand kunt u aanpassingen maken aan de parameters van een verbindingstekenreeks en aan de mogelijkheden van de verbinding. Dit geldt voor zowel ODBC- als JDBC-verbindingen.

Als u een op JDBC gebaseerde verbinding aanpast, kunt u ook de parameters van een verbindingstekenreeks in een eigenschappenbestand aanpassen. Zie Een eigenschappenbestand gebruiken om een JDBC-verbinding aan te passen voor meer informatie.

Belangrijk: U kunt TDC-bestanden gebruiken om de functionaliteit van een verbinding aan te passen of om verbindingsproblemen met uw data te diagnosticeren en op te lossen. Tableau is niet in staat niet elke mogelijke wijziging die u in deze bestanden kunt aanbrengen grondig te testen. Het maken en gebruiken van TDC-bestanden vereist handmatige bewerking en het is van cruciaal belang om ze grondig te testen voordat u ze in een productieomgeving implementeert.

Een TDC-bestand gebruiken om een verbinding aan te passen

Opmerking: U kunt slechts één TDC-bestand per connector gebruiken. Als er meerdere TDC-bestanden naar dezelfde connector verwijzen, wordt er slechts één toegepast.

TDC-bestanden (Tableau Datasource Customization) zijn XML-bestanden met de bestandsnaamextensie TDC. Deze bestanden worden gebruikt om Tableau-specifieke instellingen aan te passen. Voor een ODBC-gebaseerde verbinding kunt u ook een TDC-bestand gebruiken om delen van de ODBC- en SQL-standaarden te definiëren die het ODBC-stuurprogramma ondersteunt.

Een TDC-bestand bevat een leveranciersnaam, een stuurprogrammanaam en een sectie <connection-customization> (omvat ook de klasse). Voor een ingebouwde connector moeten de naam van de leverancier en het stuurprogramma overeenkomen met de klassenaam van de connector. Normaal gesproken komt de naam van de leverancier overeen met de naam van het stuurprogramma. Er worden twee algemene klassenamen gebruikt voor de Other Databases-connectors:

• Voor de connector van andere databases (JDBC) is de klassenaam 'genericjdbc'.
• Voor de connector van andere databases (ODBC) is de klassenaam 'genericodbc'.

Als een bestaand werkmap- of databronbestand al een ingeschakelde aanpassingssectie heeft, gebruikt Tableau alleen de daardoor gedefinieerde aanpassingen, en niet de aanpassingen die in het TDC-bestand zijn gedefinieerd.

Structuur van een TDC-bestand

Elk TDC-bestand volgt deze basisstructuur:

<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>

Een TDC-bestand bestaat uit drie hoofdonderdelen:

• Variabelen voor het aanpassen van de verbinding
• Namen van leverancier en stuurprogramma
• De aanpassingen zelf

Het deel connection-customization bevat het volgende:

• klasse: de databron waarmee u verbinding wilt maken en die u wilt aanpassen.
• ingeschakeld: geeft aan of de aanpassingen voor de TDC-bestandsverbinding worden toegepast. In het TDC-bestand altijd ingesteld op ’true’.
• versie: Tableau negeert het versienummer.

Het volgende gedeelte is van cruciaal belang omdat het de leveranciersnaam en de naam van het stuurprogramma van de databaseprovider voor de databron van dit TDC-bestand identificeert. Elk TDC-bestand kan aan maximaal één databrontype worden gekoppeld. Voor onze eigen databronnen moeten deze namen overeenkomen met de naam van de databronklasse. Bijvoorbeeld ’teradata’ voor onze Teradata-verbindingen. Voor ODBC-databronnen moeten de leveranciersnaam en de naam van het stuurprogramma van het TDC-bestand overeenkomen met wat door de database en het stuurprogramma aan Tableau wordt gemeld. Bijvoorbeeld respectievelijk ‘SQLite’ en ’SQLite3 ODBC-stuurprogramma’.

In het laatste gedeelte worden de daadwerkelijke verbindingsaanpassingen vermeld.

Hier zijn twee voorbeelden van TDC-bestanden: ten eerste een generieke ODBC-verbinding en ten tweede een wijziging van een native Salesforce-verbinding. Houd er rekening mee dat deze slechts ter illustratie dienen en dat de vermelde aanpassingen niet zijn geselecteerd om een specifiek doel te bereiken.

<?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>

Voor meer informatie over de beschikbare aanpassingen gaat u naar:

• Tableau JDBC-functieaanpassingen

• Referentie Tableau-functieaanpassingen

• Referentie ODBC/SQL-aanpassingen

Een eigenschappenbestand gebruiken om een JDBC-verbinding aan te passen

Eigenschappenbestanden worden door JDBC gebruikt en rechtstreeks doorgegeven aan het JDBC-stuurprogramma. Dit zijn platte-tekstbestanden met de bestandsnaamextensie “PROPERTIES”. Ze bevatten sleutelwaardeparen voor elke verbindingsparameter.

Het gebruik van een eigenschappenbestand met een JDBC-verbinding is vergelijkbaar met het gebruik van de parameter odbc-connect-string-extras in een TDC-bestand voor ODBC-verbindingen.

Opmerking: Een eigenschappenbestand moet de indeling Latin-1 hebben (zie https://en.wikipedia.org/wiki/.properties(Link wordt in een nieuw venster geopend)). Zolang het bestand echter alleen ASCII-tekens bevat, kunt u het bestand veilig opslaan in UTF-8-indeling zonder een BOM (byte order mark).

Plaats elk sleutelwaardepaar in het bestand op een eigen regel, zonder scheidingsteken. Geef het bestand dezelfde naam als de corresponderende connector, maar met de bestandsnaamextensie PROPERTIES. Het eigenschappenbestand voor de SAP HANA-connector zou bijvoorbeeld 'saphana.properties' zijn.

TDC- en eigenschappenbestanden installeren

Nadat een aanpassingsbestand (TDC- of eigenschappenbestand) is gemaakt, moet het in specifieke 'Databronnen'-directory's worden geplaatst, zodat het door Tableau-producten kan worden gevonden en gebruikt. Als gebruikers bijvoorbeeld inhoud publiceren van Tableau Desktop naar Tableau Server, moeten de aanpassingen naar beide productdirectory's worden gekopieerd.

Nadat het bestand naar de juiste directory's is gekopieerd, moet Tableau (en alle knooppunten als Tableau Server wordt gebruikt) opnieuw worden opgestart om de wijzigingen door te voeren. Zie hieronder het directorypad in een standaardinstallatie.

Paden voor Tableau-desktoptoepassingen

• Bureaublad/Windows: C:\Users\myuser\My Tableau Repository\Datasources
• Bureaublad/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-paden

Opmerking: Aanpassingsbestanden moeten voor elk gebruikt serverknooppunt naar de juiste directory worden gekopieerd.

• Windows:
• Server: C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number>
• Virtuele verbindingen: C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources
• Prep-flows: C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources
• Prep-webauthoring: C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources
• Linux:
• Server: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/
• Virtuele verbindingen: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/
• Prep-flows: /var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/
• Prep-webauthoring: /var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/

Nadat u de aangepaste TDC- of eigenschappenbestanden op de juiste locatie hebt opgeslagen en de toepassingen opnieuw hebt opgestart, worden de bestanden toegepast op alle verbindingen voor hetzelfde databrontype.

Andere artikelen in deze sectie