Tous les produits
Search
Centre de documentation

DataWorks:Modifier le fuseau horaire de planification

Dernière mise à jour :Aug 10, 2026

DataWorks permet de modifier le fuseau horaire de planification des espaces de travail dans les régions prises en charge, en le basculant vers UTC+0 ou UTC+8. Cette modification unifie les références de planification entre les différentes régions. Cette opération est irréversible et affecte les tâches planifiées ainsi que la substitution des paramètres. Évaluez attentivement les risques avant d'agir.

Régions prises en charge

Par défaut, le fuseau horaire de planification correspond au fuseau horaire local de la région de l'espace de travail. Le tableau ci-dessous répertorie les régions permettant la modification du fuseau horaire ainsi que les options disponibles.

Région

Prise en charge de UTC+0

Prise en charge de UTC+8

États-Unis (Silicon Valley)

Pris en charge

Pris en charge

États-Unis (Virginie)

Pris en charge

Pris en charge

Allemagne (Francfort)

Pris en charge

Pris en charge

Singapour

Pris en charge

Pris en charge (identique au fuseau horaire local)

Chine (Hong Kong)

Pris en charge

Pris en charge (identique au fuseau horaire local)

Japon (Tokyo)

Pris en charge

Pris en charge

Remarque

Par exemple, pour un espace de travail DataWorks situé dans la région États-Unis (Silicon Valley), vous pouvez basculer le fuseau horaire de planification du fuseau horaire local par défaut vers UTC+0 ou UTC+8. Une fois la modification effectuée, consultez la barre de notification en haut de Operation Center ou accédez à l'onglet Scheduling Settings > Data Timestamp d'un nœud dans Data Development pour vérifier la modification.

Précautions

Examinez les précautions suivantes avant de modifier le fuseau horaire de planification afin d'éviter tout incident en production.

Catégorie

Description

Périmètre d'impact sur les espaces de travail

Le fuseau horaire de planification est un paramètre au niveau de la région. La modification s'applique à tous les espaces de travail de cette région.

Opération irréversible

Cette modification est irréversible. Agissez avec prudence.

Important

Cette opération implique la migration des données existantes, telles que les nœuds et les instances, et peut affecter vos charges de travail. Nous recommandons une évaluation approfondie avant d'agir.

Périmètre de configuration impacté

La modification du fuseau horaire de planification affecte les configurations de planification de DataWorks et la manière dont les paramètres de planification sont substitués dans votre code. DataWorks calcule les valeurs de ces paramètres en fonction de l'heure planifiée de la tâche et de l'horodatage des données, puis les utilise comme entrées dans votre code.

Important
  • Les fuseaux horaires des moteurs de calcul sous-jacents sont configurés indépendamment par chaque moteur et ne sont pas affectés par les modifications du fuseau horaire de planification de DataWorks.

  • La modification du fuseau horaire de planification n'affecte que les propriétés liées à l'heure de planification des tâches et ne modifie pas les fuseaux horaires des moteurs. Les valeurs des paramètres de planification sont transmises au moteur sous forme de chaînes de caractères brutes et traitées selon les règles propres au moteur. Pour savoir comment les moteurs gèrent les fuseaux horaires, consultez la documentation du moteur concerné.

  • Étant donné que des opérations telles que l'exécution d'un workflow ou les tests de fumée dans DataStudio utilisent le système de planification, les paramètres temporels dans le code sont affectés par la modification du fuseau horaire de planification. En revanche, les opérations telles que l'exécution d'un nœud unique ou l'exécution de requêtes ad hoc n'utilisent pas le système de planification et ne sont donc pas affectées.

Impacts de la modification du fuseau horaire

La modification du fuseau horaire de planification affecte les configurations de planification, la substitution des paramètres et l'affichage de l'heure dans certains modules.

Remarque
  • La modification du fuseau horaire de planification n'affecte que les scénarios de planification. Comme la plupart des opérations dans DataStudio ne s'effectuent pas dans un environnement de planification, les paramètres temporels sont toujours remplacés en fonction du fuseau horaire local par défaut lors de l'exécution des tâches dans DataStudio. Par exemple, les opérations telles que l'exécution d'un nœud unique, l'exécution avec des paramètres ou l'exécution de requêtes ad hoc ne sont pas affectées par la modification du fuseau horaire de planification.

  • Étant donné que des opérations telles que l'exécution d'un workflow ou les tests de fumée dans DataStudio utilisent le système de planification, les paramètres temporels dans le code du nœud sont affectés par la modification du fuseau horaire de planification.

Impact 1 : Heure de planification du nœud

L'heure planifiée d'un nœud change en fonction du nouveau fuseau horaire de planification. Dans les paramètres de planification, supposons que la Méthode de génération d'instance soit T+1 (Jour suivant), que le Type de planification soit Normal, que la Récurrence soit Quotidienne et que l'Heure planifiée soit 00:01, ce qui correspond à l'expression cron 00 01 00 * * ?. Supposons également que la Propriété de réexécution autorise la réexécution après succès ou échec et que la Date d'effet s'étende du 01/01/1970 au 01/01/9999.

Impact 2 : Configuration des paramètres temporels du nœud

Les paramètres de planification remplacent les variables dans votre code en fonction des heures liées à la tâche, telles que l'heure planifiée et l'horodatage des données. Les valeurs de ces paramètres changent selon le nouveau fuseau horaire de planification.

YYYYMMDD=${yyyymmdd} LAST_2D=${yyyymmdd-2}

Dans la section Parameters, saisissez les paramètres de planification. Séparez plusieurs paramètres par des espaces, par exemple YYYYMMDD=${yyyymmdd} LAST_2D=${yyyymmdd-2}. Ces paramètres prennent effet lors de la planification périodique. Vous pouvez utiliser la fonctionnalité de test de fumée dans l'environnement de développement pour vérifier le remplacement correct des paramètres.

Impact 3 : Logique liée au temps dans le code du nœud

Les variables de votre code sont analysées soit par la passerelle, soit par le moteur de calcul. La logique d'analyse est la suivante :

  • Si l'analyse est effectuée par la passerelle, les valeurs changent en fonction du nouveau fuseau horaire de planification. Dans les scénarios de planification (à l'exclusion des exécutions ad hoc dans Data Development), si vous exécutez une commande temporelle dans une tâche de script DataWorks telle qu'un nœud Shell ou pyodps, par exemple la commande date dans un nœud Shell, le système renvoie l'heure basée sur votre fuseau horaire de planification.

  • Si l'analyse est effectuée par le moteur de calcul sous-jacent, les règles de conversion de fuseau horaire propres au moteur s'appliquent. Pour plus de détails, consultez la documentation du moteur spécifique.

Dans l'exemple de code ci-dessous, les variables temporelles du code sont remplacées par des chaînes de temps spécifiques basées sur l'heure planifiée, puis transmises à Hive. L'heure réelle représentée dépend de la logique d'analyse du serveur 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}
...

Impact 4 : Heures des lignes de base ou des alertes

Les heures liées aux lignes de base ou aux alertes changent en fonction du nouveau fuseau horaire de planification.

Impact 5 : Heures liées aux API

Les heures liées aux API changent en fonction du nouveau fuseau horaire de planification.

Impact 6 : Fuseaux horaires des moteurs sous-jacents

Les fuseaux horaires des moteurs sous-jacents, tels que Data Integration et MaxCompute, sont définis par chaque moteur et sont indépendants du fuseau horaire de planification de DataWorks. Les valeurs des paramètres de planification sont transmises au moteur sous forme de chaînes de caractères brutes et traitées selon les règles propres au moteur. Pour savoir comment les moteurs gèrent les fuseaux horaires, consultez la documentation du moteur concerné.

Remarque
  • La modification du fuseau horaire de planification n'affecte que les propriétés liées à l'heure de planification des tâches et n'implique pas de modification des fuseaux horaires des moteurs.

  • Pour savoir comment ce scénario est géré dans Data Integration, consultez la section Annexe : Traitement de l'heure dans Data Integration.

Demander la modification du fuseau horaire

Scénario 1 : Nouveau locataire, premier espace de travail

Lorsqu'un nouvel utilisateur crée son premier espace de travail dans une région prenant en charge la modification du fuseau horaire, une boîte de dialogue l'informe que le fuseau horaire de planification peut être modifié vers un fuseau non local. Pour effectuer cette modification, vous devez soumettre un ticket pour contacter le support technique. Vous pouvez décider de demander cette modification en fonction de vos besoins métier et des informations figurant dans la section Précautions.

Scénario 2 : Locataires existants

Si vous disposez déjà d'espaces de travail dans une région prenant en charge la modification du fuseau horaire et que vous souhaitez basculer le fuseau horaire de planification vers un fuseau non local, vous devez également soumettre un ticket pour contacter le support technique. Cette opération impliquant la migration de données existantes, telles que les nœuds et les instances, elle peut affecter vos charges de travail. Nous recommandons une évaluation approfondie. Le processus comprend les étapes suivantes :

  1. De votre côté : évaluez l'impact sur les données existantes.

  2. Côté plateforme : migrez les données existantes.

  3. Côté plateforme : définissez le nouveau fuseau horaire.

  4. De votre côté : restaurez les données existantes et vérifiez le nouveau fuseau horaire.

    Nous recommandons d'effectuer plusieurs tests de vérification pour chaque type de tâche.

Vérifier la modification du fuseau horaire

Une fois la modification du fuseau horaire réussie, accédez à la page d'édition du nœud dans Data Development (non applicable aux nœuds du nouvel éditeur de workflow) pour consulter les paramètres Scheduling Settings, ou rendez-vous sur la page Operation Center pour confirmer que le paramètre de fuseau horaire est effectif.

Méthode 1 : Vérifier les paramètres de planification

Une fois le paramètre de fuseau horaire effectif, un message de notification bleu « The scheduling time zone is UTC » apparaît en haut de l'onglet Schedule > Scheduling Time.

  1. Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur Data Development and O&M > Data Development dans le volet de navigation de gauche. Sélectionnez un espace de travail dans la liste déroulante et cliquez sur Go to Data Development.

  2. Cliquez pour ouvrir un nœud existant dans Data Development ou créer un nouveau nœud afin d'accéder à la page d'édition du nœud.

  3. Sur la page d'édition du nœud, cliquez sur l'onglet Scheduling Settings > Data Timestamp pour vérifier si le nouveau paramètre de fuseau horaire est effectif.

Méthode 2 : Vérifier dans Operation Center

Connectez-vous à la console DataWorks. Après avoir basculé vers la région cible, choisissez Data Development and O&M > Operation Center dans le volet de navigation de gauche. Sélectionnez l'espace de travail souhaité dans la liste déroulante et cliquez sur Operation Center. La configuration actuelle du fuseau horaire s'affiche dans la barre de notification en haut de la page Operation Center.

Par exemple, si le fuseau horaire de planification est défini sur UTC, la barre de notification affiche This tenant uses UTC as the scheduling time zone. Operation Center displays time in this time zone by default.

Annexe : Traitement de l'heure dans Data Integration

Le fuseau horaire de Data Integration est indépendant du fuseau horaire de planification de DataWorks. DataWorks transmet les valeurs des paramètres de planification à Data Integration sous forme de chaînes de caractères brutes. Par exemple, pour une condition de filtrage dans une clause where telle que gmt_modify >= ${yyyymmdd}, Data Integration envoie ce filtre à la source de données sous forme de littéral de chaîne. Le résultat du filtrage dépend de la gestion du fuseau horaire par la source de données.

Important

Le fuseau horaire d'un processus de synchronisation Data Integration est le fuseau horaire local de la région de l'espace de travail DataWorks. Ce fuseau horaire ne change pas avec le fuseau horaire de planification de DataWorks. Soyez conscient de cette contrainte, car la synchronisation pour certaines sources de données est liée au fuseau horaire du processus de synchronisation.