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.
Menu Docs

Visão geral da interface SQL do MongoDB

A interface SQL para Atlas e Enterprise Advanced (EA) permite que não desenvolvedores query dados MongoDB a partir das FERRAMENTAS SQL que já usam. Ele fornece acesso ao vivo e somente leitura por meio de conexões ODBC e JDBC padrão, eliminando a necessidade de aprender MQL ou mover dados do MongoDB para análise. Isso simplifica os relatórios operacionais, acelera a perspicácia e garante que os dados permaneçam precisos e consistentes.

Você pode implantar a interface SQL de três maneiras: diretamente em um cluster dedicado do Atlas , por meio de uma instância do banco de dados federado do Atlas ou em uma implantação autogerenciada do Enterprise Advanced (EA). Para acesso SQL direto a um único Atlas cluster, use um cluster dedicado. Este é o caminho recomendado para a maioria das conexões do Atlas e não requer nenhuma 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, como vários clusters ou buckets S3.

Cluster Dedicado (Recomendado para Atlas)
Instância do banco de dados federado
No local (EA)

Melhor para

Acesso SQL aos dados em um Atlas cluster.

Uma única query SQL que abrange mais de uma fonte de dados.

Acesso SQL a uma implementação autogerenciada que você executa.

Fontes de dados

Um cluster dedicado.

Vários clusters do Atlas , coleções do Atlas Data Federation e objetos de armazenamento, incluindo buckets do AWS S3, containers do Azure Blob Storage, buckets do Google Cloud, URLs HTTP e Atlas Online Archives.

Um sistema Enterprise Advanced (EA) autogerenciado.

Requisitos de implantação

Cluster dedicado, M10 e superior. Não disponível em clusters gratuitos, clusters flexíveis ou clusters compartilhados M2 e M5.

Uma instância do banco de dados federado. Nenhum requisito de camada do cluster .

Um cluster MongoDB Enterprise . Não há suporte para clusters de comunidade.

Versão do MongoDB

6.0 e posterior.

5.0 e posterior.

6.0 e posterior.

Edição do banco de dados

Atlas Core Database Edition e Atlas Infinite Database Edition.

Atlas Core Database Edition e Atlas Infinite Database Edition.

Não aplicável.

Gerenciamento de esquemas

CLI do Construtor de Esquema SQL do MongoDB .

Gerenciamento de esquema SQL do Atlas Data Federation , integrado à UI do Atlas .

CLI do Construtor de Esquema SQL do MongoDB .

Arquitetura

Conecta-se diretamente ao cluster.

Compartilhado e multilocatário. O mecanismo de query do Atlas Data Federation recupera dados de todas as fontes de dados subjacentes para agrega-los.

Executa em seu próprio ambiente.

Limites de conexão e query

Siga o próprio cluster.

A instância do banco de dados federado impõe sua própria conexão simultânea e limites de query.

Siga a implantação em si.

Todas as três opções fornecem acesso ao vivo, somente leitura e usam o dialeto MongoSQL, que é compatível com SQL-92. Não é possível usar a Interface SQL para inserir, atualizar ou excluir documentos em qualquer sistema, e a Interface SQL não oferece suporte a outros dialetos SQL.

A implantação da Interface SQL consiste em quatro componentes:

Melhorias no esquema
Experimente uma integração de esquema significativamente aprimorada. Os cálculos de esquema se adaptam aos seus dados e representam suas collections de forma nativa. Os esquemas não são armazenados em cache e você pode atualizá-los a qualquer momento sem afetar a conectividade.
Simples e seguro
Aproveite uma configuração simplificada sem configurações de proxy complexas, permitindo que você se conecte diretamente ao cluster MongoDB . Oferece autenticação robusta com suporte para protocolos X509 e OIDC.
Experiência SQL de primeira classe
Aproveite os objetos e arrays avançados com suporte ao driver nativo, aprimorando suas interações de dados. As reinicializações do servidor são contínuas, garantindo operações ininterruptas e alta disponibilidade. A interface usa o MongoSQL, um dialeto compatível com o MongoDB-Native SQL-92, que suporta transformações complexas, como o achatar de objetos aninhados e o desenrolar de arrays diretamente nas queries SQL.
Acesso Unificado
Fornece os mesmos drivers, conectores e mapeamento de esquema para instâncias de banco de dados federados, clusters dedicados e bancos de dados EA autogerenciados.
Integração com ferramentas de BI
O Power BI Connector é certificado pela Microsoft e o Tableau Connector é desenvolvido em associação com a Tableau. Ela suporta o Power BI com DirectQuery e Tableau Desktop, Tableau Server, Tableau Prep e Tableau Cloud. O Tableau Cloud suporta apenas a autenticação SCRAM.

Ao usar a Interface SQL, considere os seguintes pontos para garantir que sua configuração seja compatível e atualizada:

  • Não existe um EOL oficial para componentes da Interface SQL, incluindo drivers, conectores e o Construtor de Esquema SQL do MongoDB. Em vez disso, seu ciclo de vida está vinculado à compatibilidade das versões do servidor MongoDB e aos tempos de execução da linguagem com os quais eles foram projetados para trabalhar.

  • Os componentes da interface SQL permanecem compatíveis com uma versão do servidor MongoDB por até 3 anos após o EOL dessa versão do servidor . Para saber mais, consulte Cronogramas do ciclo de vida do software MongoDB .

  • Recomendamos atualizar seus componentes da interface SQL para a versão mais recente, especialmente ao atualizar seu servidor MongoDB . Isso garante acesso a novos recursos, aprimoramentos de desempenho e compatibilidade de longo prazo. Para ver as versões mais recentes, acesse o centro de download do MongoDB .

  • Versões posteriores dos componentes da interface SQL podem eliminar o suporte para versões anteriores do servidor MongoDB . Recomendamos revisar o SQL Interface Changelog para se manter informado sobre as alterações de compatibilidade e os requisitos de atualização.

O MongoDB Connector for BI é a ferramenta legado para conectar ferramentas de análise de BI a um banco de dados ou cluster MongoDB . O BI Connector atinge o fim da vida útil (EOL) em setembro de 2026.

Instalar a interface SQL do MongoDB