Todos os produtos
Search
Central de documentação

DataWorks:Alterar o fuso horário de agendamento

Última atualização: Jul 20, 2026

O DataWorks permite alterar o fuso horário de agendamento de workspaces em regiões compatíveis para UTC+0 ou UTC+8, unificando as linhas de base de agendamento entre regiões. Essa alteração é irreversível e afeta tarefas agendadas e a substituição de parâmetros. Avalie cuidadosamente os riscos antes de prosseguir.

Regiões compatíveis

Por padrão, o fuso horário de agendamento corresponde ao fuso horário local da região do workspace. A tabela a seguir lista as regiões que oferecem suporte à alteração de fuso horário e as opções disponíveis.

Região

Suporte a UTC+0

Suporte a UTC+8

US (Silicon Valley)

Compatível

Compatível

US (Virginia)

Compatível

Compatível

Germany (Frankfurt)

Compatível

Compatível

Singapore

Compatível

Compatível (igual ao fuso horário local)

China (Hong Kong)

Compatível

Compatível (igual ao fuso horário local)

Japan (Tokyo)

Compatível

Compatível

Nota

Por exemplo, em um workspace do DataWorks na região US (Silicon Valley), é possível alternar o fuso horário de agendamento do fuso horário local padrão para UTC+0 ou UTC+8. Após a alteração bem-sucedida, verifique a barra de notificação na parte superior do Operation Center ou acesse a aba Scheduling Settings > Data Timestamp de um nó no Data Development para verificar a alteração.

Precauções

Revise as precauções a seguir antes de alterar o fuso horário de agendamento para evitar problemas em produção.

Categoria

Descrição

Escopo de workspaces afetados

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 uma avaliação completa antes de prosseguir.

Escopo de configurações afetadas

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 dos dados e os utiliza como entradas no código.

Importante
  • Cada mecanismo de computação subjacente define seu próprio fuso horário independentemente; portanto, alterações no fuso horário de agendamento do DataWorks não os afetam.

  • A alteração do fuso horário de agendamento afeta apenas propriedades relacionadas ao horário de agendamento da tarefa e não modifica os fusos horários do mecanismo. Os valores dos parâmetros de agendamento são passados ao mecanismo como strings simples e processados conforme as regras do próprio mecanismo. Para obter informações sobre como os mecanismos lidam com fusos horários, consulte a documentação do respectivo mecanismo.

  • Operações como executar um workflow ou realizar testes de fumaça no DataStudio utilizam o sistema de agendamento; logo, os parâmetros de tempo no código sofrem impacto da mudança de fuso horário. Contudo, operações como executar um único nó ou realizar uma consulta ad hoc não usam o sistema de agendamento e, portanto, não são afetadas.

Impactos da alteração de fuso horário

A alteração do fuso horário de agendamento afeta as configurações de agendamento, a substituição de parâmetros e a exibição de horários em alguns módulos.

Nota
  • A mudança do fuso horário de agendamento afeta apenas cenários de agendamento. Como a maioria das operações no DataStudio não ocorre em ambiente de agendamento, os parâmetros de tempo ainda são substituídos com base no fuso horário local por padrão ao executar tarefas no DataStudio. Por exemplo, operações como executar um único nó, executar com parâmetros ou realizar uma consulta ad hoc não sofrem impacto da alteração do fuso horário de agendamento.

  • Como operações como executar um workflow ou realizar testes de fumaça no DataStudio usam 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 de 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, correspondente à 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âmetro de tempo do nó

Os parâmetros de agendamento substituem variáveis no código com base em tempos relacionados à tarefa, como o horário agendado e o timestamp dos dados. Os valores desses parâmetros mudam conforme 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. Use 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 analisa as variáveis no código. A lógica de análise é a seguinte:

  • Se o gateway realizar a análise, os valores mudam conforme o novo fuso horário de agendamento. Em cenários de agendamento (exceto execuções ad hoc no Data Development), ao executar um comando de tempo em uma tarefa de script do DataWorks, como um nó Shell ou pyodps (por exemplo, o comando date em um nó Shell), o sistema retorna o tempo com base no fuso horário de agendamento.

  • Se o mecanismo de computação subjacente realizar a análise, 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 são substituídas por strings de tempo específicas com base no horário agendado e depois passadas ao Hive. O tempo real representado depende da lógica de análise 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 alerta

Os horários relacionados a linhas de base ou alertas mudam conforme o novo fuso horário de agendamento.

Impacto 5: Horários relacionados a API

Os horários relacionados a APIs mudam conforme o novo fuso horário de agendamento.

Impacto 6: Fusos horários dos mecanismos subjacentes

Cada mecanismo subjacente, como Data Integration e MaxCompute, define seu próprio fuso horário, independente 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 conforme as regras do próprio mecanismo. Para obter informações sobre como os mecanismos lidam com fusos horários, consulte a documentação do respectivo mecanismo.

Nota
  • A alteração do fuso horário de agendamento afeta apenas 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 compatível com alteração de fuso horário, uma caixa de diálogo informa que é possível alterar o fuso horário de agendamento para um fuso não local. Para fazer a alteração, envie um ticket para contatar o suporte técnico. Decida se solicita 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 compatível com alteração 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 uma avaliação completa. O processo envolve as seguintes etapas:

  1. Sua parte: Avalie o impacto nos dados existentes.

  2. Parte da plataforma: Migre os dados existentes.

  3. Parte da plataforma: Defina o novo fuso horário.

  4. 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 a conclusão bem-sucedida da alteração de fuso horário, acesse a página de edição de nó 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 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.

  1. Faça login no console do DataWorks. Na região de destino, clique em Data Development and O&M > Data Development no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.

  2. Clique para abrir um nó existente no Data Development ou crie um novo nó para acessar a página de edição do nó.

  3. Na página de edição do nó, clique na aba Scheduling Settings > Data Timestamp 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 Data Development and O&M > Operation Center 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 ao Data Integration como strings simples. Por exemplo, para uma condição de filtragem em uma cláusula where como gmt_modify >= ${yyyymmdd}, o Data Integration envia esse filtro à fonte de dados como uma string literal. O resultado da filtragem depende do tratamento de fuso horário da fonte de dados.

Importante

O fuso horário de um processo de sincronização do Data Integration é o fuso horário local da região do workspace do DataWorks. Esse 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 depende do fuso horário do processo de sincronização.