PostgreSQL 接続文字列ビルダー
PostgreSQL の接続 URI、libpq のキーワード/値文字列、Npgsql (ADO.NET) 文字列、JDBC URL などを 1 つのフォームから作成するか、いずれかを貼り付けて、各パラメーターの動作と、sslmode が実際に保護してくれるかどうかを確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
PostgreSQL 接続文字列の形式
ほとんどのPostgreSQLドライバーはlibpqの上に構築されているか、そのルールをコピーしているため、URI postgresql://user:password@host:5432/db?sslmode=verify-full とキーワード/値形式 host=... dbname=... ほぼどこでも動きます:psql、psycopg、pgx、lib/pq、node-postgres。Npgsql (.NET) と pgJDBC (Java) はそれぞれ独自のつづりを使います。
最も重要なパラメーターは、 sslmode。そのデフォルトは prefer、サーバーが TLS を提供していれば使用しますが、証明書は検証せず、黙って平文にフォールバックします。対応しているのは次のみ verify-full 証明書チェーンとホスト名の両方を検証します。
URI libpq、psql、psycopg、pgx、node-postgres、Prisma
postgresql://app_user:[email protected]/sales?sslmode=verify-full
キーワード/値 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 ドライバー (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 psycopg 3 を使う Python SQLAlchemy
postgresql+psycopg://app_user:[email protected]/sales?sslmode=verify-full
複数のホスト(フェイルオーバー) libpq 10+, pgx, Npgsql, pgJDBC
postgresql://[email protected]:5432,db2.example.com:5432/sales?target_session_attrs=read-write
次のようなプレースホルダー your_password 例にすぎません。実際の文字列は上のフォームで組み立ててください。SQLlyをPostgreSQLに接続する方法の詳細: PostgreSQL 向け SQLly.
libpq パラメータ (URI とキーワード/値)
URIフォーム: postgresql://[user[:password]@][host][:port][,...][/dbname][?param=value&...] (postgres:// でも動作します)。特殊文字はパーセントエンコードしてください。ホストとして使う Unix ソケットパスのスラッシュも含みます。キーワード/値の形式: key=value スペースで区切ったペア。空の値や空白を含む値は単一引用符で囲み、次のように書きます \' そして \\ 内部の引用符またはバックスラッシュ用。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
host |
- | /tmp の Unix ソケット (Windows のローカルホスト) | ホスト名、IP、または Unix ソケット用のディレクトリ。カンマ区切りのリストは先頭から順に試されます。 |
hostaddr |
- | - | 数値 IP を使い DNS をスキップします(ホスト名は引き続き TLS 検証に使われます)。 |
port |
- | 5432 (ビルドデフォルト) | ポート 1 つ、またはホストごとに 1 つ。 |
dbname |
- | ユーザー名 | 接続先のデータベース。 |
user |
- | OS のユーザー | 接続に使用するロール。 |
password |
- | - | 次の場所に保管したほうがよい ~/.pgpass (または PGPASSWORD)に取っておく方が、接続文字列に含めるより安全です。 |
passfile |
- | ~/.pgpass(Windows では %APPDATA%\postgresql\pgpass.conf) | パスワードファイル。 |
connect_timeout |
- | 0 (無期限に待機) | ホストごとの秒数。PostgreSQL 16 以前では 1 は 2 として扱われます。 |
sslmode |
- | 優先 | disable, allow, prefer, require, verify-ca, verify-full. require はルート証明書ファイルが存在する場合にのみ CA を検証します。 verify-full ホスト名を検証します。 |
sslrootcert |
- | ~/.postgresql/root.crt | CA ファイル。 system (16+) はオペレーティングシステムの信頼された CA を使用し、 verify-full デフォルトのままです。 |
sslcert / sslkey |
- | ~/.postgresql/postgresql.crt / .key | クライアント証明書とキー。 |
sslnegotiation |
- | postgres | 17+. direct TLS を即時に開始します(sslmode が require 以上である必要があります)。 |
application_name |
- | - | 表示先: pg_stat_activity とサーバーのログ。 |
options |
- | - | 起動時のサーバー設定、例: -c statement_timeout=30000 -c search_path=app. |
target_session_attrs |
- | 任意の | any, read-write, read-only, primary, standby, prefer-standby. |
load_balance_hosts |
- | 無効 | 16+. random ホストリストをシャッフルします。 |
keepalives |
- | 1 | TCP キープアライブのオン/オフ。調整には次を使用: keepalives_idle, keepalives_interval, keepalives_count. |
channel_binding |
- | 優先 | require SCRAM チャネルバインディングがない場合は認証を拒否します。 |
Npgsql (ADO.NET) パラメーター
Npgsql は ADO.NET の Key=Value; 独自のキーワード名を持つ構文。次を含む値は引用符で囲みます ; 二重引用符で囲みます。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
Host |
サーバー | - (必須) | ホスト名、IP、カンマ区切りのリスト、または次で始まるソケットディレクトリ /. |
Port |
- | 5432 | TCP ポート。 |
Database |
DB | ユーザー名 | データベース名。 |
Username |
ユーザー名、ユーザー ID、UID | PGUSER、なければ OS ユーザー | ロール名。 |
Password |
PSW、PWD | PGPASSWORD | パスワード。 |
SSL Mode |
SslMode | 優先 | Disable, Allow, Prefer, Require, VerifyCA, VerifyFull。Npgsql 6 以降、 Require 証明書を検証しません。 |
Trust Server Certificate |
- | 偽 | 検証をスキップします。Npgsql 6 と 7 では次が必要でした: Require; Npgsql 8 では不要です。 |
Root Certificate |
- | PGSSLROOTCERT | VerifyCA / VerifyFull 用の CA ファイルです。 |
Timeout |
- | 15 | 接続を待つ秒数。 |
Command Timeout |
- | 30 | デフォルトのコマンドタイムアウト (秒)。0 を指定すると無期限に待機します。 |
Application Name |
- | PGAPPNAME | application_name. |
Search Path |
- | - | スキーマ検索パス。 |
Target Session Attributes |
- | 任意の | any, primary, standby, prefer-primary, prefer-standby, read-write, read-only. |
Pooling |
- | true | 接続プール。 |
Maximum Pool Size |
- | 100 | 最大のプール。 |
Minimum Pool Size |
- | 0 | 最小のプール。 |
Keepalive |
- | 0 (オフ) | キープアライブクエリの間隔 (秒)。 |
Include Error Detail |
- | 偽 | 行データを含み得るサーバーエラーの詳細を、例外メッセージに含めます。 |
pgJDBC プロパティ
URL 形式: jdbc:postgresql://host:port/database?property=value&...。pgJDBC は次を読み取りません user:password@ URL に含めます。次のように渡します user そして password パラメーターまたは接続プロパティとして。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
user / password |
- | - | 資格情報 |
sslmode |
- | 優先 | libpq と同じ値。 require, allow そして prefer 証明書を検証しません。 |
ssl |
- | 偽 | true sslmode なしの URL は verify-full を意味します。 |
sslrootcert |
- | ~/.postgresql/root.crt | CA ファイル。 |
connectTimeout |
- | 10 | ソケットを待つ秒数。0 は制限を無効にします。 |
socketTimeout |
- | 0 | 読み取りがブロックされてよい秒数。0 は無期限に待ちます。 |
loginTimeout |
- | 0 | ログイン全体を待つ秒数。 |
ApplicationName |
- | PostgreSQL JDBC ドライバー | application_name. |
currentSchema |
- | - | search_path、カンマ区切り。 |
targetServerType |
- | 任意の | any, primary, secondary, preferPrimary, preferSecondary. |
options |
- | - | 起動オプション、例: -c statement_timeout=30000 (URL ではパーセントエンコードされます)。 |
よくある PostgreSQL の接続エラー
FATAL: no pg_hba.conf entry for host "10.0.0.7", user "app_user", database "sales", no encryption
理由: サーバーには到達できたものの、 pg_hba.conf このクライアント、ユーザー、データベースを許可しているか、一致する行が hostssl 、そしてTLSなし(「暗号化なし」)で接続した。
修正: 次を使って接続します sslmode=require サーバーが TLS を求めている場合はそれ以上を使うか、管理者に次の追加を依頼してください host/hostssl アドレス用の行を追加し、サーバーを再読み込みします。
connection to server at "db.example.com" (10.0.0.5), port 5432 failed: Connection refused
理由: そのアドレスとポートで待ち受けているものはありません: サーバーが停止している、 listen_addresses localhost にしか対応していない、ポートが違う、またはファイアウォールが接続を拒否している場合です。
修正: 確認 listen_addresses そして port postgresql.conf、ファイアウォールまたはクラウドのセキュリティグループ、および別のポートが必要かどうか (マネージドサービスやコネクションプーラーでは 6432 やカスタムのポートがよく使われます)。
FATAL: password authentication failed for user "app_user"
理由: パスワードの誤り、パスワードのないロール、またはURIでパーセントエンコードされていないパスワード中の特殊文字(そのためドライバーが別のパスワードとして読み取った)。
修正: パスワードを確認します。URI では次のようにエンコードします @ として %40, : として %3A, / として %2F そして % として %25。URI をデコーダーに貼り付けると、ドライバーが実際に送信するパスワードを正確に確認できます。
server does not support SSL, but SSL was required
理由: 接続文字列が要求しているのは sslmode=require (または verify-ca / verify-full)で、サーバーに次がある場合 ssl = off.
修正: サーバーで TLS を有効にするか、プロバイダーのドキュメントに記載されている TLS エンドポイントに接続してください。次の設定には切り替えないでください: sslmode=disable 自分で管理できないネットワークを越えて。
root certificate file "/home/app/.postgresql/root.crt" does not exist
理由: sslmode=verify-ca または verify-full 照合するための CA 証明書が必要ですが、libpq は既定のパスで見つけられませんでした。
修正: お使いのプロバイダーの CA バンドルをダウンロードして、次のように設定します sslrootcert=/path/to/ca.pem、または PostgreSQL 16 以降のクライアントでは次を使用 sslrootcert=system サーバーの証明書がパブリック CA から発行されている場合。
FATAL: database "app_user" does not exist
理由: いいえ dbname が指定されなかったため、libpq はユーザー名をデータベース名として使用しました。
修正: URI パスにデータベースを追加します(/sales)、または次を設定します dbname=sales.
invalid connection option "sslmod"
理由: libpq は、キーワードのスペルが誤っている場合や別のドライバーのものである場合、文字列全体を拒否します (例: ApplicationName 次ではなく pgJDBC から application_name).
修正: スペルを修正します。デコーダは、すべての libpq パラメータをリストし、未知のものをマークします。
PostgreSQL 接続文字列 FAQ
PostgreSQL 接続文字列の形式は何ですか?
libpq ベースのドライバーでは 2 つの形式が使えます: URI postgresql://user:password@host:5432/dbname?sslmode=verify-full とキーワード/値文字列 host=host port=5432 dbname=dbname user=user sslmode=verify-full。Npgsql は次を使用します Host=...;Database=...;Username=... Javaは次を使います jdbc:postgresql://host:5432/dbname.
どの sslmode を使うべきですか?
verify-full を伴う sslrootcert CA を指定する(または system PostgreSQL 16+ で)。 require 暗号化はしますが、誰が応答したかは確認せず、 prefer、デフォルトのままだと、気付かないうちにプレーンテキストにフォールバックすることがあります。次を使用してください disable ソケットまたは localhost の場合のみ。
PostgreSQL URI の特殊文字をエスケープするにはどうすればよいですか?
ユーザー名、パスワード、データベースにそれぞれパーセントエンコードします。 @ です %40, : です %3A, / です %2F, # です %23, ? です %3F, % です %25 と、スペース %20。キーワード/値の形式ならこれらの大半を避けられます。値をシングルクォートで囲み、次をエスケープします ' そして \ バックスラッシュでエスケープします。
接続文字列にステートメントタイムアウトを設定するにはどうすればよいですか?
libpq ベースのドライバーでは、次を追加します options=-c statement_timeout=30000 (ミリ秒。URI では次のようにパーセントエンコードします options=-c%20statement_timeout%3D30000)。Npgsql には Command Timeout、クライアント側のタイムアウトの秒数。
フェイルオーバー用に複数のホストを指定できますか?
はい。次のように書きます postgresql://host1:5432,host2:5432/db または host=host1,host2 port=5432,5432。libpq は順番に試行します。次を追加します target_session_attrs=read-write 読み取り専用のスタンバイをスキップするか、または load_balance_hosts=random (PostgreSQL 16+)で、接続を分散させます。
node-postgres が sslmode=require でも証明書を検証するのはなぜですか?
pg-connection-string は現在、次を扱います sslmode=prefer, require そして verify-ca として verify-full 、そして、この構文は将来のメジャーバージョンでlibpqの意味に変わるという警告を表示します。追加するには uselibpqcompat=true libpq の動作を今すぐ有効にするか、次を設定します ssl 代わりにクライアント設定で指定します。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、PostgreSQL などでスキーマ対応の IntelliSense を利用できます。