Tous les produits
Search
Centre de documentation

PolarDB:Configurer PolarProxy

Dernière mise à jour :Aug 11, 2026

Cette rubrique explique comment configurer PolarProxy via un endpoint de cluster PolarDB.

Prérequis

L'édition du produit doit être PolarDB for MySQL Cluster Edition. Pour plus d'informations sur les éditions, consultez Enterprise Edition.

Remarques d'utilisation

Vous ne pouvez configurer la requête parallèle et son degré de parallélisme pour PolarProxy que sur les clusters PolarDB for MySQL 8.0.

Procédure

  1. Connectez-vous à la console PolarDB. Dans le volet de navigation de gauche, cliquez sur Clusters. Sélectionnez la région où votre cluster est déployé, puis cliquez sur l'ID du cluster cible.

  2. Sur la page Basic Information, dans la section Database Connections, localisez l'endpoint de cluster cible et cliquez sur Configure à droite du nom de l'endpoint.

  3. Dans la boîte de dialogue qui s'affiche, modifiez les paramètres de l'endpoint de cluster selon vos besoins. Le tableau suivant décrit ces paramètres.

    Tableau 1. Paramètres de configuration

    Paramètre

    Description

    Network Information

    Par défaut, PolarDB attribue un endpoint privé à chaque endpoint de cluster. Pour modifier l'endpoint privé ou demander un endpoint public, consultez Gérer les endpoints.

    Cluster Settings

    Read/Write

    Mode de lecture/écriture de l'endpoint de cluster. Valeurs valides : Read-only et Read/Write (Automatic Read/Write Splitting).

    Remarque

    Vous pouvez modifier le mode de lecture/écriture après la création d'un endpoint personnalisé. Le nouveau mode s'applique uniquement aux nouvelles connexions ; les connexions existantes ne sont pas affectées.

    Endpoint Name

    Saisissez un nom pour l'endpoint de cluster.

    Node Settings

    Available Nodes et Selected Nodes

    La zone Available Nodes répertorie le nœud principal et tous les nœuds en lecture seule. Sélectionnez les nœuds devant traiter les requêtes de lecture et déplacez-les vers la zone Selected Nodes en cliquant sur l'icône 1.

    Remarque

    La sélection des nœuds n'affecte pas le mode de lecture/écriture :

    • Si le mode de lecture/écriture est défini sur Read/Write (Automatic Read/Write Splitting), les requêtes d'écriture sont toujours envoyées au nœud principal, qu'il figure ou non dans la zone Selected Nodes.

    • Si le mode de lecture/écriture est défini sur Read-only, toutes les requêtes de lecture sont réparties entre les nœuds en lecture seule sélectionnés. Aucune requête n'est envoyée au nœud principal, même s'il est inclus dans la zone Selected Nodes.

    • En mode Read/Write (Automatic Read/Write Splitting), les clusters multi-principaux (Limitless) utilisent un mécanisme de routage basé sur les bases de données et les tables. Ajoutez à l'endpoint de lecture/écriture les nœuds principaux hébergeant les bases de données ou tables cibles, ou sélectionnez tous les nœuds principaux. Évaluez l'impact du routage avant de sélectionner les nœuds.

    Automatically Associate New Nodes

    Détermine si les nouveaux nœuds sont automatiquement ajoutés à cet endpoint.

    Load Balancing Settings

    Load Balancing Policy

    Politique de planification pour répartir les requêtes de lecture sur plusieurs nœuds lorsque la séparation lecture/écriture est activée. Valeurs valides : Connections-based Load Balancing et Active Request-based Load Balancing. Pour plus d'informations, consultez Politiques d'équilibrage de charge.

    Primary Node Accepts Read Requests

    • Sélectionnez No. Les requêtes sont envoyées uniquement aux nœuds en lecture seule, ce qui réduit la charge du nœud principal et garantit sa stabilité.

    • Sélectionnez Yes. Les requêtes peuvent être envoyées au nœud principal ainsi qu'aux nœuds en lecture seule.

    Pour plus d'informations, consultez Le nœud principal accepte les requêtes de lecture.

    Remarque

    Ce paramètre est disponible uniquement en mode Read/Write (Automatic Read/Write Splitting).

    Transaction Splitting

    Active ou désactive la séparation des transactions. Pour plus d'informations, consultez Séparation des transactions.

    Remarque

    Ce paramètre est disponible uniquement en mode Read/Write (Automatic Read/Write Splitting).

    On-demand connections

    Active ou désactive les connexions à la demande. Pour plus d'informations, consultez Connexions à la demande.

    Remarque

    Ce paramètre est disponible uniquement lorsque la Load balancing policy est définie sur Active Request-based Load Balancing.

    Consistency Settings

    Consistency Level

    • En mode Read/Write (Automatic Read/Write Splitting), vous pouvez sélectionner Eventual Consistency (Weak), Session Consistency (Medium) ou Global Consistency (Strong). Pour plus d'informations, consultez Niveaux de cohérence.

    • En mode Read-only, le niveau de cohérence est fixé à Eventual Consistency (Weak).

    Important
    • Les modifications du niveau de cohérence prennent effet immédiatement pour toutes les connexions.

    • Activer ce mode pour un endpoint l'active pour tous les endpoints du cluster. Le désactiver rétablit les niveaux de cohérence précédemment configurés pour tous les endpoints.

    • Les paramètres de niveau de cohérence s'affichent uniquement si le cluster comporte au moins un nœud en lecture seule (RO). Cette section reste masquée en l'absence de nœud en lecture seule.

    Global Consistency Timeout

    Délai maximal pendant lequel un nœud en lecture seule attend la synchronisation des données depuis le nœud principal. Valeurs valides : 0 à 60 000. Valeur par défaut : 20. Unité : ms.

    Remarque

    Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Global Consistency (Strong) et que le Global Consistency Mode est défini sur Traditional Mode.

    Global Consistency Timeout Policy

    Politique appliquée par PolarDB lorsqu'un nœud en lecture seule dépasse le délai d'attente. Valeurs valides :

    • Send Requests to Primary Node (Default)

    • SQL Exception: Wait replication complete timeout, please retry.

    Remarque

    Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Global Consistency (Strong) et que le Global Consistency Mode est défini sur Traditional Mode.

    Global consistency read timeout (high-performance mode)

    Délai maximal pendant lequel un nœud en lecture seule attend la synchronisation des données depuis le nœud principal. Valeurs valides : 1 à 1 000 000. Valeur par défaut : 100. Unité : ms.

    Important
    • La cohérence globale (mode haute performance) s'applique à tous les endpoints d'un cluster. Activer ce mode pour un endpoint l'active pour l'ensemble du cluster.

    • Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Global Consistency (Strong) et que le Global Consistency Mode est défini sur High-performance Mode.

    Global consistency read timeout policy (high-performance mode)

    Politique appliquée par PolarDB suite à un dépassement de délai sur un nœud en lecture seule. Valeurs valides :

    • Send Requests to Primary Node (Default)

    • Return error messages due to timeout.

    • Downgrade the consistency level of a query to inconsistent read when a global consistent read in the query times out. No error message is returned to the client.

    Remarque

    Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Global Consistency (Strong) et que le Global Consistency Mode est défini sur High-performance Mode.

    Session Consistency Timeout

    Délai maximal pendant lequel un nœud en lecture seule attend la synchronisation des données depuis le nœud principal. Valeurs valides : 0 à 60 000. Valeur par défaut : 0. Unité : ms.

    Important
    • Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Session Consistency (Medium).

    Session Consistency Timeout Policy

    Politique appliquée par PolarDB suite à un dépassement de délai sur un nœud en lecture seule. Valeurs valides :

    • Send Requests to Primary Node (Default)

    • SQL Exception: Wait replication complete timeout, please retry.

    Remarque

    Ce paramètre est disponible uniquement lorsque le Consistency Level est défini sur Session Consistency (Medium).

    Connection Pool Settings

    Connection Pool

    Sélectionnez Off (par défaut), Session-level ou Transaction-level. Pour plus d'informations, consultez Pools de connexions.

    Remarque
    • Ce paramètre est disponible uniquement en mode Read/Write (Automatic Read/Write Splitting).

    • Ces modifications ne s'appliquent qu'aux nouvelles connexions. Pour les appliquer aux sessions existantes, redémarrez votre application ou rétablissez ses connexions à la base de données.

    HTAP Optimization

    Slow SQL Query Optimization

    Active ou désactive la requête parallèle et définit le degré de parallélisme.

    L'activation de la requête parallèle élastique (ePQ) exploite la puissance de traitement parallèle des CPU multicœurs (ressources de calcul inactives du cluster) pour accélérer les requêtes complexes. Pour plus d'informations, consultez Requête parallèle élastique.

    Remarque

    Depuis le 1er avril 2023, la requête parallèle élastique est activée par défaut avec un degré de parallélisme de 2 si le cluster remplit les conditions suivantes :

    • Pour un nouveau cluster : le cluster dispose de 8 cœurs de CPU ou plus.

    • Pour un cluster existant : un endpoint de cluster personnalisé est créé pour un cluster existant disposant de 8 cœurs de CPU ou plus.

    HTAP Optimization

    Active ou désactive la séparation du traitement transactionnel et analytique. Pour plus d'informations, consultez Configurer la séparation du traitement transactionnel/analytique.

    Remarque

    Les clusters PolarDB for MySQL 8.0.1 dont la version mineure du moteur est 8.0.1.1.22 ou ultérieure prennent en charge ce paramètre uniquement lorsque l'endpoint de cluster est en mode Parallel Query et que la zone Transactional/Analytical Processing Splitting sous Read/Write (Automatic Read/Write Splitting) contient au moins un nœud de stockage en colonnes en lecture seule.

    Selected Nodes

    Détermine si les nœuds de stockage en colonnes sont autorisés à accepter des requêtes OLTP.

    Si cette option est activée, les nœuds de stockage en colonnes traitent à la fois les requêtes OLAP et OLTP. Le proxy de base de données route les requêtes de lecture OLTP vers les nœuds de stockage en colonnes en fonction du nombre de requêtes actives, ce qui peut augmenter la charge sur ces nœuds.

    Remarque

    Ce paramètre est disponible uniquement lorsque la Node Settings est activée.

    Column store nodes handle OLTP requests.

    Transactional/Analytical Processing Splitting

    Active ou désactive la protection contre la surcharge. Pour plus d'informations, consultez Protection contre la surcharge.

  4. Cliquez sur Security Protection.

FAQ

Erreur de connexion après la suppression d'un nœud en lecture seule

  • Scénario : Vous souhaitez retirer un nœud en lecture seule d'un endpoint de cluster. Pour éviter de perturber les connexions actives, vous définissez d'abord le poids de séparation lecture/écriture du nœud en lecture seule sur 0. Vous vous attendez à ce que les nouvelles requêtes de lecture cessent d'être routées vers ce nœud. Cependant, après avoir retiré le nœud de l'endpoint de cluster, les applications clientes rencontrent des erreurs de connexion.

  • Cause : Un endpoint de cluster propose deux options de Overload Protection : OK et Load Balancing Policy.

    • Active Request-based Load Balancing : Une fois le poids d'un nœud en lecture seule défini sur 0, les nouvelles requêtes ne sont plus routées vers ce nœud.

    • Connections-based Load Balancing : L'équilibrage de charge ne se produit qu'à l'établissement de la connexion. Les connexions existantes vers ce nœud continuent de lui envoyer des requêtes.

  • Solution :

    1. Remplacez la Active Request-based Load Balancing de l'endpoint de cluster par Connections-based Load Balancing.

    2. Définissez le poids de séparation lecture/écriture du nœud en lecture seule cible sur 0.

    3. Supprimez le nœud en lecture seule.

Référence API

API

Description

DescribeDBClusterEndpoints

Interroge les endpoints de cluster.

ModifyDBClusterEndpoint

Modifie un endpoint de cluster.

DeleteDBClusterEndpoint

Supprime un endpoint de cluster personnalisé.