SQL Server 接続文字列ビルダー
ADO.NET (Microsoft.Data.SqlClient)、ODBC Driver 18、JDBC、Go、SQLAlchemy 向けの SQL Server または Azure SQL の接続文字列を 1 つのフォームから作成するか、文字列を貼り付けて、各キーワードの動作と危険な設定を確認できます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
SQL Server 接続文字列形式
SQL Server のドライバーは keyword=value という形式は共通でも、キーワードは共通ではありません。ADO.NET では User ID そして Connect Timeout、ODBC は次のように表示します Uid そして ConnectTimeout、JDBC は次のように表示します user そして loginTimeout、Go は URL を使います。どちらにも落とし穴が 1 つあります: ポートはカンマの後に置きます(host,1433)。コロンの代わりで、JDBC と Go を除くすべての場所でそうなります。
もう 1 つ、つまずきやすいのが暗号化です。Microsoft.Data.SqlClient 4.0、ODBC Driver 18、JDBC Driver 10.2 はいずれも既定で暗号化し、サーバー証明書を検証するため、何年も動いていた接続文字列が、アップグレード後に失敗するようになりました。ビルダーは次を明示します Encrypt 明示的に指定します。デコーダーは、未設定の Encrypt ドライバーごとの意味です。
ADO.NET Microsoft.Data.SqlClient, System.Data.SqlClient, Entity Framework, Dapper
Server=sql01.example.com;Database=Sales;User ID=app_user;Password=your_password;Encrypt=True;
ODBC ODBC Driver 18 for SQL Server、pyodbc
Driver={ODBC Driver 18 for SQL Server};Server=sql01.example.com;Database=Sales;Uid=app_user;Pwd=your_password;Encrypt=yes;
JDBC SQL Server 用の Microsoft JDBC ドライバー
jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;
Go URL github.com/microsoft/go-mssqldb
sqlserver://app_user:[email protected]?database=Sales&encrypt=true
SQLAlchemy URL pyodbc を使う Python SQLAlchemy
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Windows 認証 (ADO.NET) 統合セキュリティ
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Microsoft Entra ID を使用した Azure SQL (ADO.NET) マネージドID、Azure CLI、またはVisual Studioのサインイン
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
次のようなプレースホルダー your_password 例にすぎません。実際の文字列は上のフォームで組み立ててください。SQLlyをSQL Serverに接続する方法の詳細: SQL Server 向け SQLly.
Microsoft.Data.SqlClient (ADO.NET) キーワード
キーワードは大文字小文字を区別せず、前後のスペースは無視されます。キーワード(またはその同義語)が 2 回現れた場合は最後の値が優先されます。不明なキーワードは次の例外を発生させます Keyword not supported。値を次で引用符で囲みます " または ' 含まれているとき ;、または先頭か末尾にスペースや引用符がある場合。引用符の内側では、引用符文字を 2 つ重ねます。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port、または tcp:host,port. . そして (local) このマシンを指します; (localdb)\MSSQLLocalDB は LocalDB です。名前付きインスタンスは、UDP 1434 の SQL Server Browser 経由で見つかります。 |
Database |
Initial Catalog | ログインのデフォルトデータベース | 接続後に使用するデータベース。 |
User ID |
UID、ユーザー | - | SQL ログイン、または次の認証方式の Entra ユーザー名 Active Directory Password / Interactive. |
Password |
PWD | - | 無視される場合 Integrated Security がオンです。 |
Integrated Security |
Trusted_Connection | 偽 | true, yes または sspi プロセスを実行している Windows アカウント(Kerberos または NTLM)としてサインインします。 |
Authentication |
- | 未設定 | Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (エイリアス) Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (非推奨)。7.0 以降、Entra メソッドには次が必要です Microsoft.Data.SqlClient.Extensions.Azure パッケージ。 |
Encrypt |
- | true 4.0+ では (Mandatory); false 3.x 以前 |
true/yes/Mandatory, false/no/Optional、または Strict (5.x+、TDS 8.0: SQL Server 2022+ および Azure SQL)。次を指定すると Optional ログインパケットは暗号化されたままですが、それ以外は暗号化されません。 |
TrustServerCertificate |
サーバー証明書を信頼する | 偽 | true 証明書の検証をスキップします。次の指定では無視されます(false として扱われます) Encrypt=Strict. |
HostNameInCertificate |
証明書のホスト名 | - | 5.0 以降。サーバー証明書に期待される名前。次と異なる場合に指定します。 Server、たとえば、エイリアスや IP アドレス経由で接続する場合。 |
ServerCertificate |
サーバー証明書 | - | 5.1 以降。サーバー証明書と完全に一致する必要がある証明書ファイルへのパス。 |
Connect Timeout |
接続タイムアウト、タイムアウト | 15 | 接続を待つ秒数 (超えると失敗します)。 |
Command Timeout |
- | 30 | 2.1+. デフォルト SqlCommand.CommandTimeout 秒単位。0 は無期限に待ちます。 |
Application Name |
アプリ | Core Microsoft SqlClient Data Provider (.NET) |
表示形式: program_name 内 sys.dm_exec_sessions そしてProfiler / Extended Eventsでも。 |
ApplicationIntent |
アプリケーションの目的 | ReadWrite | ReadOnly 可用性グループの読み取り可能なセカンダリ、または Azure SQL の読み取りレプリカへルーティングします。 |
MultiSubnetFailover |
マルチサブネットフェイルオーバー | 偽 | 次の値に設定 true サブネットにまたがる可用性グループリスナーに接続するときに、フェイルオーバーを高速化します。 |
MultipleActiveResultSets |
複数のアクティブな結果セット | 偽 | MARS: 1 つの接続で複数のリーダーを開いたままにできます。 |
Pooling |
- | true | 接続プール。 |
Max Pool Size |
- | 100 | 異なる接続文字列ごとのプール接続の最大数。 |
Min Pool Size |
- | 0 | プール内で開いたままの接続。 |
ConnectRetryCount |
接続の再試行回数 | 1 | アイドル状態の接続が切断された後の再接続試行回数(0~255)。 |
ConnectRetryInterval |
接続の再試行間隔 | 10 | 再試行の間隔は 1~60 秒です。 |
Persist Security Info |
PersistSecurityInfo | 偽 | true パスワードを次の中に読み取れる状態で残します ConnectionString 開いた後。オフのままにしてください。 |
ODBC Driver 18 for SQL Server のキーワード
pyodbc、R、PHP、Excel など、ODBC を使うあらゆるもので使用されます。特殊文字を含む値は囲んでください([]{}(),;?*=!@)を中括弧で囲みます。ADO.NET とは違い、キーワードが重複している場合は、最初に出てきたものが優先されます。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (または 17)。ドライバーマネージャーが一覧表示する名前と一致している必要があります。 |
Server |
アドレス、Addr | - | [tcp:]host[\instance][,port]. |
Database |
- | ログインのデフォルト | データベース名。 |
UID / PWD |
- | - | SQL ログインとパスワード。 |
Trusted_Connection |
- | なし | yes Windows 認証を使用します。 |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows)、 ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (非推奨)。次はありません ActiveDirectoryDefault ODBC で。 |
Encrypt |
- | はい(ドライバー 18)、いいえ(17 以前) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | なし | yes 証明書の検証をスキップします。次の指定では無視されます Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0 以上。想定される証明書のホスト名。 |
ServerCertificate |
- | - | 18.1 以降。サーバー証明書が一致する必要がある証明書ファイル。 |
ConnectTimeout |
- | 15 | 18.7 以降。ログインのタイムアウト(秒)。0 は無制限。古いドライバーでは次のみ指定できます SQL_ATTR_LOGIN_TIMEOUT コードから。 |
APP |
- | - | アプリケーション名。 |
ApplicationIntent |
- | ReadWrite | ReadOnly 読み取り可能なセカンダリ向け。 |
MultiSubnetFailover |
- | いいえ | Yes マルチサブネット可用性グループ向け。 |
Microsoft JDBC Driver for SQL Server のプロパティ
URL 形式: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]。プロパティ名は大文字小文字を区別しません。次を含む値は ; 波括弧で囲み、ドライバー 8.4 以降では波括弧内の閉じ波括弧は 2 つ重ねます: password={pass;}}word}.
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
databaseName |
データベース | - | データベース名。 |
user |
ユーザ名 | - | ログイン名。 |
password |
- | - | パスワード。 |
integratedSecurity |
- | 偽 | Windows 認証。Windows では次のものが必要です mssql-jdbc_auth-<version>.dll; それ以外の場合は次を追加します authenticationScheme=JavaKerberos. |
authentication |
- | NotSpecified | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI 前の)。 |
encrypt |
- | true (10.2 以降); false (9.4 以前) | true, false、または strict (11.2+). |
trustServerCertificate |
- | 偽 | true 証明書の検証をスキップします。 |
hostNameInCertificate |
- | - | 証明書に期待されるホスト名。 |
serverCertificate |
- | - | 11.2 以降。照合に使う証明書ファイルです。strict と併用します。 |
loginTimeout |
- | 30(11.2+)、15(旧) | ログインを待つ秒数。 |
queryTimeout |
- | -1 (制限なし) | デフォルトのクエリタイムアウト (秒)。 |
applicationName |
- | SQL Server 用の Microsoft JDBC ドライバー | アプリケーション名。 |
applicationIntent |
- | ReadWrite | ReadOnly 読み取り可能なセカンダリ向け。 |
multiSubnetFailover |
- | 偽 | マルチサブネットの可用性グループ。 |
instanceName |
- | - | 名前付きインスタンス。次の代わりに使えます host\instance URL に含めます。 |
go-mssqldb URL パラメータ
URL 形式: sqlserver://user:password@host:port?database=... または sqlserver://user:password@host/instance?...。パスはインスタンス名であり、データベース名ではありません。ユーザー名とパスワードの特殊文字はパーセントエンコードします。パラメーター名は大文字小文字を区別しません。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
database |
- | - | データベース名。 |
encrypt |
- | false (ログインパケットのみ) | strict, disable (TLS はまったく使用しない場合)、 false, true。デフォルトが Microsoft 自身のドライバーとは異なる点に注意してください。 |
TrustServerCertificate |
- | 暗号化が設定されている場合はfalse、設定されていない場合はtrue | true 証明書の検証をスキップします。 |
app name |
- | go-mssqldb | アプリケーション名 (次のように記述します app+name または app%20name URL に含めます)。 |
connection timeout |
- | 0 (なし) | 接続全体にかける秒数。 |
dial timeout |
- | 登録済みプロトコルごとに 15 | TCP 接続にかける秒数。 |
fedauth |
- | - | Entra の方式 (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword、...) と azuread パッケージおよび azuresql ドライバー名。 |
よくある SQL Server の接続エラー
The certificate chain was issued by an authority that is not trusted.
理由: Microsoft.Data.SqlClient 4.0+、ODBC Driver 18、JDBC 10.2+ はデフォルトで暗号化し、サーバー証明書を検証します。サーバーは自動生成された自己署名証明書、またはお使いのマシンが信頼していないプライベートCAの証明書を使用しています。
修正: 信頼できる CA の証明書をサーバーにインストールしてください(またはクライアントで社内 CA を信頼してください)。証明書が有効でも別の名前向けの場合は、次を設定してください HostNameInCertificate。ローカルの開発サーバー専用として、 TrustServerCertificate=True これで始められます。
Login failed for user 'app_user'. (Error 18456)
理由: パスワードの誤り、Windows認証のみを許可するサーバーでのSQLログイン、無効なログイン、またはログインが開けない既定のデータベース。サーバーログには、実際の理由が状態番号として記録されます。
修正: パスワードを確認し、SQL ログインを使用する場合は SQL Server と Windows 認証モードを有効にして、 Database ログインで開けるデータベースに接続します。サーバーのエラーログに記録される state(たとえば State 8 = パスワード誤り、State 38 = データベース利用不可)で原因を特定できます。
Keyword not supported: 'host'.
理由: Microsoft.Data.SqlClient は、独自のキーワードのみを受け付けます。 Host, Username そして Port はNpgsql/MySQLのキーワード。 Provider= はOLE DB接続文字列のものです。次のようなタイプミス Databse 同じように失敗します。
修正: 使用 Server, User ID、そして host,port。上のデコーダーに文字列を貼り付けてください。未知のキーワードはすべてフラグが付きます。
Format of the initialization string does not conform to specification starting at index 42.
理由: 値に次が含まれています ; または引用符を含んでいるのに引用符で囲まれていないため、パーサーが文字列を誤った位置で分割します。多くの場合、原因はパスワードです。
修正: 値を二重引用符で囲み、内部にある二重引用符は 2 つ重ねます: Password="p;a""ss"。ビルダーが値を自動でエスケープします。
The target principal name is incorrect. Cannot generate SSPI context.
理由: 統合セキュリティは Kerberos を使用するため、SQL Server サービスのサービスプリンシパル名(SPN)が存在しない、重複している、別のアカウントに登録されている、あるいは IP アドレスやエイリアスで接続している場合に発生します。
修正: サーバーの完全修飾名で接続し、管理者に SPN を登録してもらいます (setspn -L <service account> 一覧表示します)。証明書名が一致しない場合は次も確認してください HostNameInCertificate.
SQL Server 接続文字列 FAQ
SQL Server のデフォルトポートは何ですか?
1433 は既定のインスタンス用です。名前付きインスタンスは通常、SQL Server Browser(UDP 1434)がクライアントに通知する動的ポートを使います。そのため host\instance ポートなしで動作します。ADO.NET と ODBC では、ポートはコンマの後ろに書きます: Server=host,1433.
Encrypt=True と TrustServerCertificate=True、どちらを使うべきですか?
使用 Encrypt=True (または Strict SQL Server 2022 と Azure SQL で)、クライアントが信頼する証明書を使って。 TrustServerCertificate=True は通信を暗号化し続けますが、クライアントが通信相手を確認しなくなるため、接続を傍受できる人はサーバーになりすませます。ローカル開発にとどめてください。
Microsoft.Data.SqlClient 4.0 で Encrypt はどう変わりましたか?
デフォルトは Encrypt から変更されました false に true、ドライバーはデフォルトでサーバー証明書を検証します。ODBC Driver 18 と JDBC Driver 10.2 でも同じ変更が行われました。次のキーワードを含まない文字列は Encrypt キーワードを含まない文字列は、以前は TLS なしで接続できましたが、今ではサーバーに信頼できる証明書が必要になりました。
Microsoft Entra ID で Azure SQL データベースに接続するにはどうすればよいですか?
追加 Authentication=Active Directory Default (マネージド ID、環境の資格情報、または Azure CLI / Visual Studio のサインインを利用)、パスワードは省略します。次を使用します Active Directory Managed Identity Azure でホストされるアプリや Active Directory Interactive ブラウザーでのサインイン用。Azure SQLは次を受け付けません Integrated Security=SSPI.
Data Source と Server の違い、あるいは Initial Catalog と Database の違いは何ですか?
なし。Microsoft.Data.SqlClient では同義語です。次も同様です: User ID / UID / User そして Password / PWD。両方の綴りが現れた場合は、最後のものが優先されます。
System.Data.SqlClient は同じ接続文字列を使用しますか?
おおむね対応しています。従来のキーワードは受け付けますが、次のような新しいものは受け付けません Command Timeout, Encrypt=Strict, HostNameInCertificate または大半 Authentication 値で、デフォルトは Encrypt=False。Microsoft は Microsoft.Data.SqlClient への移行を推奨しています。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、SQL Server などでスキーマ対応の IntelliSense を利用できます。