Menu Docs
Página inicial do Docs
/ /

Transição do Atlas BI Connector para MongoSQL

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.

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.

  • 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.

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".

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.

  • 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.

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.

1

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

2

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

chmod +x <executable-filename>
chmod +x <executable-filename>
chmod +x <executable-filename>
3

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 :

  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. Baixe mongosql.gz.

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

4

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 :

  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 é 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.

5

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

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.

1

Para saber mais sobre como habilitar e usar o MongoSQL, consulte Habilitar a interface SQL.

2

Para saber mais sobre como se conectar ao MongoSQL, consulte Conectar-se usando a interface do Atlas SQL.

3

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.

4

Para saber mais sobre esquemas no MongoSQL, consulte Gerenciamento de esquemas.

5

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.

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

Voltar

Habilitar acesso SQL

Nesta página