Hologres:FAQ about Hologres SQL statements

Erreur : failed to import foreign schema from odps: Can't find file system factory

• Cause : Hologres ne peut pas accéder au système de fichiers de la table MaxCompute en raison d'une erreur de configuration.

• Solution : Vérifiez les configurations de votre serveur étranger et de votre table externe. Vous pouvez également importer les données dans une table interne Hologres.

Erreur : Failed to import foreign schema from ODPS: Authorization Failed: xxx

• Cause : Le compte actuel ne dispose pas des autorisations requises sur la table MaxCompute spécifiée.

• Solution : Accordez les autorisations nécessaires au compte dans MaxCompute. Pour plus de détails, reportez-vous à Gérer les autorisations des utilisateurs à l'aide de commandes.

Erreur : failed to import foreign schema from odps:Table not found -xxx

• Cause : La table spécifiée n'existe pas dans MaxCompute.

• Solution : Vérifiez que le nom de la table et le projet sont corrects dans MaxCompute.

Erreur : Update row with Key (id)=(xxxx) multiple times or duplicate key value violates unique constraint

• Cause : Les données écrites contiennent des valeurs de clé primaire en double, ce qui viole la contrainte d'unicité.

• Solution :

  • Si l'erreur survient lors d'une instruction INSERT, utilisez la syntaxe INSERT INTO xx ON CONFLICT pour dédupliquer les clés primaires. Pour plus de détails, reportez-vous à INSERT ON CONFLICT(UPSERT).

  • Si cette erreur se produit avec une instruction INSERT...ON CONFLICT , cela signifie que les données source elles-mêmes contiennent des clés primaires en double. Pour plus d'informations, consultez la section Erreurs courantes.

  • Cette erreur peut également se produire si une table a un TTL (Time To Live) expiré et que les données expirées n'ont pas encore été supprimées physiquement. Dans ce cas, utilisez la fonction hg_remove_duplicated_pk pour nettoyer les données en double. Pour plus de détails, consultez la section Erreurs courantes.

Erreur : ERROR: new row for relation violates partition constraint

• Cause : Les données insérées dans une table de partition enfant ne correspondent pas à la définition de la valeur de partition. Par exemple, l'insertion d'une ligne avec une valeur de partition autre que '20240110' dans une partition définie pour '20240110' provoque cette erreur. Exemple :

  CREATE TABLE public.tbl_20240110 PARTITION OF public.tbl FOR VALUES IN('20240110');
  
  INSERT INTO public.tbl_20240110 SELECT * FROM odps_tbl where sale_date >'20240110';
  
  error: new row for relation "tbl_20240110" violates partition constraint
  

• Solution : Assurez-vous que les données écrites dans une table de partition enfant respectent la contrainte de partition.

Erreur : null value in column "xxx" violates not-null constraint

• Cause : Une valeur NULL a été écrite dans une colonne soumise à une contrainte NOT NULL.

• Solution : Supprimez les lignes contenant des valeurs NULL dans cette colonne, puis relancez l'opération d'écriture.

Erreur : Dispatch query failed: Table not found

• Cause : La table n'existe pas. Cela se produit généralement lorsque la table a été créée récemment et que ses métadonnées ne se sont pas encore propagées, ou lorsqu'une opération TRUNCATE ou DROP a été effectuée sur la table pendant l'exécution de la requête.

• Solution : Utilisez Query Insight dans HoloWeb pour vérifier s'il existe des opérations DDL concurrentes telles que TRUNCATE ou DROP. Résolvez les conflits éventuels, puis relancez la requête. Évitez d'effectuer des opérations DDL sur des tables faisant l'objet de requêtes actives. Pour plus de détails, reportez-vous à Query Insight.

Erreur : ERROR: canceling statement due to statement timeout

• Cause : Le temps d'exécution de la requête a dépassé le délai d'expiration de l'instruction configuré sur le client.

• Solution : Optimisez la requête pour réduire son temps d'exécution ou augmentez la durée du délai d'expiration. Pour plus de détails sur les paramètres de délai d'expiration, reportez-vous à Gérer les requêtes.

Erreur : ERROR: Query:[xxx] Get result failed: canceling statement due to user request

• Cause : La requête a été annulée, généralement parce qu'une opération DROP ou TRUNCATE a été effectuée sur la table pendant l'exécution.

• Solution : Utilisez Query Insight dans HoloWeb pour vérifier s'il existe des opérations DDL conflictuelles. Pour plus de détails, reportez-vous à Query Insight. Évitez d'exécuter des opérations DDL pendant l'exécution des requêtes.

Erreur : query is cancelled Cannot find index full ID:xxx (table id: x, index id: x) in storages or it is deleting

• Cause : Une opération TRUNCATE ou DROP a été effectuée sur l'une des tables interrogées pendant l'exécution. Cela a modifié l'ID de la table, entraînant l'annulation de la requête.

• Solution : Utilisez Query Insight pour vérifier si une opération TRUNCATE ou DROP a été exécutée simultanément à votre requête. Pour plus de détails, reportez-vous à Query Insight.

Erreur : Feature not supported: insert into parent table

• Cause : Hologres ne prend pas en charge l'insertion directe de données dans une table de partition parente.

• Solution : Insérez plutôt les données dans une table de partition enfant spécifique. Pour plus de détails, reportez-vous à CREATE PARTITION TABLE.

Erreur : SELECT INTO is not supported now.

• Cause : Hologres ne prend pas en charge la syntaxe SELECT INTO.

• Solution : Utilisez la syntaxe INSERT INTO SELECT pour insérer des données. Pour plus de détails, reportez-vous à INSERT.

Erreur : ALTER TABLE CHANGE OWNER is not supported in SLPM (Schema-Level Permission Mode)

• Cause : Vous ne pouvez pas utiliser ALTER TABLE pour modifier le propriétaire de la table dans le modèle d'autorisations au niveau du schéma (SLPM).

• Solution : Dans le modèle SLPM, les propriétaires de tables sont des groupes d'utilisateurs. Pour modifier les autorisations d'un utilisateur, retirez-le du groupe d'utilisateurs. Pour plus de détails, reportez-vous à la section Retirer un utilisateur d'un groupe d'utilisateurs.

Erreur : Feature not supported: INSERT ON CONFLICT RETURNING

• Cause : Hologres ne prend pas en charge la syntaxe INSERT ON CONFLICT RETURNING .

• Solution : Utilisez la syntaxe INSERT ON CONFLICT sans la clause RETURNING. Pour plus de détails, reportez-vous à INSERT ON CONFLICT(UPSERT).

Erreur : ERROR: INSERT in ddl transaction is not supported now

• Cause : Par défaut, Hologres ne prend pas en charge les instructions DML telles que INSERT dans un bloc de transaction BEGIN...COMMIT . Exemple :

  BEGIN;
  INSERT xxx
  commit;
  ERROR: INSERT in ddl transaction is not supported now

• Solution : Exécutez l'instruction INSERT en dehors de la transaction ou activez les transactions DML. Pour plus de détails, reportez-vous à Capacités de transaction SQL.

Erreur : Creating publication with table that without binlog is not supported now

• Cause : Une publication a été créée pour une table dont le journal binaire (binlog) n'est pas activé. Les publications nécessitent le journal binaire pour s'abonner aux modifications de données.

• Solution : Activez le journal binaire sur la table avant de créer la publication. Vous ne pouvez créer des publications que pour les tables dont le journal binaire est activé. Pour plus de détails, reportez-vous à Utiliser JDBC pour consommer les journaux binaires Hologres.

Erreur : Feature not supported: INSERT on conflict contains un-unique column

• Cause : La cible de conflit dans l'instruction INSERT ON CONFLICT fait référence à une colonne qui n'est pas une clé primaire.

• Solution : La cible de conflit dans INSERT ON CONFLICT doit faire référence uniquement aux colonnes de clé primaire.

Erreur : Feature not supported: UPDATE with shard keys

• Cause : Hologres ne prend pas en charge les opérations UPDATE sur les colonnes de clé primaire ou de clé de distribution.

• Solution : Ne mettez pas à jour les colonnes de clé primaire ou de clé de distribution. Pour modifier ces valeurs, vous devez DELETE l'ancienne ligne et INSERT une nouvelle.

Erreur : time before 1925 not supported

• Cause : Les fonctions liées au temps prennent en charge par défaut la plage allant de 1925 à 2282. Les valeurs en dehors de cette plage provoquent une erreur.

• Solution : Pour des fonctions telles que to_char, to_date ou to_timestamp, définissez le paramètre GUC hg_experimental_functions_use_pg_implementation avant l'instruction SQL pour activer une plage temporelle plus large. Pour plus de détails, reportez-vous à Fonctions de date et d'heure.

Erreur : Group by key is type of imprecise not supported

• Cause : La clause GROUP BY fait référence à une colonne ayant un type de données imprécis, tel que FLOAT.

• Solution : Utilisez des types de données précis au lieu de FLOAT dans la clause GROUP BY.

Erreur : CREATE TABLE is not supported for current instance

• Cause : L'instance actuelle est une instance Shared Cluster (le endpoint commence par hgmc , par exemple hgmc-cn-xxwwwkkk ) ou une instance secondaire. Vous pouvez consulter le endpoint dans la console Hologres. Les instances Shared Cluster prennent en charge uniquement les tables externes, et non les tables internes. Les instances secondaires sont en lecture seule.

• Solution :

  • Si vous utilisez une instance Shared Cluster, créez une table externe à l'aide de la syntaxe de table étrangère. Pour plus de détails, reportez-vous à CREATE FOREIGN TABLE. Vous pouvez également utiliser une instance exclusive pour créer des tables internes.

  • Si vous utilisez une instance secondaire, vous devez créer les tables sur l'instance principale.

Erreur : ALTER TABLE ALTER COLUMN SET TYPE is not supported now

• Cause : Hologres ne prend pas en charge la modification du type de données d'une colonne avec ALTER TABLE .

• Solution : Pour modifier le type d'une colonne, recréez la table avec le type de colonne souhaité.

Erreur : ERROR: Currently materialized view does not support aggregate on expressions, only support single column

• Cause : Les vues matérialisées sur table unique ne prennent pas en charge les expressions d'agrégation sur les colonnes calculées.

• Solution : Évitez d'utiliser des expressions dans les vues matérialisées sur table unique. Utilisez uniquement des agrégats sur colonne unique. Pour plus de détails, reportez-vous à Gérer les vues matérialisées à l'aide de SQL.

Erreur : ERROR: SELECT rule's target list has too few entries

• Cause : Les vues matérialisées en temps réel ne prennent pas en charge les expressions d'agrégation sur les colonnes calculées.

• Solution : Évitez d'utiliser des expressions dans les vues matérialisées en temps réel. Pour plus de détails, reportez-vous à Gérer les vues matérialisées à l'aide de SQL.

Erreur : TransactionRowStore::DumpFlushDelta Not implemented

• Cause : La version actuelle de Hologres présente une limitation d'implémentation concernant la syntaxe DELETE FROM table USING , ce qui provoque cette erreur.

• Solution : Réécrivez l'instruction SQL pour éviter d'utiliser la clause USING pour les suppressions par lot. Utilisez plutôt la syntaxe suivante :

  DELETE FROM table WHERE (col1, col2) IN ((val1, val2), ...);

Erreur : column xxx does not exist

• Cause : La colonne spécifiée n'existe pas dans la table.

• Solution : Vérifiez que le nom de la colonne dans l'instruction SQL est correct.

Erreur : Table group xxx does not exist

• Cause : Le groupe de tables spécifié n'existe pas.

• Solution : Spécifiez un groupe de tables existant lors de la création de la table ou créez d'abord le groupe de tables.

Erreur : The specified partition does not exist

• Cause : Cette erreur se produit généralement lors d'écritures ou de mises à jour de données lorsque la table de partition enfant cible n'existe pas.

• Solution : Créez la partition enfant requise avant d'écrire les données.

Erreur : create binlog reader failed: Fail to find any shards, please check if the table group is in current virtual warehouse

• Cause : Le groupe de tables spécifié n'est pas chargé sur l'entrepôt virtuel actuel.

• Solution : Vérifiez que le groupe de tables est chargé sur l'entrepôt virtuel. Si ce n'est pas le cas, configurez l'entrepôt virtuel pour le charger. Pour plus de détails, reportez-vous à Autoriser un entrepôt virtuel à accéder aux données.

Erreur : Total memory used by all existing queries exceeded memory limitation

• Cause : La requête a dépassé la limite de mémoire et a déclenché une erreur d'épuisement de la mémoire (OOM).

• Solution : Pour plus de détails, reportez-vous à Résoudre les erreurs OOM.

Erreur : internal error: Datasets has different schema

• Cause : Les schémas des jeux de données combinés (par exemple, dans une instruction UNION ou INSERT...SELECT) ne correspondent pas en termes de nombre de colonnes, d'ordre ou de type de données.

• Solution : Assurez-vous que le nombre de colonnes, l'ordre et les types de données sont cohérents dans toutes les parties de l'instruction.

Erreur : value too long for type character varying(xxx)

• Cause : La valeur des données dépasse la limite de longueur character varying(n) définie pour la colonne.

• Solution : Tronquez ou transformez les données, augmentez la limite de longueur VARCHAR ou modifiez le type de colonne en TEXT.

Erreur : Exceeds the partition limitation of 512, current match xxx partitions.

• Cause : La requête analyse plus de 512 partitions dans la table externe MaxCompute, ce qui dépasse la limite par défaut.

• Solution : Ajoutez davantage de conditions de filtre de partition ou augmentez la limite d'analyse des partitions à l'aide du paramètre GUC suivant. Pour plus de détails, reportez-vous à la section FAQ sur l'intégration MaxCompute.

  set hg_foreign_table_max_partition_limit =xx;

Erreur : Build desc failed: Exceeds the scan limitation of 200 GB, current scan xxx GB.

• Cause : La quantité de données analysées dans la table externe MaxCompute dépasse la limite de 200 Go.

• Solution :

  • Ajoutez davantage de conditions de filtre pour réduire la quantité de données analysées.

  • Importez les données dans une table interne Hologres, qui n'a pas de limite de taille d'analyse.

Erreur : syntax error at or near "xxxxx"

• Cause : L'instruction SQL comporte une erreur de syntaxe.

• Solution : Vérifiez et corrigez la syntaxe SQL.

Erreur : DISTINCT is not implemented for window functions

• Cause : Hologres ne prend actuellement pas en charge le mot-clé DISTINCT dans les fonctions de fenêtrage.

• Solution : Supprimez le mot-clé DISTINCT de la fonction de fenêtrage.

Erreur : ERROR:function xxx does not exist

• Cause : L'extension requise n'est pas installée ou l'appel de fonction utilise une syntaxe invalide.

• Solution : Installez l'extension requise ou corrigez la syntaxe de la fonction.

Erreur : ERROR: function jsonb_set(json, text[], jsonb, boolean) does not exist

• Cause : Les types d'arguments ne correspondent pas à la signature de la fonction JSONB_SET.

• Solution : Assurez-vous que le premier argument de JSONB_SET est de type JSONB et non JSON. Pour plus de détails, reportez-vous à Types de données JSON et JSONB.

Erreur : You have NO privilege 'odps:Select' on xxx

• Cause : Le compte actuel ne dispose pas des autorisations nécessaires pour interroger la table MaxCompute.

• Solution : Accordez les autorisations requises au compte dans MaxCompute.

Erreur : The sensitive label of column 'xxx' is 2, but your effective label is 0

• Cause : Le compte actuel a accès uniquement à certaines colonnes de la table MaxCompute.

• Solution : Accordez des autorisations plus larges au niveau des colonnes dans MaxCompute ou interrogez uniquement les colonnes auxquelles vous avez accès. Pour plus de détails sur l'autorisation, reportez-vous à Gérer les autorisations des utilisateurs à l'aide de commandes.

Erreur : extension "xxxxx" already exists

• Cause : L'extension spécifiée existe déjà dans la base de données.

• Solution : L'extension est déjà installée. Aucune action n'est nécessaire. Pour éviter cette erreur, utilisez CREATE EXTENSION IF NOT EXISTS .

Erreur : invalid input syntax for type numeric: \"\"

• Cause : La colonne NUMERIC contient des données invalides, telles que des chaînes vides, qui ne peuvent pas être analysées comme une valeur numérique.

• Solution : Nettoyez les données source pour vous assurer qu'elles sont conformes au type NUMERIC. Par exemple, convertissez les chaînes vides en NULL ou en 0.

Erreur : invalid input syntax for integer: xxx

• Cause : La colonne INT contient des données qui ne peuvent pas être analysées comme un entier.

• Solution : Nettoyez les données invalides.

Erreur : missing data for column "xxx". failed to query next

• Cause : Le format du fichier de données est incorrect. Cela se produit souvent lorsque les données contiennent le délimiteur spécifié dans la commande COPY (tel qu'une virgule ou un espace), ce qui entraîne une incompatibilité du nombre de colonnes.

• Solution : Nettoyez les données ou utilisez un autre délimiteur qui n'apparaît pas dans les valeurs des données.

Erreur : ERROR: INSERT has more expressions than target columns

• Cause : Le nombre de valeurs dans l'instruction INSERT dépasse le nombre de colonnes dans la table cible.

• Solution : Assurez-vous que le nombre de valeurs dans l'instruction INSERT correspond au nombre de colonnes cibles.

Erreur : bigint out of range

• Cause : La valeur dépasse la plage valide du type BIGINT.

• Solution : Assurez-vous que les données se situent dans la plage BIGINT (-9223372036854775808 à 9223372036854775807) ou utilisez le type NUMERIC pour des valeurs plus grandes.

Erreur : numeric field overflow in function round

• Cause : La valeur NUMERIC dépasse sa limite de précision définie.

• Solution : Ajustez la précision de la colonne NUMERIC pour accommoder les données ou nettoyez les données pour qu'elles correspondent à la précision définie.

Erreur : InsertOverwrite insert select table data failed : column a.unsign_type does not exist

• Cause : La colonne spécifiée n'existe pas dans la table ou le nom d'un paramètre est incorrect.

• Solution : Vérifiez et corrigez la syntaxe SQL.

Erreur : mismatched properties: table orientation is "column" but storage format is "sst"

• Cause : Propriétés de table incompatibles. Le stockage orienté colonne a été spécifié, mais le format de stockage a été défini sur SST, ce qui est incompatible.

• Solution : Vérifiez et corrigez l'instruction SQL.

Erreur : invalid value "" for "yyyy". Value must be an integer.

• Cause : Les données ne sont pas conformes au format datetime attendu.

• Solution : Assurez-vous que les données contiennent des valeurs datetime valides avant l'écriture.

Erreur : invalid byte sequence for encoding "UTF8": 0xe9 0x80

Erreur : relation "xxxx" already exists

• Cause : La table spécifiée existe déjà dans la base de données.

• Solution : Utilisez un autre nom de table ou utilisez CREATE TABLE IF NOT EXISTS pour éviter l'erreur.

Erreur : character with byte sequence 0xe4 0x9e 0xab in encoding "UTF8" has no equivalent in encoding "GBK"

• Cause : Un caractère UTF-8 n'a pas d'équivalent dans l'encodage GBK cible.

• Solution : Nettoyez les données invalides.

Erreur : column "xxx" must appear in the GROUP BY clause or be used in an aggregate function

• Cause : Une colonne non agrégée dans la liste SELECT n'est pas incluse dans la clause GROUP BY. Toutes les colonnes de la liste SELECT doivent soit figurer dans GROUP BY, soit être utilisées dans une fonction d'agrégation.

• Solution : Ajoutez la colonne à la clause GROUP BY ou utilisez-la dans une fonction d'agrégation.

Erreur : SET_TABLE_PROPERTY and CREATE TABLE statement are not in the same transaction for table

• Cause : Les instructions CREATE TABLE et call set_table_property ne se trouvent pas dans la même transaction.

• Solution : Regroupez les instructions CREATE TABLE et toutes les instructions call set_table_property dans le même bloc de transaction. Exemple :

  begin;
  CREATE TABLE tbl (
   xxxx
  );
  call set_table_property('tbl', 'orientation', 'xx');
  call set_table_property('tbl', 'distribution_key', 'xxx');
  commit;

Erreur : column reference "xxx" is ambiguous

• Cause : Le nom de la colonne dans une requête JOIN est ambigu car il existe dans plusieurs tables. Par exemple, dans SELECT id FROM t1 INNER JOIN t2 ON t1.id=t2.id , id dans la clause SELECT est ambigu car il peut faire référence à t1 ou à t2 .

• Solution : Qualifiez la colonne avec le nom de la table ou un alias (par exemple, t1.id ).

Erreur : column "xxx" specified more than once

• Cause : Un nom de colonne apparaît plusieurs fois dans une instruction CREATE TABLE.

• Solution : Supprimez la colonne en double de l'instruction CREATE TABLE.

Erreur : invalid definition of a numeric type

• Cause : Une colonne NUMERIC ou DECIMAL a été définie sans spécifier sa précision.

• Solution : Spécifiez la précision pour la colonne NUMERIC ou DECIMAL, telle que NUMERIC(38, 18) .

Erreur : cannot cast type date to integer

• Cause : Le type DATE ne peut pas être converti en type INTEGER.

• Solution : Modifiez la syntaxe SQL pour utiliser une conversion de type valide.

Erreur : schema "xxxx" does not exist

• Cause : Le schéma n'existe pas dans la base de données.

• Solution : Vérifiez que le nom du schéma dans l'instruction SQL est correct ou créez d'abord le schéma.

Erreur : internal error: Connect timeout, err: std_exception: Connection refused

• Cause : L'instance Hologres n'est pas disponible ou ne répond pas.

• Solution : Ouvrez un ticket de support pour enquêter sur l'indisponibilité de l'instance Hologres.

Si un nom de colonne commence par un chiffre, vous devez l'entourer de guillemets doubles dans votre requête, comme indiqué dans l'exemple suivant :

select bizdate,"1_day_active_users","7_day_active_users" from t_active_users;