Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Transição do BI Connector para a interface SQL

Este guia aborda migrar tanto do MongoDB Connector for BI quanto do Atlas BI Connector para a mais recente interface SQL.

Importante

O MongoDB Connector for BI e o Atlas BI Connector atingiram o fim da vida útil (EOL) em setembro de 2026.

Interface SQL

Semelhante ao BI Connector, o SQL Interface permite que você analise dados de suas implantações do MongoDB usando uma variedade de FERRAMENTAS baseadas em SQL, como Tableau e Power BI.

Em comparação com o BI Connector, a SQL Interface oferece as seguintes vantagens:

  • Você pode se conectar diretamente a um cluster dedicado do Atlas, sem a necessidade de uma instância do banco de dados federado. Este é o caminho recomendado para a maioria das conexões do Atlas.

  • Por meio de uma instância do banco de dados federado do Atlas, você pode ler dados de fontes que não sejam clusters do Atlas. Use este caminho quando uma única query precisar abranger mais de uma fonte de dados.

  • Os esquemas são persistidos separadamente e podem ser atualizados sem interromper as funcionalidades de consulta SQL.

  • Você pode usar conectores MongoDB personalizados para Tableau e Power BI.

Para comparar os dois caminhos de conexão do Atlas, consulte Visão geral da interface do MongoDB SQL.

Limitações da interface SQL

  • A interface SQL fornece acesso somente leitura.

  • MongoSQL é o único dialeto suportado. MongoSQL é compatível com SQL-92. Outros dialetos SQL não são suportados.

  • Se você se conectar por meio de uma instância do banco de dados federado, todas as limitações do Atlas Data Federation também se aplicam. Elas não se aplicam a uma conexão direta com um cluster dedicado.

Prepare-se para a transição para a interface SQL

Antes de fazer a transição do BI Connector para a interface SQL, confirme se sua implantação atende aos pré-requisitos para o seu destino de migração. O MongoDB também recomenda que você gere um relatório de preparação de transição para ajudar a planejar sua transição.

Pré-requisitos

Os pré-requisitos dependem de para onde você migra. Para comparar os destinos do Atlas, consulte Visão geral da interface do MongoDB SQL.

  • Cluster dedicado do Atlas: um usuário de banco de dados MongoDB com o qual se conectar. Para habilitar a interface SQL, você também precisa de um Atlas user com a função Project Cluster Manager ou Project Replica Set Manager.

  • Instância do banco de dados federado do Atlas: uma instância do banco de dados federado que contém dados consultáveis e um usuário de banco de dados do MongoDB com o qual se conectar.

  • Implantação autogerenciada do Enterprise Advanced (EA): um usuário de banco de dados MongoDB com os privilégios de banco de dados necessários. Nenhuma função de projeto Atlas é necessária.

Gerar um relatório de preparação para transição

O MongoDB oferece uma ferramenta de prontidão para transição do MongoSQL para ajudar você a planejar sua mudança do BI Connector para a interface SQL. A ferramenta gera um relatório com base no seu uso anterior do BI Connector, fornecendo análise e sugestões de esquema em tempo real e destacando as query que precisam de alterações de sintaxe para serem executadas corretamente usando o MongoSQL.

Para gerar um relatório, você deve fornecer à ferramenta pelo menos um dos seguintes detalhes:

  • Seus logs do BI Connector, para análise de query.

  • O URI do seu cluster , para análise de esquema.

Você pode analisar suas queries, seu esquema ou ambos.

1

Baixe a Ferramenta de relatório de preparação do MongoSQL.

Selecione a guia do seu sistema operacional abaixo e baixe o arquivo executável.

2

Conceda permissão de execução à Ferramenta de relatório de preparação.

Se o arquivo ainda não tiver permissão de execução, conceda-a.

 chmod +x <executable-filename>
3

(Opcional) Baixe e descompacte seus logs do BI Connector.

Fornecer seus logs do BI Connector permite que a Ferramenta de Relatório de Prontidão relate as seguintes informações:

  • Dados históricos da query, como volume e frequência.

  • sintaxe de consulta que falhará no MongoSQL.

  • Campos de collection com tipos de dados desconhecidos para bancos de dados relacionais.

Para o BI Connector no local, os logs estão onde você configurou o caminho do log mongosqld.

Para baixar os logs do Atlas BI Connector :

  1. Na IU do Atlas, acesse o cluster do Atlas com a conexão BI que você deseja analisar.

  2. Nas opções do cluster (), selecione Download Logs.

  3. Baixar mongosql.gz.

  4. Crie um novo diretório e, em seguida, descompacte mongosql.gz nele.

4

(Opcional) Copie o URI do cluster.

Fornecer seu URI do cluster do Atlas permite que a Ferramenta de Relatório de Prontidão analise seus esquemas de coleção e identifique campos que contêm tipos de dados desconhecidos para ferramentas SQL.

Para encontrar o URI do cluster Atlas:

  1. Na IU do Atlas, acesse o cluster com as coleções que você deseja analisar.

  2. Clique em Connect.

  3. Selecione Shell na lista de opções de conexão.

  4. Copie somente seu URI de conexão .

    O URI de conexão se parece com: mongodb+srv://bicluster.example.mongodb.net/. Exclua o executável do shell, mongosh, e quaisquer opções de linha de comando específicas do shell.

5

Gerar um relatório.

Em um terminal, execute o executável Readiness Report Tool, fornecendo os registros baixados ou o URI do cluster.

  • Você deve incluir seu nome de usuário do banco de dados de dados.

  • Você deve incluir --input, --uri ou ambos. Se você incluir seu URI, a ferramenta de relatório de preparação solicitará sua senha de usuário de banco de dados de dados.

  • É possível especificar um destino --output para o seu relatório gerado. Se você não fizer isso, o relatório será gerado no seu diretório atual.

  • Você pode especificar um --resolver para escolher um DNS resolver para solicitações de rede. Os valores possíveis são: cloudflare, google e quad9.

  • Você pode usar --include ou --exclude para restringir sua lista de namespaces. A sintaxe de Glob é suportada. Por padrão, todos os namespaces estão incluídos.

A opção --help retorna a lista completa de opções da Ferramenta de relatório de preparação:

<executable-filename> --helpOptions:     -i, --input <INPUT>        Sets the input file or directory to analyze BIC logs (optional). One of `--input` or `--uri` must be provided, or both     -o, --output <OUTPUT>      Sets the output directory (optional). If not specified, the current directory is used         --uri <URI>            The Atlas cluster URI to analyze schema (optional). One of `--input` or `--uri` must be provided, or both     -u, --username <USERNAME>  Username for authentication (optional). This is required if the username and password is not provided in the URI         --quiet                Enables quiet mode for less output         --resolver <RESOLVER>  The specified resolver (optional) [possible values: cloudflare, google, quad9]         --include <INCLUDE>    A list of namespaces to include (optional). If not provided, all namespaces are included. Glob syntax is supported         --exclude <EXCLUDE>    A list of namespaces to exclude (optional). If not provided, no namespaces are excluded     -h, --help                 Print help (see more with '--help')     -V, --version              Print version

A Ferramenta de relatório de preparação organiza a saída e gera um arquivo de índice clicável para que você possa navegar facilmente pelo relatório.

Transição para a interface SQL

A arquitetura subjacente da Interface SQL é diferente do BI Connector e você pode precisar adaptar seu esquema ou suas queries.

Para fazer a transição para a interface SQL, identifique as query do BI Connector existentes que falham no MongoSQL e atualize seu esquema ou sua sintaxe para corrigi-las.

Aviso

Recomendamos testar o processo completo de transição em um ambiente sandbox antes de fazer alterações no seu ambiente de produção. A transição do BI Connector para o SQL Interface sem adaptar seu esquema ou suas query pode causar alteração interruptiva.

1

Habilite a interface SQL no seu cluster Atlas.

Para a maioria das implantações do Atlas, habilite a interface SQL diretamente em um cluster dedicado. Este é o destino de migração recomendado e não precisa de uma instância do banco de dados federado. Use uma instância do banco de dados federado quando uma única query SQL precisar abranger mais de uma fonte de dados.

Para aprender mais sobre como habilitar e usar a SQL Interface, consulte Configurar do servidor da SQL Interface.

2

Conecte-se aos seus dados com a interface SQL.

Para aprender mais sobre como se conectar com a SQL Interface, consulte Conecte sua ferramenta SQL ao MongoDB.

3

Teste suas queries.

Teste suas query com sua nova conexão de Interface SQL para garantir que elas sejam executar e retornem os resultados esperados.

Para saber mais sobre queries com MongoSQL, consulte Query com declarações MongoSQL.

4

Visualize seu esquema e adapte-o, se necessário.

Para aprender mais sobre esquemas na interface SQL, consulte Gerenciamento de esquemas.

5

Adapte quaisquer queries com falha.

Algumas sintaxes de query podem precisar ser alteradas ao fazer a transição do BI Connector para a SQL Interface.

Para saber mais sobre a sintaxe de query do MongoSQL, consulte Referência da linguagem MongoSQL.

Solucione problemas da interface SQL

Os seguintes recursos do MongoDB podem ajudá-lo a solucionar problemas de sua configuração de SQL Interface:

Voltar
Visão geral
Próximo
Instalar
Avalie esta página

Nesta página