Tous les produits
Search
Centre de documentation

PolarDB:Utilisation des HINTs

Dernière mise à jour :Aug 20, 2026

Cette rubrique décrit la syntaxe des HINTs et propose des exemples d'utilisation.

Les HINTs sont une syntaxe SQL complémentaire jouant un rôle majeur dans les bases de données relationnelles. Ils permettent d'influencer l'exécution des instructions SQL pour des optimisations ciblées. PolarDB-X met également à disposition une syntaxe de HINT spécifique.

Syntaxe

/*+TDDL: hint_command [hint_command ...]*/
    
/!+TDDL: hint_command [hint_command ...]*/
Remarque

Lors de l'exécution d'instructions SQL contenant des HINTs personnalisés PolarDB-X au format /+TDDL:hint_command/ avec le client en ligne de commande MySQL officiel, ajoutez le paramètre -c à la commande de connexion. À défaut, comme les HINTs personnalisés PolarDB-X suivent le format des commentaires MySQL, le client les supprime avant l'envoi des instructions au serveur, ce qui rend les HINTs personnalisés PolarDB-X inopérants. Pour en savoir plus, consultez les options de commande du client MySQL officiel.

Exemples

# Query the physical table names in each database shard.
/*+TDDL:scan()*/SHOW TABLES;
   
# Send the query to the 0000 database shard of the RDS read-only instance.
/*+TDDL:node(0) slave()*/SELECT * FROM t1;

# Force the workload type to AP.
/*+TDDL:WORKLOAD=AP*/SELECT * FROM t1;

PolarDB-X accepte plusieurs commandes HINT dans une seule instruction HINT :

SELECT /*+TDDL:node(0) slave()*/ ...;

PolarDB-X ne prend pas en charge les cas suivants :

# Multiple HINT statements are not supported in a single SQL statement.
SELECT /*+TDDL:node(0)*/ /*+TDDL:slave()*/ ...;
    
# Duplicate HINT commands are not supported in a HINT statement.
SELECT /*+TDDL:node(0) node(1)*/ ...;