Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Herstellen einer Verbindung zu einer DB-Instance, in der die PostgreSQL-Datenbank-Engine ausgeführt wird Wenn Amazon RDS Ihre DB-Instance bereitgestellt hat, können sie eine beliebige Standard-SQL-Client-Anwendung verwenden, um eine Verbindung zu der DB-Instance herzustellen. Bevor Sie eine Verbindung zu der DB-Instance herstellen können, muss diese verfügbar und zugänglich sein. Ob Sie sich von außerhalb der VPC mit der Instance verbinden können, hängt davon ab, wie Sie die Amazon-RDS-DB-Instance erstellt haben: + Wenn Sie Ihre DB-Instance als *öffentlich* erstellt haben, können sich Geräte und Amazon-EC2-Instances außerhalb der VPC mit Ihrer Datenbank verbinden. + Wenn Sie Ihre DB-Instance als *privat* erstellt haben, können sich nur Amazon-EC2-Instances und -Geräte innerhalb der Amazon VPC mit Ihrer Datenbank verbinden. Um zu überprüfen, ob Ihre DB-Instance öffentlich oder privat ist, verwenden AWS-Managementkonsole Sie die Registerkarte **Konnektivität und Sicherheit** für Ihre Instance. Unter **Security** (Sicherheit) finden Sie den Wert „Publicly accessible“ (Öffentlich zugänglich), mit „No“ (Nein) für privat und „Yes“ (Ja) für öffentlich. Weitere Informationen zu verschiedenen Amazon-RDS- und Amazon-VPC-Konfigurationen und deren Auswirkungen auf die Zugänglichkeit finden Sie unter [Szenarien für den Zugriff auf eine DB-Instance in einer VPC](USER_VPC.Scenarios.md). **Contents** + [ ## Installieren des psql-Clients ](#install-psql) + [ ## Suchen der Verbindungsinformationen für eine DB-Instance von RDS für PostgreSQL ](#postgresql-endpoint) + [ # Herstellen einer Verbindung zu einer RDS für PostgreSQL-DB-Instance mit pgAdmin ](USER_ConnectToPostgreSQLInstance.pgAdmin.md) + [ # Verwenden von psql zum Herstellen einer Verbindung mit Ihrer RDS für PostgreSQL-DB-Instance ](USER_ConnectToPostgreSQLInstance.psql.md) + [ # Herstellen einer Verbindung mit RDS für PostgreSQL mithilfe des JDBC-Treibers von Amazon Web Services (AWS) ](PostgreSQL.Connecting.JDBCDriver.md) + [ # Herstellen einer Verbindung mit RDS für PostgreSQL mithilfe des Python-Treibers von Amazon Web Services (AWS) ](PostgreSQL.Connecting.PythonDriver.md) + [ # Fehlerbehebung bei Verbindungen mit Ihrer RDS für PostgreSQL-Instance ](USER_ConnectToPostgreSQLInstance.Troubleshooting.md) + [ ## Fehler – FATAL: Datenbank *name* existiert nicht ](USER_ConnectToPostgreSQLInstance.Troubleshooting.md#USER_ConnectToPostgreSQLInstance.Troubleshooting-DBname) + [ ## Fehler – Keine Verbindung mit dem Server möglich: Zeitüberschreitung für die Verbindung ](USER_ConnectToPostgreSQLInstance.Troubleshooting.md#USER_ConnectToPostgreSQLInstance.Troubleshooting-timeout) + [ ## Fehler bei Zugriffsregeln für Sicherheitsgruppen ](USER_ConnectToPostgreSQLInstance.Troubleshooting.md#USER_ConnectToPostgreSQLInstance.Troubleshooting-AccessRules) ## Installieren des psql-Clients Wenn Sie von einer EC2-Instance aus eine Verbindung mit Ihrer DB-Instance herstellen möchten, können Sie einen PostgreSQL-Client auf der EC2-Instance installieren. Führen Sie zum Installieren der aktuellen Version des psql-Clients in Amazon Linux 2023 den folgenden Befehl aus: ``` sudo dnf install postgresql ``` Führen Sie zum Installieren der aktuellen Version des psql-Clients in Amazon Linux 2 den folgenden Befehl aus: ``` sudo yum install -y postgresql ``` Führen Sie zum Installieren der aktuellen Version des psql-Clients in Ubuntu den folgenden Befehl aus: ``` sudo apt install -y postgresql-client ``` ## Suchen der Verbindungsinformationen für eine DB-Instance von RDS für PostgreSQL Wenn die DB-Instance verfügbar und zugänglich ist, können Sie eine Verbindung herstellen, indem Sie der SQL-Clientanwendung die folgenden Informationen bereitstellen: + Der Endpunkt der DB-Instance, der als Hostname (DNS-Name) für die Instance dient. + Den Port, über den die DB-Instance kommuniziert. Der Standardport für PostgreSQL lautet 5432. + Den Benutzernamen und das Passwort für die DB-Instance. Der Standardwert „Haupt-Benutzername“ für PostgreSQL ist `postgres`. + Der Name und das Passwort der Datenbank (DB-Name). Sie können diese Details mithilfe des Befehls AWS-Managementkonsole, des AWS CLI [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html)Befehls oder der Amazon [DBInstancesRDS-API-Describe-Operation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) abrufen. **Um den Endpunkt, die Portnummer und den DB-Namen mit dem AWS-Managementkonsole** 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon RDS-Konsole unter [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Öffnen Sie die RDS-Konsole und wählen Sie **Databases (Datenbanken)**, um eine Liste Ihrer DB-Instances anzuzeigen. 1. Wählen Sie den Namen der PostgreSQL-DB-Instance, um deren Details anzuzeigen. 1. Kopieren Sie auf der Registerkarte **Connectivity & security (Anbindung und Sicherheit)** den Endpunkt. Notieren Sie sich auch die Portnummer. Sie benötigen sowohl den Endpunkt als auch die Portnummer, um die Verbindung zur DB-Instance herzustellen. ![\[Rufen Sie den Endpunkt von der RDS-Konsole ab\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/PostgreSQL-endpoint.png) 1. Notieren Sie auf der Registerkarte **Konfiguration** den DB-Namen. Wenn Sie eine Datenbank erstellt haben, als Sie die RDS für PostgreSQL-Instance erstellt haben, wird der Name unter DB-Name aufgeführt. Wenn Sie keine Datenbank erstellt haben, zeigt der DB-Name einen Bindestrich (‐) an. ![\[Rufen Sie den DB-Namen von der RDS-Konsole ab\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/PostgreSQL-db-name.png) Nachfolgend werden zwei Möglichkeiten gezeigt, eine Verbindung mit einer PostgreSQL-DB-Instance herzustellen. Im ersten Beispiel wird pgAdmin verwendet, ein beliebtes Open Source-Tool für die PostgreSQL-Administration und -Entwicklung. Im zweiten Beispiel wird psql verwendet, ein Befehlszeilen-Dienstprogramm, das in jeder PostgreSQL-Installation enthalten ist. # Herstellen einer Verbindung zu einer RDS für PostgreSQL-DB-Instance mit pgAdmin Sie können mit der Open-Source-Software pgAdmin eine Verbindung mit einer RDS für PostgreSQL-DB-Instance herstellen. Sie können pgAdmin von [http://www.pgadmin.org/](http://www.pgadmin.org/) herunterladen und instalieren, ohne über eine lokale PostgreSQL-Instance auf Ihrem Client-Computer zu verfügen. **So stellen Sie eine Verbindung zu Ihrer RDS für PostgreSQL-DB-Instance mit pgAdmin her** 1. Starten Sie die Anwendung pgAdmin auf Ihrem Client-Computer. 1. Klicken Sie auf der Registerkarte **Dashboard** auf **Add New Server** (Neuen Server hinzufügen). 1. Geben Sie im Dialogfeld **Create – Server** (Erstellen – Server) auf der Registerkarte **General** (Allgemein) einen Namen für den Server in pgAdmin ein. 1. Geben Sie auf der Registerkarte **Verbindung** die folgenden Informationen der DB-Instance ein: + Geben Sie unter **Host** den Endpunkt ein, z. B. `mypostgresql.c6c8dntfzzhgv0.us-east-2.rds.amazonaws.com`. + Geben Sie in das Feld **Port** den zugehörigen Port ein. + Geben Sie für **Benutzername** den Benutzernamen ein, den Sie beim Erstellen der DB-Instance eingegeben haben (wenn Sie den „Haupt-Benutzernamen“ vom Standardwert `postgres` geändert haben). + Geben Sie unter **Password (Passwort)** das beim Erstellen der DB-Instance festgelegte Passwort ein. ![\[Beim Erstellen der DB-Instance festgelegtes Passwort eingeben\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/Postgres-Connect01.png) 1. Wählen Sie **Speichern**. Falls Probleme beim Herstellen der Verbindung auftreten, lesen Sie die Informationen unter [Fehlerbehebung bei Verbindungen mit Ihrer RDS für PostgreSQL-Instance](USER_ConnectToPostgreSQLInstance.Troubleshooting.md). 1. Um im pgAdmin-Browser auf eine Datenbank zuzugreifen, erweitern Sie nacheinander den Knoten **Server**, die DB-Instance und den Knoten **Datenbanken**. Wählen Sie anschließend die gewünschte Datenbank in der DB-Instance aus. ![\[Namen der DB-Instance-Datenbank im pgAdmin-Browser auswählen\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/UserGuide/images/Postgres-Connect02.png) 1. Um einen Bereich zum Eingeben von SQL-Befehlen zu öffnen, klicken Sie auf **Tools**, **Query Tool** (Abfragetool). # Verwenden von psql zum Herstellen einer Verbindung mit Ihrer RDS für PostgreSQL-DB-Instance Sie können eine lokale Kopie des Befehlszeilenprogramms psql verwenden, um eine Verbindung mit einer RDS for PostgreSQL-DB-Instance herzustellen. Dazu muss entweder PostgreSQL oder der psql-Client auf dem Computer installiert sein. Sie können den PostgreSQL-Client von der [PostgreSQL](https://www.postgresql.org/download/)-Website herunterladen. Folgen Sie den Anweisungen für Ihr Betriebssystem, um diese Version zu installieren. Um über psql eine Verbindung zu Ihrer RDS for PostgreSQL-DB-Instance herzustellen, müssen Sie Hostinformationen (DNS), Zugangsdaten und den Namen der Datenbank angeben. Verwenden Sie eines der folgenden Formate, um eine Verbindung zu Ihrer RDS für PostgreSQL-DB-Instance herzustellen. Sie werden beim Verbinden zur Eingabe eines Passworts aufgefordert. Verwenden Sie in Stapelaufträgen oder Skripts die Option `--no-password`. Diese Option ist für die gesamte Sitzung festgelegt. **Anmerkung** Ein Verbindungsversuch mit `--no-password` schlägt fehl, wenn der Server eine Passwortauthentifizierung erfordert und ein Passwort aus anderen Quellen nicht verfügbar ist. Weitere Informationen finden Sie in der [PSQL-Dokumentation](https://www.postgresql.org/docs/13/app-psql.html). Wenn Sie sich zum ersten Mal mit dieser DB-Instance verbinden oder noch keine Datenbank für diese RDS for PostgreSQL-Instance erstellt haben, können Sie mit dem „Haupt-Benutzernamen“ und dem Passwort eine Verbindung zur **Postgres**-Datenbank herstellen. Verwenden Sie unter Unix das folgende Format. ``` psql \ --host= \ --port= \ --username= \ --password \ --dbname= ``` Verwenden Sie unter Windows das folgende Format. ``` psql ^ --host= ^ --port= ^ --username= ^ --password ^ --dbname= ``` Der folgende Befehl stellt beispielsweise eine Verbindung mit der Datenbank `mypgdb` in der PostgreSQL-DB-Instance `mypostgresql` her, wobei fiktive Anmeldeinformationen verwendet werden. ``` psql --host=mypostgresql.c6c8mwvfdgv0.us-west-2.rds.amazonaws.com --port=5432 --username=awsuser --password --dbname=mypgdb ``` # Herstellen einer Verbindung mit RDS für PostgreSQL mithilfe des JDBC-Treibers von Amazon Web Services (AWS) Der JDBC-Treiber für Amazon Web Services (AWS) ist als fortschrittlicher JDBC-Wrapper konzipiert. Dieser Wrapper ergänzt einen vorhandenen JDBC-Treiber und erweitert dessen Funktionen. Der Treiber ist Drop-In-kompatibel mit dem Community-pgJDBC-Treiber. Um den AWS JDBC-Treiber zu installieren, hängen Sie die JAR-Datei des AWS JDBC-Treibers an (befindet sich in der Anwendung`CLASSPATH`) und behalten Sie die Verweise auf den jeweiligen Community-Treiber bei. Aktualisieren Sie das jeweilige Verbindungs-URL-Präfix wie folgt: + `jdbc:postgresql://` auf `jdbc:aws-wrapper:postgresql://` Weitere Informationen zum AWS JDBC-Treiber und vollständige Anweisungen zu seiner Verwendung finden Sie im [Amazon Web Services (AWS) JDBC-Treiber-Repository](https://github.com/awslabs/aws-advanced-jdbc-wrapper). GitHub # Herstellen einer Verbindung mit RDS für PostgreSQL mithilfe des Python-Treibers von Amazon Web Services (AWS) Der Amazon Web Services (AWS)-Python-Treiber ist als fortschrittlicher Python-Wrapper konzipiert. Dieser Wrapper ergänzt den Open-Source-Treiber Psycopg und erweitert dessen Funktionen. Der AWS -Python-Treiber unterstützt Python-Version 3.8 und höher. Sie können das Paket `aws-advanced-python-wrapper` zusammen mit den Open-Source-Paketen `psycopg` mithilfe des Befehls `pip` installieren. Weitere Informationen zum AWS Python-Treiber und vollständige Anweisungen zu seiner Verwendung finden Sie im [ GitHub Python-Treiber-Repository von Amazon Web Services (AWS)](https://github.com/awslabs/aws-advanced-python-wrapper). # Fehlerbehebung bei Verbindungen mit Ihrer RDS für PostgreSQL-Instance **Topics** + [ ## Fehler – FATAL: Datenbank *name* existiert nicht ](#USER_ConnectToPostgreSQLInstance.Troubleshooting-DBname) + [ ## Fehler – Keine Verbindung mit dem Server möglich: Zeitüberschreitung für die Verbindung ](#USER_ConnectToPostgreSQLInstance.Troubleshooting-timeout) + [ ## Fehler bei Zugriffsregeln für Sicherheitsgruppen ](#USER_ConnectToPostgreSQLInstance.Troubleshooting-AccessRules) ## Fehler – FATAL: Datenbank *name* existiert nicht Wenn Sie bei der Verbindung einen Fehler wie `FATAL: database name does not exist` erhalten, versuchen Sie, den Standard-Datenbanknamen **postgres** für die Option `--dbname` zu verwenden. ## Fehler – Keine Verbindung mit dem Server möglich: Zeitüberschreitung für die Verbindung Wenn die Verbindung mit der DB-Instance nicht hergestellt werden kann, wird meistens der Fehler `Could not connect to server: Connection timed out.` angezeigt. Ist dies der Fall, gehen Sie wie folgt vor: + Prüfen Sie, ob der DB-Instance-Endpunkt als Hostname sowie die richtige Portnummer angegeben wurden. + Stellen Sie sicher, dass die öffentliche Zugänglichkeit der DB-Instance auf **Ja** festgelegt ist, um externe Verbindungen zuzulassen. Informationen zum Ändern der Einstellung **Öffentlicher Zugriff** finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). + Stellen Sie sicher, dass der Benutzer, der sich mit der Datenbank verbindet, CONNECT-Zugriff darauf hat. Sie können folgende Abfrage verwenden, um den CONNECT-Zugriff auf die Datenbank bereitzustellen. ``` GRANT CONNECT ON DATABASE database name TO username; ``` + Prüfen Sie, ob die der DB-Instance zugewiesene Sicherheitsgruppe die erforderlichen Regeln enthält, um den Zugriff durch alle vorhandenen Firewalls zu ermöglichen. Beispiel: Bei der Erstellung der DB-Instance wurde der Standardport 5432 festgelegt und die Firewall-Regeln des Unternehmens blockieren Verbindungen mit diesem Port von externen Unternehmensgeräten. Sie können dieses Problem beheben, indem Sie für die DB-Instance einen anderen Port verwenden. Stellen Sie außerdem sicher, dass die mit der DB-Instance verknüpfte Sicherheitsgruppe eingehende Verbindungen mit dem neuen Port zulässt. Informationen zum Ändern der Einstellung für **Datenbank-Port** finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). + Prüfen Sie, ob der Port, den Sie verwenden möchten, bereits von einer lokalen Instance von PostgreSQL oder einem anderen Service belegt ist, der auf Ihrem Computer ausgeführt wird. Wenn Sie beispielsweise eine lokale PostgreSQL-Datenbank auf demselben Port haben (Standard ist 5432), kann dies eine erfolgreiche Verbindung mit der DB-Instance von RDS für PostgreSQL verhindern. Stellen Sie sicher, dass der Port frei ist, oder versuchen Sie möglichst, eine Verbindung mit einer anderen Portnummer herzustellen. + Weitere Informationen finden Sie auch unter [Fehler bei Zugriffsregeln für Sicherheitsgruppen](#USER_ConnectToPostgreSQLInstance.Troubleshooting-AccessRules). ## Fehler bei Zugriffsregeln für Sicherheitsgruppen Die bei Weitem häufigsten Verbindungsprobleme treten in Verbindung mit den Zugriffsregeln der Sicherheitsgruppe auf, die der DB-Instance zugewiesen wurde. Wenn Sie bei der Erstellung der DB-Instance die Standard-Sicherheitsgruppe verwendet haben, ist es sehr wahrscheinlich, dass die Regeln in der Sicherheitsgruppe den Zugriff auf die Instance nicht zulassen. Damit die Verbindung möglich ist, muss die Sicherheitsgruppe, die Sie der DB-Instance bei der Erstellung zugewiesen haben, den Zugriff auf die DB-Instance zulassen. Wenn die DB-Instance beispielsweise in einer VPC erstellt wurde, muss sie über eine VPC-Sicherheitsgruppe verfügen, die die Verbindungen zulässt. Prüfen Sie, ob die DB-Instance mit einer Sicherheitsgruppe erstellt wurde, die keine Verbindungen vom Gerät oder von der Amazon EC2-Instance zulässt, auf dem bzw. der die Anwendung ausgeführt wird. Sie können eine Regel für eingehenden Datenverkehr in der Sicherheitsgruppe hinzufügen oder ändern. Die Auswahl der Option **My IP (Meine IP)** für **Source (Quelle)** ermöglicht Zugriff auf die DB-Instance von der IP-Adresse, die in Ihrem Browser erkannt wird. Weitere Informationen finden Sie unter [Ermöglichen des Zugriffs auf Ihre DB-Instance in der VPC durch Erstellen einer Sicherheitsgruppe](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup). Wurde die DB-Instance außerhalb einer VPC erstellt, muss sie über eine Datenbank-Sicherheitsgruppe verfügen, die diese Verbindungen zulässt. Weitere Informationen zu Amazon-RDS-Sicherheitsgruppen finden Sie unter [Zugriffskontrolle mit Sicherheitsgruppen](Overview.RDSSecurityGroups.md).