Hologres:Migration des données MySQL vers Hologres

Guillemets

Par défaut, Hologres ne respecte pas la casse. Pour faire référence à un identifiant sensible à la casse, encadrez-le avec des guillemets doubles ("").

Remplacez la syntaxe des accents graves de MySQL par des guillemets doubles :

-- MySQL
SELECT `A` FROM b;

-- Hologres
SELECT "A" FROM b;

Conditions de filtrage

Hologres impose une correspondance exacte des types dans les conditions de filtrage et n'effectue aucune conversion implicite de type. En cas de discordance, vous obtenez une erreur telle que :

operator does not exist: text = integer

Pour résoudre ce problème, créez des conversions de type personnalisées :

CREATE CAST (TEXT AS INTEGER) WITH INOUT AS IMPLICIT;
CREATE CAST (TEXT AS BIGINT) WITH INOUT AS IMPLICIT;
CREATE CAST (TEXT AS DECIMAL) WITH INOUT AS IMPLICIT;
CREATE CAST (TEXT AS TIMESTAMP) WITH INOUT AS IMPLICIT;
CREATE CAST (NUMERIC AS TEXT) WITH INOUT AS IMPLICIT;

Exemple : Si la colonne ds est de type TEXT et que vous appliquez un filtre avec une valeur entière, la requête suivante échoue dans Hologres :

SELECT * FROM business_module WHERE ds = 20210329;

Après avoir créé la conversion appropriée, la requête s'exécute sans erreur.

Pagination

Remplacez la syntaxe LIMIT à deux arguments de MySQL par la forme standard OFFSET/LIMIT :

-- MySQL
LIMIT 0, 10

-- Hologres
OFFSET 0 LIMIT 10

Tri

MySQL et Hologres diffèrent dans leur manière de trier les valeurs NULL par ordre croissant :

Pour obtenir des résultats cohérents, spécifiez explicitement l'ordre de tri des valeurs NULL :

ORDER BY column DESC NULLS LAST

Regroupement

Par défaut, Hologres ne prend pas en charge GROUP BY sur les types inexacts (FLOAT, DOUBLE). Deux options s'offrent à vous :

• Convertissez la colonne en DECIMAL avant le regroupement.

• Activez le paramètre hg_experimental_enable_double_equivalent :

  -- Session level
  SET hg_experimental_enable_double_equivalent = on;
  
  -- Database level
  ALTER DATABASE <database_name> SET hg_experimental_enable_double_equivalent = on;

Ce paramètre nécessite Hologres V0.10 ou une version ultérieure. Si votre instance exécute une version antérieure, contactez le support technique via le groupe DingTalk Hologres pour demander une mise à niveau. Pour plus de détails, consultez Comment obtenir davantage de support en ligne ? .

UNION

L'opérateur UNION exige que les types de colonnes correspondent dans toutes les requêtes. MySQL effectue une conversion implicite de type, contrairement à Hologres. Une incompatibilité de type génère l'erreur suivante :

UNION types bigint and text cannot be matched

Convertissez explicitement les colonnes incompatibles :

-- Fails if project_id is BIGINT in tableA and TEXT in tableB
SELECT project_id FROM tableA
UNION ALL
SELECT project_id FROM tableB;

-- Fix: cast to a matching type
SELECT project_id FROM tableA
UNION ALL
SELECT CAST(project_id AS BIGINT) FROM tableB;

Division par zéro

MySQL renvoie NULL en cas de division par zéro. Hologres renvoie une erreur :

ERROR: division by zero

Option 1 : Utilisez NULLIF pour traiter le diviseur comme NULL lorsqu'il est égal à zéro :

SELECT a / NULLIF(b, 0) FROM table;

Option 2 (Hologres V1.3.21 et versions ultérieures) : Activez l'extension mysql_compatible pour tolérer la division par zéro sans modifier les requêtes individuelles :

-- Run once per database (requires Superuser)
CREATE EXTENSION IF NOT EXISTS mysql_compatible;

-- Enable division-by-zero tolerance for the current session
SET mysql_compatible.enable = on;

Cela couvre plusieurs scénarios :

-- Scenario 1: Constant division of the same type
SET mysql_compatible.enable = on;
SELECT 1 / 0;

-- Scenario 2: Constant division with type conversion
SET mysql_compatible.enable = on;
SELECT 1.0 / 0;

-- Scenario 3: Dividend is a column expression
SET mysql_compatible.enable = on;
SELECT SUM(c) / 0 FROM (SELECT generate_series(1, 100) AS c) AS t;

-- Scenario 4: Divisor is a column expression
SET mysql_compatible.enable = on;
SELECT MAX(c) / SUM(d)
FROM (
  SELECT generate_series(1, 101) AS c,
         generate_series(-50, 50) AS d
) AS t;

-- Scenario 5: Tolerate division by zero during INSERT
CREATE TABLE IF NOT EXISTS test_insert_divide_by_zero (c1 INT);
SET mysql_compatible.strict_mode = off;
SET mysql_compatible.enable = on;
INSERT INTO test_insert_divide_by_zero SELECT 100 / 0.0;

Si vous rencontrez des problèmes, consultez Erreurs courantes lors de la préparation de la mise à niveau ou contactez le support technique via le groupe DingTalk Hologres. Pour plus de détails, consultez Comment obtenir un support en ligne supplémentaire ?.

Division entière

MySQL renvoie une valeur décimale lors de la division de deux entiers avec un reste, tandis que Hologres tronque le résultat en un entier.

Convertissez l'un des opérandes en un type à virgule flottante pour obtenir le résultat décimal :

SELECT 1 / 2::FLOAT;

Fonction IF

Hologres ne prend pas en charge la fonction IF. Remplacez-la par une expression CASE WHEN :

-- MySQL
IF(condition, true_value, false_value)

-- Hologres
CASE WHEN condition THEN true_value ELSE false_value END

Fonction IFNULL

Remplacez la fonction IFNULL de MySQL par COALESCE :

-- MySQL
IFNULL(x, y)

-- Hologres
COALESCE(x, y)

Fonction LENGTH

Remplacez la fonction LENGTH de MySQL par CHAR_LENGTH :

-- MySQL
LENGTH(string)

-- Hologres
CHAR_LENGTH(string)