Een verbinding aanpassen en afstemmen

U kunt een verbinding aanpassen met gebruik van een TDC-bestand.

Als u een JDBC-gebaseerde verbinding aanpast, kunt u ook een PROPERTY-bestand aanpassen. Zie PROPERTIES-bestand gebruiken om een JDBC-verbinding aan te passen voor meer informatie.

Speciale tekens

Speciale tekens moeten worden voorzien van correcte escape-tekens. Of dit nodig is, hangt af van de positie van het teken. Als bijvoorbeeld het gelijkteken '=' in de waarde is opgenomen, moeten rechts van de eerste '=' de juiste escape-tekens worden geplaatst.

Voorbeeld:

ServiceLocation=Region=east;Name=prod;

moet worden geschreven als: ServiceLocation=Region\=east;Name\=prod;

Een TDC-bestand gebruiken om een verbinding aan te passen

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 <connection-customization> (omvat ook de klasse)sectie. 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.

Zie Een TDC-bestand met Tableau Server gebruiken(Link wordt in een nieuw venster geopend) in de Tableau-knowledgebase voor meer informatie.

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'/>
        ...
    </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.

Zie Tableau JDBC-functieaanpassingen voor meer informatie.

Een PROPERTIES-bestand gebruiken om een JDBC-verbinding aan te passen

PROPERTIES-bestanden 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 PROPERTIES-bestand 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 PROPERTIES-bestand 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 PROPERTIES-bestand voor de SAP HANA-connector zou bijvoorbeeld 'saphana.properties' zijn.

  • Voor Tableau Desktop plaatst u PROPERTIES-bestanden in deze map:

    My Tableau Repository/Datasources

  • Om een PROPERTIES-bestand voor Tableau Server in te schakelen plaatst u het voor elk serverknooppunt in deze map:

    Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources

    Linux: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/

  • Voor Prep Flows plaatst u PROPERTIES-bestanden in deze mappen:

    Linux:

    /var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/

    /var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/

    Windows:

    ProgramData\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources

    ProgramData\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources

  • Voor virtuele verbindingen plaatst u PROPERTIES-bestanden in deze map:

    Linux: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/

    Windows: ProgramData\Tableau\Tableau Server\data\tabsvc\minerva\Datasources

Nadat u het bestand op de juiste locatie hebt opgeslagen, worden de eigenschappen toegepast op alle JDBC-verbindingen voor hetzelfde databrontype.

Een werkmap publiceren met een JDBC-gebaseerde verbinding

Als u een werkmap wilt publiceren via een JDBC-gebaseerde verbinding, moet u een kopie van het PROPERTIES-bestand toevoegen aan de Tableau Desktop- en de Tableau Server-computer.

Zie ook

De verbindingstekenreeks voor een native connector aanpassen(Link wordt in een nieuw venster geopend) – In dit artikel in Tableau Community wordt beschreven hoe u een verbinding kunt wijzigen die met een native connector is gemaakt met aanpassing van odbc-connect-string-extras.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.