Migração de data no Jitterbit App Builder

Visão geral

O recurso de Migração de Data do App Builder oferece suporte para migrar datas de um fuso horário para outro.

Recomendações

A Migração de Data é recomendada para desenvolvedores que buscam converter colunas DateTime de um fuso horário para outro.

O fuso horário ideal para sua Fonte de Dados é, talvez, debatível; no entanto, a prática recomendada é configurar seus servidores e Fontes de Dados para que todos usem o mesmo fuso horário. O UTC é provavelmente a melhor escolha, pois qualquer outro fuso horário está sujeito a mudanças se a localização do servidor mudar. Também observe que as instâncias da Amazon estão, por padrão, configuradas para usar UTC.

Outra coisa a ter em mente é que configurar o fuso horário do seu servidor de banco de dados para ser o mesmo que o fuso horário da sua Fonte de Dados garantirá que chamadas para 'Now()' retornem o valor esperado. Now() retorna a hora atual de acordo com o fuso horário do banco de dados.

Ao manter todos os fusos horários da sua Fonte de Dados sincronizados, você pode evitar a dor de cabeça de converter dados DateTime de um fuso horário para outro. Hoje, isso não é feito automaticamente, embora possa ser implementado em uma versão futura.

Limitações e advertências

Embora as colunas DateTime sejam migradas, há outros aspectos da sua aplicação App Builder que podem exigir modificação, incluindo:

• Valores DateTime codificados diretamente nas regras não são ajustados. Se suas regras incluírem cláusulas where ou select com datas codificadas, você precisará ajustá-las manualmente para o novo fuso horário esperado.
• Quaisquer colunas que utilizem DateAdd ou funções semelhantes para ajustar fusos horários manualmente também permanecerão inalteradas. Os desenvolvedores precisarão corrigir isso manualmente.
• Versões do MS SQL Server anteriores a 2016 não suportam a função AT TIME ZONE. Como resultado, a Migração de Data será realizada usando um deslocamento de fuso horário calculado a partir dos fusos horários de origem e destino no momento atual. Isso pode causar problemas com fusos horários que utilizam horário de verão.
• As Migrações de Data são executadas em uma única transação quando seu aplicativo/fonte de dados está sendo atualizado via um LP. A transação pode expirar dependendo da quantidade de dados a serem migrados. Se isso acontecer, definir um CommandTimeOut mais longo em seu arquivo de conexão ajudará a mitigar o tempo limite.

Configurar migração de data

Para realizar uma Migração de Data, execute os seguintes passos:

• Navegue até IDE > Configurações Adicionais > Migração de Data
• Clique em + Migração no painel de Migrações de Data
• Selecione uma Fonte de Dados
• Selecione um Fuso Horário de Origem. Esta configuração já estará preenchida para Fontes de Dados que possuem um Fuso Horário não nulo.
• Selecione um Fuso Horário de Destino
• Clique em Salvar

Neste ponto, o painel do lado direito deve ser preenchido com todas as colunas DateTime na Fonte de Dados selecionada. A partir daqui, você pode configurar as definições de Migração de Data para colunas individuais.

Se sua Fonte de Dados não tiver um fuso horário definido, você notará que as colunas de DateTime de Auditoria usarão o fuso horário do servidor de aplicativos do App Builder como o Fuso Horário de Origem. Os dados de auditoria são gravados usando o fuso horário do servidor de aplicativos quando a Fonte de Dados não tem um fuso horário configurado. Também observe que o App Builder usa os Tipos de Uso das colunas AddedOn e ChangedOn para determinar se uma coluna é considerada dados de Auditoria.

Depois de ajustar as colunas individuais, você pode prosseguir com os seguintes passos:

• Na mesma tela que acima, clique no botão Migrar no painel de Migração de Data.

Isso executará um trabalho em segundo plano para migrar todas as colunas configuradas. A Migração de Data é executada dentro de uma única transação e bloqueará tabelas no processo. Você deve garantir que o tráfego em seu servidor seja mínimo ou inexistente para evitar bloqueios.

Passos de gerenciamento de mudanças também serão adicionados para cada tabela sendo migrada.

Após as datas terem sido migradas, o status da Migração de Data mudará para Completo.

Se ocorrer uma falha, a transação de Migração de Data será revertida e registros adicionais podem ser encontrados no histórico do trabalho em segundo plano.

Solução de Problemas

Para solução de problemas relacionados, consulte o seguinte no guia de solução de problemas do App Builder:

• A migração de data expira em grandes conjuntos de dados