Notas de versão

1.14.1 Registro de alterações

Lançado em 20 de agosto de 2025

Melhorias:

• Adição da propriedade collectionFilters ao endpoint POST /jobs para incluir ou excluir collections para uma migração.

• Novo endpoint de API para obter todas as collections de um projeto abaixo de api/v1/project/{projectId}/collections.

• Os usuários agora podem definir a propriedade migrator.engine.transform.calculated.field.timeout para configurar o valor de tempo limite (em segundos) para a geração de campo calculado.

Correções de Bugs:

• Corrigido o problema em que uma array incorporada aninhada pode estar ausente ao usar a estratégia de chave envolta e a opção Merge Fields into the Parent no documento pai.

• Corrigiu o problema de verificação em que todos os campos com o mesmo caminho em uma array incorporada poderiam resultar em um falso positivo.

• Corrigiu o problema de desempenho na tela Select tables e no Job update log quando uma grande quantidade de linhas é exibida.

• Foi corrigido um problema em que uma inicialização muito lenta poderia fazer com que uma migração de snapshot fosse encerrada antecipadamente, tendo processado zero linhas.

1.14 Registro de alterações

Lançado em 14 de julho de 2025

Correções críticas de bugs:

• Corrigido um problema para mapeamentos com um documento incorporado que contém uma array incorporada e tem a opção Merge Fields into the Parent habilitada. Isso criou elementos de array incorporados duplicados no local incorreto.

• Foi corrigido um problema em que os mapeamentos contendo um loop de dependência cíclica com uma array incorporada poderiam ter a array primitiva substituída por uma array de objetos.

Correções de bugs críticos para migrações contínuas (CDC):

As seguintes correções resolvem problemas de integridade de dados que afetam as migrações do CDC:

• Corrigido um problema de CDC em que vários eventos de alteração de linha em um único lote podem fazer com que os filhos não sejam atualizados devido a uma cláusula $match malformada.

• Corrigido um problema de CDC em que as entradas anteriores de array incorporada não eram removidas se o pai fosse atualizado de modo que agora não corresponda a zero filhos de array.

• Corrigiu um problema de CDC com eventos de alteração de linha durante a migração contínua que pode inserir várias entradas de array adicionais em mapeamentos de array profundamente aninhados.

• Corrigido um problema de CDC que afetava mapeamentos usando Calculated ID campos contendo colunas que não fossem chave primária(s), onde eventos de alteração podem resultar na falta de objetos filhos ou em atualizações subsequentes incorretas.

• Corrigido um problema de CDC para quando a estratégia de tratamento nulo omit é usada, as atualizações que definem um valor de campo como nulo não são aplicadas.

• Corrigido um problema de CDC em que os filhos de mapeamento incorporado não eram atualizados após a atualização para participar de campos na tabela sem chave primária.

• Corrigido um problema de CDC causado por um evento de alteração de linha de CDC, resultando em entradas de array adicionais se uma tabela sem chave primária for usada para mapeamento de array incorporado com campos excluídos.

• Corrigido um problema de CDC causado por um evento de alteração de linha de CDC que pode aplicar atualizações filho a incorporações aninhadas fora de ordem.

• Foi corrigido um problema em que mapeamentos com uma array incorporada poderiam ter a array primitiva substituída por uma array de objetos.

Melhorias:

• Todos os índices criados em collections de destino durante a migração agora são retidos por padrão.

• Registros desnecessários removidos.

Correções de Bugs:

• Corrigido um problema de CDC para mapeamentos contendo Document > Array > Document em que um ID de objeto contendo um caractere de ponto . causava um erro fatal.

1.13.2 Registro de alterações

Lançado em 27 de maio de 2025

Atualização de problemas de integridade de dados:

A pesquisa e a resolução de problemas de integridade de dados que afetam determinadas configurações de migração de CDC e snapshots estão em andamento como um projeto de alta prioridade. As migrações de modo contínuo (CDC) permanecem desabilitadas nesta versão para projetos que contêm documentos e arrays incorporados. Migrações de snapshots e migrações de CDC "um para um" que não contêm incorporações ainda estão habilitadas.

Correções de Bugs:

• Foi corrigido um problema em que migrações de snapshots contendo referências circulares (onde o conjunto de tabelas não pode ser ordenado de forma que cada pai seja totalmente migrado antes de qualquer documento ou array incorporado) podem resultar na omissão de uma ou mais incorporações.

• Os avisos de tarefa de migração não são mais contabilizados no limite de erros dessa tarefa.

1.13.1 Registro de alterações

Versão lançada em 29 de abril de 2025

Aviso de integridade de dados:

Correções críticas de bugs:

• Foi corrigido um problema em que as migrações de snapshots podiam falhar ao preencher Arrays incorporadas profundamente aninhadas se os mapeamentos fossem estruturados de forma que um mapeamento de documento incorporado estivesse entre dois mapeamentos de array incorporada na hierarquia de mapeamento.

• Foi corrigido um problema com migrações contínuas em que tabelas relacionais sem chave primária podiam causar entradas duplicadas em matrizes incorporadas quando a linha era atualizada.

Melhorias:

• Desempenho aprimorado para migrações de snapshots contendo matrizes incorporadas.

• Carregamentos iniciais de banco de dados mais rápidos ao conectar-se a bancos de dados grandes com muitas tabelas.

• Erros aprimorados de migração e verificação com mais detalhes e informações de depuração.

• Relatórios de erros e avisos aprimorados para tarefas de pré-migração e pós-migração.

• Projetos importados e novos agora usam um esquema de nomenclatura consistente para gerar seu ID do projeto.

• Adicionado suporte para o Oracle JDBC Driver versão 23.

Correções de Bugs:

• Foi corrigido um problema com migrações de snapshots no modo idempotente em que execuções subsequentes da migração podiam causar entradas duplicadas em arrays incorporadas. Isso ocorre com mapeamentos aninhados em que a array incorporada contém documentos ou arrays incorporados adicionais.

• Foi corrigido um problema em que campos contendo caracteres de ponto em seu nome causavam erros durante migrações de snapshot e contínuas.

• Corrigiu problemas em que a edição de um campo de mapeamento incorporado para adicionar o prefixo _id resultava no comportamento inesperado da interface do usuário.

• A configuração de pré-requisitos gerada e atualizada e o script SQL de permissões para Oracle incluem instruções do Amazon Web Services RDS.

1.13.0 Registro de alterações

Lançado em 24 de março de 2025

Novas funcionalidades:

• A análise de pré-migração agora está em visualização pública. Esse recurso permite identificar problemas de migração antes de iniciar e obter recomendações práticas para uma migração tranquila. A análise de pré-migração suporta os seguintes bancos de dados:

  • Oráculo

  • Servidor SQL

  • PostgreSQL

  • MySQL

Correções de erros:

• Corrigido um problema em que as chamadas de API de tarefa travavam quando os filtros de tabela retornavam um resultado vazio.

• Corrigido um problema que impedia os usuários de salvar campos de chave calculados para projetos que usam as opções de tratamento de chave herdada única ou agrupada.

• Corrigido um problema com mapeamentos de array incorporados e campos excluídos, em que dados de origem em branco podiam disparar um erro de "desconfiguração" em vez de serem processados silenciosamente.

1.12.0 Registro de alterações

Lançado em 3 de fevereiro de 2025

Novas funcionalidades:

• Suporte adicionado para quatro bancos de dados de origem, usando conectividade JDBC para permitir a migração de dados baseada em snapshots e a conversão de objeto de banco de dados de:

  • YugabyteDB

  • CockroachDB

  • SAP Sybase IQ (SAP IQ)

  • SAP SQL em qualquer lugar

  Observação

  O suporte de conexão JDBC para esses bancos de dados está atualmente em pré-visualização pública. Os usuários também podem adicionar suporte a banco de dados relacional personalizado criando um conector JDBC personalizado.

• Suporte adicionado para autenticação de certificado X.509 para autenticação de cliente em bancos de dados de destino MongoDB .

• Foram adicionadas informações para usuários do MongoDB Atlas que tentam grandes migrações de dados para clusters de nível inferior do MongoDB Atlas, o que pode resultar em um tempo estendido de migração. Para trabalhos grandes onde o desempenho da migração é uma consideração, os usuários podem conseguir reduzir o tempo total de migração em até 54% atualizando para uma camada Atlas mais rápida.

• Seção de notícias opcional adicionada para informar os usuários sobre os novos recursos da ferramenta de migração, atualizações importantes e anúncios de segurança. Esse recurso somente online pode ser desabilitado nas propriedades do usuário.

• Relatórios de erros aprimorados ao ignorar a importação de tipos de dados binários não suportados no Microsoft SQL Server (tipo FILESTREAM) e Oracle (tipos LONG, LONG CRW e BFILE).

• Aumentou o tamanho máximo do arquivo de esquemas DDL suportados de 4MB para 20MB.

Correções de Bugs:

• Foi corrigido um problema em que o Postgres criava um slot de replicação duplicado em determinados cenários.

1.11.0 Registro de alterações

Lançado em 25 de novembro de 2024

Novas funcionalidades:

• O novo recurso de gerenciamento de conexões de banco de dados facilita o armazenamento e o gerenciamento de um grande número de conexões de banco de dados , além de alternar entre ambientes de banco de dados, como controle de qualidade, desenvolvimento e produção.

• Conversão de query aprimorada adicionando a opção de usar entidades Java fortemente digitadas nas assinaturas de queries convertidas.

• Suporte adicionado para converter pacotes Oracle e funções do SQL Server no conversor de query.

• Suporte adicionado para os mais recentes Postgres 17 e MySQL 8.4/9.0 versões do banco de dados .

• Suporte aprimorado para conexão com bancos de dados Oracle conectáveis (PDBs).

• Foi adicionado suporte ao "Traga seu próprio LLM" usando um serviço LLM gerenciado pelo cliente para geração de código de IA em vez do serviço padrão hospedado no MongoDB.

• Desativou temporariamente a capacidade de selecionar Atlas clusters de uma lista quando conectado com uma conta do Atlas

Correções de Bugs:

• Foi corrigido um problema em que um erro "Nenhuma chave estrangeira encontrada" poderia ocorrer em alguns casos com várias incorporações de chave estrangeira.

1.10.0 Registro de alterações

Lançado em 2 de outubro de 2024

Novas funcionalidades:

• Nova UI de conversão em massa e API para o Query Converter para converter automaticamente um grande número de queries SQL, visualizações e procedimentos armazenados. Consulte Conversão em massa.

• As tarefas de snapshot agora criam documentos de nível superior usando um método de inserção em massa não idempotente. Isso melhora o desempenho.

• Adicionado controle explícito sobre o comportamento idempotente por meio da configuração migrator.engine.transform.idempotency: true no arquivo user.properties .

• Os índices internos usados para migração são excluídos automaticamente após a conclusão do tarefa . Isso melhora o desempenho.

• Driver JDBC do SQL Server atualizado para a versão mais recente.

• Adicionado suporte de autenticação básica para Kafka.

• Foi adicionado um registro mais detalhado no arquivo de log do aplicativo em evento de erros de migração.

• Simplificou a estrutura das classes Java POJO na Geração de Código.

Correções de erros:

• Correção de um problema em que as tabelas eram desmarcadas para importação para um projeto após a filtragem da lista de tabelas.

• Corrigido um problema de UI com o Migration Job Log que impedia que ele fosse redimensionado quando continha um grande número de entradas.

• Corrigido um problema em que as chamadas de API remota, como conversões de query, não eram roteadas pelo proxy do sistema.

• Foi corrigido um problema em que linhas individuais que excediam o limite de documento 16MB causavam a interrupção imediata do tarefa , em vez de continuar até o limite de erro.

• Corrigido um problema em que a verificação de dados não conseguiu detectar alguns problemas causados por diferenças de precisão entre os tipos de dados de origem e destino.

• Foi corrigido um problema em que cada query poderia ser importada duas vezes.

• Corrigido um problema em que as queries convertidas às vezes usavam caminhos incorretos para mapeamentos incorporados.

1.9.0 Registro de alterações

Lançado em 20 de agosto de 2024

Novas funcionalidades:

• O Conversor de Query agora permite que você teste suas queries relacionais e convertidas e compare os resultados no painel Test Queries .

• O suporte do banco de dados de dados DB2 LUW está agora em pré-visualização pública. Usuários interessados no suporte do DB2 LUW e mainframe (DB2 para i), entre em contato com seu representante de conta do MongoDB para obter detalhes completos ou uma avaliação guiada.

• As conexões do SQL Server agora são padronizadas como trust server certificate. Esta configuração pode ser desmarcada na guia SSL.

Correções:

• Foi corrigido um problema em que os conectores falhavam ao carregar ao iniciar trabalhos de migração usando o Confluent Cloud.

• Corrigido um problema em que os trabalhos de migração falhavam ao iniciar para bancos de dados Postgres quando as credenciais eram fornecidas com parâmetros de string de query.

• Foi corrigido um problema em que várias chaves estrangeiras sintéticas entre as mesmas tabelas não eram tratadas como uma chave composta.

• Corrigido um problema em que a caixa de diálogo da tarefa de migração indicava que o banco de dados de dados não estava pronto se o teste de simulação não fosse executado.

• Corrigido um problema em que os arquivos de query não eram excluídos quando os projetos eram excluídos.

• Corrigido um problema em que as queries não podiam ser importadas de um banco de banco de dados Postgres quando conectado como um usuário que não é o proprietário.

1.8.0 Registro de alterações

Lançado em 09 de julho de 2024

Novas funcionalidades:

• Novas regras de mapeamento condicional para transformações mais avançadas:

  • Mapeamento de filtros de regra para incluir ou excluir documentos com base em uma expressão JavaScript personalizada.

  • Condições de array para classificar e limitar arrays incorporadas, suportando a aplicação do padrão de subconjunto.

  • Modelagem aprimorada de chaves estrangeiras para oferecer suporte a tabelas com referências múltiplas e potencialmente ambíguas a uma tabela estrangeira.

• Novo modo de luz na interface do usuário da web.

• Nova funcionalidade desfazer/refazer para edição de regras de mapeamento.

• Conversão de procedimento armazenado aprimorada para banco de banco de dados Postgres e MySQL adicionando cabeçalhos de procedimento.

1.7.0 Registro de alterações

Lançado em 20 de maio de 2024

Novas funcionalidades:

• Estatísticas mais detalhadas durante a execução de uma tarefa de migração, incluindo a porcentagem de visualização concluída, o tempo estimado para a conclusão e qual tabela está sendo processada no momento.

• Agora os usuários podem recuperar um tarefa de migração contínuo se o aplicação Relational Migrator for reiniciado enquanto um tarefa de migração estiver em execução.

• Nova API REST de gerenciamento de tarefas. A API REST permite que os usuários iniciem, parem e monitorem os trabalhos de migração programaticamente.

Correções de Bugs:

• Corrigido um problema em que as sessões de login do Atlas expiravam após o Relational Migrator ficar ocioso por um curto período de tempo.

• Corrigido um problema em que não era possível importar queries de bancos de dados Oracle onde o esquema ou o nome do banco de dados de dados continha pontos.

• Corrigido um problema em que as classes Java POJO geradas usavam tipos incorretos para campos digitados por data.

• Foi corrigido um problema em que a verificação poderia ser cancelada para esquemas com chaves compostas quando alguns campos de chave eram excluídos.

• Corrigido um problema em que os trabalhos paravam sem progresso se nenhuma tabela para o esquema fosse encontrada no banco de banco de dados de origem.

1.6.0 Registro de alterações

Versão lançada em 18 de abril de 2024

Novas funcionalidades:

• Os usuários podem migrar dados de séries temporais para o MongoDB com suporte nativo a séries temporais.

• Os usuários podem migrar dados do TimescaleDB Hypertables.

• Os usuários podem migrar de um banco de dados que tenha um nome diferente do nome usado ao criar o projeto correspondente.

• O desempenho da migração melhora com a configuração da preocupação de gravação para 1 por padrão (pode ser substituído no URI do MongoDB ).

• Registro de tarefas mais detalhado.

Correções de erros:

• Agora é possível criar projetos e executar tarefas de migração quando o nome do banco de dados ou o nome do esquema contiver caracteres de ponto.

• Corrigido um problema em que não era possível criar um campo calculado com o mesmo nome de um campo regular excluído.

• Melhorias de qualidade diversas no conversor de query.

1.5.0 Registro de alterações

Lançada em 6 de março de 2024

Novas funcionalidades:

• O conversor de queries agora está em versão prévia pública. Para obter detalhes, consulte Habilitar conversor de query.

• O conversor de query agora exige que você entre em uma conta do MongoDB Atlas . Quando você entra no Atlas, o processo para selecionar clusters do Atlas em uma tarefa de migração é preenchido dinamicamente.

• O conversor de query agora suporta a conversão de triggers DML do banco de dados relacional para MongoDB Atlas Triggers.

Melhorias:

• O conversor de query agora permite converter queries e visualizações SQL para C#, Java ou JavaScript.

Correções de erros:

• Pequenas melhorias na recuperabilidade e nas métricas da tarefa.

1.4.6 Registro de alterações

Lançado em 12 de fevereiro de 2024

Melhorias:

• Suporte adicionado para Oracle 11g como reconhecimento de data center de origem.

• Novo indicador de status na página do projeto que mostra se uma migração está em execução.

• Verificações de permissões aprimoradas no MongoDB database ao iniciar uma nova migração.

• Melhorias na visualização privada do query Converter.

Correções de erros:

• Corrigido um problema em que migrações concluídas não podiam se marcar como concluídas na interface da web.

1.4.4 Registro de alterações

Lançado em 29 de janeiro de 2024

Melhorias:

• Chaves estrangeiras sintéticas aprimoradas para serem preservadas após a atualização do esquema.

• Correção para implantações totalmente offline em ambientes com lacunas de ar.

• Correção para determinadas combinações de mapeamentos, especificamente dois mapeamentos diferentes no mesmo nível de incorporação.

• Várias pequenas correções e melhorias no suporte do reconhecimento de data center Sybase, métricas de estágio de CDC, estágio de verificação, exportações de reconhecimento de data center e registro em log.

1.4.3 Registro de alterações

Lançada em 11 de dezembro de 2023

Novas funcionalidades:

• O suporte do banco de dadosSybase ASE agora está disponível para tarefas únicas de migração de snapshot e conversão de procedimento armazenado.

• Suporte do Kafka hospedado no Confluent para participantes do programa de acesso antecipado do Kafka. Esta versão adiciona suporte pré-construído para conexão a um cluster Kafka gerenciado pelo provedor de hospedagem Confluent.

  Observação

  O Kafka é uma plataforma de código aberto para volumes de trabalho distribuídos de alta disponibilidade. Para obter acesso ao Relational Migrator com suporte do Kafka, entre em contato com sua equipe de conta do MongoDB para se inscrever no Programa de Acesso Antecipado do Kafka.

• Integração suportada com Hackolade.

  O Hackolade é uma ferramenta de modelagem de dados visuais. Para explorar esquemas no Hackolade, importe um Relational Migrator arquivo. Para mais informações, leia o artigo de ajuda do Hackolade.

Melhorias:

• Melhor qualidade de conversão de query SQL para o Query Converter (prévia privada). Para obter detalhes sobre como participar do programa de acesso antecipado do query Converter, consulte query Converter.

• Melhor desempenho do aplicativo por meio do uso expandido da memória disponível em ambientes de servidor adequados.

1.3.3 Registro de alterações

Lançada em 7 de novembro de 2023

Melhorias:

• Melhorias de desempenho para tarefas de migração que criam arrays grandes.

• Corrigido um problema em que a descoberta do esquema falhava em nomes de esquema que contêm o caractere de traço.

1.3.2 Registro de alterações

Lançado em 25 de outubro de 2023

Melhorias:

• Desempenho aprimorado quando o Relational Migrator analisa grandes esquemas relacionais.

• O Relational Migrator agora se integra ao armazenamento de certificados do Windows para conexões SSL.

Novas funcionalidades:

• Novo instalador e binários para arquiteturas Mac M1.

• As regras de mapeamento agora mostram a coluna original e o tipo usado para gerar um campo _id .

• Mensagens de erro aprimoradas no conversor de query (prévia privada).

1.3.1 Registro de alterações

Lançado em 10 de outubro de 2023

Novas funcionalidades:

• Capacidade de selecionar idiomas de destino C#, Java e JavaScript para conversões de procedimentos armazenados no conversor de query (prévia privada).

• As conversões de query agora são incluídas quando você exporta/importa projetos.

Correções de erros:

• Corrigido um problema em que os eventos de atualização podiam retornar erros em tarefas do CDC.

• Corrigido um problema em que o Relational Migrator poderia travar ao tentar detectar se uma nova versão estava disponível.

• Corrigido um problema em que todas as tabelas podiam ser inesperadamente desmarcadas ao selecionar tabelas para um projeto.

• Melhorias na execução de tarefas de migração no modelo de sistema Kafka (visualização privada).

1.3.0 Registro de alterações

Lançado em 26 de setembro de 2023

Novas funcionalidades:

• O recurso Conversor de query agora está em visualização privada. Para solicitar acesso de visualização privada, use o formulário de inscrição dentro do aplicativo Relational Migrator:

  1. Na guia Code Generation , clique no painel Query Converter .

  2. Clique no botão Register interest.

  3. Preencha os detalhes do formulário e clique no botão Submit .

Correções de erros:

• As conexões do SQL servidor agora exigem um nome de reconhecimento de data center, o que resolve alguns problemas causados pela inferência do nome do reconhecimento de data center.

• Melhorias nos instaladores do Mac e Windows.

1.2.0 Registro de alterações

Lançado em 4 de setembro de 2023

Novas funcionalidades:

• Capacidade de alterar o tipo de dados dos campos migrados.

• Capacidade de controlar como os valores nulos são representados nos dados migrados.

• Capacidade de utilizar campos calculados para o valor _id de uma coleção.

• O despejo de diagnóstico inclui arquivos de configuração para ajudar a simplificar o suporte.

Correções de erros:

• Melhora a validação e o tratamento de erros nas regras de mapeamento.

• Melhora a capacidade de analisar uma faixa mais ampla de arquivos Oracle DDL.

• Corrige um problema em que as tabelas eram perdidas ao atualizar um esquema usando o servidor SQL e a autenticação do Windows.

• Corrige um problema em que as atualizações do CDC podem direcionar o documento errado quando as tabelas não têm uma chave primária.

• Corrige um problema em que as senhas do reconhecimento de data center podem ser salvas incorretamente na biblioteca de senhas do navegador.

1.1.3 Registro de alterações

Lançada em 26 de julho de 2023

Novas funcionalidades:

• Suporte para conexão com uma instância nomeada do servidor SQL.

• Os nomes das collection agora aparecem para arquivos JSON schema criados a partir da tela Code Generation .

Correções de erros:

• Corrige um problema de tarefa pós-migração em que a verificação de dados às vezes para ou exibe como não iniciada.

• Corrige um problema em que colunas JSON contendo arrays de nível superior não podem ser migradas.

• Corrige um problema em que os campos excluídos podem substituir campos calculados com o mesmo nome.

• Corrige um problema em que os campos calculados com base em valores de coluna decimal retornam NaN.

• Corrige um problema em que alguns campos de visualização de diagramas são cortados após você alterar a opção de tratamento de chaves no nível do projeto.

1.1.2 Registro de alterações

Lançada em 22 de junho de 2023

Relational Migrator 1.1.2 agora está disponível ao público em geral. O Relational Migrator ajuda na migração de seus volumes de trabalho relacionais para o MongoDB.