Aide de Tableau Desktop et de la création Web

Il peut arriver que vous souhaitiez modifier la connexion établie avec un connecteur intégré. Vous pouvez le faire en créant un fichier TDC (Tableau Datasource Customization) qui transmet les modifications de configuration à la connexion à l’aide de la personnalisation odbc-connect-string-extras.

Cet article s’applique aux connecteurs qui utilisent un lecteur d’interface universelle de connexion aux bases de données.

Important : Les fichiers TDC peuvent être utilisés pour personnaliser la fonctionnalité d’une connexion ou pour diagnostiquer et résoudre les problèmes liés à la connexion à vos données. Tableau n’est pas en mesure de tester en profondeur toutes les modifications potentielles que vous pourriez apporter à ces fichiers. La création et l’utilisation de fichiers TDC nécessitent une édition manuelle. De plus, il est essentiel de les tester minutieusement avant de les déployer dans un environnement de production.

Modifier la chaîne de connexion

Lorsque Tableau se connecte à l’aide d’un lecteur d’interface universelle de connexion aux bases de données, il crée une chaîne de connexion et la transmet au gestionnaire de pilotes. La chaîne de connexion identifie le pilote et contient tous les paramètres du pilote.

Voici un exemple de chaîne de connexion :

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

Supposons que vous souhaitez remplacer la valeur DRIVER de BagelDB Driver par BagelDB Driver 2.0 et ajouter un numéro de port. La chaîne de connexion transmise au gestionnaire de pilotes serait modifiée comme suit :

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

Vous pouvez modifier les paramètres de la chaîne de connexion en utilisant un TDC et la balise odbc-connect-string-extras. En général, le seul paramètre qui peut être remplacé est DRIVER. D’autres paramètres sont ajoutés à la fin de la chaîne de connexion. Découvrez comment « Utiliser un fichier TDC » ci-dessous.

Remarque : En raison de restrictions de sécurité, la personnalisation de odbc-connect-string-extras n’est pas entièrement prise en charge sur Tableau Online. Certains paramètres peuvent ne pas être pris en charge.

Utiliser une liste d’autorisations afin de réduire le risque de sécurité

Important : La procédure suivante doit être effectuée par un administrateur de Tableau Server sur Tableau Server, et doit être évaluée par votre service informatique pour garantir le respect des consignes de sécurité de votre organisation.

La personnalisation de odbc-connect-string-extras peut présenter un risque de sécurité. Votre administrateur Tableau Server peut gérer ce risque en spécifiant une liste de paramètres approuvés dans une liste d’autorisations (également appelée liste de sécurité) :

• Tous les paramètres spécifiés par odbc-connect-string-extras qui ne figurent pas dans la liste sont filtrés.
• Si aucun paramètre n’a été spécifié dans la liste, tous les paramètres sont autorisés.

La liste d’autorisations est une liste de valeurs séparées par des virgules sans espaces entre elles.

Par exemple, pour ajouter les paramètres UseDeclareFetch et App à la liste d’autorisations, exécutez les commandes suivantes :

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

tsm pending-changes apply

Pour plus d’informations sur l’exécution des commandes tsm, consultez Référence de ligne de commande tsm(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de Tableau Server.

Utiliser un fichier TDC

Un fichier TDC est un fichier XML qui contient un nom de fournisseur, un nom de pilote et une section <connection-customization> pouvant contenir plusieurs types de personnalisations (pour la chaîne du connexion et pour les fonctionnalités de connexion). Pour un connecteur intégré, le nom du fournisseur et le nom du pilote doivent correspondre au nom de classe du connecteur. Consultez la « Liste des classes de connecteurs intégrés » ci-dessous pour connaître les valeurs. Les classeurs ou les sources de données existants présentant déjà une section de personnalisation activée n’utiliseront que les personnalisations intégrées, et non le fichier TDC.

Après avoir créé un fichier TDC, vous devez l’enregistrer dans le dossier Datasources afin qu’il puisse être utilisé par votre connexion. Si vous créez un classeur que vous souhaitez publier sur Tableau Server, ou si vous utilisez Tableau Prep ou Tableau Bridge, vous devez également enregistrer le fichier TDC dans les répertoires Datasources de ces produits. Pour plus d’informations, consultez Installation des fichiers tdc et de propriétés.

Remarque : Si vous créez une source de données ou un classeur avec des odbc-extras personnalisés, les informations sont intégrées dans les attributs de connexion. Ainsi, vous pouvez publier un classeur ou une source de données sur Tableau Server sans avoir à installer le fichier TDC sur Tableau Server.

Dans le fichier TDC, vous pouvez utiliser la personnalisation odbc-connect-string-extras pour ajouter des attributs ou pour remplacer l’attribut DRIVER dans la chaîne de connexion.

Créer un fichier TDC

1. Ouvrez un éditeur de texte brut, tel que Notepad ou Notepad++.
2. Copiez les informations à partir de l’exemple fourni ci-dessous, collez-les dans votre fichier texte, puis spécifiez la valeur pour la classe, le nom du fournisseur et le nom du pilote. Pour les connecteurs intégrés Tableau, utilisez la même valeur pour la classe, le nom du fournisseur et le nom du pilote.
3. Enregistrez le fichier avec une extension .tdc, par exemple, mybagel.tdc dans le dossier Datasources de chaque produit Tableau. Pour plus d’informations, consultez Installation des fichiers tdc et de propriétés.
4. Entrez les personnalisations souhaitées pour établir la connexion.
   

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

Liste des classes de connecteurs intégrés

Recherchez votre connecteur dans la liste ci-dessous (indiqué sous le format <connecteur>:<classe>) pour obtenir la valeur de la classe dont vous avez besoin pour personnaliser le fichier TDC.

• 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
• Autres bases de données (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

Voir également

Autres bases de données (ODBC) - Décrit comment vous connecter à vos données à l’aide du connecteur ODBC.

Exemple : personnaliser une connexion ODBC – Processus étape par étape montrant comment personnaliser les fonctionnalités et les chaînes de connexion ODBC.

Tableau et ODBC – Fournit des informations d’arrière-plan sur ODBC, décrit comment Tableau détermine le fonctionnement d’un pilote ODBC et répertorie les questions fréquemment posées.

Référence des personnalisations des possibilités de Tableau – Répertorie les personnalisations que vous pouvez utiliser pour définir les fonctionnalités de Tableau qui sont prises en charge par la source de données.

Référence des personnalisations ODBC/SQL – Répertorie les personnalisations qui représentent les parties des normes ODBC et SQL prises en charge par les rapports du lecteur d’interface universelle de connexion aux bases de données.