Partilhar via


Interface SQL do MongoDB Atlas

Observação

Este conector pertence e é fornecido pelo MongoDB.

Resumo

Item Description
Estado do Lançamento Disponibilidade Geral
Products Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Framework (Dataflow Gen2)
Tipos de autenticação suportados Base de Dados (Nome de Utilizador/Palavra-passe)
Certificados X.509
OAuth (OIDC)
Gerenciamento de identidade e acesso da AWS

Observação

Ao usar mecanismos de autenticação diferentes de nome de usuário/senha (como certificados X.509, OAuth (OIDC) ou AWS IAM), você pode deixar os campos de nome de usuário e senha em branco na caixa de diálogo de conexão. As credenciais apropriadas são tratadas através do método de autenticação escolhido.

Pré-requisitos

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

Obtendo informações de conexão para sua instância de banco de dados federado

  1. Navegue até a instância do banco de dados federado. 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 de banco de dados federado.
  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ê precisa deles em uma etapa posterior.

Observação

Se alguns ou todos os seus 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.

O driver ODBC do MongoDB Atlas SQL é necessário para usar o MongoDB Atlas SQL Connector.

Capacidades suportadas

  • Import
  • DirectQuery (modelos semânticos do Power BI)

Ligar à base de dados federada do MongoDB Atlas utilizando a interface Atlas SQL a partir do Power Query Desktop

Para conectar-se usando a interface do Atlas SQL:

  1. Selecione Obter Dados na barra de menu Início no Power BI Desktop.

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

    Captura de tela da caixa de diálogo Obter dados com o conector MongoDB Atlas SQL selecionado.

  3. Se você estiver se conectando ao conector MongoDB Atlas SQL pela primeira vez, um aviso de terceiros será exibido. Selecione "Não me avisar novamente com este conector" se não quiser que esta mensagem seja exibida novamente.

    Selecione Continuar.

  4. Na janela MongoDB Atlas SQL que aparece, 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 contém o seu nome de utilizador e palavra-passe. URIs contendo nome de usuário e/ou senhas são rejeitados.

    • O seu nome de base de dados federada. Obrigatório

      Use o nome do banco de dados federado obtido nos pré-requisitos.

    • Uma consulta SQL. Opcional

      Para executar imediatamente, insira uma consulta nativa do Atlas SQL. Se o banco de dados for o mesmo usado anteriormente, você poderá omiti-lo da consulta.

      SELECT * FROM orders
      
    • Selecione Importar ou DirectQuery para o modo de conectividade de dados desejado.

    Selecione OK.

    Captura de tela da caixa de diálogo de conexão MongoDB Atlas SQL onde você insere as informações de conexão.

  5. Digite seu nome de usuário e senha de acesso ao Banco de Dados Atlas MongoDB e selecione Conectar.

    Captura de tela da caixa de diálogo de autenticação SQL do MongoDB Atlas onde você insere suas credenciais.

    Observação

    Depois de inserir seu nome de usuário e senha para um determinado banco de dados federado do Atlas, o Power BI Desktop usa essas mesmas credenciais em tentativas de conexão subsequentes. Você pode modificar essas credenciais indo para Opções de arquivo>e configurações>Configurações da fonte de dados.

  6. No Navegador, selecione um ou vários elementos para importar e usar 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, onde pode filtrar e refinar o conjunto de dados que pretende utilizar e, em seguida, carregar esse conjunto de dados refinado no Power BI Desktop.

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

Para conectar-se usando a interface do Atlas SQL:

  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 contém o seu nome de utilizador e palavra-passe. URIs contendo nome de usuário e/ou senhas são rejeitados.

    • O seu nome de base de dados federada. 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.

    • Digite seu nome de usuário e senha de acesso ao Banco de Dados Atlas MongoDB e selecione Avançar.

    Captura de ecrã da caixa de diálogo online Ligar à fonte de dados onde introduz as definições de ligação.

  3. No ecrã Navegador , selecione os dados de que necessita e, em seguida, selecione Transformar dados. Esta seleção abre o editor do Power Query para que possa filtrar e refinar o conjunto de dados que pretende utilizar.

    Captura de ecrã do Navigator online onde escolhe os dados que pretende transformar.

Solução de problemas

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

Você também pode achar as seguintes informações úteis: