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 do Atlas Data Federation e nos custos de transferência do Amazon Web Services; 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.gz
nele.
(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
,--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 resolvedor de DNS para solicitações de rede. Os valores possíveis são:cloudflare
,google
equad9
.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> --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