Este guia aborda a migração do MongoDB Connector for BI e do Atlas BI Connector para a interface SQL mais recente.
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, a interface SQL permite analisar dados de suas implementações do MongoDB usando uma variedade de ferramentas baseadas em SQL, como Tableau e Power BI.
Em comparação com o BI Connector, a Interface SQL oferece as seguintes vantagens:
Você pode se conectar diretamente a um cluster dedicado do Atlas , sem nenhuma instância do banco de dados federado necessário. 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 diferentes dos clusters do Atlas . Use esse 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 os recursos de querydo 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 MongoDB SQL.
Limitações da interface SQL
A interface SQL fornece acesso somente leitura.
MongoSQL é o único dialeto suportado. O 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 aplicarão. Eles não se aplicam a uma conexão direta com um cluster dedicado.
Preparar-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 os pré-requisitos para o destino da migração. O MongoDB também recomenda que você gere um Relatório de Prontidã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 SQL do MongoDB .
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 ManagerouProject Replica Set Manager.Atlas Federated Database Instance: uma instância do banco de dados federado que contém dados para query e um usuário de banco de dados MongoDB com o qual se conectar.
Implantação Enterprise Advanced (EA) autogerenciada: um usuário de banco de dados do MongoDB com os privilégios de banco de dados necessários. Nenhuma função do projeto Atlas é necessária.
Gerar um relatório de preparação para transição
O MongoDB fornece uma Ferramenta de Prontidão de Transição MongoSQL para ajudá-lo a planejar sua mudança do BI Connector para a Interface SQL. A ferramenta gera um relatório com base em seu uso anterior do BI Connector , fornecendo análise e sugestões de esquema em tempo real, destacando queries 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 registros 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.
(Opcional) Baixe e descompacte seus logs do BI Connector .
Fornecer os registros 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 on-premises, os registros estão onde quer que você configurou o caminho do registro mongosqld.
Para baixar os logs do Atlas BI Connector :
Na IU do Atlas, acesse o cluster do Atlas com a conexão BI que você deseja analisar.
Nas opções do cluster (), selecione Download Logs.
Baixar
mongosql.gz.Crie um novo diretório e, em seguida, descompacte
mongosql.gznele.
(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 Atlas cluster:
Na IU do Atlas, acesse o cluster com as coleções que você deseja analisar.
Clique em Connect.
Selecione Shell na lista de opções de conexão.
Copie somente seu URI de conexão .
O URI de conexão é semelhante a:
mongodb+srv://bicluster.example.mongodb.net/. Exclua o executável do shellmongoshe quaisquer opções de linha de comando específicas do shell.
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,--uriou 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
--outputpara 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
--resolverpara escolher um resolvedor de DNS para solicitações de rede. Os valores possíveis são:cloudflare,googleequad9.Você pode usar
--includeou--excludepara 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> --help Options: -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 interface SQL
A arquitetura subjacente da Interface SQL é diferente do BI Connector e talvez seja necessário adaptar seu esquema ou suas queries.
Para fazer a transição para a interface SQL, identifique as queries existentes do BI Connector que falham no MongoSQL e atualize seu esquema ou a sintaxe deles para corrigi-las.
Aviso
Recomendamos testar o processo completo de transição em um ambiente de sandbox antes de fazer alterações no ambiente de produção. Fazer a transição do BI Connector para a Interface SQL sem adaptar seu esquema ou suas queries pode causar alterações significativas.
Ative a interface SQL em seu Atlas cluster.
Para a maioria dos sistemas do Atlas , habilite a interface SQL diretamente em um cluster dedicado. Este é o destino de migração recomendado e não precisa de 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 saber mais sobre como ativar e usar a interface SQL, consulte Configuração do servidor de interface SQL.
Conecte-se aos seus dados com a interface SQL.
Para saber mais sobre como se conectar com a interface SQL, consulte Conectar sua ferramenta SQL ao MongoDB.
Teste suas queries.
Teste suas queries com sua nova conexão de interface SQL para garantir que elas sejam executadas e retornem os resultados esperados.
Para saber mais sobre queries com MongoSQL, consulte Query com declarações MongoSQL.
Visualize seu esquema e adapte-o, se necessário.
Para saber mais sobre esquemas na interface SQL, consulte Gerenciamento de esquemas.
Adapte quaisquer queries com falha.
Talvez alguma sintaxe de query precise ser alterada ao fazer a transição do BI Connector para a Interface SQL.
Para saber mais sobre a sintaxe de query do MongoSQL, consulte Referência da linguagem MongoSQL.
Solucionar problemas da interface SQL
Os seguintes recursos MongoDB podem ajudá-lo a solucionar problemas de configuração da interface SQL:
As comunidades MongoDB no Reddit ou Stack Overflow
Sua equipe de sucesso do cliente