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

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