As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conecte-se ao Amazon DocumentDB a partir do Tableau Desktop
<a name="connect-jdbc-tableau"></a>

**Topics**
+ [Adicionar o driver JDBC do Amazon DocumentDB](#connect-jdbc-tableau-adddriver)
+ [Conectar-se ao Amazon DocumentDB usando o Tableau - Túnel SSH](#connect-jdbc-tableau-ssh)

## Adicionar o driver JDBC do Amazon DocumentDB
<a name="connect-jdbc-tableau-adddriver"></a>

Para se conectar ao Amazon DocumentDB a partir do Tableau Desktop, você deve fazer o download e instalar o driver JDBC do Amazon DocumentDB e o conector DocumentDB Tableau.

1. Faça o download do arquivo JAR do driver JDBC do Amazon DocumentDB no [repositório do driver JDBC do Amazon DocumentDB](https://github.com/aws/amazon-documentdb-jdbc-driver/releases) e copie-o em um desses diretórios de acordo com seu sistema operacional:
   + *Windows* - `C:\Program Files\Tableau\Drivers`
   + *MacOS* - `~/Library/Tableau/Drivers`

1. *Baixe o conector DocumentDB Tableau (um arquivo TACO) do [site do Tableau Exchange](https://exchange.tableau.com/products/821) e copie-o para o diretório Meu Tableau. Repository/Connectors *
   + *Windows* - `C:\Users\[user]\Documents\My Tableau Repository\Connectors`
   + *MacOS* - `/Users/[user]/Documents/My Tableau Repository/Connectors`

Para obter informações, consulte a [Documentação do Tableau](https://tableau.github.io/connector-plugin-sdk/docs/run-taco).

**nota**  
[Se você estiver usando certificados CA mais recentes, certifique-se de atualizar seu driver JDBC para a versão v1.4.5 (disponível neste repositório). AWS GitHub ](https://github.com/aws/amazon-documentdb-jdbc-driver/releases/tag/v1.4.5)

## Conectar-se ao Amazon DocumentDB usando o Tableau - Túnel SSH
<a name="connect-jdbc-tableau-ssh"></a>

Para se conectar ao Tableau a partir de uma máquina cliente fora da VPC do seu cluster do DocumentDB, você deve configurar um túnel SSH antes de seguir as etapas abaixo:

1. Inicie a aplicação Tableau Desktop.

1. Navegue até **Connect** > **To A Server** > **More**. 

1.  Escolha **Amazon DocumentDB da Amazon Web Services** em **Conectores instalados**.  
![A interface Conectar no Tableau Desktop mostra o submenu Mais... na seção A um servidor. A opção Amazon DocumentDB está destacada no submenu Conectores instalados.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-choose-docdb.png)

**Conectar-se ao Amazon DocumentDB usando o Tableau - Túnel SSH externo**

1. Insira os parâmetros de conexão necessários **Nome do host**, **porta**, **banco de dados**, **nome de usuário** e **senha**. Os parâmetros de conexão no exemplo abaixo são equivalentes à cadeia de conexão JDBC: 

   `jdbc:documentdb://localhost:27019/test? tls=true&tlsAllowInvalidHostnames=true&scanMethod=random&scanLimit=1000&loginTimeoutSec=0&readPreference=primary&retryReads=true&schemaName=_default` com os parâmetros de nome de usuário e senha passados separadamente em uma coleção de propriedades. Para obter mais informações sobre os parâmetros da cadeia de conexão, consulte a documentação do github do [driver JDBC do Amazon DocumentDB ](https://github.com/aws/amazon-documentdb-jdbc-driver/blob/develop/src/markdown/setup/connection-string.md).   
![Guia geral na interface do conector Amazon DocumentDB mostrando os campos de nome do host, porta, banco de dados, nome de usuário e senha.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-connect.png)

1. (Opcional) Opções mais avançadas podem ser encontradas na guia **Avançado**.  
![Guia avançada na interface do conector Amazon DocumentDB mostrando opções adicionais de conexão.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-advanced.png)

1. Escolha **Logon**.

**Conectar-se ao Amazon DocumentDB usando o Tableau - Túnel SSH interno**
**nota**  
Se você preferir não configurar o túnel SSH usando um terminal, você pode usar a GUI do Tableau para especificar os detalhes da sua instância EC2, que o driver JDBC usará inerentemente para criar um túnel SSH. 

1. Na guia **Avançado**, escolha a **opção Ativar túnel SSH** para revisar outras propriedades.  
![Guia avançada na interface do conector Amazon DocumentDB com a opção Ativar túnel de SSH selecionada e campos de entrada de SSH adicionais mostrados.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-advanced-Enablessh.png)

1. Insira o **usuário SSH**, o **nome do host SSH** e o **arquivo de chave privada SSH.** 

1. (Opcional) É possível desativar a opção **SSH Strict Host Key Check**, que ignora a verificação da chave do host em relação a um arquivo host conhecido.
**nota**  
Desativar essa opção é menos seguro, pois pode levar a um [man-in-the-middle](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)ataque.  
![Guia avançada na interface do conector Amazon DocumentDB com a opção Verificação rigorosa da chave do host de SSH desabilitada.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-advanced-sshhostkeycheck.png)

1. Insira os parâmetros necessários; **Nome do host**, **porta**, **banco de dados**, **nome de usuário** e **senha**.
**nota**  
Certifique-se de usar o endpoint do cluster DocumentDB e não o localhost ao usar a opção de túnel SSH interno.  
![Guia geral na interface do conector Amazon DocumentDB mostrando os campos de nome do host, porta, banco de dados, nome de usuário e senha.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/jdbc/tableau-hostname.png)

1. Selecione **Fazer login**.