PostgreSQL-Verbindungszeichenfolgen-Generator
Eine PostgreSQL-Verbindungs-URI, eine libpq-Schlüssel/Wert-Zeichenfolge, eine Npgsql-Zeichenfolge (ADO.NET), eine JDBC-URL und mehr in einem Formular erstellen oder eine davon einfügen, um zu sehen, was jeder Parameter bewirkt und ob sslmode dich wirklich schützt. Alles läuft in deinem Browser: Nichts, was du eingibst, wird irgendwohin gesendet.
Diese Verbindung in SQLly öffnen
Öffnet den Verbindungseditor von SQLly mit vorausgefüllten Angaben.
Diese Verbindung in SQLly öffnen
Privat von Grund auf. Der Builder und der Decoder sind einfaches JavaScript, das in diesem Tab läuft. Die Seite sendet keine Anfrage mit dem, was du eingibst, speichert nichts (nicht einmal in deinem Browser) und funktioniert weiter offline, sobald sie geladen ist. Der Link „In SQLly öffnen“ geht direkt von deinem Browser zur App auf deinem Computer.
PostgreSQL-Verbindungszeichenfolgenformate
Die meisten PostgreSQL-Treiber basieren auf libpq oder übernehmen dessen Regeln, daher funktionieren die URI postgresql://user:password@host:5432/db?sslmode=verify-full und die Schlüssel/Wert-Form host=... dbname=... funktionieren fast überall: psql, psycopg, pgx, lib/pq, node-postgres. Npgsql (.NET) und pgJDBC (Java) haben ihre eigenen Schreibweisen.
Der wichtigste Parameter ist sslmode. Standardmäßig, preferverwendet TLS, wenn der Server es anbietet, prüft aber niemals das Zertifikat und fällt stillschweigend auf Klartext zurück. Nur verify-full prüft sowohl die Zertifikatskette als auch den Hostnamen.
URI libpq, psql, psycopg, pgx, node-postgres, Prisma
postgresql://app_user:[email protected]/sales?sslmode=verify-full
Schlüssel/Wert libpq conninfo, psycopg, pgx, lib/pq
host=db.example.com dbname=sales user=app_user password=your_password sslmode=verify-full
ADO.NET (Npgsql) Npgsql, Entity Framework Core
Host=db.example.com;Database=sales;Username=app_user;Password=your_password;SSL Mode=VerifyFull
JDBC PostgreSQL JDBC-Treiber (pgJDBC)
jdbc:postgresql://db.example.com/sales?user=app_user&password=your_password&sslmode=verify-full
ODBC psqlODBC
Driver={PostgreSQL Unicode};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SSLmode=verify-full;
SQLAlchemy-URL Python SQLAlchemy mit psycopg 3
postgresql+psycopg://app_user:[email protected]/sales?sslmode=verify-full
Mehrere Hosts (Failover) libpq 10+, pgx, Npgsql, pgJDBC
postgresql://[email protected]:5432,db2.example.com:5432/sales?target_session_attrs=read-write
Platzhalter wie your_password sind genau das: Stell deine eigene Verbindungszeichenfolge mit dem Formular oben zusammen. Mehr dazu, wie du SQLly mit PostgreSQL verbindest: SQLly für PostgreSQL.
libpq-Parameter (URI und Schlüssel/Wert)
URI-Format: postgresql://[user[:password]@][host][:port][,...][/dbname][?param=value&...] (postgres:// funktioniert auch); Sonderzeichen prozentkodieren, einschließlich der Schrägstriche eines Unix-Socket-Pfads, der als Host verwendet wird. Schlüssel/Wert-Form: key=value Paare durch Leerzeichen trennen; einen Wert, der leer ist oder Leerzeichen enthält, in einfache Anführungszeichen setzen, und schreiben \' und \\ für ein Anführungszeichen oder Backslash darin.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
host |
- | Unix-Socket in /tmp (localhost unter Windows) | Hostname, IP oder ein Verzeichnis für einen Unix-Socket. Eine durch Kommas getrennte Liste wird der Reihe nach ausprobiert. |
hostaddr |
- | - | Numerische IP, DNS wird übersprungen (der Host wird weiterhin für TLS-Prüfungen verwendet). |
port |
- | 5432 (Build-Standard) | Ein Port, oder einer pro Host. |
dbname |
- | der Benutzername | Datenbank, zu der du dich verbindest. |
user |
- | der Betriebssystembenutzer | Rolle, unter der sich verbunden wird. |
password |
- | - | Besser aufzubewahren in ~/.pgpass (oder PGPASSWORD) als in der Zeichenkette. |
passfile |
- | ~/.pgpass (%APPDATA%\postgresql\pgpass.conf unter Windows) | Passwortdatei. |
connect_timeout |
- | 0 (endlos warten) | Sekunden pro Host. PostgreSQL 16 und älter behandelt 1 als 2. |
sslmode |
- | bevorzugen | disable, allow, prefer, require, verify-ca, verify-full. require überprüft die CA nur, wenn eine Root-Zertifikatdatei vorhanden ist; nur verify-full prüft den Hostnamen. |
sslrootcert |
- | ~/.postgresql/root.crt | CA-Datei. system (16+) verwendet die vertrauenswürdigen CAs des Betriebssystems und macht verify-full die Standardeinstellung. |
sslcert / sslkey |
- | ~/.postgresql/postgresql.crt / .key | Client-Zertifikat und Schlüssel. |
sslnegotiation |
- | postgres | 17+. direct startet TLS sofort (benötigt sslmode require oder stärker). |
application_name |
- | - | Angezeigt in pg_stat_activity und dem Serverprotokoll. |
options |
- | - | Servereinstellungen beim Start, z. B. -c statement_timeout=30000 -c search_path=app. |
target_session_attrs |
- | beliebig | any, read-write, read-only, primary, standby, prefer-standby. |
load_balance_hosts |
- | deaktivieren | 16+. random mischt die Hostliste. |
keepalives |
- | 1 | TCP-Keepalives ein/aus; anpassen mit keepalives_idle, keepalives_interval, keepalives_count. |
channel_binding |
- | bevorzugen | require weigert sich, ohne SCRAM-Kanalbindung zu authentifizieren. |
Npgsql (ADO.NET) Parameter
Npgsql verwendet ADO.NET Key=Value; Syntax mit eigenen Schlüsselwortnamen. Anführungszeichen für Werte mit ; mit doppelten Anführungszeichen.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
Host |
Server | - (erforderlich) | Hostname, IP, eine durch Komma getrennte Liste oder ein Socket-Verzeichnis beginnend mit /. |
Port |
- | 5432 | TCP-Port. |
Database |
DB | der Benutzername | Datenbankname. |
Username |
Benutzername, Benutzer-ID, UID | PGUSER, sonst der OS-Benutzer | Rollenname. |
Password |
PSW, PWD | PGPASSWORD | Passwort. |
SSL Mode |
SslMode | Bevorzugen | Disable, Allow, Prefer, Require, VerifyCA, VerifyFull. Seit Npgsql 6, Require überprüft das Zertifikat nicht. |
Trust Server Certificate |
- | falsch | Validierung überspringen. Npgsql 6 und 7 verlangten das mit Require; Npgsql 8 tut dies nicht. |
Root Certificate |
- | PGSSLROOTCERT | CA-Datei für VerifyCA / VerifyFull. |
Timeout |
- | 15 | Sekunden, um auf eine Verbindung zu warten. |
Command Timeout |
- | 30 | Standard-Timeout für Befehle in Sekunden; 0 wartet unbegrenzt. |
Application Name |
- | PGAPPNAME | application_name. |
Search Path |
- | - | Schema-Suchpfad. |
Target Session Attributes |
- | beliebig | any, primary, standby, prefer-primary, prefer-standby, read-write, read-only. |
Pooling |
- | wahr | Verbindungs-Pooling. |
Maximum Pool Size |
- | 100 | Größter Pool. |
Minimum Pool Size |
- | 0 | Kleinster Pool. |
Keepalive |
- | 0 (aus) | Sekunden zwischen Keepalive-Abfragen. |
Include Error Detail |
- | falsch | Übernimmt Serverfehlerdetails, die Zeilendaten enthalten können, in Ausnahmemeldungen. |
pgJDBC-Eigenschaften
URL-Format: jdbc:postgresql://host:port/database?property=value&.... pgJDBC ignoriert user:password@ in der URL: Übergib user und password als Parameter oder Verbindungseigenschaften.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
user / password |
- | - | Zugangsdaten. |
sslmode |
- | bevorzugen | Gleiche Werte wie bei libpq. require, allow und prefer validieren das Zertifikat nicht. |
ssl |
- | falsch | true ohne sslmode bedeutet verify-full. |
sslrootcert |
- | ~/.postgresql/root.crt | CA-Datei. |
connectTimeout |
- | 10 | Sekunden, um auf den Socket zu warten; 0 deaktiviert das Limit. |
socketTimeout |
- | 0 | Sekunden, die ein Lesevorgang blockieren kann; 0 wartet unbegrenzt. |
loginTimeout |
- | 0 | Sekunden, um auf den gesamten Login zu warten. |
ApplicationName |
- | PostgreSQL JDBC-Treiber | application_name. |
currentSchema |
- | - | search_path, durch Kommas getrennt. |
targetServerType |
- | beliebig | any, primary, secondary, preferPrimary, preferSecondary. |
options |
- | - | Startoptionen, z. B. -c statement_timeout=30000 (prozentkodiert in der URL). |
Häufige PostgreSQL-Verbindungsfehler
FATAL: no pg_hba.conf entry for host "10.0.0.7", user "app_user", database "sales", no encryption
Warum: Der Server wurde erreicht, aber keine Zeile in pg_hba.conf erlaubt diesen Client, Benutzer und diese Datenbank, oder die passende Zeile ist hostssl und deine Verbindung kam ohne TLS („keine Verschlüsselung“) zustande.
Lösung: Verbinden mit sslmode=require oder stärker, wenn der Server TLS erwartet, oder den Administrator bitten, eine host/hostssl Zeile für deine Adresse hinzuzufügen und den Server neu zu laden.
connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused
Warum: An dieser Adresse und diesem Port lauscht nichts: Der Server läuft nicht, listen_addresses deckt nur localhost ab, der Port ist ein anderer oder eine Firewall lehnt die Verbindung ab.
Lösung: Prüfen listen_addresses und port in postgresql.conf, der Firewall oder der Cloud-Sicherheitsgruppe, und ob du einen anderen Port brauchst (verwaltete Dienste und Pooler nutzen oft 6432 oder einen eigenen Port).
FATAL: password authentication failed for user "app_user"
Warum: Falsches Passwort, eine Rolle ohne Passwort oder ein Sonderzeichen im Passwort, das in der URI nicht prozentkodiert wurde, sodass der Treiber ein anderes Passwort gelesen hat.
Lösung: Prüfe das Passwort; kodiere in einer URI @ als %40, : als %3A, / als %2F und % als %25. Füge die URI in den Decoder ein, um genau zu sehen, welches Passwort der Treiber senden wird.
server does not support SSL, but SSL was required
Warum: Die Zeichenfolge fragt nach sslmode=require (oder verify-ca / verify-full) und der Server hat ssl = off.
Lösung: Schalte TLS auf dem Server ein oder verbinde dich mit dem TLS-Endpunkt, den dein Anbieter dokumentiert. Weiche nicht zurück auf sslmode=disable über ein Netzwerk, das du nicht kontrollierst.
root certificate file "/home/app/.postgresql/root.crt" does not exist
Warum: sslmode=verify-ca oder verify-full benötigt ein CA-Zertifikat zum Überprüfen, und libpq hat keines am Standardpfad gefunden.
Lösung: Lade das CA-Bündel deines Anbieters herunter und setze sslrootcert=/path/to/ca.pem, oder verwende bei Clients ab PostgreSQL 16+ sslrootcert=system wenn das Serverzertifikat von einer öffentlichen CA stammt.
FATAL: database "app_user" does not exist
Warum: Nein dbname wurde angegeben, daher verwendete libpq den Benutzernamen als Datenbanknamen.
Lösung: Füge die Datenbank in den URI-Pfad ein (/sales) oder setze dbname=sales.
invalid connection option "sslmod"
Warum: libpq lehnt die gesamte Zeichenkette ab, wenn ein Schlüsselwort falsch geschrieben ist oder zu einem anderen Treiber gehört (zum Beispiel ApplicationName von pgJDBC anstelle von application_name).
Lösung: Korrigiere die Schreibweise. Der Decoder listet jeden libpq-Parameter auf und markiert unbekannte.
PostgreSQL-Verbindungszeichenfolgen-FAQ
Wie lautet das Format der PostgreSQL-Verbindungszeichenfolge?
Zwei Formen funktionieren mit libpq-basierten Treibern: die URI postgresql://user:password@host:5432/dbname?sslmode=verify-full und die Schlüsselwort/Wert-Zeichenfolge host=host port=5432 dbname=dbname user=user sslmode=verify-full. Npgsql verwendet Host=...;Database=...;Username=... und Java verwendet jdbc:postgresql://host:5432/dbname.
Welchen sslmode sollte ich verwenden?
verify-full mit sslrootcert zeigt auf Ihre CA (oder system unter PostgreSQL 16+). require verschlüsselt, prüft jedoch nicht, wer geantwortet hat, und preferdas Standard, kann stillschweigend auf Klartext zurückfallen. Verwenden Sie disable nur für eine Socket- oder localhost-Verbindung.
Wie maskiere ich Sonderzeichen in einer PostgreSQL-URI?
Diese Sonderzeichen im Benutzernamen, im Passwort und in der Datenbank prozentkodieren: @ ist %40, : ist %3A, / ist %2F, # ist %23, ? ist %3F, % ist %25 und ein Leerzeichen ist %20. Die Schlüsselwort/Wert-Form vermeidet das meiste davon: setze den Wert in einfache Anführungszeichen und maskiere ' und \ mit einem Backslash.
Wie setze ich ein Statement-Timeout in der Verbindungszeichenfolge?
Bei libpq-basierten Treibern ergänze options=-c statement_timeout=30000 (Millisekunden; in einer URI mit Prozentkodierung als options=-c%20statement_timeout%3D30000). Npgsql hat Command Timeout, einen clientseitigen Timeout in Sekunden.
Kann ich mehrere Hosts für Failover angeben?
Ja. Schreibe postgresql://host1:5432,host2:5432/db oder host=host1,host2 port=5432,5432. libpq versucht sie der Reihe nach; füge target_session_attrs=read-write hinzu, um nur-Lese-Standbys zu überspringen, oder load_balance_hosts=random (PostgreSQL 16+) um Verbindungen zu verteilen.
Warum überprüft node-postgres das Zertifikat mit sslmode=require?
pg-connection-string behandelt derzeit sslmode=prefer, require und verify-ca als verify-full und gibt eine Warnung aus, dass sich dies in einer zukünftigen Hauptversion zu den libpq-Bedeutungen ändert. Füge uselibpqcompat=true hinzu, um jetzt das libpq-Verhalten zu übernehmen, oder konfiguriere ssl stattdessen in der Client-Konfiguration.
Andere Engines
- SQL Server-Verbindungszeichenfolgen
- MySQL-Verbindungszeichenfolgen
- MariaDB-Verbindungszeichenfolgen
- SQLite-Verbindungszeichenfolgen
- Oracle-Verbindungszeichenfolgen
- Redis-Verbindungszeichenfolgen
- ClickHouse-Verbindungszeichenfolgen
- DuckDB-Verbindungszeichenfolgen
- libSQL-Verbindungszeichenfolgen
- Alle Engines und Formate
- SQL-Formatter
- Alle kostenlosen Tools
Einmal verbinden. Dann einfach SQL schreiben.
SQLLY ist eine native SQL-Workbench für macOS, Windows und Linux. Füge eine Verbindungszeichenfolge in den Verbindungseditor ein, speichere Passwörter in deinem System-Schlüsselbund, und erhalte schemabewusstes IntelliSense für PostgreSQL und mehr.