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 Microsoft Power BI Desktop
<a name="connect-odbc-power-bi"></a>

**Topics**
+ [Pré-requisitos](#odbc-power-bi-prerequisites)
+ [Adicionar o conector personalizado do Microsoft Power BI Desktop](#odbc-adding-power-bi)
+ [Conexão usando o conector personalizado do Amazon DocumentDB](#odbc-connect-custom-connector)
+ [Configurar o Microsoft Power BI Gateway](#odbc-power-bi-gw)

## Pré-requisitos
<a name="odbc-power-bi-prerequisites"></a>

Antes de começar, certifique-se de que o driver ODBC do Amazon DocumentDB esteja instalado corretamente.

## Adicionar o conector personalizado do Microsoft Power BI Desktop
<a name="odbc-adding-power-bi"></a>

Copie o arquivo `AmazonDocumentDBConnector.mez` para a pasta `<User>\Documents\Power BI Desktop\Custom Connectors\` (ou para `<User>\OneDrive\Documents\Power BI Desktop\Custom Connectors` se estiver usando o OneDrive). Isso permitirá que o Power BI acesse o conector personalizado. É possível obter o conector para o Power BI Desktop [aqui](https://github.com/aws/amazon-documentdb-odbc-driver/releases). Reinicie o Power BI Desktop para garantir que o conector esteja carregado.

**nota**  
O conector personalizado só oferece suporte ao nome de usuário e senha do Amazon DocumentDB para autenticação.

## Conexão usando o conector personalizado do Amazon DocumentDB
<a name="odbc-connect-custom-connector"></a>

1. Selecione Amazon DocumentDB (Beta) em **Obter dados** e clique em **Conectar**. Se você receber um aviso por usar um serviço de terceiros, clique em **Continuar**.  
![A opção da interface Obter dados com o Amazon DocumentDB (Beta) foi destacada.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/get-data-1.png)

1. Insira todas as informações necessárias para se conectar ao seu cluster Amazon DocumentDB e clique em **OK**:  
![Formulário com os campos de entrada de detalhes da conexão para um cluster do Amazon DocumentDB.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-form-1.png)
**nota**  
Dependendo da configuração do nome da fonte de dados (DSN) do driver ODBC, a tela de detalhes da conexão SSH pode não ser exibida se você já tiver fornecido as informações necessárias nas configurações do DSN.

1. Escolha o modo de conectividade de dados:
   + **Importar** - carrega todos os dados e armazena as informações no disco. Os dados devem ser atualizados e recarregados para mostrar as atualizações dos dados.
   + **Consulta direta** - não carrega dados, mas faz consultas em tempo real sobre os dados. Isso significa que os dados não precisam ser atualizados e recarregados para mostrar as atualizações de dados.  
![Interface mostrando as opções do modo de conectividade de dados para o DocumentDB.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/data-connectivity-1.png)
**nota**  
Se você estiver usando um conjunto de dados muito grande, a importação de todos os dados pode levar mais tempo.

1. Se for a primeira vez que você se conecta a essa fonte de dados, selecione o tipo de autenticação e insira suas credenciais quando solicitado. Depois, clique em **Conectar**:  
![Interface de autenticação mostrando os campos de entrada para as credenciais de nome de usuário e senha.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-credentials-1.png)

1. Na caixa de diálogo **Navegador**, selecione as tabelas do banco de dados desejadas e clique em **Carregar** para carregar os dados ou em **Transformar dados** para continuar transformando os dados.  
![Interface do navegador mostrando uma lista de tabelas de banco de dados para escolher. Os botões Carregar e Transformar Dados estão no canto inferior direito.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/navigator-1.png)
**nota**  
As configurações da fonte de dados são salvas quando você se conecta. Para modificá-las, selecione **Transformar dados** > **Configurações da fonte de dados**.

## Configurar o Microsoft Power BI Gateway
<a name="odbc-power-bi-gw"></a>

**Pré-requisitos**:
+ Verifique se o conector personalizado funcionará com o Power BI Gateway.
+ Verifique se o DSN ODBC foi criado nas fontes de dados ODBC na guia **Sistema** na máquina em que o Power BI Gateway está instalado.

Se você estiver usando o atributo de túnel SSH interno, o arquivo `known_hosts` precisará estar localizado onde a conta de serviço do Power BI tenha acesso a ele.

![A interface de propriedades known_hosts mostrando permissões para PBIEgwService.](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/ssh-known-hosts-1.png)


**nota**  
Isso também se aplica a qualquer arquivo que você possa precisar para estabelecer uma conexão com seu cluster Amazon DocumentDB, como um arquivo de certificado de autoridade de certificação (CA) (arquivo pem).