Personalizar e ajustar uma conexão
Você pode fazer personalizações nos parâmetros de uma cadeia de caracteres de conexão e nos recursos da conexão usando um arquivo TDC. Isso se aplica tanto às conexões ODBC quanto às JDBC.
Se você estiver personalizando uma conexão baseada em JDBC, também poderá modificar os parâmetros da string de conexão em um arquivo de propriedades. Para obter detalhes, consulte Usar um arquivo de propriedade para personalizar uma conexão JDBC.
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.
Use um arquivo TDC para personalizar uma conexão
Observação: você só pode ter um arquivo TDC por conector. Se houver vários arquivos TDC referentes ao mesmo conector, apenas um será aplicado.
Os arquivos TDC (Tableau Datasource Customization) são arquivos XML com uma extensão de nome de arquivo “.tdc”. Eles são usados para personalizar configurações específicas do Tableau. Para conexão baseada em ODBC, você também pode usar um arquivo TDC para definir partes dos padrões ODBC e SQL compatível com o driver ODBC.
Um arquivo TDC contém o nome do fornecedor, o nome do driver e a seção <connection-customization> (também inclui a classe). Para um conector inserido, o nome do fornecedor e o nome do driver devem corresponder ao nome da classe do conector. Normalmente, o nome do fornecedor corresponde ao nome do driver. Dois nomes de classe genéricos são usados para os conectores de outros bancos de dados:
- Para o conector Outros bancos de dados (JDBC), o nome da classe é "genericjdbc".
- Para o conector Outros bancos de dados (JDBC), o nome da classe é "genericodbc".
Se uma pasta de trabalho ou arquivo de fonte de dados existente já tiver uma seção de personalização habilitada, o Tableau usará apenas as personalizações que ele define e não as definidas no arquivo TDC.
Estrutura de um arquivo TDC
Cada arquivo TDC segue esta estrutura 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>Um arquivo TDC possui três seções principais:
- Variáveis de personalização de conexão
- Nomes do fornecedor e driver
- As próprias personalizações
A seção connection-customization inclui o seguinte:
- Classe : a fonte de dados à qual você deseja se conectar e personalizar.
- ativado : especifica se as personalizações de conexão de arquivos TDC foram aplicadas. No arquivo TDC, sempre definido como “true”.
- Versão: o Tableau ignora o número da versão.
A próxima seção é fundamental porque identifica o nome do fornecedor e o nome do driver do provedor de banco de dados para a fonte de dados deste arquivo TDC. Cada arquivo TDC pode ser vinculado a apenas um tipo de fonte de dados. Para nossas fontes de dados nativas, esses nomes devem corresponder ao nome da classe da fonte de dados, por exemplo, “teradata” para nossas conexões Teradata. Para fontes de dados ODBC, o nome do fornecedor e o nome do driver do arquivo TDC devem corresponder ao relatório do Tableau pelo banco de dados e pelo driver, por exemplo, “SQLite” e “SQLite3 ODBC Driver”, respectivamente.
A seção final lista as personalizações de conexão reais.
Aqui estão dois exemplos de arquivos TDC: primeiro, uma conexão ODBC genérica e, segundo, uma modificação em uma conexão nativa do Salesforce. Observe que eles são apenas para fins de exemplo e as personalizações listadas não são selecionadas para atingir um 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 obter mais informações sobre as personalizações disponíveis,consulte:
Use um arquivo de propriedades para personalizar uma conexão JDBC
Os arquivos de propriedade são usados pelo JDBC e transferidos diretamente para o driver JDBC. São arquivos de texto simples com uma extensão de nome de arquivo ".properties". Eles contêm pares de valor-chave para cada parâmetro de conexão.
Usar um arquivo de propriedades com uma conexão JDBC é semelhante ao uso do parâmetro odbc-connect-string-extras em um arquivo TDC para conexões ODBC.
Observação: um arquivo de propriedades deve estar no formato Latin-1 (ver https://en.wikipedia.org/wiki/.properties(O link abre em nova janela)). No entanto, desde que inclua apenas caracteres ASCII, você pode salvar o arquivo com segurança no formato UTF-8 sem uma marca BOM (marca de ordem de byte).
No arquivo, coloque cada par de valor de chave na própria linha sem delimitador. Dê ao arquivo o mesmo nome do conector correspondente, mas com uma extensão de nome de arquivo ".properties". Por exemplo, o arquivo de propriedades do conector SAP HANA seria "saphana.properties".
Instalação de arquivos tdc e de propriedades
Depois que um arquivo de personalização (TDC ou propriedades) for criado, ele deverá ser colocado em diretórios específicos de "Fontes de dados" para que seja descoberto e usado pelos produtos Tableau. Por exemplo, se os usuários forem publicar conteúdo do Tableau Desktop no Tableau Server, as personalizações deverão ser copiadas para ambos os diretórios de produtos.
Depois que o arquivo for copiado para os diretórios apropriados, o Tableau (incluindo todos os nós, se estiver usando o Tableau Server) deverá ser reiniciado para que as alterações sejam reconhecidas. Veja abaixo o caminho do diretório em uma instalação padrão.
Caminhos do aplicativo 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/
Caminhos do Tableau Server
Observação: os arquivos de personalização devem ser copiados para o diretório apropriado para cada nó de servidor em uso.
- Windows:
- Server:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources
C:\Program Files\Tableau\Tableau Server\packages\bin.<build number> - Conexões virtuais:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\minerva\Datasources - Fluxos do Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowprocessor\Datasources - Criação na Web do Prep:
C:\Program Files\Tableau\Tableau Server\data\tabsvc\flowminerva\Datasources - Linux:
- Server:
/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/ - Conexões virtuais:
/var/opt/tableau/tableau_server/data/tabsvc/minerva/Datasources/ - Fluxos do Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowprocessor/Datasources/ - Criação na Web do Prep:
/var/opt/tableau/tableau_server/data/tabsvc/flowminerva/Datasources/
Depois de salvar o TDC personalizado ou os arquivos de propriedades no local correto e reiniciar os aplicativos, eles serão aplicados a todas as conexões desse mesmo tipo de origem de dados.