MySQL 接続文字列ビルダー
MySQL の接続 URI、JDBC URL、ADO.NET 文字列、ODBC 文字列、Go DSN を 1 つのフォームから作成するか、文字列を貼り付けて、各オプションの動作を確認し、allowPublicKeyRetrieval のような安全でない設定を見つけられます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
MySQL 接続文字列のフォーマット
MySQL には接続文字列の単一標準がありません。Connector/J は camelCase プロパティを持つ JDBC URL を使い(sslMode, connectTimeout ミリ秒単位)、MySqlConnector と Connector/NET は ADO.NET を使用します Server=...; 文字列、Connector/ODBC は ODBC キーワード、Go のドライバーは独自の user:pass@tcp(host:3306)/db DSN を使い、MySQL Shell が使う URI に含まれるのは ssl-mode.
TLS のデフォルトは PREFERRED ほぼどこでも: サーバーが対応していれば暗号化されますが、証明書は確認されません。 VERIFY_IDENTITY (MySqlConnector:) VerifyFull) CA とホスト名をチェックします。
URI MySQL Shell, mysql2, Prisma
mysql://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
JDBC MySQL Connector/J
jdbc:mysql://db.example.com/sales?user=app_user&password=your_password&sslMode=VERIFY_IDENTITY
ADO.NET MySqlConnector、MySql.Data
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
ODBC MySQL Connector/ODBC
Driver={MySQL ODBC 8.0 Unicode Driver};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SslMode=VERIFY_IDENTITY;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
SQLAlchemy URL PyMySQL を使う Python SQLAlchemy
mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4
次のようなプレースホルダー your_password あくまで一例です。接続文字列は上のフォームで組み立ててください。SQLlyをMySQLに接続する方法の詳細: MySQL 向け SQLly.
MySQL Connector/J プロパティ
URL 形式: jdbc:mysql://[host][:port][/database][?property=value&...]。予約文字をパーセントエンコードします(/ : @ ( ) [ ] & # = ? とスペース)を、ユーザー名とパスワードを含むすべての場所でエンコードします。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
user / password |
- | - | 資格情報 |
sslMode |
- | PREFERRED | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
useSSL / requireSSL / verifyServerCertificate |
- | - | 非推奨ですが、引き続き翻訳されます (useSSL=false = DISABLED). sslMode が優先されます。 |
connectTimeout |
- | 0 (なし) | ソケットの接続を待つミリ秒数。 |
socketTimeout |
- | 0 (なし) | 読み取りがブロックされてよいミリ秒数。 |
allowPublicKeyRetrieval |
- | 偽 | クライアントがサーバーの RSA キーを要求できるようにします。対象は caching_sha2_password TLS なし。 |
connectionTimeZone |
serverTimezone | LOCAL | LOCAL, SERVER またはゾーン ID。 |
characterEncoding |
- | utf8mb4 (8.0.26+) | Java の文字セット。 |
trustCertificateKeyStoreUrl |
- | - | VERIFY_CA / VERIFY_IDENTITY 用の、サーバーの CA を含むトラストストア。 |
rewriteBatchedStatements |
- | 偽 | バッチ化されたINSERTを複数行のステートメントに書き換えます。 |
MySqlConnector(ADO.NET)のオプション
MySqlConnector と Oracle の Connector/NET (MySql.Data) は、ほとんどのキーワードを共有します。次を含む値は ; 二重引用符で囲まれます。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
Server |
ホスト、データソース、アドレス | ローカルホスト | ホスト、カンマ区切りのリスト、または Unix ソケットのパス。 |
Port |
- | 3306 | TCP ポート。 |
User ID |
UID、ユーザーネーム | - | ユーザー名。 |
Password |
PWD | - | パスワード。 |
Database |
Initial Catalog | - | デフォルトスキーマ。 |
SslMode |
SSLモード | 優先 | None/Disabled, Preferred, Required, VerifyCA, VerifyFull. |
SslCa |
CA 証明書 ファイル、Ssl-Ca | - | VerifyCA / VerifyFull 用の CA ファイルです。 |
Connection Timeout |
接続タイムアウト | 15 | 秒。 |
Default Command Timeout |
コマンドタイムアウト | 30 | 秒数。0 は無期限に待ちます。 |
Application Name |
- | - | 次の項目を設定します program_name 接続属性。 |
AllowPublicKeyRetrieval |
- | 偽 | 上記の警告をご覧ください。 |
AllowUserVariables |
- | 偽 | 許可する @variables SQL で。 |
Pooling |
- | true | 接続プール。 |
Maximum Pool Size |
最大プールサイズ | 100 | 最大のプール。 |
Minimum Pool Size |
最小プールサイズ | 0 | 最小のプール。 |
go-sql-driver/mysql DSN
フォーム: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]。パスワードはエスケープ不要です。データベース名はパスとしてエスケープします(1.8 以降)。パラメーター値はクエリとしてエスケープし、パラメーター名は大文字小文字を区別します。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
tcp(host:port) |
unix(/path) | tcp(127.0.0.1:3306) | アドレス。ポートの既定値は 3306 です。 |
tls |
- | 偽 | true (検証)、 false, skip-verify (暗号化、チェックなし)、 preferred、または登録済みの設定名。 |
timeout |
- | OS のデフォルト | 単位付きのダイヤルタイムアウト: 10s. |
readTimeout / writeTimeout |
- | 0 | 単位付きの I/O タイムアウト。 |
parseTime |
- | 偽 | DATE と DATETIME を次の型に読み込みます time.Time. |
loc |
- | UTC | タイムゾーン time.Time の値 (エスケープ / として %2F). |
collation |
- | utf8mb4_general_ci | 接続の照合順序。 |
allowCleartextPasswords |
- | 偽 | パスワードを平文で送信します (TLS 経由の場合のみ)。 |
multiStatements |
- | 偽 | クエリごとに複数のステートメントを許可します。SQLインジェクションの影響が拡大します。 |
MySQL Connector/ODBC キーワード
キーワードは大文字小文字を区別しません。ドライバー名は、ODBC ドライバーマネージャーに登録されている名前(バージョンを含みます)と一致している必要があります。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
Driver |
- | - | 例: {MySQL ODBC 8.0 Unicode Driver}. |
Server |
- | ローカルホスト | ホスト。 |
Port |
- | 3306 | TCP ポート。 |
Database |
- | - | デフォルトスキーマ。 |
User |
UID | - | ユーザー名。 |
Password |
PWD | - | パスワード。 |
SSLMODE |
ssl-mode (8.0.29+) | PREFERRED | DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY. |
よくある MySQL の接続エラー
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
理由: エラー 1045: パスワードが間違っているか、アカウントが別のホストパターン用に存在しています ('app_user'@'localhost' は別のアカウントで、 'app_user'@'%').
修正: パスワードを確認し、 SELECT user, host FROM mysql.user; 接続するホストのアカウントを作成または付与します。
Public Key Retrieval is not allowed
理由: Connector/J と MySQL 8 の caching_sha2_password TLS なしの接続で発生します:ドライバーはパスワードを送信するためにサーバーの RSA キーを必要としますが、それを要求することは許可されていません。
修正: TLS を使用する(sslMode=REQUIRED またはそれより強い)。 allowPublicKeyRetrieval=true 動作しますが、信頼できないネットワーク上では中間者攻撃を受ける可能性があります。
Can't connect to MySQL server on 'db.example.com:3306' (110)
理由: エラー 2003: サーバーに到達できません: ホストまたはポートの誤り、 bind-address 127.0.0.1 のみに制限されているか、ファイアウォールが原因です。(111 は接続拒否、110 はタイムアウトを意味します。)
修正: 確認 bind-address そして port my.cnf、ファイアウォール、クラウドのセキュリティグループを確認し、その後次でテストします nc -vz db.example.com 3306.
Host '10.0.0.7' is not allowed to connect to this MySQL server
理由: エラー 1130: そのユーザー名とクライアントのホストの組み合わせに一致するアカウントがありません。
修正: 接続元ホストまたはパターンを指定してアカウントを作成します: CREATE USER 'app_user'@'10.0.0.%' ... 必要な特権を付与します。
Unknown database 'sales'
理由: エラー 1049: 文字列内のスキーマが存在しないか、テーブル名で大文字と小文字が区別されるサーバーで、その名前の大文字小文字が異なっています。
修正: 確認 SHOW DATABASES; と、正確なスペル。
Communications link failure
理由: Connector/J がサーバーとの通信を完了できませんでした: ネットワークの切断、TLS ハンドシェイクの失敗、 wait_timeout サーバーがアイドル中のプール接続を閉じたか、経路上のプロキシが閉じた。
修正: 入れ子になった原因を確認します。TLSの問題の場合は次を確認 sslMode とトラストストア。アイドルでの切断には、プールの最大ライフタイムをサーバーの値より短く設定します wait_timeout.
Authentication plugin 'caching_sha2_password' cannot be loaded
理由: MySQL 8 の既定の認証プラグインより前に作られた古いクライアントライブラリ。
修正: クライアントまたはコネクタをアップグレードしてください。アカウントを mysql_native_password は暫定措置であり、そのプラグインは非推奨です。
MySQL 接続文字列 よくある質問
MySQL 接続文字列の形式は何ですか?
ドライバーによって異なります。JDBC: jdbc:mysql://host:3306/db?user=...&password=...。ADO.NET: Server=host;Port=3306;Database=db;User ID=user;Password=...;。Go: user:password@tcp(host:3306)/db。MySQL Shell や多くの Node および ORM ツールは次を受け付けます mysql://user:password@host:3306/db.
MySQL のデフォルトポートは何ですか?
クラシックプロトコルは 3306、X プロトコルは 33060(mysqlx://).
useSSL=false を使うべきですか?
いいえ。 useSSL は Connector/J では非推奨です。次を使用してください sslMode. sslMode=DISABLED (これは useSSL=false 対応します) は、クエリと結果をプレーンテキストで送信します。使用 VERIFY_IDENTITY できる限りサーバーの CA で暗号化し、少なくとも REQUIRED.
allowPublicKeyRetrieval=true は安全ですか?
TLS または信頼できるネットワーク経由の場合のみ。MySQL 8 のデフォルト caching_sha2_password パスワードを送信するには、TLS またはサーバーの RSA 公開鍵が必要です。クライアントが認証なしでそのキーを取得できると、中間者の攻撃者が自分のキーを渡してパスワードを読み取れてしまいます。TLS を推奨します(sslMode=REQUIRED またはそれより強い)。
Go の MySQL DSN ではパスワードをエスケープする必要がありますか?
いいえ。go-sql-driver/mysql のドキュメントには、パスワードにはエスケープなしで任意の文字を含められると記載されています。ドライバーは最後の @。クエリパラメーターの値は URL エスケープが必要で、パラメーター名は大文字小文字を区別します(parseTime、ではない parsetime).
JDBC の connectTimeout がこんなに大きいのはなぜですか?
Connector/J の connectTimeout そして socketTimeout はミリ秒単位で、どちらも既定値は0、つまり制限なしです。 connectTimeout=10000 は 10 秒です。MySqlConnector の Connection Timeout は秒単位です (デフォルトは 15)。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、MySQL などでスキーマ対応の IntelliSense を利用できます。