Chaque instance ApsaraDB RDS for PostgreSQL dispose d'au moins un endpoint et d'un numéro de port pour les connexions à la base de données. Les types d'endpoints disponibles dépendent de l'édition RDS utilisée. Pour plus d'informations sur la connexion à l'aide de ces endpoints, consultez la rubrique Connexion à une instance ApsaraDB RDS for PostgreSQL.
RDS Basic Edition et RDS High-availability Edition : endpoint d'instance et endpoint de proxy de base de données
RDS Cluster Edition : endpoint en lecture/écriture et endpoint en lecture seule
RDS Basic Edition et RDS High-availability Edition
Types d'endpoints
| Type d'endpoint | Description |
|---|---|
| Endpoint d'instance | Convient à tous les scénarios de connexion. Comprend un endpoint interne pour un accès à faible latence via le réseau interne (par exemple, depuis une instance ECS au sein du même VPC) et un endpoint public pour un accès via Internet. |
| Endpoint de proxy de base de données | Disponible lorsque la fonctionnalité de proxy de base de données est activée. Nous vous recommandons d'utiliser l'endpoint de proxy de base de données si cette fonctionnalité est activée pour votre instance. Cela améliore les performances de répartition lecture/écriture et réduit la charge sur l'instance principale. Pour plus d'informations, consultez la rubrique Présentation des proxys de base de données. |
Modifier l'endpoint d'instance et le numéro de port
Prérequis
Avant de commencer, assurez-vous d'avoir :
Configuré une liste d'autorisation d'adresses IP pour l'instance. Pour plus d'informations, consultez la rubrique Configuration d'une liste d'autorisation d'adresses IP
Demandé un endpoint public, si nécessaire. Pour plus d'informations, consultez la rubrique Demande ou libération d'un endpoint public
Procédure
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région de votre instance RDS, puis cliquez sur l'ID de l'instance.
Dans le volet de navigation de gauche, cliquez sur Database Connection pour afficher les endpoints internes et publics ainsi que les numéros de port.
Dans la section Database Connection, cliquez sur Modify Endpoint.
Définissez Connection Type sur Internal Endpoint ou Public Endpoint. Modifiez le préfixe de l'Endpoint et le numéro de Port, puis cliquez sur OK.
Le préfixe de l'endpoint doit comporter entre 8 et 64 caractères et peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Il doit commencer par une lettre minuscule. Le numéro de port doit être compris entre 1000 et 5999. Si votre instance RDS utilise des SSD locaux premium, le numéro de port ne peut pas être modifié.
Modifier l'endpoint de proxy de base de données et le numéro de port
Prérequis
Avant de commencer, assurez-vous d'avoir :
Activé la fonctionnalité de proxy de base de données. Pour plus d'informations, consultez la rubrique Activation de la fonctionnalité de proxy de base de données
Procédure
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région de votre instance RDS, puis cliquez sur l'ID de l'instance.
Dans le volet de navigation de gauche, cliquez sur Database Proxy.
Dans la section Connection Information, repérez l'endpoint de proxy de base de données et cliquez sur l'icône de modification située à sa droite.
Modifiez le préfixe de l'Endpoint et le numéro de Port, puis cliquez sur OK.
Le préfixe de l'endpoint de proxy de base de données doit comporter entre 1 et 40 caractères et peut contenir des lettres minuscules, des chiffres et des traits d'union (-). Il doit commencer par une lettre minuscule. Le numéro de port doit être compris entre 1000 et 5999. La valeur de Endpoint Type ne peut pas être modifiée.
FAQ
Dois-je mettre à jour mon application après avoir modifié un endpoint ou un numéro de port ?
Oui. Mettez à jour immédiatement l'endpoint ou le numéro de port dans votre application, sinon les connexions à l'instance échoueront.
Les modifications d'endpoint ou de numéro de port prennent-elles effet immédiatement ? Un redémarrage est-il nécessaire ?
Les modifications prennent effet immédiatement. Aucun redémarrage de l'instance n'est nécessaire.
Puis-je réutiliser un endpoint après l'avoir libéré ?
Oui. Après la modification ou la libération d'un endpoint, l'ancien endpoint devient disponible pour d'autres instances RDS.
Un basculement primaire/secondaire modifie-t-il les endpoints ?
Non. Les endpoints restent identiques lors d'un basculement primaire/secondaire. Seules les adresses IP sous-jacentes changent. Votre application peut continuer à se connecter via les mêmes endpoints sans modification.
RDS Cluster Edition
Une instance RDS exécutant RDS Cluster Edition est appelée cluster RDS. Chaque cluster prend en charge deux types d'endpoints pour différents modes d'accès.
Types d'endpoints
| Type d'endpoint | Description |
|---|---|
| Endpoint en lecture/écriture | Un par cluster. Se connecte uniquement au nœud principal. Lors d'un basculement primaire/secondaire, l'endpoint achemine automatiquement le trafic vers le nouveau nœud principal. Comprend un endpoint interne (généré automatiquement lors de la création du cluster) et un endpoint public facultatif. |
| Endpoint en lecture seule | Un par cluster. Achemine le trafic vers un ou plusieurs nœuds secondaires. Prend en charge l'ajout et la suppression de nœuds ainsi que l'ajustement des pondérations des nœuds pour l'équilibrage de charge. Le nombre de nœuds secondaires correspond toujours au nombre défini par l'utilisateur. Si un nœud secondaire tombe en panne, il est automatiquement reconstruit. Si un nœud secondaire est promu en tant que nœud principal, un nouveau nœud secondaire est automatiquement ajouté à l'endpoint en lecture seule. |
Afficher et gérer l'endpoint en lecture/écriture
L'endpoint en lecture/écriture comprend des endpoints internes et publics. Un endpoint interne est généré automatiquement lors de la création du cluster. Demandez un endpoint public en fonction de vos besoins métier.
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région de votre instance RDS, puis cliquez sur l'ID de l'instance.
-
Sur la page Basic Information, localisez la section Database Connection dans Instance Topology Management.
Afficher l'endpoint en lecture/écriture : placez le curseur sur la carte Read/Write Mode pour voir l'endpoint dans l'infobulle.
-
Modifier l'endpoint en lecture/écriture ou demander un endpoint public : cliquez sur Edit et effectuez l'une des actions suivantes :
Cliquez sur Change Connection pour modifier l'endpoint interne et le numéro de port.
Cliquez sur Change VPC pour changer de VPC et de vSwitch.
Cliquez sur Apply for pour demander un endpoint public.
Vous pouvez également cliquer sur Apply for Public Endpoint pour demander un endpoint public.
Afficher et gérer l'endpoint en lecture seule
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région de votre instance RDS, puis cliquez sur l'ID de l'instance.
Sur la page Basic Information, localisez la section Database Connection dans Instance Topology Management. Effectuez les opérations nécessaires :
Créer un endpoint en lecture seule
Le cluster doit être à l'état Running. La création d'un endpoint en lecture seule n'affecte pas les requêtes de lecture et d'écriture existantes. Un seul endpoint en lecture seule est autorisé par cluster. Un endpoint interne est généré automatiquement pour l'endpoint en lecture seule, offrant un équilibrage de charge entre les nœuds secondaires.
Cliquez sur Add Endpoint.
Dans la boîte de dialogue, configurez le Internal Endpoint Prefix, le Port, le VPC et le vSwitch. Ajoutez les nœuds secondaires à accéder et ajustez leurs pondérations.
Cliquez sur OK.
Supprimer un endpoint en lecture seule
La suppression d'un endpoint en lecture seule libère ses endpoints internes et publics et interrompt toutes les connexions établies. Les requêtes de lecture et d'écriture existantes vers le cluster ne sont pas affectées.
Dans la carte Read-only Mode, cliquez sur Delete.
Dans le message de confirmation, cliquez sur OK.
Afficher l'endpoint en lecture seule
Placez le curseur sur la carte Read-only Mode pour afficher l'endpoint en lecture seule.
Ajouter ou supprimer des nœuds
Le cluster doit être à l'état Running. Au moins un nœud doit rester dans l'endpoint en lecture seule. Les modifications de configuration des nœuds s'appliquent aux endpoints internes et publics de l'endpoint en lecture seule.
Ajouter des nœuds :
Dans la carte Read-only Mode, cliquez sur Edit et sélectionnez le nœud à ajouter.
Cliquez sur l'icône d'ajout pour inclure le nœud.
Ajustez les pondérations des nœuds selon vos besoins, puis cliquez sur OK.
L'ajout de nœuds n'affecte pas les connexions persistantes existantes. Les nouvelles connexions sont distribuées en fonction des pondérations mises à jour.
Supprimer des nœuds :
Dans la carte Read-only Mode, cliquez sur Edit et sélectionnez le nœud à supprimer.
Cliquez sur l'icône de suppression, puis cliquez sur OK.
La suppression d'un nœud entraîne une indisponibilité d'environ 30 à 120 secondes pour ce nœud. Les connexions aux autres nœuds ne sont pas affectées.
Ajuster les pondérations des nœuds
Le cluster doit être à l'état Running. Au moins un nœud doit avoir une pondération supérieure à 0. Les modifications de pondération s'appliquent aux endpoints internes et publics de l'endpoint en lecture seule.
Dans la carte Read-only Mode, cliquez sur Edit.
Ajustez les pondérations des nœuds dans la boîte de dialogue, puis cliquez sur OK.
Les connexions existantes ne sont pas affectées. Seules les nouvelles connexions suivent la distribution des pondérations mise à jour.
FAQ
Pourquoi les nœuds ayant la même pondération affichent-ils une utilisation différente du CPU et de la mémoire ?
Server Load Balancer (SLB) répartit les connexions uniformément entre les nœuds, mais la consommation de ressources des connexions individuelles varie. Un nombre identique de connexions ne garantit pas une utilisation identique du CPU ou de la mémoire.
L'ajustement des pondérations des nœuds provoque-t-il une interruption de service ?
Non. Les connexions existantes restent actives. Seules les nouvelles connexions sont acheminées selon les pondérations mises à jour.
Puis-je définir toutes les pondérations des nœuds sur 0 ?
Non. Au moins un nœud doit avoir une pondération supérieure à 0.
Puis-je supprimer tous les nœuds de l'endpoint en lecture seule ?
Non. Au moins un nœud doit rester dans l'endpoint en lecture seule.
Référence API
Les opérations API suivantes sont disponibles pour gérer les endpoints des instances ApsaraDB RDS for PostgreSQL exécutant RDS Cluster Edition.
| Opération | Description |
|---|---|
| CreateDBInstanceEndpoint | Crée un endpoint |
| DescribeDBInstanceEndpoints | Interroge les endpoints |
| ModifyDBInstanceEndpointAddress | Modifie l'adresse d'un endpoint |
| CreateDBInstanceEndpointAddress | Crée un endpoint public |
| DeleteDBInstanceEndpointAddress | Libère un endpoint public |
| DeleteDBInstanceEndpoint | Supprime un endpoint |
| ModifyDBInstanceEndpoint | Modifie la pondération d'un endpoint |