Help voor Tableau Desktop en webauthoring

Soms kan het nodig zijn om de bestaande verbinding met een systeemeigen connector te wijzigen. U kunt dit doen door een TDC-bestand (Tableau Datasource Customization) te maken dat configuratiewijzigingen doorgeeft aan de verbinding met behulp van de aanpassing odbc-connect-string-extras.

Dit artikel is van toepassing op connectors die gebruikmaken van een ODBC-stuurprogramma.

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.

De verbindingstekenreeks wijzigen

Wanneer Tableau verbinding maakt via een ODBC-stuurprogramma, wordt er een verbindingstekenreeks gemaakt en doorgegeven aan de stuurprogrammamanager. De verbindingstekenreeks identificeert het stuurprogramma en bevat alle parameters voor het stuurprogramma.

Hier ziet u een voorbeeld van een verbindingstekenreeks:

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

Stel dat u de DRIVER-waarde van BagelDB Driver wilt overschrijven met BagelDB Driver 2.0 en een poortnummer wilt toevoegen. De verbindingstekenreeks die aan de stuurprogrammamanager wordt doorgegeven, wordt gewijzigd in:

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

U kunt de parameters voor de verbindingstekenreeks wijzigen met behulp van een TDC- en de odbc-connect-string-extras-tag. Over het algemeen is DRIVER de enige parameter die kan worden overschreven. Andere parameters worden aan het einde van de verbindingstekenreeks toegevoegd. Zie hieronder hoe u een TDC-bestand gebruikt.

Opmerking: Vanwege beveiligingsbeperkingen is er in Tableau Online beperkte ondersteuning beschikbaar voor aanpassing van odbc-connect-string-extras. Sommige parameters worden mogelijk niet ondersteund.

Een toelatingslijst gebruiken om het beveiligingsrisico te verminderen

Belangrijk: De volgende procedure moet worden uitgevoerd door een Tableau Server-beheerder in Tableau Server en moet door uw IT-afdeling worden beoordeeld op naleving van de beveiligingsrichtlijnen van uw organisatie.

De aanpassing odbc-connect-string-extras kan een veiligheidsrisico vormen. Uw Tableau Server-beheerder kan dit risico beperken door een lijst met goedgekeurde parameters op te nemen in een toelatingslijst (ook wel beveiligingslijst genoemd):

• Alle parameters die door odbc-connect-string-extras zijn opgegeven en die niet in de lijst voorkomen, worden uitgefilterd.
• Als er geen parameters in de lijst zijn opgegeven, zijn alle parameters toegestaan.

De toelatingslijst is een door komma's gescheiden lijst zonder spaties tussen de items.

Voer bijvoorbeeld de volgende opdrachten uit om de parameters UseDeclareFetch en App toe te voegen aan de toelatingslijst:

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

tsm pending-changes apply

Zie tsm-opdrachtregelreferentie(Link wordt in een nieuw venster geopend) in de Help van Tableau Server voor meer informatie over het uitvoeren van tsm-opdrachten.

Een TDC-bestand gebruiken

Een TDC-bestand is een XML-bestand met een leveranciernaam, een stuurprogrammanaam en een sectie <connection-customization> dat meerdere typen aanpassingen kan bevatten (zowel aan de verbindingstekenreeks als aan de verbindingsmogelijkheden). Voor een systeemeigen connector moeten de naam van de leverancier en het stuurprogramma overeenkomen met de naam van de connectorklasse. Zie de onderstaande 'Lijst met systeemeigen connectorklassen' voor de waarden. Als een bestaand werkmap- of databronbestand al een ingeschakelde aanpassingssectie heeft, worden alleen de ingesloten aanpassingen gebruikt, en niet het TDC-bestand.

Wanneer u een TDC-bestand maakt, moet u dit opslaan in de map Datasources, zodat het door uw verbinding kan worden gebruikt. Als u een werkmap maakt die u wilt publiceren naar Tableau Server of als u Tableau Prep of Tableau Bridge gebruikt, moet u het TDC-bestand ook opslaan in de directory's Datasources voor die producten. Zie TDC- en eigenschappenbestanden installeren voor meer informatie.

Opmerking: Als u een databron of werkmap met aangepaste odbc-extras maakt, wordt de informatie ingesloten in de verbindingskenmerken. Hierdoor kunt u een werkmap of databron publiceren naar Tableau Server zonder dat u het TDC-bestand op Tableau Server hoeft te installeren.

In het TDC-bestand kunt u de aanpassing odbc-connect-string-extras gebruiken om kenmerken toe te voegen aan of het DRIVER-kenmerk te overschrijven voor de verbindingstekenreeks.

Een TDC-bestand maken

1. Open een eenvoudig tekstbewerkingsprogramma, zoals Kladblok of Kladblok++.
2. Kopieer de informatie uit het onderstaande voorbeeld, plak deze in uw tekstbestand en geef vervolgens de klasse en de leveranciers- en stuurprogrammanaam op. Voor systeemeigen Tableau-connectors gebruikt u dezelfde waarde voor klasse, leveranciersnaam en stuurprogrammanaam.
3. Sla het bestand op met de extensie .tdc, bijvoorbeeld: mybagel.tdc in de map Datasources voor elk Tableau-product. Zie TDC- en eigenschappenbestanden installeren voor meer informatie.
4. Geef de aanpassingen op die u in de verbinding wilt aanbrengen.
   

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

Lijst met systeemeigen connectorklassen

Zoek uw connector in de onderstaande lijst (vermeld in de indeling <connector>:<klasse>) om de klassewaarde te verkrijgen die u nodig hebt voor het aanpassen van het TDC-bestand.

• 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
• Other Databases (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

Zie ook

Andere databases (ODBC) – Beschrijft hoe u via de ODBC-connector verbinding kunt maken met uw data.

Voorbeeld: Een ODBC-verbinding aanpassen - Stapsgewijs proces waarin wordt getoond hoe u mogelijkheden en ODBC-verbindingstekenreeksen kunt aanpassen.

Tableau en ODBC – Biedt achtergrondinformatie over ODBC, beschrijft hoe Tableau de functionaliteit van een ODBC-stuurprogramma bepaalt en geeft een overzicht van veelgestelde vragen.

Referentie Tableau-functieaanpassingen – Hierin vindt u een overzicht van de aanpassingen waarmee u kunt definiëren welke Tableau-functies door de databron worden ondersteund.

Referentie ODBC/SQL-aanpassingen – Geeft een lijst met aanpassingen weer die de onderdelen van de ODBC- en SQL-standaarden vertegenwoordigen waarvan het ODBC-stuurprogramma rapporteert dat ze worden ondersteund.