接続文字列ビルダー&デコーダー
フォームに入力すると、ドライバーが使用するすべての形式 (ADO.NET、JDBC、ODBC、URL、libpq、Go の DSN など) の接続文字列を並べて表示します。または、接続文字列を貼り付けると、各キーの働きと危険な設定がわかります。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
データベースを選ぶ
各エンジンページは、そのエンジンのビルダーを開き、完全なキーワードリファレンス、その一般的な接続エラーと修正を追加します。
SQL Server
ADO.NET、ODBC、JDBC、Go URL、SQLAlchemy URL
PostgreSQL
URI、キーワード/値、ADO.NET(Npgsql)、JDBC、ODBC
MySQL
URI、JDBC、ADO.NET、ODBC、Go DSN
MariaDB
JDBC、ADO.NET、Go DSN、SQLAlchemy URL、URI
SQLite
ファイルパス、URI ファイル名 (読み取り専用)、ADO.NET、JDBC、SQLAlchemy URL
Oracle
Easy Connect、TLS 経由の Easy Connect、接続記述子、JDBC thin、ADO.NET (ODP.NET)
Redis
TLS 付きの URI、ACL ユーザー付きの URI (Redis 6+)、StackExchange.Redis、redis-cli
ClickHouse
HTTP URL、ネイティブ DSN、JDBC、ADO.NET
DuckDB
ファイルパス、JDBC、SQLAlchemy URL、CLI、読み取り専用
libSQL
データベース URL、認証トークン付き URL、ローカル sqld
接続文字列の形式と、そのエスケープ方法
接続文字列のバグの大半はエスケープのバグです。次のような文字を含むパスワードは @、 ; または、ドライバーが誤った位置で分割する引用符。形式ごとに独自のルールがあります。
| フォーマット | 次のように表示されます | 特殊文字 |
|---|---|---|
| URL / URI | postgresql://user:pass@host:5432/db?sslmode=verify-full | ユーザー、パスワード、データベース内の予約文字をパーセントエンコードします: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25、スペース → %20. |
| ADO.NET | Server=host;Database=db;User ID=u;Password=p; | 値を次で囲みます ;、先頭または末尾のスペース、または先頭の引用符が "…" (または '…')とし、内側の引用符は 2 つ重ねます: Password="a;b""c". |
| ODBC | Driver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w}; | 値を波括弧で囲みます。ドライバー名は常に囲まれます。 |
| JDBC | jdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=u | ベンダー固有。Microsoft: 波括弧、 } 二重化されます。PostgreSQL、MySQL、MariaDB は URL クエリなので、パーセントエンコードします。 |
| libpq キーワード/値 | host=h dbname=db user=u password='a b' | 値が空の場合や空白を含む場合は、シングルクォートで囲みます。次のように書きます \' そして \\ 引用符またはバックスラッシュ用。 |
| Go MySQL DSN | user:pass@tcp(host:3306)/db?tls=true | パスワードはエスケープ不要です。パラメーター値は URL エスケープされ、パラメーター名の大文字と小文字は区別されます。 |
| StackExchange.Redis | host:6380,password=p,ssl=true | カンマはオプションの区切りなので、カンマを含むパスワードはコードで設定する必要があります。 |
| Oracle Easy Connect | host:1521/service_name | 認証情報は含まれていません。ユーザーとパスワードは別々に渡します。 |
デコーダーがチェックする内容
- 証明書のチェックがオフになっています。
TrustServerCertificate=true,sslmode=require,tls=skip-verify,sslMode=trustおよびpgJDBCのNonValidatingFactoryいずれも、誰が応答したかを確認せずに暗号化します。 - TLS なし、またはフォールバックする可能性のある TLS。
sslmode=disableまたはprefer,Encrypt=False,ssl-mode=DISABLED,redis://パスワード付きで、ClickHouse にはプレーン HTTP で。 - 変更のあったデフォルト。 いいえ
EncryptMicrosoft.Data.SqlClient 4.0+、ODBC Driver 18、JDBC 10.2+ では暗号化と検証を意味しますが、古いドライバや go-mssqldb ではそうなりません。 - 文字列内のシークレット。 平文のパスワードと認証トークン、
Persist Security Info=True、期限切れの Turso トークン。 - タイプミスと、他の方言から借りたキーワード。 検出されたドライバーに対する不明なキー、
host:portSQL Server が望む場所にhost,port、大文字小文字を区別する Go のパラメーター、エスケープされていない@URL パスワード内、サービス名にすべきところが Oracle SID。 - SQLly がそれをどう読み取るか。 このデコーダーは SQLly アプリの接続文字列リーダーと同じルールで動作するため、アプリがどの値を補うかわかります。
接続文字列 FAQ
接続文字列はどこかに送信されますか?
いいえ。ビルダーとデコーダーは、お使いのブラウザータブ内で動作する JavaScript です。入力または貼り付けた内容がアップロード、記録、保存されることはなく、ブラウザーのストレージにも保存されません。ページは一度読み込まれれば、ネットワークをオフにしても動作し続けます。
どのデータベースとドライバーに対応していますか?
SQL ServerとAzure SQL、PostgreSQL、MySQL、MariaDB、SQLite、Oracle、RedisとValkey、ClickHouse、DuckDB、libSQL / Turso。各エンジンについて、実際に存在する形式を書き出します。URL、ADO.NET、JDBC、ODBC、libpqのキーワード/値文字列、Go DSN、SQLAlchemy URL、StackExchange.Redis文字列、Oracle Easy ConnectとTNS記述子に加え、PythonとNode.js向けのそのまま貼り付けられるコードです。
パスワードに特殊文字を入れるにはどうすればよいですか?
形式によって異なります。URL では、パーセントエンコードします: @ になります %40, : になります %3A, / になります %2F, % になります %25。ADO.NET 文字列では、次を含む値を囲みます ; または引用符を二重引用符で囲み、内部の二重引用符は二重にします。ODBC と Microsoft の JDBC ドライバーでは、波括弧で囲みます {...} 閉じ波括弧は2つ重ねます。libpqのキーワード/値形式の文字列では、単一引用符を使い、バックスラッシュでエスケープします ' そして \。ビルダーがこれらすべてを自動で行います。
デコーダーは何をチェックしますか?
ドライバーと同じ方法で文字列を読み取り、すべてのキーとその働きを一覧にし、問題にフラグを立てます。証明書チェックの無効化(TrustServerCertificate=true, sslmode=require, tls=skip-verify)、 host:port SQL Server が望む場所に host,port、URL パスワード内のエスケープされていない文字、Oracle での SID とサービス名の取り違え、そして次のようにドライバーのバージョン間で変わったデフォルト Encrypt Microsoft.Data.SqlClient 4.0 で。
ドライバーのアップグレード後、接続が証明書エラーで失敗するのはなぜですか?
Microsoft.Data.SqlClient 4.0、ODBC Driver 18、Microsoft JDBC Driver 10.2はいずれも、デフォルトで暗号化し、サーバー証明書を検証するようになりました。自己署名証明書を使い続けているSQL Serverは、「The certificate chain was issued by an authority that is not trusted」で失敗します。クライアントが信頼するCAの証明書をインストールしてください。次を設定します: TrustServerCertificate=true ローカル開発専用
「SQLly で開く」とは何ですか?
SQLly は、macOS、Windows、Linux 向けのデスクトップ SQL クライアントです。このボタンが作成するのは sqlly://connection/new ホスト、ポート、データベース、ユーザーがすでに入力された状態で SQLly の接続エディターを開くリンク。パスワードはチェックボックスをオンにした場合にのみリンクに含まれ、SQLly が接続ファイルに書き込むことはありません。リンクはブラウザーからお使いのコンピューター上のアプリに直接渡され、どのサーバーも経由しません。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、データベースなどでスキーマ対応の IntelliSense を利用できます。