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.
Zugreifen auf Aurora DSQL mit Clients PostgreSQL-compatible
Aurora DSQL verwendet das PostgreSQL-Wire-Protokoll
| PostgreSQL | Aurora DSQL | Hinweise |
|---|---|---|
| Rolle (auch Benutzer oder Gruppe genannt) | Datenbankrolle | Aurora DSQL erstellt eine Rolle für Sie mit dem Namen admin. Wenn Sie benutzerdefinierte Datenbankrollen erstellen, müssen Sie die admin-Rolle verwenden, um sie IAM-Rollen für die Authentifizierung zuzuordnen, wenn Sie eine Verbindung zu Ihrem Cluster herstellen. Weitere Informationen finden Sie unter Verwenden von Datenbankrollen und IAM-Authentifizierung. |
| Host (auch hostname oder hostspec genannt) | Cluster-Endpunkt | Aurora DSQL-Einzelregions-Cluster bieten einen einzigen verwalteten Endpunkt und leiten den Datenverkehr automatisch um, falls es innerhalb der Region zu einer Nichtverfügbarkeit kommt. |
| Port | N/A — Standard verwenden 5432 |
Dies ist der PostgreSQL-Standard. |
| Datenbank (dbname) | postgres verwenden |
Aurora DSQL erstellt diese Datenbank für Sie, wenn Sie den Cluster erstellen. |
| SSL-Modus | SSL ist immer serverseitig aktiviert | In Aurora DSQL unterstützt Aurora DSQL den SSL-Modus require. Verbindungen ohne SSL werden von Aurora DSQL abgelehnt. |
| Passwort | Authentifizierungstoken | Aurora DSQL erfordert temporäre Authentifizierungstokens anstelle von dauerhaft gültigen Passwörtern. Weitere Informationen hierzu finden Sie unter Generieren eines Authentifizierungstokens in Amazon Aurora DSQL. |
Beim Herstellen einer Verbindung benötigt Aurora DSQL anstelle eines herkömmlichen Passworts ein signiertes IAM-Authentifizierungstoken. Diese temporären Token werden mit AWS Signature Version 4 generiert und nur beim Verbindungsaufbau verwendet. Sobald die Verbindung hergestellt ist, bleibt die Sitzung aktiv, bis sie endet oder der Client die Verbindung trennt.
Wenn Sie versuchen, eine neue Sitzung mit einem abgelaufenen Token zu öffnen, schlägt die Verbindungsanforderung fehl und es muss ein neues Token generiert werden. Weitere Informationen finden Sie unter Generieren eines Authentifizierungstokens in Amazon Aurora DSQL.
Unterstützte Sitzungsparameter
Aurora DSQL optimiert automatisch Speicher, Verbindungsmanagement und Transaktionsverarbeitung, sodass es einen bestimmten Satz von Sitzungsparametern unterstützt. Aurora DSQL akzeptiert die in der folgenden Tabelle aufgeführten Parameter. Parameter außerhalb dieses Satzes geben den folgenden Fehler zurück:
ERROR: setting configuration parameter "parameter_name" not supported
Aurora DSQL unterstützt die folgenden PostgreSQL-Sitzungsparameter. Sofern nicht anders angegeben, können Sie diese mithilfe von SETSET SESSION, oder als Verbindungszeichenfolgenoptionen festlegen. Sie können diese Option auch verwendenSET LOCAL, um jeden dieser Parameter für die Dauer einer einzelnen Transaktion festzulegen. Wird verwendetRESET, um einen Parameter auf seinen Standardwert zurückzusetzen.
| Parameter | Kategorie | Description |
|---|---|---|
application_name |
Identifizierung des Kunden | Legt den in den Verbindungsmetadaten angegebenen Anwendungsnamen fest. Nützlich für die Identifizierung von Verbindungen bei der Überwachung. |
client_encoding |
Lokalisierung | Legt die clientseitige Zeichenkodierung fest. Die Datenbank verwendet UTF-8 intern. |
datestyle |
Formatierung der Ausgabe | Legt das Anzeigeformat für Datums- und Uhrzeitwerte fest (z. B.ISO, MDY). |
extra_float_digits |
Formatierung der Ausgabe | Legt die Anzahl der Stellen fest, die für Gleitkommawerte angezeigt werden. Einige Treiber, z. B. JDBC, verwenden diesen Parameter. |
intervalstyle |
Formatierung der Ausgabe | Legt das Anzeigeformat für Intervallwerte fest. |
timezone |
Lokalisierung | Legt die Zeitzone für die Sitzung fest. Aurora DSQL speichert alle zeitzonenspezifischen Datums- und Uhrzeitangaben intern in UTC. Dieser Parameter steuert, wie Aurora DSQL dem Client Werte anzeigt. |
search_path |
Schemaauflösung | Legt die Schemasuchreihenfolge für unqualifizierte Objektnamen fest. |
enable_bitmapscan |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Bitmap-Scan-Plantypen durch den Abfrageplaner. |
enable_hashjoin |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Hash-Join-Plantypen durch den Abfrageplaner. |
enable_indexonlyscan |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Plantypen, die nur für Indexscans verwendet werden, durch den Abfrageplaner. |
enable_indexscan |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Indexscan-Plantypen durch den Abfrageplaner. |
enable_material |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung der Materialisierung durch den Abfrageplaner. |
enable_mergejoin |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Merge-Join-Plantypen durch den Abfrageplaner. |
enable_nestloop |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung von Nested-Loop-Join-Plänen durch den Abfrageplaner. |
enable_seqscan |
Abfrageplaner | Aktiviert oder deaktiviert die Verwendung sequentieller Scanplantypen durch den Abfrageplaner. |
disable_sync_create_index |
Aurora DSQL-specific | Steuert, ob asynchron CREATE INDEX ausgeführt wird. Die Standardeinstellung iston, was bedeutet, dass Aurora DSQL Indizes asynchron erstellt. Wird auf gesetzt, off um Indizes synchron für leere Tabellen zu erstellen. |
role |
Identität der Sitzung | Legt die aktuelle Rolle fest. In Aurora DSQL können Sie diesen Parameter nur SET LOCAL innerhalb eines Transaktionsblocks festlegen. |
Aurora DSQL verwaltet automatisch die folgenden Aspekte Ihrer Datenbank, sodass Sie die entsprechenden PostgreSQL-Sitzungsparameter nicht konfigurieren müssen:
-
Verbindungs- und Netzwerkparameter — Aurora DSQL verwaltet den Verbindungslebenszyklus und die TCP-Einstellungen intern
tcp_keepalives_idle, einschließlichtcp_keepalives_interval, undtcp_keepalives_count. -
Speicher- und Ressourcenparameter — Aurora DSQL verwaltet automatisch die Speicherzuweisung, einschließlich
work_memundshared_buffers. -
Timeout-Parameter — Aurora SQL setzt seine eigenen Beschränkungen für die Transaktionsdauer durch, einschließlich
statement_timeout, undlock_timeout.idle_in_transaction_session_timeout -
Replikations- und WAL-Parameter — Aurora DSQL verarbeitet die Replikation automatisch über seine integrierte Multiregions-Architektur, einschließlich
wal_levelund.synchronous_commit -
Protokollierungsparameter — Aurora DSQL verwaltet die Protokollierung intern, einschließlich
log_statementundclient_min_messages. -
Transaktionsparameter — Aurora DSQL verwendet eine feste
REPEATABLE READIsolationsstufe für alle Transaktionen. Wenn Ihr Treiber die Angabe einer Isolationsstufe erfordert, verwenden SieBEGIN ISOLATION LEVEL REPEATABLE READ.
Greifen Sie mithilfe von SQL-Clients auf Aurora DSQL zu
Aurora DSQL unterstützt mehrere PostgreSQL-compatible Clients für die Verbindung zu Ihrem Cluster. In den folgenden Abschnitten wird beschrieben, wie Sie mithilfe von PostgreSQL mit AWS CloudShell oder Ihrer lokalen Befehlszeile sowie GUI-based Tools wie DBeaver und eine Verbindung herstellen. JetBrains DataGrip Jeder Client benötigt ein gültiges Authentifizierungstoken, wie im vorherigen Abschnitt beschrieben.
Topics
Fehlerbehebung
Ablauf der Authentifizierungsdaten für die SQL-Clients
Bestehende Sitzungen bleiben für maximal 1 Stunde authentifiziert oder bis eine explizite Trennung oder ein clientseitiger Timeout erfolgt. Wenn neue Verbindungen hergestellt werden müssen, muss ein neues Authentifizierungstoken generiert und im Feld Passwort der Verbindung bereitgestellt werden. Der Versuch, eine neue Sitzung zu öffnen (z. B. um neue Tabellen aufzulisten oder eine neue SQL-Konsole zu öffnen), erzwingt einen neuen Authentifizierungsversuch. Ist das in den Verbindungseinstellungen konfigurierte Token nicht mehr gültig, schlägt die neue Sitzung fehl und alle zuvor geöffneten Sitzungen werden ungültig. Denken Sie daran, wenn Sie die Dauer Ihres IAM-Authentifizierungstokens mit der expires-in Option wählen, die standardmäßig auf 15 Minuten und auf einen Höchstwert von sieben Tagen festgelegt werden kann.
Weitere Informationen finden Sie im Abschnitt zur Fehlerbehebung in der Aurora DSQL-Dokumentation.
