Arbeiten mit Amazon RDS Proxy-Endpunkten

Im Folgenden können Sie mehr über Endpunkte für RDS-Proxy erfahren und wie man sie benutzt. Durch die Verwendung von Proxy-Endpunkten können Sie die folgenden Funktionen nutzen:

• Sie können mehrere Endpunkte mit einem Proxy verwenden, um Verbindungen von verschiedenen Anwendungen unabhängig voneinander zu überwachen und zu beheben.

• Sie können Reader-Endpunkte mit Aurora-DB-Cluster zur Verbesserung der Leseskalierbarkeit und Hochverfügbarkeit für Ihre abfrageintensiven Anwendungen verwenden.

• Sie können einen VPC-übergreifenden Endpunkt verwenden, um den Zugriff auf Datenbanken in einer VPC aus Ressourcen wie Amazon EC2-Instances in einer anderen VPC zu erlauben.

Überblick über Proxy-Endpunkte

Arbeiten mit RDS-Proxy-Endpunkten umfassen die gleichen Arten von Verfahren wie bei Aurora-DB-Cluster- und Reader-Endpunkten. Wenn Sie nicht mit Aurora-Endpunkten vertraut sind finden Sie weitere Informationen unter Amazon Aurora-Verbindungsverwaltung.

Standardmäßig hat der Endpunkt, mit dem Sie eine Verbindung herstellen, wenn Sie RDS Proxy mit einem Aurora-Cluster verwenden, Lese-/Schreibfähigkeit. Infolgedessen sendet dieser Endpunkt alle Anforderungen an die Writer-Instance des Clusters. Alle diese Verbindungen werden auf den max_connections-Wert für die Writer-Instance angerechnet. Wenn Ihr Proxy mit einem Aurora-DB-Cluster verbunden ist, können Sie zusätzliche Lese-/Schreib- oder schreibgeschützte Endpunkte für diesen Proxy erstellen.

Sie können einen schreibgeschützten Endpunkt mit Ihrem Proxy für schreibgeschützte Abfragen verwenden. Sie verwenden diesen, wie Sie den Reader-Endpunkt für einen von Aurora bereitgestellten Cluster nutzen. Auf diese Weise können Sie die Leseskalierbarkeit eines Aurora-Cluster mit einer oder mehreren Reader-DB-Instances nutzen. Sie können mehr gleichzeitige Abfragen ausführen und mehr gleichzeitige Verbindungen herstellen, indem Sie einen schreibgeschützten Endpunkt verwenden und Ihrem Aurora--Cluster nach Bedarf mehr Reader-DB-Instances hinzufügen.

Tipp

Wenn Sie einen Proxy für einen Aurora-Cluster mit der AWS Management Console erstellen, können Sie RDS-Proxy einen Reader-Endpunkt automatisch erstellen lassen. Informationen zu den Vorteilen eines Reader-Endpunkts finden Sie unter Verwenden von Reader-Endpunkten mit Aurora-Clustern.

Für einen Proxy-Endpunkt, den Sie erstellen, können Sie den Endpunkt auch einer anderen Virtual Private Cloud (VPC) zuordnen, als der Proxy selbst verwendet. Auf diese Weise können Sie sich von einer anderen VPC aus mit dem Proxy verbinden, z. B. von einer VPC, die von einer anderen Anwendung in Ihrem Unternehmen verwendet wird.

Informationen zu Limits im Zusammenhang mit Proxy-Endpunkten finden Sie unter Limits für Proxy-Endpunkte.

In den RDS Proxy-Protokollen wird jedem Eintrag der Name des zugehörigen Proxy-Endpunkts vorangestellt. Dieser Name kann derjenige sein, den Sie für einen benutzerdefinierten Endpunkt angegeben haben. Oder es kann der spezielle Name default für den Standardendpunkt eines Proxys sein, der Lese-/Schreibanforderungen ausführt.

Jeder Proxy-Endpunkt hat seinen eigenen Satz von CloudWatch Metriken. Sie können die Metriken für alle Endpunkte eines Proxys überwachen. Sie können auch Metriken für einen bestimmten Endpunkt oder für alle Lese-/Schreib- oder schreibgeschützten Endpunkte eines Proxys überwachen. Weitere Informationen finden Sie unter Überwachen von RDS-Proxy-Metriken mit Amazon CloudWatch.

Ein Proxy-Endpunkt verwendet denselben Authentifizierungsmechanismus wie der zugehörige Proxy. Für RDS Proxy richtet automatisch Berechtigungen und Autorisierungen für den benutzerdefinierten Endpunkt ein, die mit den Eigenschaften des zugehörigen Proxys übereinstimmen.

Informationen zur Funktionsweise von Proxy-Endpunkten für DB-Cluster in einer globalen Aurora-Datenbank finden Sie unter So funktionieren RDS-Proxy-Endpunkte mit globalen Datenbanken.

Verwenden von Reader-Endpunkten mit Aurora-Clustern

Sie können schreibgeschützte Endpunkte namens Reader-Endpunkte erstellen und eine Verbindung herstellen, wenn Sie RDS Proxy mit Aurora-Clustern verwenden. Diese Reader-Endpunkte tragen dazu bei, die Leseskalierbarkeit Ihrer abfrageintensiven Anwendungen zu verbessern. Reader-Endpunkte helfen auch, die Verfügbarkeit Ihrer Verbindungen zu verbessern, wenn eine Reader-DB-Instance in Ihrem Cluster nicht verfügbar ist.

Anmerkung

Wenn Sie angeben, dass ein neuer Endpunkt schreibgeschützt ist, verlangt RDS Proxy, dass der Aurora-Cluster eine oder mehrere Reader-DB-Instances hat. In einigen Fällen ändern Sie ggf. das Ziel des Proxys in einen Aurora-Cluster, der einen Aurora-Cluster mit nur einem Writer oder mit mehreren Writern enthält. In diesem Fall schlagen alle Anfragen an den Reader-Endpunkt mit einem Fehler fehl. Anfragen schlagen auch fehl, wenn das Ziel des Proxys eine RDS-Instance anstelle eines Aurora-Clusters ist.

Wenn ein Aurora-Cluster Reader-Instances hat, aber diese Instances nicht verfügbar sind, wartet RDS Proxy darauf, die Anfrage zu senden, anstatt sofort einen Fehler zu zurückzugeben. Wenn innerhalb des Zeitraums der Zeitüberschreitung für die Verbindung keine Reader-Instance verfügbar wird, schlägt die Anfrage mit einem Fehler fehl.

Wie Reader-Endpunkte die Verfügbarkeit von Anwendungen unterstützen

In einigen Fällen sind möglicherweise eine oder mehrere Reader-Instances in Ihrem Cluster nicht verfügbar. In diesem Fall können Verbindungen, die einen Reader-Endpunkt eines DB-Proxys verwenden, schneller wiederhergestellt werden als solche, die den Aurora-Reader-Endpunkt verwenden. RDS Proxy leitet Verbindungen nur an die verfügbaren Reader-Instances im Cluster weiter. Es gibt keine Verzögerung aufgrund von DNS-Caching, wenn eine Instance nicht verfügbar ist.

Wenn die Verbindung Multiplexing durchführt, leitet RDS Proxy nachfolgende Abfragen ohne Unterbrechung Ihrer Anwendung an eine andere Reader-DB-Instance weiter. Bei der automatischen Umstellung auf eine neue Reader-Instance prüft RDS Proxy die Replikationsverzögerung der alten und neuen Reader-Instance. RDS Proxy stellt sicher, dass die neue Reader-Instance mit den gleichen Änderungen wie die vorherige Reader-Instance auf dem neuesten Stand ist. Auf diese Weise hat Ihre Anwendung niemals veraltete Daten, wenn RDS Proxy von einer Reader-DB-Instance zu einer anderen wechselt.

Wenn die Verbindung fixiert ist, gibt die nächste Abfrage der Verbindung einen Fehler zurück. Ihre Anwendung kann sich jedoch sofort wieder mit demselben Endpunkt verbinden. RDS Proxy leitet die Verbindung zu einer anderen Reader-DB-Instance weiter, die sich im Status available befindet. Wenn Sie die Verbindung manuell wiederherstellen, überprüft RDS Proxy nicht die Replikationsverzögerung zwischen den alten und neuen Reader-Instances.

Wenn Ihr Aurora-Cluster keine Reader-Instances verfügbar hat, prüft RDS Proxy, ob diese Bedingung vorübergehend oder dauerhaft ist. Das Verhalten ist in jedem Fall wie folgt:

• Angenommen, Ihr Cluster hat eine oder mehrere Reader-DB-Instances, aber keine von ihnen befindet sich im Status Available. Zum Beispiel könnten alle Reader-Instances neu gestartet werden oder Probleme aufweisen. In diesem Fall warten Versuche, eine Verbindung zu einem Reader-Endpunkt herzustellen, darauf, dass eine Reader-Instance verfügbar wird. Wenn innerhalb des Zeitraums der Zeitüberschreitung für die Verbindung keine Reader-Instance verfügbar wird, schlägt der Verbindungsversuch fehl. Wenn eine Reader-Instance verfügbar wird, ist der Verbindungsversuch erfolgreich.

• Angenommen, Ihr Cluster hat keine Reader-DB-Instances. In diesem Fall gibt RDS Proxy sofort einen Fehler zurück, wenn Sie versuchen, eine Verbindung zu einem Reader-Endpunkt herzustellen. Um dieses Problem zu beheben, fügen Sie Ihrem Cluster eine oder mehrere Reader-Instances hinzu, bevor Sie eine Verbindung zum Reader-Endpunkt herstellen.

Wie Reader-Endpunkte bei der Skalierbarkeit von Abfragen unterstützen

Reader-Endpunkte für einen Proxy unterstützen mit einer Aurora-Abfrage die Skalierbarkeit auf folgende Weise:

• Wenn Sie Reader-Instances zu Ihrem Aurora-Cluster hinzufügen, kann RDS Proxy neue Verbindungen zu beliebigen Reader-Endpunkten an die verschiedenen Reader-Instances weiterleiten. Auf diese Weise verlangsamen Abfragen, die mit einer Reader-Endpunktverbindung durchgeführt werden, keine Abfragen, die über eine andere Reader-Endpunktverbindung durchgeführt werden. Die Abfragen laufen auf separaten DB-Instances. Jede DB-Instance verfügt über eigene Rechenressourcen, Puffer-Cache usw.

• Wo praktisch, verwendet RDS Proxy dieselbe Reader-DB-Instance für alle Abfragen unter Verwendung einer bestimmten Reader-Endpunktverbindung. Auf diese Weise kann eine Reihe von verwandten Abfragen in denselben Tabellen das Caching, die Planoptimierung usw. für eine bestimmte DB-Instance nutzen.

• Wenn eine Reader-DB-Instance nicht verfügbar ist, hängt die Auswirkung auf Ihre Anwendung davon ab, ob die Sitzung Multiplexing durchführt oder fixiert ist. Wenn die Sitzung Multiplexing durchführt, leitet RDS Proxy leitet alle nachfolgenden Abfragen an eine andere Reader-DB-Instance weiter, ohne dass Sie etwas unternehmen müssen. Wenn die Sitzung fixiert ist, bekommt Ihre Anwendung einen Fehler und muss sich erneut verbinden. Sie können sich sofort wieder mit dem Reader-Endpunkt verbinden und RDS Proxy leitet die Verbindung zu einer verfügbaren Reader-DB-Instance. Weitere Informationen zum Multiplexing und Pinning für Proxy-Sitzungen finden Sie unter Überblick über RDS Proxy-Konzepte.

• Je mehr Reader-DB-Instances Sie in dem Cluster haben, desto mehr gleichzeitige Verbindungen können Sie mithilfe von Reader-Endpunkten herstellen. Angenommen, Ihr Cluster verfügt über vier Reader-DB-Instances, die jeweils so konfiguriert sind, dass sie 200 gleichzeitige Verbindungen unterstützen. Nehmen wir außerdem an, Ihr Proxy ist so konfiguriert, dass er 50 % der maximalen Verbindungen verwendet. Hier beträgt die maximale Anzahl von Verbindungen, die Sie über die Reader-Endpunkte im Proxy herstellen können, 100 (50% von 200) für Reader 1. Es sind auch 100 für Reader 2 usw. bei insgesamt 400. Wenn Sie die Anzahl der Reader-DB-Instances im Cluster auf acht verdoppeln, verdoppelt sich die maximale Anzahl von Verbindungen über die Reader-Endpunkte ebenfalls, und zwar auf 800.

Beispiele für die Verwendung von Reader-Endpunkten

Das folgende Linux-Beispiel zeigt, wie Sie bestätigen können, dass Sie mit einem Aurora MySQL-Cluster durch einen Reader-Endpunkt verbunden sind. Die innodb_read_only-Konfigurationseinstellung ist aktiviert. Versuche Schreibvorgänge wie CREATE DATABASE-Anweisungen durchzuführen, schlagen mit einem Fehler fehl. Und Sie können bestätigen, dass Sie mit einer Reader-DB-Instance verbunden sind, indem Sie den Namen der DB-Instance mit der aurora_server_id-Variable prüfen.

Tipp

Verlassen Sie sich nicht nur darauf, den Namen der DB-Instance zu überprüfen, um festzustellen, ob die Verbindung lesen/schreibgeschützt oder schreibgeschützt ist. Denken Sie daran, dass DB-Instances in Aurora-Clustern die Rollen zwischen Writer und Reader ändern können, wenn Failovers auftreten.

$ mysql -h endpoint-demo-reader.endpoint.proxy-demo.us-east-1.rds.amazonaws.com -u admin -p
...
mysql> select @@innodb_read_only;
+--------------------+
| @@innodb_read_only |
+--------------------+
|                  1 |
+--------------------+
mysql> create database shouldnt_work;
ERROR 1290 (HY000): The MySQL server is running with the --read-only option so it cannot execute this statement

mysql> select @@aurora_server_id;
+---------------------------------------+
| @@aurora_server_id                    |
+---------------------------------------+
| proxy-reader-endpoint-demo-instance-3 |
+---------------------------------------+

Das folgende Beispiel zeigt, wie Ihre Verbindung zu einem Proxy-Reader-Endpunkt auch dann weiterfunktioniert, wenn die Reader-DB-Instance gelöscht wird. In diesem Beispiel hat der Aurora-Cluster zwei Reader-Instances, instance-5507 und instance-7448. Die Verbindung zum Reader-Endpunkt beginnt mit der Verwendung einer der Reader-Instances. Im Beispiel wird diese Reader-Instance durch einen Befehl delete-db-instance gelöscht. Für nachfolgende Abfragen wechselt RDS Proxy zu einer anderen Reader-Instance.

$ mysql -h reader-demo.endpoint.proxy-demo.us-east-1.rds.amazonaws.com
  -u my_user -p
...
mysql> select @@aurora_server_id;
+--------------------+
| @@aurora_server_id |
+--------------------+
| instance-5507      |
+--------------------+

mysql> select @@innodb_read_only;
+--------------------+
| @@innodb_read_only |
+--------------------+
|                  1 |
+--------------------+

mysql> select count(*) from information_schema.tables;
+----------+
| count(*) |
+----------+
|      328 |
+----------+

Während die mysql-Sitzung noch ausgeführt wird, löscht der folgende Befehl die Reader-Instance, mit der der Reader-Endpunkt verbunden ist.

aws rds delete-db-instance --db-instance-identifier instance-5507 --skip-final-snapshot

Abfragen in der mysql-Sitzung funktionieren weiterhin, ohne dass eine erneute Verbindung erforderlich ist. RDS Proxy wechselt automatisch zu einer anderen Reader-DB-Instance.

mysql> select @@aurora_server_id;
+--------------------+
| @@aurora_server_id |
+--------------------+
| instance-7448      |
+--------------------+

mysql> select count(*) from information_schema.TABLES;
+----------+
| count(*) |
+----------+
|      328 |
+----------+

Zugreifen auf Aurora-Datenbanken über VPCs hinweg

Standardmäßig befinden sich die Komponenten Ihres Aurora--Technologie-Stacks alle in derselben Amazon-VPC. Nehmen wir zum Beispiel an, dass eine Anwendung in einer Amazon-EC2-Instance eine Verbindung mit einem Aurora-DB-Cluster herstellt. In diesem Fall müssen sich der Anwendungsserver und die Datenbank beide innerhalb derselben VPC befinden.

Mit RDS Proxy können Sie den Zugriff auf einen Aurora-DB-Clustereine in einer VPC von Ressourcen in einer anderen VPC aus einrichten, z. B. EC2-Instances. Zum Beispiel könnte Ihre Organisation mehrere Anwendungen haben, die auf dieselben Datenbankressourcen zugreifen. Jede Anwendung könnte sich in einer eigenen VPC befinden.

Um den VPC-übergreifenden Zugriff zu aktivieren, erstellen Sie einen neuen Endpunkt für den Proxy. Der Proxy selbst befindet sich in derselben VPC wie der Aurora-DB-Cluster. Der VPC-übergreifenden Endpunkt befindet sich jedoch in der anderen VPC bei den anderen Ressourcen wie den EC2-Instances. Der VPC-übergreifende Endpunkt ist mit Subnetzen und Sicherheitsgruppen aus derselben VPC wie der EC2 und anderen Ressourcen verknüpft. Mit diesen Zuordnungen können Sie von den Anwendungen aus eine Verbindung zum Endpunkt herstellen, die aufgrund der VPC-Einschränkungen sonst nicht auf die Datenbank zugreifen können.

In den folgenden Schritten wird erläutert, wie Sie einen VPC-übergreifenden Endpunkt erstellen und darauf über RDS Proxy zugreifen:

1. Erstellen Sie zwei VPCs oder wählen Sie zwei VPCs, die Sie bereits für Aurora -Aufgaben verwenden. Jede VPC sollte über eigene Netzwerkressourcen wie ein Internet-Gateway, Routing-Tabellen, Subnetze und Sicherheitsgruppen verfügen. Wenn Sie nur eine VPC haben, können Sie Erste Schritte mit Amazon Aurora für die Schritte zum Einrichten einer anderen VPC zur erfolgreichen Verwendung von Aurora konsultieren. . Sie können Ihre vorhandene VPC auch in der Amazon EC2-Konsole untersuchen, um die Arten von Ressourcen zu sehen, die miteinander verbunden werden sollen.

2. Erstellen Sie einen DB-Proxy, der mit dem Aurora-DB-Cluster verknüpft ist, mit dem/der Sie eine Verbindung herstellen möchten. Folgen Sie dem Verfahren unter Erstellen eines RDS Proxy.

3. Auf der Seite Einzelheiten für Ihren Proxy in der RDS-Konsole unter dem Abschnitt Proxy-Endpunkte wählen Sie Endpunkt erstellen. Folgen Sie dem Verfahren unter Erstellen eines Proxy-Endpunktes.

4. Wählen Sie aus, ob der VPC-übergreifende Endpunkt zum Lesen/Schreiben oder schreibgeschützt sein soll.

5. Anstatt den Standard der gleichen VPC wie für den Aurora-DB-Cluster zu akzeptieren, wählen Sie eine andere VPC. Diese VPC muss sich in derselben AWS-Region befinden wie die VPC, in der sich der Proxy befindet.

6. Anstatt nun die Standardeinstellungen für Subnetze und Sicherheitsgruppen von derselben VPC wie für den Aurora-DB-Cluster zu akzeptieren, treffen Sie eine neue Auswahl. Wählen Sie diese basierend auf den Subnetzen und Sicherheitsgruppen aus der von Ihnen ausgewählten VPC.

7. Sie müssen keine der Einstellungen für die Secrets Manager-Secrets ändern. Dieselben Anmeldeinformationen funktionieren für alle Endpunkte für Ihren Proxy, unabhängig davon, in welcher VPC sich jeder Endpunkt befindet.

8. Warten Sie, bis der neue Endpunkt den Status verfügbar erreicht.

9. Notieren Sie sich den vollständigen Endpunktnamen. Dies ist der Wert, der auf Region_name.rds.amazonaws.com endet, den Sie als Teil der Verbindungszeichenfolge für Ihre Datenbankanwendung angeben.

10. Greifen Sie auf den neuen Endpunkt von einer Ressource in derselben VPC wie der Endpunkt zu. Eine einfache Möglichkeit, diesen Prozess zu testen, besteht darin, eine neue EC2-Instance in dieser VPC zu erstellen. Melden Sie sich dann bei der EC2-Instance an und führen Sie die psql Befehle mysql oder aus, um eine Verbindung herzustellen, indem Sie den Endpunktwert in Ihrer Verbindungszeichenfolge verwenden.

Erstellen eines Proxy-Endpunktes

Konsole

So erstellen Sie einen Proxy-Endpunkt

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

2. Wählen Sie im Navigationsbereich Proxies (Proxys).

3. Klicken Sie auf den Namen des Proxys, für den Sie einen neuen Endpunkt erstellen möchten.

   Die Detailseite für diesen Proxy wird angezeigt.

4. Im Abschnitt Proxy-Endpunkte wählen Sie Proxy-Endpunkt erstellen.

   Das Fenster Proxy-Endpunkt erstellen wird angezeigt.

5. Für Name des Proxy-Endpunkts geben Sie einen beschreibenden Namen Ihrer Wahl ein.

6. Für Ziel-Rolle wählen Sie aus, ob der Endpunkt lese-/schreibgeschützt oder schreibgeschützt sein soll.

   Verbindungen, die Lese-/Schreibendpunkte verwenden, können jede Art von Operationen ausführen, z. B. Data Definition Language (DDL)-Anweisungen, Data Manipulation Language (DML)-Anweisungen und Abfragen. Diese Endpunkte stellen immer eine Verbindung mit der primären Instance des Aurora-Clusters her. Sie können Endpunkte mit Lese-/Schreibzugriff für allgemeine Datenbankoperationen verwenden, wenn Sie nur einen einzelnen Endpunkt in Ihrer Anwendung verwenden. Sie können auch Lese-/Schreibendpunkte für administrative Vorgänge, Online Transaction Processing (OLTP)-Anwendungen und extract-transform-load (ETL)-Aufträge verwenden.

   Verbindungen, die einen schreibgeschützten Endpunkt verwenden, können nur Abfragen durchführen. Wenn es mehrere Reader-Instances im Aurora-Cluster gibt, kann RDS-Proxy für jede Verbindung mit dem Endpunkt eine andere Reader-Instance verwenden. Auf diese Weise kann eine abfrageintensive Anwendung die Clustering-Fähigkeit von Aurora nutzen. Sie können dem Cluster mehr Abfragekapazität hinzufügen, indem Sie weitere Reader-DB-Instances hinzufügen. Diese schreibgeschützten Verbindungen verursachen keinen Overhead für die primäre Instance des Clusters. Auf diese Weise verlangsamen Ihre Berichts- und Analyseabfragen die Schreibvorgänge Ihrer OLTP-Anwendungen nicht.

7. Wählen Sie für Virtual Private Cloud (VPC) die Standardeinstellung für den Zugriff auf den Endpunkt von denselben EC2-Instances oder anderen Ressourcen aus, die normalerweise für den Zugriff auf den Proxy oder die zugehörige Datenbank verwenden. Wenn Sie den VPC-übergreifenden Zugriff für diesen Proxy einrichten möchten, wählen Sie eine andere VPC als die Standard-VPC aus. Weitere Informationen zum VPC-übergreifenden Zugriff finden Sie unter Zugreifen auf Aurora-Datenbanken über VPCs hinweg.

8. Für Subnetze füllt RDS Proxy standardmäßig dieselben Subnetze wie der zugehörige Proxy aus. Um den Zugriff auf den Endpunkt auf einen Teil des Adressbereichs der VPC zu beschränken, der eine Verbindung herstellen kann, entfernen Sie ein oder mehrere Subnetze.

9. Für die VPC-Sicherheitsgruppe können Sie eine vorhandene Sicherheitsgruppe auswählen oder eine neue erstellen. Standardmäßig füllt RDS Proxy dieselbe Sicherheitsgruppe oder Gruppen wie der zugehörige Proxy aus. Wenn die eingehenden und ausgehenden Regeln für den Proxy für diesen Endpunkt geeignet sind, behalten Sie die Standardauswahl bei.

   Wenn Sie eine neue Sicherheitsgruppe erstellen möchten, geben Sie auf dieser Seite einen Namen für die Sicherheitsgruppe an. Bearbeiten Sie dann die Sicherheitsgruppeneinstellungen später über die EC2-Konsole.

10. Wählen Sie Proxy-Endpunkt erstellen.

AWS CLI

Verwenden Sie den AWS CLI create-db-proxy-endpoint Befehl , um einen Proxy-Endpunkt zu erstellen.

Nutzen Sie die folgenden erforderlichen Parameter:

• --db-proxy-name value

• --db-proxy-endpoint-name value

• --vpc-subnet-ids list_of_ids. Trennen Sie die Subnetz-IDs durch Leerzeichen Sie geben die ID der VPC selbst nicht an.

Sie können auch die folgenden optionalen Parameter angeben:

• --target-role { READ_WRITE | READ_ONLY }. Dieser Parameter lautet standardmäßig READ_WRITE. Der Wert READ_ONLY hat nur Auswirkungen auf von Aurora bereitgestellte Cluster, die eine oder mehrere Reader-DB-Instances enthalten. Wenn der Proxy einem Aurora-Cluster zugeordnet ist, der nur eine Writer-DB-Instance enthält, können Sie nicht angebenREAD_ONLY. Weitere Informationen zur beabsichtigten Verwendung von schreibgeschützten Endpunkten mit Aurora-Clustern finden Sie unter Verwenden von Reader-Endpunkten mit Aurora-Clustern .

• --vpc-security-group-ids value. Trennen Sie die Sicherheitsgruppen-IDs durch Leerzeichen Wenn Sie diesen Parameter weglassen, verwendet RDS Proxy die Standardsicherheitsgruppe für die VPC. RDS-Proxy bestimmt die VPC basierend auf den Subnetz-IDs, die Sie für die --vpc-subnet-ids-Parameter angeben.

Beispiel

Im folgenden Beispiel wird ein Proxy-Endpunkt mit dem Namen erstell my-endpoint.

Für Linux, macOSoder Unix:

aws rds create-db-proxy-endpoint \
  --db-proxy-name my-proxy \
  --db-proxy-endpoint-name my-endpoint \
  --vpc-subnet-ids subnet_id subnet_id subnet_id ... \
  --target-role READ_ONLY \
  --vpc-security-group-ids security_group_id ]

Windows:

aws rds create-db-proxy-endpoint ^
  --db-proxy-name my-proxy ^
  --db-proxy-endpoint-name my-endpoint ^
  --vpc-subnet-ids subnet_id_1 subnet_id_2 subnet_id_3 ... ^
  --target-role READ_ONLY ^
  --vpc-security-group-ids security_group_id

RDS-API

Um einen Proxy-Endpunkt zu erstellen, verwenden Sie die RDS-API-Aktion CreateDBProxyEndpoint.

Anzeigen von Proxy-Endpunkten

Konsole

Anzeigen der Details für einen Proxy-Endpunkt

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

2. Wählen Sie im Navigationsbereich Proxies (Proxys).

3. Wählen Sie in der Liste den Proxy aus, dessen Endpunkt Sie anzeigen möchten. Klicken Sie auf den Proxy-Namen, um die Detailseite anzuzeigen.

4. Wählen Sie im Abschnitt Proxy-Endpunkte den Endpunkt aus, den Sie anzeigen möchten. Klicken Sie auf seinen Namen, um die Detailseite aufzurufen.

5. Untersuchen Sie die Parameter, für deren Werten Sie sich interessieren. Sie können Eigenschaften wie die Folgenden überprüfen:

   • Ob der Endpunkt lese-/schreibgeschützt oder schreibgeschützt ist.

   • Die Endpunkt-Adresse, die Sie in einer Datenbank-Verbindungszeichenfolge verwenden.

   • Die VPC-Subnetze und -Sicherheitsgruppen, die einem Endpunkt zugeordnet sind.

AWS CLI

Um einen oder mehrere Proxy-Endpunkte anzuzeigen, verwenden Sie den AWS CLI describe-db-proxy-endpoints Befehl .

Sie können die folgenden optionalen Parameter angeben:

• --db-proxy-endpoint-name

• --db-proxy-name

Das folgende Beispiel beschreibt den my-endpoint-Proxy-Endpunkt.

Beispiel

Für Linux, macOSoder Unix:

aws rds describe-db-proxy-endpoints \
  --db-proxy-endpoint-name my-endpoint

Windows:

aws rds describe-db-proxy-endpoints ^
  --db-proxy-endpoint-name my-endpoint

RDS-API

Um einen oder mehrere Proxy-Endpunkte zu beschreiben, verwenden Sie die RDS-API-Operation DescribeDBProxyEndpoints.

Ändern eines Proxy-Endpunkts

Konsole

So ändern Sie einen oder mehrere Proxy-Endpunkte

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-RDS-Konsole unter https://console.aws.amazon.com/rds/.

2. Wählen Sie im Navigationsbereich Proxies (Proxys).

3. Wählen Sie in der Liste den Proxy aus, dessen Endpunkt Sie ändern möchten. Klicken Sie auf den Proxy-Namen, um dessen anzuzeigen

4. Wählen Sie m Abschnitt Proxy-Endpunkte den Endpunkt aus, den Sie ändern möchten. Sie können ihn in der Liste auswählen oder auf seinen Namen klicken, um die Detailseite anzuzeigen.

5. Auf der Seite mit den Proxy-Details unter dem Abschnitt Proxy-Endpunkte wählen Sie Bearbeiten. Oder wählen Sie auf der Detailseite des Proxy-Endpunkts für Aktionen die Option Bearbeiten aus.

6. Ändern Sie wie gewünscht die Werte der Parameter.

7. Wählen Sie Save Changes.

AWS CLI

Um einen Proxy-Endpunkt zu ändern, verwenden Sie den AWS CLI modify-db-proxy-endpoint Befehl mit den folgenden erforderlichen Parametern:

• --db-proxy-endpoint-name

Geben Sie Änderungen in den Endpunkteigenschaften an, indem Sie einen oder mehrere der folgenden Parameter verwenden:

• --new-db-proxy-endpoint-name

• --vpc-security-group-ids. Trennen Sie die Sicherheitsgruppen-IDs durch Leerzeichen

Das folgende Beispiel benennt den my-endpoint-Proxy-Endpunkt in new-endpoint-name.

Beispiel

Für Linux, macOSoder Unix:

aws rds modify-db-proxy-endpoint \
  --db-proxy-endpoint-name my-endpoint \
  --new-db-proxy-endpoint-name new-endpoint-name

Windows:

aws rds modify-db-proxy-endpoint ^
  --db-proxy-endpoint-name my-endpoint ^
  --new-db-proxy-endpoint-name new-endpoint-name

RDS-API

Um einen Proxy-Endpunkt zu ändern, verwenden Sie die RDS-API-Operation ModifyDBProxyEndpoint.

Löschen eines Proxy-Endpunkts

Sie können einen Endpunkt für Ihren Proxy löschen, indem Sie die Konsole, wie im Folgenden beschrieben, verwenden.

Anmerkung

Sie können nicht den Standard-Proxy-Endpunkt löschen, den RDS Proxy automatisch für jeden Proxy erstellt.

Wenn Sie einen Proxy löschen, löscht RDS Proxy automatisch alle zugehörigen Endpunkte.

Konsole

So löschen Sie einen Proxy-Endpunkt mit AWS Management Console

1. Wählen Sie im Navigationsbereich Proxies (Proxys).

2. Wählen Sie in der Liste den Proxy aus, dessen Endpunkt Sie löschen möchten. Klicken Sie auf den Proxy-Namen, um die Detailseite anzuzeigen.

3. Im Abschnitt Proxy-Endpunkte den Endpunkt aus, den Sie löschen möchten. Sie können einen oder mehrere Endpunkte in der Liste auswählen oder auf den Namen eines einzelnen Endpunkts klicken, um die Detailseite anzuzeigen.

4. Auf der Seite mit den Proxy-Details unter dem Abschnitt Proxy-Endpunkte, wählen Sie Löschen. Oder wählen Sie auf der Detailseite des Proxy-Endpunkts für Aktionen die Option Löschen aus.

AWS CLI

Um einen Proxy-Endpunkt zu löschen, führen Sie den delete-db-proxy-endpoint Befehl mit den folgenden erforderlichen Parametern aus:

• --db-proxy-endpoint-name

Der folgende Befehl löscht den Proxy-Endpunkt mit dem Namen my-endpoint.

Für Linux, macOSoder Unix:

aws rds delete-db-proxy-endpoint \
  --db-proxy-endpoint-name my-endpoint

Windows:

aws rds delete-db-proxy-endpoint ^
  --db-proxy-endpoint-name my-endpoint

RDS-API

Um einen Proxy-Endpunkt mit der RDS-API zu löschen, führen Sie die Operation DeleteDBProxyEndpoint aus. Geben Sie den Namen des Proxy-Endpunkts für den DBProxyEndpointName-Parameter an.

Limits für Proxy-Endpunkte

RDS Proxy-Endpunkte haben die folgenden Einschränkungen:

• Jeder Proxy hat einen Standard-Endpunkt, den Sie ändern, aber nicht erstellen oder löschen können.

• Die maximale Anzahl von benutzerdefinierten Endpunkten für einen Proxy beträgt 20. Daher kann ein Proxy bis zu 21 Endpunkte haben: den Standard-Endpunkt plus 20, die Sie erstellen.

• Wenn Sie zusätzliche Endpunkte mit einem Proxy verknüpfen, bestimmt RDS Proxy automatisch, welche DB-Instances in Ihrem Cluster für jeden Endpunkt verwendet werden. Sie können bestimmte Instances nicht so auswählen, wie Sie es mit benutzerdefinierten Aurora-Endpunkten können.

• Reader-Endpunkte sind nicht verfügbar für Aurora-Multi-Writer-Cluster.