ApsaraDB for SelectDB:Gestion des variables

SHOW VARIABLES;

SHOW VARIABLES LIKE '%time_zone%';

Définir une variable de session

Les variables de session prennent effet immédiatement et s'appliquent uniquement à la connexion actuelle :

SET exec_mem_limit = 137438953472;
SET forward_to_master = true;
SET time_zone = "Asia/Shanghai";

Les variables acceptent également les expressions constantes :

SET exec_mem_limit = 10 * 1024 * 1024 * 1024;
SET forward_to_master = concat('tr', 'u', 'e');

Définir une variable globale

Les variables globales s'appliquent à la session actuelle ainsi qu'à toutes les sessions suivantes :

SET GLOBAL exec_mem_limit = 137438953472;

Les variables suivantes prennent en charge à la fois les niveaux session et global :

• time_zone

• wait_timeout

• sql_mode

• enable_profile

• query_timeout

• insert_timeout

• exec_mem_limit

• batch_size

• allow_partition_column_nullable

• insert_visible_timeout_ms

• enable_fold_constant_by_be

Les variables suivantes prennent en charge uniquement le niveau global :

• default_rowset_type

• default_password_lifetime

• password_history

• validate_password_policy

Remplacer une variable pour une seule requête

Utilisez l'indicateur SET_VAR pour définir une variable de session pour une instruction unique sans modifier l'état de la session :

SELECT /*+ SET_VAR(exec_mem_limit = 8589934592) */ name FROM people ORDER BY name;
SELECT /*+ SET_VAR(query_timeout = 1, enable_partition_cache=true) */ sleep(3);

Les commentaires doivent commencer par /*+ et suivre l'instruction SELECT.

Consulter et définir les variables de fuseau horaire

Pour afficher les deux variables de fuseau horaire :

SHOW VARIABLES LIKE '%time_zone%';

Pour définir le fuseau horaire de la session :

SET time_zone = 'Asia/Shanghai';

Pour définir le fuseau horaire du cluster pour toutes les sessions suivantes :

SET GLOBAL time_zone = 'Asia/Shanghai';

Formats de fuseau horaire pris en charge

Certaines méthodes d'importation de données peuvent accepter des formats de fuseau horaire supplémentaires non répertoriés ci-dessus. Évitez d'utiliser des formats non standard en production, car ApsaraDB for SelectDB peut modifier leur gestion à tout moment.

Impact des paramètres de fuseau horaire sur les fonctions et les données

Fonctions concernées

Les fonctions suivantes renvoient des résultats basés sur le paramètre time_zone actuel :

La sortie des commandes SHOW LOAD et SHOW BACKENDS reflète également le fuseau horaire configuré.

Non affecté par les paramètres de fuseau horaire :

• Les valeurs less than des colonnes de clé de partition de type temporel dans CREATE TABLE

• Les valeurs stockées sous le type DATE ou DATETIME (la valeur stockée elle-même ne change pas)

Données de type temporel lors de l'importation

Lors de l'importation de données de type DATE, DATEV2, DATETIME ou DATETIMEV2, ApsaraDB for SelectDB gère la conversion de fuseau horaire comme suit :

• Données avec un suffixe de fuseau horaire (par exemple, 2020-12-12 12:12:12+08:00) : Converties vers le time_zone actuel du cluster. Par exemple, si time_zone est défini sur +00:00, la valeur stockée devient 2020-12-12 04:12:12.

• Données sans suffixe de fuseau horaire (par exemple, 2020-12-12 12:12:12) : Traitées comme une heure absolue — importées telles quelles sans conversion.

Heure d'été

Les ajustements liés à l'heure d'été sont intégrés aux fuseaux horaires nommés. Par exemple, America/Los_Angeles passe de -08:00 à -07:00 en mars, puis revient en novembre.

Pour éviter les changements liés à l'heure d'été, définissez time_zone sur un décalage UTC fixe (par exemple, -08:00) plutôt que sur un fuseau nommé comme America/Los_Angeles.

Sources de données de fuseau horaire

Sur chaque nœud backend (BE), ApsaraDB for SelectDB recherche les données de fuseau horaire aux emplacements suivants, dans l'ordre :

1. Le répertoire renvoyé par la commande TZDIR

2. /usr/share/zoneinfo

3. Le répertoire zoneinfo dans le répertoire de déploiement du BE

Si aucune donnée de fuseau horaire n'est trouvée à aucun emplacement, le nœud BE ne démarre pas.

Données sensibles au fuseau horaire

Avant d'importer des données, décidez comment gérer les informations de fuseau horaire de manière cohérente. Les données de types temporels tels que DATETIME ne stockent pas de fuseau horaire. ApsaraDB for SelectDB distingue deux catégories :

Heure absolue : Aucun fuseau horaire dans les données, aucun fuseau horaire configuré au moment de l'importation. Exemple : 2023-12-12 08:00:00. Stockée et interrogée telle quelle, sans être affectée par time_zone.

Heure dans un fuseau horaire spécifique : Les données incluent un suffixe de fuseau horaire. Exemple : 2020-12-12 12:12:12+02:00. La méthode d'importation détermine quel paramètre de fuseau horaire s'applique :

• INSERT INTO : Régie par la variable de session time_zone.

• Stream Load ou Broker Load : Régis par l'en-tête de requête timezone. Si l'en-tête timezone entre en conflit avec la variable de session time_zone, l'en-tête timezone a la priorité.

ApsaraDB for SelectDB convertit le fuseau horaire littéral présent dans les données entrantes vers le fuseau horaire configuré par time_zone au moment de l'importation.

Approche recommandée : Définissez time_zone une fois avant l'importation, puis maintenez-le constant. Modifier time_zone après avoir importé des données conscientes du fuseau horaire entraîne une interprétation erronée des valeurs stockées lors des requêtes suivantes.

L'exemple suivant illustre ce qui se produit lorsque time_zone est modifié en cours de session :

-- Current time zone: Asia/Hong_Kong
SELECT @@time_zone;
-- +----------------+
-- | @@time_zone    |
-- +----------------+
-- | Asia/Hong_Kong |
-- +----------------+

-- Import data with literal time zone +02:00
-- Stored as 2020-12-12 18:12:12 (converted to Asia/Hong_Kong)
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 18:12:12.000 |
-- +-------------------------+

-- Changing time_zone does not update stored values
SET time_zone = 'America/Los_Angeles';

-- A second import now uses America/Los_Angeles for conversion
INSERT INTO dtv23 VALUES('2020-12-12 12:12:12+02:00');

SELECT * FROM dtv23;
-- Rows now carry inconsistent time zone semantics
-- +-------------------------+
-- | k0                      |
-- +-------------------------+
-- | 2020-12-12 02:12:12.000 |  -- imported under America/Los_Angeles
-- | 2020-12-12 18:12:12.000 |  -- imported under Asia/Hong_Kong
-- +-------------------------+

Résumé des bonnes pratiques relatives au fuseau horaire :

• Vérifiez le time_zone du cluster avant d'importer les données et ne le modifiez pas par la suite.

• Lors de l'utilisation de Stream Load ou Broker Load, définissez l'en-tête timezone sur la même valeur que la variable de session time_zone.

• Pour les données d'heure absolue, importez sans suffixe de fuseau horaire. Pour les données conscientes du fuseau horaire, incluez le suffixe de fuseau horaire et laissez ApsaraDB for SelectDB gérer la conversion.

Précision de l'heure d'été

Les données de fuseau horaire nommé (y compris les dates de début et de fin de l'heure d'été) sont maintenues par l'Internet Assigned Numbers Authority (IANA). Les données stockées sur chaque nœud BE peuvent ne pas refléter les modifications les plus récentes confirmées par l'IANA pour l'année en cours.

Si votre charge de travail nécessite le calendrier d'heure d'été le plus récent, assurez-vous que la source de données de fuseau horaire sur chaque nœud BE contient la dernière version de la base de données IANA tz. Pour obtenir les dernières données, consultez The tz-announce Archives.

Variables prises en charge