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 |
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 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
|
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.
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
datedans 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é.
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 :
De votre côté : évaluez l'impact sur les données existantes.
Côté plateforme : migrez les données existantes.
Côté plateforme : définissez le nouveau fuseau horaire.
-
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.
-
Connectez-vous à la console DataWorks. Dans la région cible, cliquez sur 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.
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.
Sur la page d'édition du nœud, cliquez sur l'onglet 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 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.
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.