Personnalisation et optimisation d’une connexion
Vous pouvez personnaliser les paramètres d’une chaîne de connexion et les fonctionnalités de la connexion à l’aide d’un fichier TDC. Ceci s’applique aux connexions ODBC et JDBC.
Si vous personnalisez une connexion basée sur JDBC, vous pouvez également modifier les paramètres de la chaîne de connexion dans un fichier de propriétés. Pour plus de détails, consultez Utiliser un fichier de propriétés pour personnaliser une connexion JDBC.
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.
Utiliser un fichier TDC pour personnaliser une connexion
Remarque : Vous ne pouvez avoir qu’un seul fichier TDC par connecteur. Si plusieurs fichiers TDC renvoient au même connecteur, un seul sera appliqué.
Les fichiers TDC (Tableau Datasource Customization) sont des fichiers XML portant une extension de fichier « .tdc ». Ces fichiers sont utilisés pour personnaliser les paramètres spécifiques à Tableau. Pour une connexion basée sur ODBC, vous pouvez également utiliser un fichier TDC pour définir les parties des normes ODBC et SQL prises en charge par le pilote ODBC.
Un fichier TDC contient un nom de fournisseur, un nom de pilote et la section <connection-customization> (comprend également la classe). Pour un connecteur intégré, le nom du fournisseur et le nom du pilote doivent correspondre au nom de classe du connecteur. Généralement, le nom du fournisseur correspond au nom du pilote. Deux noms de classe génériques sont utilisés pour les connecteurs Autres bases de données :
- Pour le connecteur Autres bases de données (JDBC), le nom de la classe est « genericjdbc ».
- Pour le connecteur Autres bases de données (ODBC), le nom de la classe est « genericodbc ».
Si une section de personnalisation est déjà activée pour des classeurs ou des sources de données existants, Tableau utilise uniquement les personnalisations qu’il définit et non celles définies dans le fichier TDC.
Structure d’un fichier TDC
Chaque fichier TDC suit cette structure de base :
<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>Un fichier TDC comporte trois sections principales :
- Variables de personnalisation de la connexion
- Noms du fournisseur et du pilote
- Les personnalisations elles-mêmes
La section connection-customization comporte les éléments suivants :
- classe : La source de données à laquelle vous souhaitez vous connecter et que vous souhaitez personnaliser.
- activé : Indique si les personnalisations de la connexion du fichier TDC sont appliquées. Dans le fichier TDC, définissez toujours sur « true ».
- version : Tableau ignore le numéro de version.
La section suivante est cruciale car elle identifie le nom du fournisseur et le nom du pilote du fournisseur de la base de données pour la source de données de ce fichier TDC. Chaque fichier TDC ne peut être lié qu’à un seul type de source de données. Pour nos sources de données natives, ces noms doivent tous deux correspondre au nom de classe de la source de données, par exemple « Teradata » pour nos connexions Teradata. Pour les sources de données ODBC, le nom du fournisseur et le nom du lecteur du fichier TDC doivent correspondre à ce qui est déclaré à Tableau par la base de données et le lecteur, par exemple, « SQLite » et « Lecteur d’interface universelle de connexion aux bases de données SQLite3 », respectivement.
La dernière section énumère les personnalisations de connexion réelles.
Voici deux exemples de fichiers TDC : le premier est une connexion ODBC générique et le deuxième est une modification d'une connexion Salesforce native. Veuillez noter que ces informations sont fournies à titre d'exemple uniquement et que les personnalisations présentées ne sont pas sélectionnées pour atteindre un objectif spécifique.
<?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>Pour plus d’informations sur les personnalisations disponibles, consultez :
Utiliser un fichier de propriétés pour personnaliser une connexion JDBC
Les fichiers de propriétés sont utilisés par JDBC et transmis directement au pilote JDBC. Il s’agit de fichiers en texte simple avec une extension de nom de fichier « .properties ». Ils contiennent des paires clé/valeur pour chaque paramètre de connexion.
L’utilisation d’un fichier de propriétés avec une connexion JDBC est similaire à l’utilisation du paramètre odbc-connect-string-extras dans un fichier TDC pour les connexions ODBC.
Remarque : Un fichier de propriétés doit être au format Latin-1 (voir https://fr.wikipedia.org/wiki/.properties(Le lien s’ouvre dans une nouvelle fenêtre)). Toutefois, tant qu’il n’inclut que des caractères ASCII, vous pouvez enregistrer le fichier en toute sécurité au format UTF-8 sans BOM (byte order mark, ou marque d’ordre d’octet).
Dans le fichier, placez chaque paire clé/valeur sur sa propre ligne sans délimiteur. Donnez au fichier le même nom que son connecteur correspondant, mais avec une extension de nom de fichier « .properties ». Par exemple, le fichier de propriétés pour le connecteur SAP HANA serait « saphana.properties ».
Installation des fichiers tdc et de propriétés
Une fois qu’un fichier de personnalisation (TDC ou de propriétés) est créé, il doit être placé dans des répertoires « Sources de données » spécifiques pour qu’il soit découvert et utilisé par les produits Tableau. Par exemple, si les utilisateurs publient du contenu de Tableau Desktop vers Tableau Server, les personnalisations doivent être copiées dans les répertoires des deux produits.
Une fois le fichier copié dans les répertoires concernés, Tableau (y compris tous les nœuds si vous utilisez Tableau Server) doit être redémarré pour que les modifications soient prises en compte. Vous trouverez ci-dessous le chemin du répertoire dans une installation par défaut.
Chemins des applications 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/
Chemins de Tableau Server
Remarque : Les fichiers de personnalisation doivent être copiés dans le répertoire concerné pour chaque nœud de serveur utilisé.
- Windows :
- Serveur :
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - Connexions virtuelles :
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - Flux Prep :
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - Création Web Prep :
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux :
- Serveur :
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - Connexions virtuelles :
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - Flux Prep :
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - Création Web Prep :
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Après avoir enregistré les fichiers TDC ou de propriétés personnalisés au bon emplacement et redémarré les applications, ils seront appliqués à toutes les connexions pour ce même type de source de données.