// 無料のツール

PostgreSQL 接続文字列ビルダー

PostgreSQL の接続 URI、libpq のキーワード/値文字列、Npgsql (ADO.NET) 文字列、JDBC URL などを 1 つのフォームから作成するか、いずれかを貼り付けて、各パラメーターの動作と、sslmode が実際に保護してくれるかどうかを確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。

SQLly でこの接続を開く

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 を利用できます。