Transição do Atlas BI Connector para Atlas SQL
Nesta página
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.
Atlas SQL
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.
Limitações do 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.
Preços do Atlas SQL
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".
Preparar-se para a transição para Atlas SQL
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.
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 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.
(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 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 :
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 Atlas SQL
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.
Habilite o Atlas SQL para sua instância de banco de dados federado.
Para saber mais sobre como habilitar e usar o Atlas SQL, consulte Habilitar a interface do Atlas SQL .
Conecte-se aos seus dados com a interface Atlas SQL .
Para saber mais sobre como se conectar com o Atlas SQL, consulte Conectar-se usando a interface do Atlas SQL .
Teste suas queries.
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 .
Visualize seu esquema e adapte-o, se necessário.
Para saber mais sobre esquemas no Atlas SQL, 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 Atlas SQL.
Para saber mais sobre a sintaxe de query do Atlas SQL, consulte Referência de linguagem do Atlas SQL.
Solucionar problemas do Atlas SQL
Os seguintes recursos MongoDB podem ajudá-lo a solucionar problemas de configuração do Atlas SQL :