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
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.
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.
-
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).
RemarqueVous 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
.RemarqueLa 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueCe 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.
RemarqueDepuis 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.
RemarqueLes 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.
RemarqueCe 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.
-
Cliquez sur Security Protection.
FAQ
Erreur de connexion après la suppression d'un nœud en lecture seule
Référence API
|
API |
Description |
|
Interroge les endpoints de cluster. |
|
|
Modifie un endpoint de cluster. |
|
|
Supprime un endpoint de cluster personnalisé. |