Share via

Interface SQL do MongoDB Atlas

  • Artigo

Observação

O artigo a seguir sobre o conector é fornecido pelo MongoDB, proprietária desse conector e membro do Programa de certificação de conector do Microsoft Power Query. Se tiver dúvidas sobre o conteúdo deste artigo ou desejar fazer alterações neste artigo, visite o site do MongoDB e use os canais de suporte.

Resumo

Item Descrição
Estado da liberação Beta
Produtos Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Tipos de autenticação compatíveis Banco de dados (nome de usuário/senha)

Pré-requisitos

Para usar o conector SQL do MongoDB Atlas, você deve ter uma configuração de banco de dados federado do Atlas.

Obtendo informações de conexão da instância de banco de dados federada

  1. Navegue até a instância do banco de dados federada. No Atlas, selecione Federação de Dados no painel de navegação esquerdo.
  2. Selecione Conectar para abrir o modal de conexão da instância do banco de dados federada.
  3. Selecione Conectar usando a interface SQL do Atlas.
  4. Selecione Power BI Connector.
  5. Copie o nome do banco de dados federado e o URI do MongoDB. Você precisará deles mais tarde.

Observação

Se alguns ou todos os dados vierem de um cluster do Atlas, você deverá usar o MongoDB versão 5.0 ou superior para que esse cluster aproveite o Atlas SQL.

Também recomendamos que você instale o Driver ODBC do MongoDB Atlas SQL antes de usar o conector do MongoDB Atlas SQL.

Funcionalidades com suporte

  • Importação

Conectar-se ao banco de dados federado do MongoDB Atlas usando a interface SQL do Atlas a partir do Power Query Desktop

Para conectar-se usando a interface SQL do Atlas:

  1. Selecione Obter Dados na faixa de opções Início no Power BI Desktop.

  2. Selecione Banco de dados nas categorias à esquerda, selecione MongoDB Atlas SQL e selecione Conectar.

    Get Data from MongoDB Atlas SQL

  3. Se você estiver se conectando ao conector do MongoDB Atlas SQL pela primeira vez, um aviso de terceiros será exibido. Selecione "Não mostrar alerta novamente para esse conector" se você não quiser que essa mensagem seja exibida novamente.

    Selecione Continuar.

  4. Na janela do MongoDB Atlas SQL exibida, preencha os seguintes valores:

    • O URI do MongoDB. Obrigatório. Use o URI do MongoDB obtido nos pré-requisitos. Certifique-se de que não contenha seu nome de usuário e senha. URIs com nome de usuário e/ou senhas são rejeitados.
    • O nome do Banco de dados federado. Obrigatório
      Use o nome do banco de dados federado obtido nos pré-requisitos.

    Selecione OK.

    Atlas SQL connection dialogue

  5. Insira seu nome de usuário e senha de acesso ao banco de dados Atlas MongoDB e selecione Conectar.

    Authentication

    Observação

    Depois de inserir seu nome de usuário e senha para um banco de dados federado Atlas específico, o Power BI Desktop usará essas mesmas credenciais em tentativas de conexão subsequentes. Você pode modificar essas credenciais acessando Arquivo>Opções e configurações>Configurações de fonte de dados.

  6. Em Navegador, selecione um ou vários elementos para importação e uso no Power BI Desktop. Em seguida, selecione Carregar para carregar a tabela no Power BI Desktop ou Transformar dados para abrir o Editor do Power Query em que você pode filtrar e refinar o conjunto de dados que deseja usar e, em seguida, carregar esse conjunto refinado de dados em Power BI Desktop.

Conectar-se ao banco de dados federado do MongoDB Atlas usando a interface SQL do Atlas a partir do Power Query Online

Para conectar-se usando a interface SQL do Atlas:

  1. Selecione MongoDB Atlas SQL na página Power Query - Escolher fonte de dados.

  2. Na página Configurações de conexão, preencha os seguintes valores:

    • O URI do MongoDB. Obrigatório. Use o URI do MongoDB obtido nos pré-requisitos. Certifique-se de que não contenha seu nome de usuário e senha. URIs com nome de usuário e/ou senhas são rejeitados.
    • O nome do Banco de dados federado. Obrigatório
      Use o nome do banco de dados federado obtido nos pré-requisitos.
    • Insira um Nome de conexão.
    • Escolha um Gateway de dados.
    • Insira seu nome de usuário e senha de acesso ao banco de dados Atlas MongoDB e selecione Avançar.

    Connection Settings

  3. Na tela Navegador, selecione os dados necessários e selecione Transformar dados. Essa seleção abre o Editor do Power Query para que você possa filtrar e refinar o conjunto de dados que deseja usar.

    Navigator

Solução de problemas

Quando a conexão não pode ser estabelecida, a mensagem de erro genérica The driver returned invalid (or failed to return) SQL_DRIVER_ODBC_VER: 03.80 é exibida. Comece verificando suas credenciais e se você não tem problemas de rede ao acessar seu banco de dados federado.

Próximas etapas

As informações a seguir poderão ser úteis: