Hjälp om Tableau Desktop och webbredigering

Du kan anpassa parametrarna för en anslutningssträng och för själva anslutningen med en TDC-fil. Detta gäller både ODBC- och JDBC-anslutningar.

Om du anpassar en JDBC-baserad anslutning kan du även ändra parametrarna för anslutningssträngen i en egenskapsfil. Mer information finns i Använda en egenskapsfil för att anpassa en JDBC-anslutning.

Viktigt: TDC-filer kan användas för att anpassa funktionaliteten för en anslutning eller för att diagnostisera och lösa problem relaterade till anslutning till dina data. Tableau kan inte noggrant testa alla potentiella ändringar du kan göra med dessa filer. Att skapa och använda TDC-filer kräver manuell redigering och det är viktigt att testa dem noggrant innan de distribueras i en produktionsmiljö.

Använda en TDC-fil för att anpassa anslutningen

Obs! Du kan bara ha en TDC-fil per koppling. Om det finns flera TDC-filer som hänvisar till samma koppling kommer bara en att användas.

TDC-filer (Tableau Datasource Customization) är XML-filer med ett .tdc-filnamnstillägg. De här filerna används för att anpassa Tableau-specifika inställningar. Det går även att använda TDC-filer för att definiera de ODBC-delar och SQL-standarder som ODBC-drivrutinen har stöd för i ODBC-baserade anslutningar.

En TDC-fil innehåller ett leverantörsnamn, ett drivrutinsnamn och ett <connection-customization>-avsnitt (inkluderar även klass). Namnet på leverantören och drivrutinen måste matcha klassnamnet på den interna kopplingen. Vanligtvis matchar leverantörsnamnet drivrutinsnamnet. Två allmänna klassnamn används för kopplingar för andra databaser:

• Vid användning av andra databaskopplingar (JDBC) är klassnamnet ”genericjdbc”.
• Vid användning av andra databaskopplingar (ODBC) är klassnamnet ”genericodbc”.

Om delar av den befintliga arbetsboken eller datakällfilen har anpassats redan används enbart de anpassade delarna i Tableau, inte de i TDC-filen.

Strukturen på en TDC-fil

Varje TDC-fil följer den här grundläggande strukturen:

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

En TDC-fil har tre huvudsektioner:

• Anpassningsvariabler för anslutningar
• Namn på leverantörer och drivrutiner
• Själva anpassningarna

Avsnittet connection-customization inkluderar följande:

• class: Den datakälla som du vill ansluta till och anpassa.
• enabled: Anger om anpassningarna av TDC-filanslutningen tillämpas. Alltid satt till ”sant” i TDC-filen.
• version: Tableau ignorerar versionsnumret.

Nästa avsnitt är avgörande då det identifierar leverantörens och drivrutinens namn gällande databasleverantören för den här TDC-filens datakälla. Varje TDC-fil kan endast kopplas till en datakälla. För våra inbyggda datakällor måste båda dessa namn matcha datakällans klassnamn – såsom ”teradata” för våra Teradata-anslutningar. För ODBC-datakällor måste leverantörens och drivrutinens namn för TDC-filen matcha det som rapporteras till Tableau av databasen och drivrutinen – såsom ”SQLite” och ”SQLite3 ODBC Driver”, respektive.

Det sista avsnittet listar de faktiska anslutningsanpassningarna.

Två exempel på TDC-filer är en generisk ODBC-anslutning och en ändring av en inbyggd Salesforce-anslutning. Observera att detta endast är exempel och att anpassningarna som anges inte har valts för att uppnå ett specifikt mål.

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

Du hittar mer information om tillgängliga anpassningar i:

• Tableau JDBC-funktionsanpassningar

• Referens för funktionsanpassningar i Tableau

• ODBC/SQL-anpassningsreferens

Använda en egenskapsfil för att anpassa en JDBC-anslutning

Egenskapsfiler används i JDBC-anslutningen direkt via JDBC-drivrutinen. De är filer med oformaterad text och ett ”.properties”-filnamnstillägg. De innehåller nyckelvärdespar för varje anslutningsparameter.

Användning av egenskapsfiler med JDBC-anslutningar liknar användningen av odbc-connect-string-extras-parametrar i TDC-filer för ODBC-anslutningar.

Obs! Egenskapsfiler ska ha Latin-1-format (se https://en.wikipedia.org/wiki/.properties(Länken öppnas i ett nytt fönster)). Det går däremot att spara filen i UTF-8-format utan BOM (Byte Order Mark) så länge den endast innehåller ASCII-tecken.

Placera nyckelvärdesparet på en egen rad utan avgränsare i filen. Ge filen samma namn som på motsvarande koppling men lägg till filnamnstillägget ”.properties”. Egenskapsfilen för en SAP HANA-koppling blir till exempel ”saphana.properties”.

Installera tdc- och egenskapsfiler

När en anpassningsfil (antingen en TDC-fil eller en egenskapsfil) har skapats måste den placeras i specifika datakällsmappar för att kunna identifieras och användas av Tableau-produkter. Om användare till exempel ska publicera innehåll från Tableau Desktop till Tableau Server måste anpassningarna kopieras till båda produktkatalogerna.

När filen har kopierats till lämpliga kataloger måste Tableau (inklusive alla noder om Tableau Server används) startas om för att ändringarna ska träda i kraft. Katalogsökvägen i en standardinstallation anges nedan.

Programsökvägar för Tableau Desktop

• 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-sökvägar

Obs! Anpassningsfiler måste kopieras till rätt katalog för varje servernod som används.

• Windows:
• Server: C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number>
• Virtuella anslutningar: C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources
• Prep-flöden: C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources
• Prep-webbredigering: C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources
• Linux:
• Server: /var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/
• Virtuella anslutningar: /var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/
• Prep-flöden: /var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/
• Prep-webbredigering: /var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/

När du har sparat den anpassade TDC-filen eller egenskapsfilen på rätt plats och startar om programmet används de på alla anslutningar med samma typ av datakälla.

Andra artiklar i det här avsnittet