Personalizar la cadena de conexión para conectores nativos

Se aplica a: Tableau Desktop

Hay ocasiones en las que puede que desee modificar la conexión realizada con el conector nativo. Puede hacerlo creando un archivo TDC (personalización de fuente de datos de Tableau) que pase los cambios de configuración a la conexión mediante la personalización odbc-connect-string-extras.

Este artículo se aplica a los conectores que utilizan un controlador ODBC.

Importante: Los archivos TDC se pueden utilizar para personalizar la funcionalidad de una conexión o para diagnosticar y resolver problemas relacionados con la conexión a sus datos. Tableau no puede probar exhaustivamente cada posible modificación que pueda realizar con estos archivos. La creación y el uso de archivos TDC requiere edición manual y es fundamental probarlos exhaustivamente antes de implementarlos en un entorno de producción.

Modificar la cadena de conexión

Cuando Tableau se conecta mediante un controlador ODBC, crea y pasa una cadena de conexión al administrador del controlador. La cadena de conexión identifica al controlador y contiene todos los parámetros del controlador.

A continuación se muestra un ejemplo de cadena de conexión:

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

Digamos que desea anular el valor DRIVER de BagelDB Driver con BagelDB Driver 2.0 y agregar un número de puerto. La cadena de conexión pasada al administrador de controladores se modificaría a la siguiente:

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

Puede modificar los parámetros de la cadena de conexión utilizando un TDC y la etiqueta odbc-connect-string-extras. En general, el único parámetro que se puede anular es DRIVER. Otros parámetros se añaden al final de la cadena de conexión. Consulte cómo "usar un archivo TDC" a continuación.

Nota: Debido a restricciones de seguridad, existe un soporte limitado para la personalización odbc-connect-string-extras en Tableau Online. Es posible que algunos parámetros no sean compatibles.

Utilizar una lista de admisión para reducir el riesgo de seguridad

Importante: El siguiente procedimiento debe ser realizado por un administrador de Tableau Server en Tableau Server y debe ser evaluado por su departamento de TI para verificar que cumpla con las pautas de seguridad de su organización.

La personalización odbc-connect-string-extras puede presentar un riesgo de seguridad. El administrador de Tableau Server puede gestionar este riesgo especificando una lista de parámetros aprobados en una lista de admisión (también conocida como lista de seguridad):

  • Cualquier parámetro especificado por odbc-connect-string-extras que no esté en la lista se filtrará.
  • Si no hay parámetros especificados en la lista, se permiten todos los parámetros.

La lista de admisión es una lista separada por comas sin espacios entre ellas.

Por ejemplo, para agregar los parámetros UseDeclareFetch y App en la lista de admisión, ejecute los siguientes comandos:

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

Para obtener más información sobre ejecutar comandos tsm, consulte Referencia de línea de comandos de tsm(El enlace se abre en una ventana nueva) en la ayuda de Tableau Server.

Utilizar un archivo TDC

Un archivo TDC es un archivo XML que contiene un nombre de proveedor, un nombre de controlador y una sección <connection-customization> que puede contener múltiples tipos de personalizaciones (tanto de la cadena de conexión como de las capacidades de conexión). En un conector nativo, el nombre del proveedor y el nombre del controlador deben coincidir con el nombre de clase del conector. Consulte la "Lista de clases de conector nativo" a continuación para conocer los valores. Cualquier libro de trabajo o archivo de fuente de datos que ya tenga una sección de personalización habilitada solo usará las personalizaciones insertadas, no el archivo TDC.

Una vez creado el archivo TDC, debe guardarlo en la carpeta Datasources para que su conexión pueda usarlo. Si crea un libro de trabajo que desea publicar en Tableau Server, o si usa Tableau Prep o Tableau Bridge, deberá guardar el archivo TDC en las carpetas Datasources de esos productos. Para obtener más información, consulte Instalar archivos .tdc y de propiedades.

Nota: Si crea una fuente de datos o un libro de trabajo con odbc-extras personalizados, la información se integra en los atributos de conexión. Gracias a esto, puede publicar un libro de trabajo o una fuente de datos en Tableau Server sin tener que instalar el archivo TDC en Tableau Server.

En el archivo TDC, puede utilizar la personalización odbc-connect-string-extras para anexar atributos o anular el atributo DRIVER a la cadena de conexión.

Crear un archivo TDC

  1. Abra un editor de texto sin formato, por ejemplo, el Bloc de notas o Notepad++.
  2. Copie la información de la muestra que se proporciona a continuación, cópiela en el archivo de texto y, después, especifique el valor de clase, nombre del proveedor y nombre del controlador. Para los conectores nativos de Tableau, utilice el mismo valor para la clase, el nombre del proveedor y el nombre del controlador.
  3. Guarde el archivo con una extensión .tdc (por ejemplo, mybagel.tdc) en la carpeta Datasources de cada producto de Tableau. Para obtener más información, consulte Instalar archivos .tdc y de propiedades.
  4. Escriba las personalizaciones que quiera realizar en la conexión.

 

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

Lista de clases de conectores nativos

Ubique su conector en la lista a continuación (en el formato <conector>:<clase>) para obtener el valor de clase que necesita para personalizar el archivo TDC.

  • Actian Matrix: paraccel
  • Actian Vector: vectorwise
  • Amazon Aurora: aurora
  • Amazon EMR (Hive): awshadowophive
  • 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
  • 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

Consulte también

Otras bases de datos (ODBC): describe cómo conectar los datos con el conector ODBC.

Ejemplo: personalizar una conexión ODBC - Proceso detallado que muestra cómo se puede lograr la personalización de las capacidades y las cadenas de conexión ODBC.

Tableau y ODBC: en este artículo se proporciona información general sobre ODBC, se describe cómo determina Tableau la funcionalidad de un controlador ODBC y se enumeran las preguntas más frecuentes.

Referencia de las personalizaciones de las capacidades de Tableau: en este artículo se enumeran las personalizaciones que puede usar para definir las capacidades de Tableau que admite la fuente de datos.

Referencia de las personalizaciones de ODBC/SQL: en este artículo se enumeran las personalizaciones que representan las partes de los estándares ODBC y SQL admitidas por los informes del controlador ODBC.

Volver arriba
¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!