AnalyticDB:Paramètres de configuration et d'indication

Paramètres de configuration courants

Lorsque la version du noyau du cluster est 3.2.5 ou ultérieure, le système valide les types de paramètres de configuration.

Indications courantes

Instructions

1. Lisez le contenu en anglais pour comprendre CE qui doit être communiqué

2. Rédigez le texte en français À PARTIR DE ZÉRO — oubliez la structure des phrases anglaises

3. Conservez exactement tout le formatage Markdown, les blocs de code, les liens et les images

4. Balises xref (<a data-tag="xref" ...>texte</a>) — conservez la balise ENTIERE avec tous ses attributs dans l'ordre et la casse d'origine, traduisez UNIQUEMENT le texte visible entre > et

5. Appliquez strictement toutes les règles spécifiques à la langue

6. Appliquez les règles relatives aux mots interdits avec une tolérance zéro

7. Utilisez le mode impératif dans les étapes numérotées et les listes à puces procédurales

8. Assurez la cohérence terminologique — un même terme doit toujours avoir la même traduction

9. Variez les débuts de phrase dans les listes et les tableaux — aucun début ne doit être répété plus de 3 fois

10. Renvoyez UNIQUEMENT le document Markdown en français, sans explication

    Catégorie	Paramètre	Description	Exemple	Références
    Délai d'expiration des requêtes	QUERY_TIMEOUT	Description Délai d'expiration pour l'exécution des requêtes. Valeur par défaut : 1 800 000 ms (30 minutes). Ce paramètre contrôle uniquement le délai d'exécution des instructions SQL. Il n'affecte pas le délai d'expiration de la connexion ni le délai d'inactivité de la session.	SET ADB_CONFIG QUERY_TIMEOUT=1000;	Écritures et requêtes
    Délai d'expiration INSERT, UPDATE, DELETE	INSERT_SELECT_TIMEOUT	Description Durée maximale d'exécution des instructions INSERT, UPDATE et DELETE au niveau du cluster. Valeur par défaut : 24*3600000. Valeurs valides : entiers supérieurs à 0. Unité : millisecondes.	SET ADB_CONFIG INSERT_SELECT_TIMEOUT=3600000; Référence	Limites
    Désactivation du pushdown de prédicat	Paramètres Version du noyau 3.1.4 ou ultérieure : FILTER_NOT_PUSHDOWN_COLUMNS Versions du noyau antérieures à 3.1.4 : NO_INDEX_COLUMNS Description Désactive le pushdown de prédicat pour des colonnes spécifiques au niveau du cluster.	Désactive le pushdown de prédicat pour des colonnes spécifiques au niveau de la requête.	Version du noyau 3.1.4 ou ultérieure : /+ FILTER_NOT_PUSHDOWN_COLUMNS=[Schema1.table1:colName1|colName2;Schema2.table2:colName1|colName2] / Versions du noyau antérieures à 3.1.4 : /+ NO_INDEX_COLUMNS=[tableName1.colName1;colName2,tableName2.colName1] /	Conditions de filtrage sans pushdown
    Priorité de planification BUILD	BUILD_TASK_PRIORITY	Modifie la priorité de planification des tâches BUILD. Actuellement, vous ne pouvez utiliser que des indications pour configurer la priorité de planification BUILD pour des tables individuelles. Valeur par défaut : 0. Valeurs valides : entiers supérieurs ou égaux à 0. Une valeur plus élevée indique une priorité plus haute.	/+ BUILD_TASK_PRIORITY = 2/ BUILD TABLE db.table;	Configurer les priorités de planification pour les jobs BUILD
    Importation élastique	Active l'importation élastique et configure le groupe de ressources de type job pour l'exécution des tâches d'importation élastique.	Sélectionnez Elastic Import et configurez le groupe de ressources de job pour les tâches d'importation élastique.	/+ ELASTIC_LOAD=true, ELASTIC_LOAD_CONFIGS=[adb.load.resource.group.name=resource_group]/ SUBMIT JOB INSERT OVERWRITE INTO adb_demo.adb_import_test SELECT * FROM adb_external_db.person;	Importation élastique des données OSS via des tables externes Importation élastique des données MaxCompute via des tables externes
    L'implémentation de Hash Join utilise la table de droite pour la construction. Left Join ne réorganise pas les tables de gauche et de droite. Lorsque la table de droite contient un grand volume de données, cela peut entraîner une exécution lente et une consommation excessive de mémoire. Vous pouvez ajouter une indication pour demander à l'optimiseur de convertir Left Join en Right Join en fonction de la consommation de ressources. Valeurs valides : true : Activé. false (par défaut) : Désactivé.	Version du noyau 3.1.8 ou ultérieure : O_CBO_RULE_SWAP_OUTER_JOIN Versions du noyau antérieures à 3.1.8 : LEFT_TO_RIGHT_ENABLED	L'implémentation de Hash Join utilise la table de droite pour la construction. Left Join ne réorganise pas les tables de gauche et de droite. Lorsque la table de droite est volumineuse, cela peut entraîner une exécution lente et une consommation excessive de mémoire. Vous pouvez ajouter une indication pour demander à l'optimiseur de convertir Left Join en Right Join en fonction de l'utilisation des ressources. Valeurs valides : true : Activer. false (Valeur par défaut) : Désactiver.	/+ O_CBO_RULE_SWAP_OUTER_JOIN=true/ /+ LEFT_TO_RIGHT_ENABLED=true/	Changer LEFT JOIN en RIGHT JOIN
    	REORDER_JOINS	AnalyticDB for MySQL active la réorganisation automatique des jointures par défaut. Vous pouvez ajuster manuellement l'ordre des jointures en fonction des caractéristiques des données afin que la requête suive l'ordre spécifié dans l'instruction SQL. Valeurs valides : true (par défaut) : Active la réorganisation automatique des jointures. false : Désactive la réorganisation automatique des jointures.	/+ REORDER_JOINS=false/	Ajuster manuellement l'ordre des jointures
    	AGGREGATION_PATH_TYPE	Lors de l'utilisation de l'agrégation en deux phases, un grand nombre de groupes dans l'agrégation group-by consomme d'importantes ressources de calcul. Vous pouvez utiliser cette indication pour ignorer l'agrégation locale et effectuer directement l'agrégation finale. Valeurs valides : single_agg : Ignore l'agrégation locale. auto (par défaut) : L'optimiseur détermine automatiquement s'il faut ignorer l'agrégation locale.	/+ AGGREGATION_PATH_TYPE=single_agg/	Optimisation des requêtes de regroupement et d'agrégation
    Chaque tâche de calcul est divisée en plusieurs tâches concurrentes pour exploiter pleinement les ressources de calcul. Vous pouvez utiliser cette indication pour définir la concurrence. Valeur par défaut : 32. Valeurs valides : entiers supérieurs à 0.	HASH_PARTITION_COUNT	Chaque tâche de calcul est divisée en plusieurs tâches concurrentes pour exploiter pleinement les ressources de calcul. Vous pouvez utiliser cette indication pour définir la concurrence. Valeur par défaut : 32. Valeurs valides : entiers positifs.	/+ HASH_PARTITION_COUNT=32/	Aucune
    	BATCH_HASH_PARTITION_COUNT	Valeur par défaut : 32. Valeurs valides : entiers supérieurs à 0. Important En mode batch (query_execution_type=batch), une valeur trop élevée peut entraîner un nombre excessif de tâches concurrentes sur un nœud, provoquant un débordement du pool de mémoire. Lorsque le cluster compte plus de 32 nœuds de calcul, nous vous recommandons de définir ce paramètre sur le nombre de nœuds de calcul pour éviter les problèmes de limite de disque.	/+ BATCH_HASH_PARTITION_COUNT=64, QUERY_EXECUTION_TYPE=batch / SELECT ...
    	TASK_WRITER_COUNT	Concurrence des tâches d'importation INSERT INTO SELECT. Lorsque la charge des workers est trop élevée, vous pouvez réduire cette valeur. Valeur par défaut : 16. Valeurs valides : entiers supérieurs à 0.	/+ TASK_WRITER_COUNT=8/
    	CTE_EXECUTION_MODE	Indique s'il faut activer l'optimisation de l'exécution CTE. Lorsqu'elle est activée, une sous-requête CTE référencée plusieurs fois n'est exécutée qu'une seule fois, ce qui améliore les performances des requêtes. Valeurs valides : shared : Active l'optimisation de l'exécution CTE. inline (par défaut) : Désactive l'optimisation de l'exécution CTE.	/+ CTE_EXECUTION_MODE=shared/	WITH
    Limites des conditions de requête	QUERY_MAX_SHUFFLE_DATA_SIZE_MB	Taille maximale des données Shuffle pour une requête. Par défaut, aucune erreur n'est déclenchée quel que soit le volume de données. Si ce paramètre est défini, le système termine la requête et signale une erreur lorsque le volume de données dépasse le seuil. Valeurs valides : entiers supérieurs à 0. Unité : Mo.	/+ QUERY_MAX_SHUFFLE_DATA_SIZE_MB=1024/	Aucune
    	MAX_SELECT_ITEMS_COUNT	Description Nombre maximal de colonnes dans une instruction SELECT. Valeur par défaut : 1 024. L'augmentation de cette valeur peut affecter la stabilité du cluster. Nous vous déconseillons de modifier cette valeur.	SET ADB_CONFIG MAX_SELECT_ITEMS_COUNT=1000; Référence
    	MAX_IN_ITEMS_COUNT	Description Définit le nombre maximal d'éléments dans une condition IN. Valeurs valides : entiers positifs supérieurs à 0. Pour les clusters dont la version du noyau est antérieure à 3.2.8, la valeur par défaut est 4 000. Pour les clusters dont la version du noyau est 3.2.8 ou ultérieure, la valeur par défaut est 20 000.	/+ MAX_IN_ITEMS_COUNT=1000/
    	MAX_WHERE_ITEMS_COUNT	Définit le nombre maximal d'éléments dans une clause WHERE. Valeur par défaut : 256. Valeurs valides : entiers supérieurs à 0.	/+ MAX_WHERE_ITEMS_COUNT=512/
    Priorité des jobs XIHE BSP	QUERY_PRIORITY	Priorité des jobs BSP. Valeurs valides : HIGH NORMAL (par défaut) LOW LOWEST	/+ QUERY_PRIORITY=HIGH/	Développement SQL XIHE BSP
    Nombre maximal d'ACU utilisés par les paramètres des jobs XIHE BSP	ELASTIC_JOB_MAX_ACU	Nombre maximal d'ACU qu'un seul job XIHE BSP peut utiliser. Valeur par défaut : 9. Valeur minimale : 3. Valeurs valides : [3, ressources maximales du groupe de ressources de type job].	/+ ELASTIC_JOB_MAX_ACU=20/
    Délai d'expiration des requêtes pour les jobs XIHE BSP	BATCH_QUERY_TIMEOUT	Délai d'expiration des jobs XIHE BSP. Valeur par défaut : 7 200 000 ms. Valeurs valides : entiers supérieurs à 0. Unité : millisecondes.	/+ BATCH_QUERY_TIMEOUT=3600000/
    Tables externes OSS	OUTPUT_FILENAME	Personnalise le nom du fichier stocké dans OSS lors de l'exportation des données via des tables externes OSS.	/+ OUTPUT_FILENAME=output.csv/	Exporter des données vers OSS
    	SQL_OUTPUT_OSS_FILE_HEAD_ENABLE	Indique s'il faut inclure les noms de colonnes dans les fichiers de données exportés vers OSS. Par défaut, les fichiers exportés contiennent uniquement les données sans les noms de colonnes. Valeurs valides : true : Inclure les noms de colonnes. false (par défaut) : Ne pas inclure les noms de colonnes.	/+ SQL_OUTPUT_OSS_FILE_HEAD_ENABLE=true/
    	HIVE_SPLIT_ASYNC_GENERATION_ENABLED	Description Indique s'il faut soumettre de manière asynchrone les tâches Hive Split à une file d'attente lors de la génération d'un plan d'exécution par Hive. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ HIVE_SPLIT_ASYNC_GENERATION_ENABLED=true/	Importer des données OSS à l'aide de tables externes
    	FAST_PARQUET_READER_ENABLE	Indique s'il faut revenir au lecteur Parquet natif lorsque les statistiques d'un fichier Parquet sont incorrectes. Valeurs valides : true (par défaut) : Oui. false : Non.	/+ FAST_PARQUET_READER_ENABLE=true/
    	OSS_VECTORIZED_PARQUET_READER_ENABLE	Indique s'il faut activer le commutateur de lecture vectorisée Parquet lorsqu'aucune valeur NULL n'existe dans les données. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ OSS_VECTORIZED_PARQUET_READER_ENABLE=true/
    	OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE	Indique s'il faut activer le commutateur de lecture vectorisée Parquet lorsque des valeurs NULL existent dans les données. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ OSS_VECTORIZED_PARQUET_READER_NULL_SCENE_ENABLE=true/
    	Indique s'il faut charger les métadonnées Hudi. Valeurs valides : true : Oui. false (par défaut) : Non.	Indique s'il faut charger les métadonnées Hudi. Valeurs valides : true : Oui. false (Valeur par défaut) : Non.	/+ HUDI_METADATA_TABLE_ENABLED=true/
    	HUDI_QUERY_TYPE	Définit le mode de requête pour les tables Hudi. Valeurs valides : snapshot : Interroge toutes les données qui ont été validées ou compactées à l'heure spécifiée. read_optimized (par défaut) : Interroge les données après la dernière validation ou compaction.	/+ HUDI_QUERY_TYPE=snapshot/
    	HUDI_REALTIME_SKIP_MERGE	Indique s'il faut ignorer la fusion des fichiers de base et des fichiers journaux lors de l'interrogation des données de table Hudi en mode snapshot. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ HUDI_REALTIME_SKIP_MERGE=true/
    	Taille maximale du split. Valeur par défaut : 128. Unité : Mo.	Taille maximale du split. Valeur par défaut : 128. Unité : Mo.	/+ HUDI_MAX_SPLIT_SIZE=128/
    	HUDI_SPLIT_PARALLEL_GENERATION_ENABLED	Indique s'il faut générer les splits en parallèle. Valeurs valides : true (par défaut) : Oui. false : Non.	/+ HUDI_SPLIT_PARALLEL_GENERATION_ENABLED=true/
    	HUDI_DATA_SKIPPING_ENABLED	Utilise les statistiques de la MetaTable Hudi pour ignorer les splits qui n'ont pas besoin d'être lus, améliorant ainsi les performances des requêtes. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ HUDI_DATA_SKIPPING_ENABLED=true/
    	HUDI_SPLIT_ASYNC_GENERATION_ENABLED	Indique s'il faut générer de manière asynchrone les splits Hudi lors de la génération du plan d'exécution. Valeurs valides : true (par défaut) : Oui. false : Non.	/+ HUDI_SPLIT_ASYNC_GENERATION_ENABLED=true/
    Tables externes RDS MySQL	JDBC_SCAN_SPLITS	Nombre de splits lors de l'exécution d'un TableScan via JDBC. Valeur par défaut : 1. Valeurs valides : 1 à 100.	/+ JDBC_SCAN_SPLITS=1/	Importer des données RDS MySQL à l'aide d'une table externe
    	JDBC_SPLIT_COLUMN	Colonne utilisée pour fractionner les données lors de la lecture des tables externes RDS MySQL.	/+ JDBC_SPLIT_COLUMN=column1/
    	JDBC_INSERT_DIRECTLY	Lors de l'écriture de données dans des tables externes RDS MySQL, les données sont écrites par défaut dans une table temporaire avant d'être transférées vers la table cible. Vous pouvez utiliser cette indication pour écrire les données directement dans la table cible. Toutefois, si une erreur survient pendant l'écriture, la table cible peut contenir des données corrompues. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ JDBC_INSERT_DIRECTLY=true/
    Tables externes Tablestore	Indique s'il faut utiliser des instructions INSERT au lieu d'instructions UPDATE. Valeurs valides : true : Oui. false (par défaut) : Non.	Indique s'il faut utiliser des instructions INSERT au lieu d'instructions UPDATE. Valeurs valides : true : Oui. false (Valeur par défaut) : Non.	/+ OTS-INSERT-AS-UPDATE=true/	Interroger et importer des données depuis Tablestore
    Tables externes MaxCompute	ODPS_SPLIT_LIMIT	Nombre maximal de splits lors de la lecture des données via Tunnel. Valeur par défaut : 1 000. Valeurs valides : 1 à 1 000.	/+ ODPS_SPLIT_LIMIT=1000/	Importer des données MaxCompute à l'aide de tables externes
    	IGNORE_PARTITION_CACHE	Lors de l'exécution de requêtes avec des conditions de partition, récupère les métadonnées de partition directement depuis les tables MaxCompute au lieu d'utiliser les métadonnées de partition mises en cache. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ IGNORE_PARTITION_CACHE=true/
    	ROWS_PER_SPLIT	Nombre maximal de lignes par split lors de la lecture des données via Tunnel. Valeur par défaut : 500 000. Valeurs valides : 10 000 à 500 000.	/+ ROWS_PER_SPLIT=500000/
    	STORAGE_API_ENABLED	Indique s'il faut utiliser l'API Storage de MaxCompute pour lire les données MaxCompute. L'API Storage offre des performances de lecture nettement supérieures à celles du Tunnel traditionnel. Valeurs valides : true : Oui. false (par défaut) : Non.	/+ STORAGE_API_ENABLED=true/
    	APLIT_BYTE_SIZE	Taille maximale par split lors de la lecture des données via l'API Storage de MaxCompute. Valeur par défaut : 256. Unité : Mo.	/+ APLIT_BYTE_SIZE=256/
    	MAX_BATCH_ROW_COUNT	Nombre maximal de lignes par split lors de la lecture des données via l'API Storage de MaxCompute. Valeur par défaut : 1 024.	/+ MAX_BATCH_ROW_COUNT=1024/
    	PAGE_BATCH_SIZE	Nombre maximal de lignes par page lors de la lecture des données via l'API Storage de MaxCompute. Valeur par défaut : 1 024.	/+ PAGE_BATCH_SIZE=1024/
    	MAX_ALLOCATION_PER_SPLIT	Mémoire de pointe maximale allouée par split lors de la lecture des données via l'API Storage de MaxCompute. Valeur par défaut : 300. Unité : Mo.	/+ MAX_ALLOCATION_PER_SPLIT=300/
    	ASYNC_GET_SPLIT	Indique s'il faut soumettre de manière asynchrone les tâches à une file d'attente en optimisant les performances de chargement des splits lors de la génération d'un plan d'exécution par MaxCompute. Valeurs valides : true : Oui. false (par défaut) : Non. Remarque Ce paramètre est pris en charge uniquement dans la version du noyau 3.1.10.1 et ultérieures.	/+ ASYNC_GET_SPLIT=true/
    Contrôle de la concurrence d'analyse	SPLIT_FLOW_CONTROL_ENABLED	true (par défaut) : Active le contrôle de la concurrence d'analyse. false : Désactive le contrôle de la concurrence d'analyse.	/+ SPLIT_FLOW_CONTROL_ENABLED=true/ SELECT * FROM table;	Contrôle de flux des splits
    	MIN_RUNNING_SPLITS_LIMIT_PER_TASK	Quota minimal de concurrence d'analyse par tâche. Valeur par défaut : 1. Valeurs valides : [1, TARGET_RUNNING_SPLITS_LIMIT_PER_TASK].	/+ MIN_RUNNING_SPLITS_LIMIT_PER_TASK=10/SELECT * FROM orders;
    	TARGET_RUNNING_SPLITS_LIMIT_PER_TASK	Quota cible (point médian) de concurrence d'analyse par tâche. Le système augmente ou diminue le quota de concurrence d'analyse en fonction de cette valeur. Valeur par défaut : 32. Valeurs valides : [MIN_RUNNING_SPLITS_LIMIT_PER_TASK, MAX_RUNNING_SPLITS_LIMIT_PER_TASK].	/+ TARGET_RUNNING_SPLITS_LIMIT_PER_TASK=32/SELECT * FROM adb_test;
    	MAX_RUNNING_SPLITS_LIMIT_PER_TASK	Quota maximal de concurrence d'analyse par tâche. Valeur par défaut : 64. Valeurs valides : supérieures à TARGET_RUNNING_SPLITS_LIMIT_PER_TASK.	/+ MAX_RUNNING_SPLITS_LIMIT_PER_TASK=100/SELECT * FROM adb_test;
    Active la fonctionnalité Paging Cache et spécifie manuellement un paging_id pour identifier le cache d'un groupe de requêtes de pagination liées (requêtes ayant le même modèle mais des paramètres LIMIT et OFFSET différents).	PAGING_ID	Active la fonctionnalité de cache de pagination et spécifie manuellement un paging_id pour identifier un groupe de requêtes de pagination liées (c'est-à-dire un groupe de requêtes ayant le même modèle mais des valeurs de paramètres LIMIT et OFFSET différentes).	/PAGING_ID=paging123/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;	Cache de pagination (optimisation des performances pour les requêtes de pagination profonde)
    	PAGING_CACHE_ENABLED	Active la fonctionnalité Paging Cache et génère automatiquement un paging_id basé sur le modèle SQL pour identifier le cache d'un groupe de requêtes de pagination liées. Valeurs valides : true : Active la fonctionnalité Paging Cache. false (par défaut) : Désactive la fonctionnalité Paging Cache.	/PAGING_CACHE_ENABLED=true/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;
    	PAGING_CACHE_VALIDITY_INTERVAL	Définit la période de validité du cache. Après cette période, le cache expire. Si le cache n'est pas consulté dans l'heure suivant son expiration, le système supprime automatiquement la table de cache temporaire correspondante. Valeurs valides : entiers supérieurs à 0. Unité : secondes. Ce paramètre doit être utilisé conjointement avec paging_cache_enabled.	/PAGING_CACHE_ENABLED=true,PAGING_CACHE_VALIDITY_INTERVAL=300/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;
    	INVALIDATE_PAGING_CACHE	Indique s'il faut effacer le cache des requêtes de pagination pour un modèle spécifié. Valeurs valides : true : Oui. false (par défaut) : Non. Ce paramètre doit être utilisé conjointement avec paging_id ou paging_cache_enabled.	/PAGING_CACHE_ENABLED=true,INVALIDATE_PAGING_CACHE=true/ SELECT * FROM t_order ORDER BY id LIMIT 0, 100;
    Spécifier le moteur de table	RC_DDL_ENGINE_REWRITE_XUANWUV2	Description Spécifie le moteur de table au niveau du cluster. Valeurs valides : true (par défaut) : Les tables existantes conservent leur moteur actuel. Les nouvelles tables utilisent XUANWU_V2 par défaut. Même si vous spécifiez explicitement ENGINE=XUANWU lors de la création d'une table, le moteur est automatiquement remplacé par XUANWU_V2. false : Les tables existantes conservent leur moteur actuel. Les nouvelles tables utilisent XUANWU par défaut.	/+ RC_DDL_ENGINE_REWRITE_XUANWUV2=true /	Configurer le moteur de table

    Autre	RESOURCE_GROUP	Spécifie le groupe de ressources pour une requête. Si ce paramètre n'est pas indiqué, le groupe de ressources associé au compte de base de données est utilisé. Si aucun groupe de ressources n'est lié au compte, le groupe de ressources par défaut est utilisé.	/+ RESOURCE_GROUP=my_group_name/	Aucun
    	DML_EXCEPTION_TO_NULL_ENABLED	Indique si une exception doit être levée lorsque des valeurs non valides sont rencontrées lors des opérations INSERT SELECT. Valeurs possibles : true : Aucune exception n'est levée. Des valeurs NULL sont écrites à la place. false (par défaut) : Lève une exception.	/+ DML_EXCEPTION_TO_NULL_ENABLED=true/
    	DISPLAY_HINT	Permet d'identifier les requêtes, par exemple pour distinguer les requêtes provenant de différentes sources métier.	/+ DISPLAY_HINT=from_user_123/

FAQ

SET ADB_CONFIG REMOVE key;

SET ADB_CONFIG REMOVE QUERY_TIMEOUT; -- Restore the query timeout to the default value.