O MongoDB recomenda migrar do Atlas BI Connector para a mais recente interface SQL.
Observação
O BI Connector Atlas e o BI Connector on-premises são ferramentas separadas. Este guia é sobre a migração do Atlas BI Connector, que o MongoDB está desativando.
mongosql
Semelhante ao BI Connector do Atlas , o MongoSQL permite analisar dados de clusters do Atlas usando uma variedade de FERRAMENTAS baseados em SQL, como Tableau e Power BI.
Comparado com o Atlas BI Connector, o MongoSQL oferece as seguintes vantagens:
Você pode ler dados de fontes diferentes dos Atlas clusters usando a infraestrutura do Atlas Data Federation .
Você pode definir seu esquema.
Você paga apenas pelo seu uso; você não precisa de uma assinatura.
Você pode usar conectores MongoDB personalizados para Tableau e Power BI.
Para saber mais sobre MongoSQL, consulte Query com interface SQL.
Limitações do MongoSQL
O MongoSQL é somente leitura.
O MongoSQL é compatível apenas com o dialeto SQL 92; outros dialetos SQL não são suportados.
Todas as limitações do Atlas Data Federation se aplicam ao MongoSQL porque é uma funcionalidade do Atlas Data Federation.
Preços do MongoSQL
O MongoSQL incorre apenas nos custos de query da Atlas Data Federation e nos custos de transferência da AWS; o uso da própria interface SQL é gratuito. Para saber mais sobre o custo de query da instância do banco de dados federado, consulte Custos de Data Federation .
Observação
Os custos incorridos pelas queries do MongoSQL aparecem em sua fatura na instância do banco de dados federado que você consultou, como cobranças de "Dados Processados" ou "Dados Retornados e Transferidos".
Preparar-se para a transição para o MongoSQL
Para fazer a transição do Atlas BI Connector para MongoSQL, verifique se seu sistema atende os pré-requisitos a seguir:
Além disso, o MongoDB recomenda que você gere um relatório de preparação de transição para ajudar a planejar sua transição.
Pré-requisitos
Uma instância do banco de dados federado contendo dados consultáveis.
Um usuário de banco de dados de dados MongoDB para conectar à sua instância do banco de dados federado.
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 Atlas para a Interface SQL. A ferramenta gera um relatório com base no seu uso anterior do Atlas 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 do Atlas , 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 do Atlas .
Fornecer os registros do BI Connector do Atlas 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 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.
Baixe
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 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 shell,mongosh, e 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 MongoSQL
A arquitetura subjacente do MongoSQL é diferente do Atlas BI Connector e talvez seja necessário adaptar seu esquema ou suas queries.
Para fazer a transição para o MongoSQL, identifique as queries existentes do Atlas BI Connector que falham no MongoSQL e atualize seu esquema ou a sintaxe para corrigi-las.
Aviso
O MongoDB recomenda testar o processo de transição completo em um ambiente de sandbox antes de fazer alterações em seu ambiente de produção. A transição do Atlas BI Connector para o MongoSQL sem adaptar seu esquema ou suas queries pode causar alterações significativas.
Habilite o MongoSQL para sua instância do banco de dados federado.
Para saber mais sobre como habilitar e usar o MongoSQL, consulte Habilitar a interface SQL.
Conecte-se aos seus dados com a interface SQL.
Para saber mais sobre como se conectar ao MongoSQL, consulte Conectar-se usando a interface do Atlas SQL.
Teste suas queries.
Teste suas queries com sua nova conexão MongoSQL 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 no MongoSQL, consulte Gerenciamento de esquemas.
Adapte quaisquer queries com falha.
Algumas sintaxe de query podem precisar ser alteradas quando você faz a transição do Atlas BI Connector para o MongoSQL.
Para saber mais sobre a sintaxe de query do MongoSQL, consulte Referência da linguagem MongoSQL.
Solucionar problemas do MongoSQL
Os seguintes recursos MongoDB podem ajudá-lo a solucionar problemas de configuração MongoDB:
As comunidades MongoDB no Reddit ou Stack Overflow
Sua equipe de sucesso do cliente