Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/ / /

Transição do Atlas BI Connector para Atlas SQL

Nesta página

  • Atlas SQL
  • Limitações do Atlas SQL
  • Preços do Atlas SQL
  • Preparar-se para a transição para Atlas SQL
  • Transição para Atlas SQL
  • Solucionar problemas do Atlas SQL

O MongoDB recomenda migrar do Atlas BI Connector para a mais recente Interface Atlas SQL .

Observação

O Atlas BI Connector e o on-premise BI Connector são ferramentas separadas. Este guia é sobre a migração do Atlas BI Connector, que o MongoDB está desativando.

Semelhante ao Atlas BI Connector, o Atlas SQL permite analisar dados de Atlas clusters usando uma variedade de ferramentas baseadas em SQL, como Tableau e Power BI.

Comparado com o BI Connector do Atlas , o Atlas SQL 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 mais informações sobre Atlas SQL, consulte Query com Atlas SQL.

  • O Atlas SQL é somente leitura.

  • O Atlas SQL é 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 Atlas SQL porque é uma funcionalidade do Atlas Data Federation.

O Atlas SQL incorre apenas nos custos de query Atlas Data Federation e nos custos de transferência do Amazon Web Services ; o uso da própria interface Atlas 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 pelo Atlas SQL aparecem em sua fatura na instância do banco de dados federado que você fez a query como encargos "Dados processados" ou "Dados retornados e transferidos".

Para fazer a transição do Atlas BI Connector para o Atlas SQL, 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 Atlas SQL para ajudá-lo a planejar sua mudança do BI Connector Atlas para a Interface Atlas 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 Atlas SQL.

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 query que falhará no Atlas SQL.

  • 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 Atlas SQL é diferente do Atlas BI Connector e talvez seja necessário adaptar seu esquema ou suas queries.

Para fazer a transição para o Atlas SQL, identifique as queries existentes do Atlas BI Connector que falham no Atlas SQL e atualize seu esquema ou a sintaxe deles 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 Atlas SQL sem adaptar seu esquema ou suas queries pode causar alterações significativas.

1

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

2

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

3

Teste suas queries com sua nova conexão Atlas SQL para garantir que elas sejam executadas e retornem os resultados esperados.

Para saber mais sobre queries com Atlas SQL, consulte Query com Atlas SQL .

4

Para saber mais sobre esquemas no Atlas SQL, 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 Atlas SQL.

Para saber mais sobre a sintaxe de query do Atlas SQL, consulte Referência de linguagem do Atlas SQL.

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

Voltar

BI Connector