Aide de Tableau Desktop et de la création Web

Il peut arriver que vous souhaitiez modifier la connexion établie avec un connecteur natif. Pour cela, vous allez créer 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 pilote ODBC.

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 modification manuelle et 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 pilote ODBC, il crée et transmet une chaîne de connexion au gestionnaire de pilotes. La chaîne de connexion identifie le pilote et contient tous ses paramètres.

Voici un exemple de chaîne de connexion :

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

Imaginons que vous souhaitiez remplacer la valeur DRIVER du pilote BagelDB 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 pouvant ê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 des restrictions de sécurité, la prise en charge est limitée pour la personnalisation odbc-connect-string-extras sur Tableau Online. Certains paramètres peuvent ne pas être pris en charge.

Utiliser une liste d’autorisations pour réduire les risques de sécurité

Important : la procédure suivante doit être effectuée par un administrateur Tableau Server sur Tableau Server et doit être évaluée par votre service informatique pour vérifier sa conformité avec les consignes de sécurité de votre organisation.

La personnalisation 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 exclus.
• Si aucun paramètre n’est spécifié dans la liste, alors tous les paramètres sont autorisés.

La liste d’autorisations est une liste d’éléments séparés par des virgules sans espaces entre deux éléments.

Par exemple, pour ajouter les paramètres UseDeclareFetch et App pour accéder à 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 des 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 incluant un nom de fournisseur, un nom de pilote et une section <connection-customization> pouvant contenir plusieurs types de personnalisations (à la fois sur la chaîne du connexion et sur les fonctionnalités de connexion). Pour un connecteur natif, le nom du fournisseur et le nom du pilote doivent correspondre au nom de classe du connecteur. Consultez la « Liste des classes de connecteurs natifs » ci-dessous pour connaître les valeurs. Les sources de données ou les classeurs existants sur lesquels une section de personnalisation a déjà été activée n’utiliseront que les personnalisations intégrées, et non le fichier TDC.

Une fois que vous avez 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 sur les répertoires Datasources de ces produits. Pour plus d’informations, consultez Installation de fichiers TDC et .properties.

Remarque : si vous créez une source de données ou un classeur avec des chaînes personnalisées odbc.extras, les informations sont intégrées dans les attributs de connexion. Vous pouvez ainsi 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 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 classe, le nom du fournisseur et la valeur de nom du pilote. Pour les connecteurs Tableau natifs, 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 pour chaque produit Tableau. Pour plus d’informations, consultez Installation de fichiers TDC et .properties.
4. Entrez les personnalisations que vous souhaitez apporter à 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 natifs

Localisez votre connecteur dans la liste ci-dessous (répertorié au format <connecteur>:<classe>) pour obtenir la valeur de 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
• Connecteur MongoDB BI : 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

Voir également

Autres bases de données (ODBC) : décrit la connexion à vos données à l’aide du connecteur ODBC.

Exemple : personnaliser une connexion ODBC : processus étape par étape montrant comment effectuer la personnalisation pour 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 de pilote ODBC.