Personalizar y ajustar una conexión
Puede personalizar los parámetros de una cadena de conexión y las capacidades de la conexión utilizando un archivo TDC. Esto se aplica tanto a las conexiones ODBC como a las JDBC.
Si quiere personalizar una conexión basada en JDBC, también puede modificar los parámetros de cadena de la conexión en un archivo de propiedades. Para obtener más información, consulte Usar un archivo de propiedades para personalizar una conexión JDBC.
Utilizar un archivo TDC para personalizar una conexión
Nota: Solo puede tener un archivo TDC por conector. Si hay varios archivos TDC que hacen referencia al mismo conector, solo se aplicará uno.
Los archivos TDC (personalización de la fuente de datos de Tableau) son archivos XML con una extensión de nombre de archivo ".tdc". Estos archivos se utilizan para personalizar la configuración específica de Tableau. Para las conexiones basadas en ODBC, también puede usar un archivo TDC para definir las partes de los estándares de ODBC y SQL compatibles con el controlador de ODBC.
Un archivo TDC contiene un nombre de proveedor, un nombre de controlador y una sección <connection-customization> (también incluye la clase). En un conector integrado, el nombre del proveedor y el nombre del controlador deben coincidir con el nombre de clase del conector. Normalmente, el nombre del proveedor coincide con el nombre del controlador. Se utilizan dos nombres de clase genéricos para los conectores de otras bases de datos:
- Para el conector Otras bases de datos (JDBC), el nombre de clase es "genericjdbc".
- Para el conector Otras bases de datos (oDBC), el nombre de clase es "genericodbc".
Si un libro de trabajo o fuente de datos existente ya tiene una sección de personalización habilitada, Tableau solo usará las personalizaciones establecidas y no las que aparecen en el archivo TDC.
Estructura de un archivo TDC
Cada archivo TDC sigue esta estructura básica:
<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 archivo TDC tiene tres secciones principales:
- Variables de personalización de la conexión
- Nombres de proveedor y de controlador
- Las personalizaciones en sí mismas
La sección connection-customization de la conexión incluye lo siguiente:
- class: la fuente de datos a la que desea conectarse y que quiere personalizar.
- enabled: especifica si se aplican las personalizaciones de conexión de archivos TDC. En el archivo TDC, siempre se establece como "true".
- version: Tableau ignora el número de versión.
La siguiente sección es crucial porque identifica el nombre del proveedor y el nombre del controlador del proveedor de la base de datos para la fuente de datos de este archivo TDC. Cada archivo TDC puede enlazar con uno solo tipo de fuente de datos. Para nuestras fuentes de datos nativas, estos nombres deben coincidir con el nombre de clase de la fuente de datos; por ejemplo, "teradata" para nuestras conexiones Teradata. En el caso de las fuentes de datos ODBC, el nombre del proveedor y el nombre del controlador del archivo TDC deben coincidir con lo que la base de datos y el controlador comunican a Tableau; por ejemplo, "SQLite" y "SQLite3 ODBC Driver", respectivamente.
En la última sección se enumeran las personalizaciones de la conexión reales.
A continuación se muestran dos archivos TDC de ejemplo: primero, una conexión ODBC genérica y, segundo, una modificación de una conexión nativa de Salesforce. Tenga en cuenta que estos son solo para fines de ejemplo y las personalizaciones enumeradas no se seleccionan para lograr un objetivo específico.
<?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>Para obtener más información sobre las personalizaciones disponibles, consulte:
Utilizar un archivo de propiedades para personalizar una conexión JDBC
JDBC utiliza los archivos de propiedades y los pasa directamente al controlador JDBC. Se trata de archivos de texto sin formato con la extensión ".properties" en el nombre de archivo. Contienen pares clave-valor para cada parámetro de conexión.
El uso de un archivo de propiedades con una conexión JDBC es similar al uso del parámetro odbc-connect-string-extras en un archivo TDC para conexiones ODBC.
Nota: Un archivo de propiedades debe estar en formato Latin-1 (consulte https://en.wikipedia.org/wiki/.properties(El enlace se abre en una ventana nueva)). Sin embargo, siempre que contenga solo caracteres ASCII, puede guardar el archivo de forma segura en formato UTF-8 sin BOM (marca de orden de bytes).
En el archivo, coloque cada par clave-valor en su propia línea sin delimitador. Asigne al archivo el mismo nombre que su conector correspondiente, pero con la extensión ".properties" en el nombre de archivo. Por ejemplo, el archivo de propiedades del conector de SAP HANA sería "saphana.properties".
Instalación de archivos .tdc y de propiedades
Una vez que se crea un archivo de personalización (ya sea TDC o propiedades), debe colocarse en directorios "Datasources" específicos para que los productos de Tableau los descubran y utilicen. Por ejemplo, si los usuarios van a publicar contenido de Tableau Desktop en Tableau Server, las personalizaciones deben copiarse en ambos directorios de productos.
Después de copiar el archivo en los directorios apropiados, se debe reiniciar Tableau (incluidos todos los nodos si se usa Tableau Server) para que se reconozcan los cambios. Vea a continuación la ruta del directorio en una instalación predeterminada.
Rutas de la aplicación de escritorio de 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/
Rutas de Tableau Server
Nota: Los archivos de personalización deben copiarse en el directorio apropiado para cada nodo de servidor en uso.
- Windows:
- Server:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - Conexiones virtuales:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - Flujos de Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - Creación web de Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux:
- Server:
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - Conexiones virtuales:
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - Flujos de Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - Creación web de Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Después de guardar los archivos de TDC personalizados o de propiedades en la ubicación correcta y de reiniciar las aplicaciones, las propiedades se aplicarán a todas las conexiones de ese mismo tipo de fuente de datos.