Anpassa anslutningssträngen för inbyggda kopplingar

Det kan finnas tillfällen då du vill ändra den anslutning som upprättats med en inbyggd koppling. Du kan göra detta genom att skapa en TDC-fil (Tableau Datasource Customization) som skickar konfigurationsändringar till anslutningen med hjälp av anpassningen odbc-connect-string-extras.

Den här artikeln gäller kopplingar som använder en ODBC-drivrutin.

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

Ändra anslutningssträngen

När Tableau ansluter med en ODBC-drivrutin skapas och skickas en anslutningssträng till drivrutinshanteraren. Anslutningssträngen identifierar drivrutinen och innehåller alla parametrar för drivrutinen.

Det här är ett exempel på en anslutningssträng:

DRIVER=BagelDB Driver;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;

Anta att du vill åsidosätta DRIVER-värdet för BagelDB-drivrutinen med BagelDB Driver 2.0 och lägga till ett portnummer. Anslutningssträngen som skickas till drivrutinshanteraren skulle ändras till:

DRIVER=BagelDB Driver 2.0;SERVER=bageldb.lan;UID=creamcheese;PWD=bagel;PORT=54321

Du kan ändra parametrarna för anslutningssträngen genom att använda en TDC-fil och taggen odbc-connect-string-extras. I allmänhet är det bara parametern DRIVER som kan åsidosättas. Andra parametrar läggs till i slutet av anslutningssträngen. Läs mer om hur du använder en TDC-fil nedan.

Obs! Av säkerhetsskäl är stödet för anpassningen odbc-connect-string-extras begränsat i Tableau Online. Vissa parametrar kanske inte stöds.

Använd en godkännandelista för att minska säkerhetsrisken

Viktigt: Följande procedur måste utföras av en Tableau Server-administratör på Tableau Server och bör utvärderas av IT-avdelningen så att den följer organisationens säkerhetsriktlinjer.

Anpassningen odbc-connect-string-extras kan utgöra en säkerhetsrisk. Tableau Server-administratören kan minska den här risken genom att ange en lista med godkända parametrar i en godkännandelista:

  • Alla parametrar som anges i odbc-connect-string-extras som inte finns i den listan filtreras bort.
  • Om inga parametrar har angetts i listan är alla parametrar tillåtna.

Godkännandelistan är en kommaavgränsad lista utan mellanslag.

Om du till exempel vill lägga till parametrarna UseDeclareFetch och App i godkännandelistan kör du följande kommandon:

tsm configuration set -k native_api.ODBCConnectStringSecurityList -v UseDeclareFetch,App --force-keys
tsm pending-changes apply

Mer information om hur du använder tsm-kommandon finns i tsm-kommandoradsreferensen(Länken öppnas i ett nytt fönster) i Tableau Server-hjälpen.

Använda en TDC-fil

En TDC-fil är en XML-fil som innehåller ett leverantörsnamn, ett drivrutinsnamn och ett <connection-customization>-avsnitt som kan innehålla flera typer av anpassningar (både av anslutningssträngen och själva anslutningen). För en inbyggd koppling måste leverantörsnamnet och drivrutinsnamnet matcha kopplingens klassnamn. Du hittar värdena i avsnittet ”Lista över klasser för inbyggda kopplingar” nedan. Alla befintliga arbetsböcker eller datakällor som redan har ett aktiverat anpassningsavsnitt använder bara de inbäddade anpassningarna, inte TDC-filen.

När du har skapat en TDC-fil måste du spara den i mappen Datasources så att den kan användas av anslutningen. Om du skapar en arbetsbok som du vill publicera på Tableau Server, eller om du använder Tableau Prep eller Tableau Bridge, måste du spara TDC-filen i mappen Datasources för dessa produkter också. Mer information finns i Installera tdc- och egenskapsfiler.

Obs! Om du skapar en datakälla eller arbetsbok med anpassade odbc-extras, bäddas informationen in i anslutningsattributen. Detta är anledningen till att du kan publicera en arbetsbok eller datakälla på Tableau Server utan att installera TDC-filen på Tableau Server.

I TDC-filen kan du använda anpassningen odbc-connect-string-extras för att lägga till attribut eller åsidosätta DRIVER-attributet för anslutningssträngen.

Skapa en TDC-fil

  1. Öppna en vanlig textredigerare, som Anteckningar eller Anteckningar++.
  2. Kopiera informationen från exemplet nedan, klistra in den i textfilen och ange sedan värdena för klass, leverantörsnamn och drivrutinsnamn. För inbyggda Tableau-kopplingar använder du samma värde för klass, leverantörsnamn och drivrutinsnamn.
  3. Spara filen med filtillägget .tdc – till exempel, mybagel.tdc – i mappen Datasources för varje Tableau-produkt. Mer information finns i Installera tdc- och egenskapsfiler.
  4. Ange de anpassningar som du vill göra för anslutningen.

 

<connection-customization class='bagelDB' enabled='true' version='19.1'>
<vendor name='bagelDB' />
<driver name='bagelDB' />
<customizations>
<customization name='odbc-connect-string-extras' value='DRIVER=BagelDB Driver 2.0;PORT=54321' />
</customizations>
</connection-customization>

Lista över klasser för inbyggda kopplingar

Leta upp din koppling i listan nedan (visas i formatet <koppling>:<klass>) för att hitta det klassvärde du behöver för att anpassa TDC-filen.

  • Actian Matrix: paraccel
  • Actian Vector: vectorwise
  • Amazon Aurora: aurora
  • Amazon EMR (Hive): awshadoophive
  • Amazon Redshift: redshift
  • Spark SQL: spark
  • Aster Database: asterncluster
  • Azure SQL Data Warehouse: azure_sql_dw
  • Cloudera Hadoop: hadoophive
  • Denodo: denodo
  • Exasol : exasolution
  • Firebird : firebird
  • Google Cloud SQL: googlecloudsql
  • Hortonworks Hadoop Hive: hortonworkshadoophive
  • IBM: BigInsights bigsql
  • IBM DB2: db2
  • IBM PDA (Netezza): netezza
  • Kognitio: kognitio
  • MapR Hadoop Hive: maprhadoophive
  • MariaDB: mariadb
  • MarkLogic: marklogic
  • MemSQL: memsql
  • Microsoft SQL Server: sqlserver
  • MonetDB: monetdb
  • MongoDB BI Connector: mongodb
  • MySQL: mysql
  • Oracle Essbase: essbase
  • Andra databaser (ODBC): genericodbc
  • Pivotal Greenplum Database: greenplum
  • PostgreSQL: postgres
  • Presto: presto
  • Progress OpenEdge: progressopenedge
  • SAP HANA: saphana
  • SAP Sybase ASE: sybasease
  • SAP Sybase IQ: sybaseiq
  • Snowflake: snowflake
  • Splunk: splunk
  • Teradata: teradata
  • Tibco Data Virtualization: composite
  • Vertica: vertica

Se även

Andra databaser (ODBC) – Beskriver hur du ansluter till dina data med hjälp av ODBC-kopplingen.

Exempel: Anpassa en ODBC-anslutning – Visar steg för steg hur anpassningar kan utföras för funktioner och ODBC-anslutningssträngar.

Tableau och ODBC – Tillhandahåller bakgrundsinformation om ODBC, beskriver hur Tableau fastställer funktionerna hos en ODBC-drivrutin och listar vanliga frågor.

Referens för funktionsanpassningar i Tableau – Listar anpassningar som du kan använda för att definiera vilka Tableau-funktioner som stöds av datakällan.

ODBC/SQL-anpassningsreferens – Listar anpassningar som representerar de delar av ODBC- och SQL-standarderna som ODBC-drivrutinen rapporterar att den stöder.

Tack för din feedback!Din feedback har skickats in. Tack!