Personnalisation et optimisation d’une connexion
Vous pouvez personnaliser les paramètres d'une chaîne de connexion et les capacités de la connexion à l'aide d'un fichier TDC. Ceci s’applique à la fois aux connexions ODBC et JDBC.
Si vous personnalisez une connexion basée sur JDBC, vous pouvez également modifier les paramètres de 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 modification manuelle et 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. S’il existe plusieurs fichiers TDC faisant référence 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 <connection-customization> (qui inclut aussi la classe). Pour un connecteur intégré, le nom du fournisseur et le nom du pilote doivent correspondre au nom de classe du connecteur. Dans la plupart des cas, le nom du fournisseur correspond au nom du pilote. Deux noms de classes 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 pilote du fichier TDC doivent correspondre à ce qui est déclaré à Tableau par la base de données et le pilote, par exemple, « SQLite » et « Pilote SQLite3 ODBC », 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 répertoriées ne sont pas sélectionnées en vue d’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 .properties
Une fois qu’un fichier de personnalisation (TDC ou .properties) est créé, il doit être placé dans un répertoire spécifique « Datasources » pour être 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 deux répertoires de produits.
Une fois le fichier copié dans les répertoires appropriés, vous devez redémarrer Tableau (y compris tous les nœuds si vous utilisez Tableau Server) pour que les modifications soient reconnues. Voir ci-dessous le chemin du répertoire dans une installation par défaut.
Chemins d'accès aux applications de bureau Tableau
- 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 d’accès Tableau Server
Remarque : les fichiers de personnalisation doivent être copiés dans le répertoire approprié pour chaque nœud de serveur utilisé.
- Windows :
- Tableau Server :
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 :
- Tableau Server :
/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/
Une fois que vous avez enregistré les fichiers TDC ou .properties à l’emplacement correct et redémarré les applications, ils sont appliqués à toutes les connexions pour ce même type de source de données.