Ajuda para criação na Web e Tableau Desktop

Haverá momentos em que você pode querer modificar a conexão feita com o conector nativo. Você pode fazer isso criando um arquivo TDC (Tableau Datasource Customization) que passa alterações de configuração para a conexão usando a personalização odbc-connect-string-extras.

Este artigo se aplica a conectores que usam um driver ODBC.

Importante: os arquivos TDC podem ser utilizados para personalizar a funcionalidade de uma conexão ou para diagnosticar e resolver problemas relacionados à conexão com seus dados. O Tableau não consegue testar exaustivamente todas as possíveis modificações que você pode fazer com esses arquivos. Criar e usar arquivos TDC requer edição manual e é crucial testá-los completamente antes de implantá-los em um ambiente de produção.

Modificar a cadeia de caracteres de conexão

Quando o Tableau se conecta usando um driver ODBC, ele cria e passa uma sequência de conexão para o gerenciador de driver. A cadeia de caracteres de conexão identifica o driver e contém todos os parâmetros do driver.

Aqui está um exemplo de cadeia de caracteres de conexão:

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

Digamos que você queira substituir o valor DRIVER do BagelDB Driver pelo BagelDB Driver 2.0 e adicionar um número de porta. A cadeia de caracteres de conexão passada ao gerenciador de driver seria modificada para:

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

Você pode modificar os parâmetros da cadeia de caracteres de conexão usando um TDC e a marca odbc-conexão-string-extras. Em geral, o único parâmetro que pode ser substituído é DRIVER. Outros parâmetros são acrescentados ao final da cadeia de caracteres de conexão. Veja como “Usar um arquivo TDC” abaixo.

Observação: devido a restrições de segurança, há suporte limitado para o odbc-conexão-string-extras personalização no Tableau Online. Alguns parâmetros podem não ser suportados.

Usar uma lista de permissões para reduzir o risco de segurança

Importante: o procedimento a seguir precisa ser executado por um administrador do Tableau Server no Tableau Server e deve ser avaliado pelo seu departamento de TI quanto à conformidade com as diretrizes de segurança da sua organização.

A personalização odbc-conexão-string-extras pode representar um risco à segurança. O administrador do Tableau Server pode gerenciar esse risco especificando uma lista de parâmetros aprovados em uma lista de permissões (também conhecida como lista de segurança):

• Todos os parâmetros especificados por odbc-connect-string-extras que não estão na lista serão filtrados.
• Se não houver parâmetros especificados na lista, todos os parâmetros serão permitidos.

A lista de permissões é uma lista separada por vírgulas e sem espaços entre elas.

Por exemplo, para adicionar os parâmetros UseDeclareFetch e App para a lista segura, execute os seguintes comandos:

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

tsm pending-changes apply

Para obter informações sobre executando comandos tsm o consulte Referência da linha de comando do tsm(O link abre em nova janela) na Ajuda do Tableau Server.

Usar um arquivo TDC

Um arquivo TDC é um arquivo XML que contém um nome de fornecedor, um nome de driver e uma seção <connection-customization> que pode conter vários tipos de personalizações (tanto para a cadeia de caracteres de conexão quanto para os recursos de conexão). Para um conector nativo, o nome do fornecedor e o nome do driver devem corresponder ao nome da classe do conector. Veja a "Lista de classes de conectores nativos" abaixo para obter valores. Qualquer arquivo da pasta de trabalho ou da fonte de dados existente que já tenha uma seção de personalização habilitada usará apenas as de visualizações, não o arquivo TDC.

Ao criar um arquivo TDC, é necessário salvá-lo pasta Datasources que ele possa ser usado pela conexão. Se você criar uma pasta de trabalho que deseja publicar no Tableau Server ou se usar o Tableau Prep ou o Tableau Bridge, será necessário salvar também o arquivo TDC nos diretórios Datasources para esses produtos. Para obter mais informações, consulte o arquivo Instalação de tdc e arquivos de propriedades.

Observação: se você criar uma fonte de dados ou pasta de trabalho com odbc-extras personalizados, as informações serão inseridas nos atributos de conexão. Por isso, você pode publicar uma pasta de trabalho ou fonte de dados no Tableau Server sem precisar instalar o arquivo TDC no Tableau Server.

No arquivo TDC, você pode usar a personalização odbc-connect-string-extras para acrescentar atributos ou substituir o atributo DRIVER à cadeia de caracteres de conexão.

Criar um arquivo TDC

1. Abra um editor de texto simples, como, por exemplo, o Bloco de Notas ou Notepad++.
2. Copie as informações do exemplo fornecido abaixo, cole-as no arquivo de texto e especifique o valor da classe, do nome do fornecedor e do nome do driver. Para conectores nativos do Tableau, use o mesmo valor para classe, nome do fornecedor e nome do driver.
3. Salve o arquivo com uma extensão .tdc — por exemplo, mybagel.tdc — para a pasta Datasources em cada produto do Tableau. Para obter mais informações, consulte o arquivo Instalação de tdc e arquivos de propriedades.
4. Insira as personalização que você quer para fazer a conexão.
   

<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 classes de conectores nativos

Localize seu conector na lista abaixo (listada no formato <conector>:<classe>) para obter o valor de classe necessário para personalizar o arquivo 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
• MongoDB BI Connector: mongodb
• MySQL: mysql
• Oracle Essbase: essbase
• Outros bancos de dados (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 também

Outros bancos de dados (ODBC) – Descreve como conectar-se aos seus dados usando o conector ODBC.

Exemplo: personalizar uma conexão ODBC - Processo passo a passo mostrando como a personalização pode ser feita para recursos e cadeias de caracteres de conexão ODBC.

Tableau e ODBC – Fornece informações de contexto sobre o ODBC, descreve como Tableau determina a funcionalidade de um driver ODBC e lista as perguntas mais frequentes.

Referência de personalizações de recurso do Tableau – Lista as personalizações que você pode usar para definir quais recursos do Tableau são suportados pela fonte de dados.

Referência de personalizações do ODBC/SQL – Lista as personalizações que representam as partes dos padrões ODBC e SQL suportadas pelo driver ODBC.