Alibaba Cloud RDS MySQL database endpoints and ports - ApsaraDB RDS

Cette rubrique explique comment consulter et gérer les endpoints et les ports de vos instances ApsaraDB RDS for MySQL dans la console RDS.

Instances Basic Edition et High-availability Edition

Les instances ApsaraDB RDS for MySQL Basic Edition et High-availability Edition proposent les deux types d'endpoints suivants. Consultez-les ou modifiez-les en fonction de votre scénario de connexion, comme indiqué ci-dessous :

Type d'adresse

Instructions d'utilisation

Comment consulter et modifier

Endpoint d'instance

L'endpoint d'instance comprend un endpoint interne et un endpoint public :

Endpoint interne : Accédez à RDS via un réseau interne (tel qu'un VPC) pour bénéficier d'une faible latence et d'une grande stabilité. Le système génère cet endpoint automatiquement. Par exemple, les instances ECS situées dans le même VPC utilisent l'endpoint interne pour accéder à la base de données RDS.
Endpoint public : Accédez à RDS via le réseau public. Vous devez demander manuellement un endpoint public.

Consultez les sections suivantes pour afficher et modifier les endpoints et les ports internes et publics.

Endpoint de proxy de base de données

Si vous activez le proxy de base de données pour votre instance (la Basic Edition ne prend pas en charge cette fonctionnalité ; la High-availability Edition la prend en charge), utilisez l'endpoint du proxy de base de données pour vous connecter à l'instance. Cela optimise les performances de répartition lecture/écriture et réduit la charge sur l'instance principale.

Consulter les endpoints et les ports internes et publics

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Sur la page Basic Information, dans la section Basic Information, cliquez sur View Details.

Remarque
L'endpoint public n'apparaît qu'après avoir demandé un endpoint public.

Modifier les endpoints et les ports internes et publics

Remarque

Si vous avez précédemment activé le chiffrement SSL pour les connexions internes ou publiques, vous devez d'abord désactiver SSL avant de modifier les endpoints. La désactivation de SSL entraîne le redémarrage de l'instance. Effectuez cette opération pendant les heures creuses.

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Database Connection.
Cliquez sur Modify Endpoint.
Dans la boîte de dialogue qui s'affiche, définissez le préfixe de l'endpoint et le numéro de port pour l'endpoint interne ou public, puis cliquez sur OK.

Remarque
Le préfixe de l'endpoint doit être unique à l'échelle mondiale. Vous ne pouvez pas le remplacer par un endpoint existant.

Instances Cluster Edition

Les instances ApsaraDB RDS for MySQL Cluster Edition fournissent un endpoint cluster lecture/écriture, un endpoint cluster lecture seule, des endpoints de connexion directe aux nœuds et un endpoint de proxy de base de données. Consultez-les ou modifiez-les en fonction de votre scénario de connexion :

Type d'adresse	Description	Comment consulter et modifier
Endpoint cluster lecture/écriture	Chaque instance ne possède qu'un seul endpoint lecture/écriture, qui se connecte au nœud principal du cluster et prend en charge les opérations de lecture et d'écriture. L'endpoint cluster lecture/écriture comprend un endpoint interne (généré automatiquement) et un endpoint public (à demander manuellement). Endpoint interne : Accédez à RDS via un réseau interne (tel qu'un VPC) pour bénéficier d'une faible latence et d'une grande stabilité. Par exemple, les instances ECS situées dans le même VPC utilisent l'endpoint interne pour accéder à la base de données RDS. Endpoint public : Accédez à RDS via le réseau public.	Endpoint cluster lecture/écriture
Endpoint cluster lecture seule	Vous ne pouvez créer qu'un seul endpoint lecture seule par instance. Il se connecte aux nœuds secondaires du cluster et prend en charge l'équilibrage de charge. L'endpoint cluster lecture seule comprend un endpoint interne (généré automatiquement lors de la création de l'endpoint lecture seule) et un endpoint public (à demander manuellement). L'endpoint cluster lecture seule maintient toujours le nombre de nœuds secondaires que vous spécifiez afin de garantir la disponibilité : Si un nœud secondaire connecté à l'endpoint lecture seule tombe en panne, le système le reconstruit automatiquement. Si un nœud secondaire connecté à l'endpoint lecture seule est promu au rang de nœud principal, un nouveau nœud secondaire est automatiquement ajouté à l'endpoint lecture seule.	Endpoint cluster lecture seule
Endpoint de connexion directe au nœud	Connectez-vous directement à un nœud spécifique. Le nœud principal prend en charge les opérations de lecture et d'écriture. Les nœuds secondaires sont en lecture seule. L'endpoint de connexion directe au nœud comprend un endpoint interne (généré automatiquement lors de la création de l'endpoint de connexion directe) et un endpoint public (à demander manuellement).	Endpoint de connexion directe au nœud
Endpoint de proxy de base de données	Les instances Cluster Edition ont le proxy de base de données à usage général activé par défaut. Vous pouvez configurer l'endpoint du proxy en lecture/écriture ou en lecture seule : Read/Write : Prend en charge la répartition lecture/écriture pour une mise à l'échelle linéaire des activités, et prend en charge les fonctionnalités de proxy de données telles que la division des transactions et la gestion des pools de connexions. Read-only : Prend en charge les charges de travail en lecture seule, telles que les rapports.	Configurer un endpoint de proxy de base de données Configurer les politiques d'accès pour l'endpoint du proxy de base de données

Endpoint cluster lecture/écriture

L'endpoint cluster lecture/écriture comprend un endpoint interne et un endpoint public. L'endpoint interne est généré automatiquement après la création de l'instance. Demandez un endpoint public si nécessaire.

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Sur la page Basic Information, dans la section Instance Topology Management > Database Connection, consultez ou modifiez l'endpoint cluster lecture/écriture et demandez un endpoint public.
- Consulter l'endpoint cluster lecture/écriture : Placez le curseur de la souris sur la zone de connexion lecture/écriture et consultez l'endpoint dans la fenêtre contextuelle.
- Modifier l'endpoint cluster lecture/écriture ou demander un endpoint public : Cliquez sur Edit. Dans la boîte de dialogue qui s'affiche, vous pouvez Change Endpoint, Change VPC et Apply for un endpoint public.

Endpoint cluster lecture seule

Créer, consulter et supprimer un endpoint cluster lecture seule

Remarque

La création ou la suppression d'un endpoint cluster lecture seule n'affecte pas l'endpoint cluster lecture/écriture.
Lorsque vous supprimez un endpoint cluster lecture seule, ses endpoints interne et public sont libérés, et toutes les connexions à la base de données utilisant cet endpoint sont interrompues.
Chaque instance Cluster Edition ne peut disposer que d'un seul endpoint cluster lecture seule. Plusieurs nœuds secondaires partagent cet endpoint pour l'équilibrage de charge.

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Sur la page Basic Information, dans la section Instance Topology Management > Database Connection, choisissez :
- Add address
  
  Cliquez sur Add Endpoint. Dans la boîte de dialogue qui s'affiche, saisissez ou sélectionnez le préfixe de l'endpoint interne, le port de l'endpoint interne, le VPC et le vSwitch. Ajoutez les nœuds secondaires que vous souhaitez inclure, puis cliquez sur OK.
- Delete Address
  
  Dans la zone de connexion lecture seule cible, cliquez sur Delete. Dans la boîte de dialogue qui s'affiche, cliquez sur OK.
Consulter l'endpoint cluster lecture seule : Sur la page Basic Information, dans la section Instance Topology Management > Database Connection, placez le curseur de la souris sur la zone de connexion lecture seule et consultez l'endpoint dans la boîte de dialogue contextuelle.

Ajuster la configuration des nœuds pour l'endpoint cluster lecture seule

Remarque

Ajouter des nœuds secondaires ou ajuster les pondérations des nœuds : Les connexions à la base de données existantes ne sont pas affectées. Les nouvelles connexions (utilisant l'endpoint cluster lecture seule) utilisent la configuration des nœuds mise à jour pour l'équilibrage de charge.
Supprimer des nœuds secondaires : Vous devez conserver au moins un nœud secondaire. Les connexions vers le nœud supprimé subissent une déconnexion transitoire durant entre 30 et 120 secondes. Les autres nœuds ne sont pas affectés.
Lors de l'ajustement des pondérations des nœuds secondaires, assurez-vous qu'au moins un nœud a une pondération supérieure à 0.
Les modifications de configuration des nœuds pour l'endpoint cluster lecture seule s'appliquent aux connexions internes et publiques.

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Sur la page Basic Information, dans la section Instance Topology Management > Database Connection, cliquez sur Edit dans la zone de connexion lecture seule :
- Ajouter des nœuds et ajuster les pondérations : Sélectionnez les nœuds secondaires que vous souhaitez ajouter à l'endpoint et cliquez sur l'icône . Ajustez les pondérations des nœuds, puis cliquez sur OK.
- Supprimer des nœuds : Sélectionnez les nœuds que vous souhaitez supprimer et cliquez sur l'icône , puis cliquez sur OK.

Endpoint de connexion directe au nœud

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où se trouve l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Sur la page Basic Information, dans la section Instance Topology Management > Database Nodes, créez, consultez, modifiez ou demandez un endpoint public pour les endpoints de connexion directe aux nœuds.
- Créer un endpoint de nœud : Dans la zone du nœud cible, cliquez sur Create Node Endpoint, configurez les informations du réseau interne, puis cliquez sur OK.
- Consulter, modifier ou demander un endpoint public pour un endpoint de connexion directe au nœud : Cliquez sur Manage. Dans la boîte de dialogue qui s'affiche, vous pouvez Change Endpoint, Change VPC et Apply for un endpoint public.

FAQ

Q : Dois-je mettre à jour l'endpoint ou le port dans mon application après l'avoir modifié ?

R : Oui, il doit être modifié ; sinon, l'application ne pourra pas se connecter à la base de données.

Q : La modification d'un endpoint ou d'un port prend-elle effet immédiatement ? Dois-je redémarrer l'instance ?

R : Oui, elle prend effet immédiatement. Aucun redémarrage n'est requis.

Q : Après avoir modifié ou libéré un endpoint, puis-je réutiliser l'endpoint d'origine sur une autre instance ?

R : Oui, c'est possible.

Q : L'endpoint de l'instance change-t-il après un basculement principal/secondaire réussi ?

R : Non, il ne change pas. L'endpoint reste inchangé. Après le basculement, l'instance principale d'origine devient une instance secondaire, et les applications se connectent automatiquement à la nouvelle instance principale (l'ancienne instance secondaire).

Q : Comment résoudre l'erreur « Invalid connection string format » avec le code d'erreur InvalidConnectionString.Malformed lors de la modification d'un endpoint ?

R : Cette erreur se produit pour l'une des raisons suivantes :

Raison 1 : SSL est activé pour l'instance, ce qui empêche la modification de l'endpoint.

Solution : Désactiver le chiffrement SSL, puis modifier l'endpoint.
Raison 2 : La chaîne de connexion modifiée ne respecte pas les exigences — par exemple, le préfixe de l'endpoint comporte moins de 8 caractères ou la longueur totale dépasse 63 caractères.

Solution : Optimisez l'endpoint modifié pour respecter ces exigences : Le préfixe de l'endpoint doit commencer par une lettre minuscule, se terminer par une lettre minuscule ou un chiffre, et peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Il doit comporter au moins 8 caractères. La longueur totale de l'endpoint (préfixe + suffixe) ne doit pas dépasser 63 caractères.

Q : Pourquoi l'utilisation du CPU ou de la mémoire diffère-t-elle entre les nœuds d'une instance Cluster Edition lorsque toutes les pondérations des nœuds sont égales ?

R : Server Load Balancer (SLB) effectue l'équilibrage de charge en fonction du nombre de connexions, mais chaque connexion consomme des quantités différentes de ressources CPU ou mémoire.

Q : L'ajustement des pondérations des nœuds dans une instance Cluster Edition affecte-t-il les connexions existantes ? Provoque-t-il une brève indisponibilité du service ?

R : Non, cela n'a aucun impact. L'ajustement des pondérations des nœuds n'affecte que les nouvelles connexions. Les connexions existantes restent inchangées et aucune indisponibilité du service ne se produit.

Q : Puis-je définir les pondérations de tous les nœuds à 0 dans une instance Cluster Edition ?

R : Non, ce n'est pas possible. Au moins un nœud doit avoir une pondération supérieure à 0.

Q : Puis-je supprimer tous les nœuds d'un endpoint dans une instance Cluster Edition ?

R : Non, ce n'est pas possible. Un endpoint cluster lecture seule doit conserver au moins un nœud.

API associées

API

Description

Créer un endpoint pour une instance

Crée un endpoint pour une instance ApsaraDB RDS for MySQL Cluster Edition.

Supprimer un endpoint pour une instance

Supprime un endpoint pour une instance ApsaraDB RDS for MySQL Cluster Edition.

Modifier les informations de connexion de l'endpoint pour une instance

Modifie les informations de l'endpoint pour une instance ApsaraDB RDS for MySQL Cluster Edition.