Les instances ApsaraDB RDS for SQL Server exposent des endpoints internes et publics que votre application utilise pour se connecter. Cette rubrique explique comment consulter et modifier ces endpoints et ports, ainsi que la procédure pour consulter ou désactiver les endpoints en lecture seule sur les instances de l'édition Cluster.
Types d'endpoints
| Type d'endpoint | Description | Rubriques connexes |
|---|---|---|
| Endpoint interne | S'applique à tous les scénarios de connexion à une instance. | Activer ou désactiver un endpoint public |
| Endpoint public | S'applique à tous les scénarios de connexion à une instance. Doit être activé avant utilisation. | Activer ou désactiver un endpoint public |
| Endpoint unifié en lecture seule | Achemine les requêtes de lecture vers le nœud secondaire et les instances en lecture seule en fonction de leurs poids attribués. Configurez cet endpoint dans votre application pour activer la séparation lecture/écriture. | Activer un endpoint en lecture seule |
| Endpoint en lecture seule du nœud secondaire | Permet un accès direct au nœud secondaire. N'achemine pas le trafic vers l'instance principale ni vers les instances en lecture seule. | Activer un endpoint en lecture seule |
Si votre application se connecte uniquement via l'endpoint interne ou public de l'instance principale, toutes les requêtes sont dirigées vers l'instance principale ; aucune n'est distribuée au nœud secondaire ou aux instances en lecture seule.
Consulter ou modifier les endpoints et ports internes et publics
Prérequis
Avant de commencer, assurez-vous d'avoir :
Une liste d'autorisation configurée. Consultez la rubrique Configurer une liste d'autorisation
(Pour l'endpoint public uniquement) Un endpoint public activé. Consultez la rubrique Activer ou désactiver un endpoint public
Après avoir modifié un endpoint ou un port, mettez à jour les paramètres de connexion dans votre application. Sinon, votre application ne pourra pas se connecter à la base de données.
Procédure
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance. Localisez l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Database Connection pour afficher les endpoints et ports internes et publics.
Cliquez sur Modify Endpoint.
-
Configurez les paramètres de connexion, puis cliquez sur Ok.
Champ Description Exigence Connection Type L'endpoint à modifier Sélectionnez Internal Endpoint ou Public Endpoint Endpoint Le préfixe de l'endpoint Doit commencer par une lettre minuscule, comporter entre 8 et 64 caractères et contenir uniquement des lettres, des chiffres et des traits d'union (-) Port Le numéro de port Doit être compris entre 1000 et 5999
Consulter ou désactiver un endpoint en lecture seule (édition Cluster)
Prérequis
Avant de commencer, assurez-vous d'avoir activé soit un endpoint unifié en lecture seule, soit un endpoint en lecture seule du nœud secondaire.
Tenez compte des points suivants avant de désactiver un endpoint en lecture seule :
La désactivation d'un endpoint en lecture seule le rend immédiatement invalide. Votre application ne peut plus l'utiliser pour se connecter à l'instance. Les endpoints internes et publics ne sont pas affectés.
La désactivation entraîne une déconnexion transitoire durant moins de 30 secondes. Effectuez cette opération pendant les heures creuses et assurez-vous que votre application dispose d'un mécanisme de reconnexion automatique.
Chaque fois que vous réactivez un endpoint unifié ou un endpoint en lecture seule du nœud secondaire, le nouvel endpoint peut différer du précédent.
Désactiver l'endpoint unifié en lecture seule
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance. Localisez l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Cluster Management.
Dans la section Read-only Network Information, cliquez sur Disable Readonly Splitting Address.
Dans la boîte de dialogue, cliquez sur OK.
Désactiver l'endpoint en lecture seule du nœud secondaire
Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance. Localisez l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Cluster Management.
Dans la section Secondary Instance Network Information, cliquez sur Disable Secondary Instance Endpoint.
Dans la boîte de dialogue, cliquez sur OK.
FAQ
Dois-je mettre à jour mon application après avoir modifié un endpoint ou un port ?
Oui. Mettez à jour immédiatement les paramètres de connexion dans votre application. Sinon, les connexions échoueront.
Les modifications d'endpoints ou de ports nécessitent-elles un redémarrage ?
Non. Les modifications prennent effet immédiatement sans redémarrer l'instance.
Puis-je réutiliser un endpoint libéré pour une autre instance ?
Oui. Une fois libéré, l'endpoint devient disponible pour d'autres instances.
Un basculement principal/secondaire modifie-t-il l'endpoint ?
Non. L'endpoint reste identique après un basculement. Seule l'adresse IP sous-jacente change, ce qui n'affecte pas votre application.