Para atender às necessidades de colaboração empresarial entre fusos horários e unificar o processamento de dados, as organizações frequentemente precisam padronizar a linha de base de agendamento dos workspaces do DataWorks em diferentes regiões para um fuso horário específico, como UTC+0 ou UTC+8. Este tópico explica como alterar o fuso horário de agendamento e detalha os impactos nas tarefas agendadas e nas configurações relacionadas. Antes de alterar o fuso horário, avalie completamente os riscos para garantir uma lógica de agendamento consistente em seus negócios globais e evitar conflitos de agendamento ou erros de dados causados por inconsistências de fuso horário.
Regiões suportadas
Por padrão, o fuso horário de agendamento de um workspace do DataWorks corresponde ao fuso horário local da região onde o workspace está localizado. Algumas regiões do DataWorks permitem alterar o fuso horário de agendamento. A tabela a seguir lista as regiões que suportam essa alteração e os fusos horários disponíveis.
|
Região |
Suporte a UTC+0 |
Suporte a UTC+8 |
|
EUA (Silicon Valley) |
Suportado |
Suportado |
|
EUA (Virginia) |
Suportado |
Suportado |
|
Alemanha (Frankfurt) |
Suportado |
Suportado |
|
Singapura |
Suportado |
Suportado (igual ao fuso horário local) |
|
China (Hong Kong) |
Suportado |
Suportado (igual ao fuso horário local) |
|
Japão (Tóquio) |
Suportado |
Suportado |
Por exemplo, em um workspace do DataWorks na região EUA (Silicon Valley), você pode alternar o fuso horário de agendamento do fuso horário local padrão para UTC+0 ou UTC+8. Após alterar o fuso horário com êxito, verifique a barra de notificação na parte superior do Operation Center ou acesse a aba de um nó no Data Development para verificar a alteração.
Precauções
Leia atentamente as precauções a seguir antes de alterar o fuso horário de agendamento para evitar problemas em produção ou comportamentos inesperados.
|
Categoria |
Descrição |
|
Escopo do workspace afetado |
O fuso horário de agendamento é uma configuração de nível de região. A alteração entra em vigor em todos os workspaces da região. |
|
Operação irreversível |
Esta alteração é irreversível. Prossiga com cautela. Importante
Esta operação envolve a migração de dados existentes, como nós e instâncias, e pode afetar suas cargas de trabalho. Recomendamos avaliar completamente o impacto antes de prosseguir. |
|
Escopo da configuração afetada |
Alterar o fuso horário de agendamento afeta as configurações de agendamento do DataWorks e a substituição de parâmetros de agendamento no código. O DataWorks calcula os valores desses parâmetros com base no horário agendado da tarefa e no timestamp de dados e os utiliza como entradas no código.
Importante
|
Impactos da alteração de fuso horário
A mudança do fuso horário de agendamento afeta as configurações de agendamento do DataWorks, a substituição de parâmetros em cenários de agendamento e a exibição de horários em alguns módulos.
A alteração do fuso horário de agendamento afeta apenas cenários de agendamento. Como a maioria das operações no DataStudio não ocorre em um ambiente de agendamento, os parâmetros de tempo ainda são substituídos com base no fuso horário local por padrão quando você executa tarefas no DataStudio. Por exemplo, operações como executar um único nó, executar com parâmetros ou realizar uma consulta ad hoc não são afetadas pela mudança do fuso horário de agendamento.
Como operações como executar um workflow ou realizar testes de fumaça no DataStudio utilizam o sistema de agendamento, os parâmetros de tempo no código do nó são afetados pela alteração do fuso horário de agendamento.
Impacto 1: Horário de agendamento do nó
O horário agendado para um nó muda com base no novo fuso horário de agendamento. Nas configurações de Schedule, suponha que Instance Generation Method seja T+1 (Next Day), Schedule Type seja Normal, Recurrence seja Daily e Scheduled Time seja 00:01, o que corresponde à expressão cron 00 01 00 * * ?. Suponha também que Rerun Property seja Rerun allowed after success or failure e Effective Date seja de 1970-01-01 a 9999-01-01.
Impacto 2: Configuração de parâmetros de tempo do nó
Os parâmetros de agendamento substituem variáveis no código com base em horários relacionados à tarefa, como o horário agendado e o timestamp de dados. Os valores desses parâmetros mudam de acordo com o novo fuso horário de agendamento.
YYYYMMDD=${yyyymmdd} LAST_2D=${yyyymmdd-2}
Na seção Parameters, insira os parâmetros de agendamento. Separe múltiplos parâmetros com espaços, por exemplo, YYYYMMDD=${yyyymmdd} LAST_2D=${yyyymmdd-2}. Esses parâmetros entram em vigor durante o agendamento periódico. Utilize o recurso de teste de fumaça no ambiente de desenvolvimento para verificar a substituição correta dos parâmetros.
Impacto 3: Lógica relacionada a tempo no código do nó
O gateway ou o mecanismo de computação interpreta as variáveis no código. A lógica de interpretação é a seguinte:
Se o gateway interpretar as variáveis, os valores mudam de acordo com o novo fuso horário de agendamento. Em cenários de agendamento (excluindo execuções ad hoc no Data Development), se você executar um comando para obter o horário em uma tarefa de script do DataWorks, como um nó Shell ou pyodps, executando o comando
dateem um nó Shell, o sistema retornará o horário com base no seu fuso horário de agendamento.Se o mecanismo de computação subjacente interpretar as variáveis, aplicam-se as regras de conversão de fuso horário do próprio mecanismo. Para detalhes, consulte a documentação do mecanismo específico.
No exemplo de código a seguir, as variáveis de tempo no código são substituídas por strings de tempo específicas com base no horário agendado e depois passadas para o Hive. O tempo real representado depende da lógica de interpretação do servidor Hive.
if [ "${YYYYMMDDHH}" = "${YYYYMMDD}00" ] ;then
echo '######## run hive reload data'
hive --hiveconf hive.merge.tezfiles=false --hiveconf tez.queue.name=${YARN_QUEUE} -d YYYYMMDD=${LASTDAY} -d YYYYMMDDHH=${YYYYMMDDHH} -d LASTDAY=${LAST_2D}
...
Impacto 4: Horários de linha de base ou alertas
Os horários relacionados a linhas de base ou alertas mudam de acordo com o novo fuso horário de agendamento.
Impacto 5: Horários relacionados a API
Os horários relacionados a APIs mudam de acordo com o novo fuso horário de agendamento.
Impacto 6: Fusos horários dos mecanismos subjacentes
Os fusos horários dos mecanismos subjacentes, como Data Integration e MaxCompute, são definidos por cada mecanismo e independem do fuso horário de agendamento do DataWorks. Os valores dos parâmetros de agendamento são passados ao mecanismo como strings simples e processados de acordo com as regras próprias do mecanismo. Para obter informações sobre como os mecanismos lidam com fusos horários, consulte a documentação do respectivo mecanismo.
A alteração do fuso horário de agendamento afeta apenas as propriedades relacionadas ao horário de agendamento da tarefa e não envolve mudanças nos fusos horários do mecanismo.
Para obter informações sobre como esse cenário é tratado no Data Integration, consulte Apêndice: Processamento de tempo no Data Integration.
Solicitar a alteração de fuso horário
Cenário 1: Novo tenant, primeiro workspace
Quando um novo usuário cria seu primeiro workspace em uma região que suporta alterações de fuso horário, uma caixa de diálogo informa que o fuso horário de agendamento pode ser alterado para um fuso não local. Para fazer a alteração, envie um ticket para entrar em contato com o suporte técnico. Decida se deseja solicitar a alteração com base nas necessidades do seu negócio e nas informações em Precauções.
Cenário 2: Tenants existentes
Se você já possui workspaces em uma região que suporta alterações de fuso horário e precisa mudar o fuso horário de agendamento para um fuso não local, também será necessário enviar um ticket para contatar o suporte técnico. Como isso envolve a migração de dados existentes, como nós e instâncias, pode afetar suas cargas de trabalho. Recomendamos avaliar completamente o impacto. O processo envolve as seguintes etapas:
Sua parte: Avalie o impacto nos dados existentes.
Parte da plataforma: Migre os dados existentes.
Parte da plataforma: Defina o novo fuso horário.
-
Sua parte: Restaure os dados existentes e verifique o novo fuso horário.
Recomendamos executar vários testes de verificação para cada tipo de tarefa.
Verificar a alteração de fuso horário
Após alterar o fuso horário com êxito, acesse a página de edição de nós no Data Development (não aplicável a nós no novo editor de workflow) para verificar as configurações de Scheduling Settings, ou vá para a página do Operation Center para confirmar que a configuração de fuso horário está em vigor.
Método 1: Verificar as configurações de Schedule
Depois que a configuração de fuso horário entrar em vigor, uma mensagem de notificação azul "The scheduling time zone is UTC" aparecerá na parte superior da aba Schedule > Scheduling Time.
-
Faça login no console do DataWorks. Na região de destino, clique em no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.
Abra um nó existente no Data Development ou crie um novo nó para acessar a página de edição do nó.
Na página de edição do nó, clique na aba para verificar se a nova configuração de fuso horário entrou em vigor.
Método 2: Verificar no Operation Center
Faça login no console do DataWorks. Após alternar para a região de destino, escolha no painel de navegação à esquerda. Selecione o workspace desejado na lista suspensa e clique em Operation Center. A configuração atual de fuso horário é exibida na barra de notificação na parte superior da página do Operation Center.
Por exemplo, se o fuso horário de agendamento estiver definido como UTC, a barra de notificação exibirá This tenant uses UTC as the scheduling time zone. Operation Center displays time in this time zone by default.
Apêndice: Processamento de tempo no Data Integration
O fuso horário do Data Integration é independente do fuso horário de agendamento do DataWorks. O DataWorks passa os valores dos parâmetros de agendamento para o Data Integration como strings simples. Por exemplo, para uma condição de filtragem de dados em uma cláusula where como gmt_modify >= ${yyyymmdd}, o Data Integration envia esse filtro SQL para a fonte de dados como uma string literal. O resultado real da filtragem depende do mecanismo de processamento de fuso horário da própria fonte de dados.
O fuso horário para um processo de sincronização do Data Integration é o fuso horário local da região do workspace do DataWorks. Este fuso horário não muda com o fuso horário de agendamento do DataWorks. Esteja ciente dessa restrição, pois a sincronização de algumas fontes de dados está relacionada ao fuso horário do processo de sincronização.