Lindorm:Specify a time zone for a LindormTable connection

Outil de ligne de commande MySQL

Pour obtenir des instructions de connexion, consultez Utiliser un client MySQL pour se connecter à LindormTable et l'utiliser.

L'exemple suivant crée une table et insère une ligne contenant des valeurs de date, d'heure et d'horodatage, puis montre comment la colonne TIMESTAMP change lorsque vous basculez de fuseau horaire.

Configuration de la table :

-- Create the table
CREATE TABLE tb (p1 INT, c1 DATE, c2 TIME, c3 TIMESTAMP(3), PRIMARY KEY (p1));

-- Insert a row
UPSERT INTO tb (p1, c1, c2, c3) VALUES (1, '2024-08-30', '08:11:15', '2024-08-30 08:11:15.354');

Requête dans UTC+8 (par défaut) :

1. Vérifiez le fuseau horaire actuel.

   SELECT @@time_zone;

   Sortie attendue :

   +-------------+
   | @@time_zone |
   +-------------+
   | +08:00      |
   +-------------+

2. Interrogez la table.

   SELECT * FROM tb;

   Sortie attendue :

   +------+------------+----------+-------------------------+
   | p1   | c1         | c2       | c3                      |
   +------+------------+----------+-------------------------+
   |    1 | 2024-08-30 | 08:11:15 | 2024-08-30 08:11:15.354 |
   +------+------------+----------+-------------------------+

Basculez vers UTC et réinterrogez :

1. Modifiez le fuseau horaire pour UTC.

   SET @@time_zone = 'UTC';

2. Confirmez la modification.

   SELECT @@time_zone;

   Sortie attendue :

   +-------------+
   | @@time_zone |
   +-------------+
   | UTC         |
   +-------------+

3. Interrogez à nouveau la table.

   SELECT * FROM tb;

   Sortie attendue :

   +------+------------+----------+-------------------------+
   | p1   | c1         | c2       | c3                      |
   +------+------------+----------+-------------------------+
   |    1 | 2024-08-30 | 08:11:15 | 2024-08-30 00:11:15.354 |
   +------+------------+----------+-------------------------+

Les valeurs c1 (DATE) et c2 (TIME) restent inchangées car elles ne sont pas sensibles au fuseau horaire. La valeur c3 (TIMESTAMP) passe de 08:11:15 à 00:11:15 — une différence de 8 heures reflétant la conversion de UTC+8 vers UTC.

Java

Pour obtenir des instructions de connexion, consultez Utiliser les API Java JDBC pour développer des applications.

Le pilote MySQL Connector/J fournit deux paramètres qui fonctionnent conjointement pour contrôler le fuseau horaire de la connexion :

Ajoutez les deux paramètres à votre chaîne de connexion lorsque votre application s'exécute en dehors de UTC+8 :

String url = "jdbc:mysql://ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com:33060/"
    + database
    + "?sslMode=disabled"
    + "&allowPublicKeyRetrieval=true"
    + "&useServerPrepStmts=true"
    + "&useLocalSessionState=true"
    + "&rewriteBatchedStatements=true"
    + "&cachePrepStmts=true"
    + "&prepStmtCacheSize=100"
    + "&prepStmtCacheSqlLimit=50000000"
    + "&forceConnectionTimeZoneToSession=true";

Properties properties = new Properties();
properties.put("user", username);
properties.put("password", password);

// Get a connection
Connection connection = DriverManager.getConnection(url, properties);

Python

Pour obtenir des instructions de connexion, consultez Utiliser mysql-connector-python pour développer des applications.

Transmettez le paramètre time_zone dans l'appel de connexion pour définir le fuseau horaire de la session lors de la connexion :

connection = mysql.connector.connect(
    host='<LindormTable endpoint for MySQL>',
    port=33060,
    user='<Username>',
    passwd='<Password>',
    database='<Database name>',
    time_zone='<Time zone>'   # for example, 'UTC' or 'Asia/Tokyo'
)

Go

Pour obtenir des instructions de connexion, consultez Utiliser Go pour développer des applications.

Le pilote Golang MySQL transmet les variables de session via la chaîne de connexion. Les valeurs de chaîne doivent être encodées en URL : entourez la valeur de guillemets simples ('), puis encodez ces guillemets en pourcentage sous la forme %27. Par exemple, la chaîne 'UTC' devient %27UTC%27.

Pour plus d'informations sur la manière dont le pilote gère les variables système, consultez Variables système.

urlString := fmt.Sprintf(
    "%s:%s@tcp(%s:%d)/%s?timeout=%s&parseTime=true&loc=Local",
    user, password, host, port, database, connectTimeout,
)
timeZoneValue := url.QueryEscape("'UTC'")  // produces %27UTC%27
urlString = urlString + "&time_zone=" + timeZoneValue

db, err := sql.Open("mysql", urlString)
if err != nil {
    panic(err.Error())
}