scheme: 使用するトランスポートプロトコル。 X プロトコル 接続には mysqlx を、クラシック MySQL プロトコル 接続には mysql を使用します。 プロトコルが指定されていない場合、サーバーはプロトコルの推測を試みます。 DNS SRV をサポートするコネクタは、mysqlx+srv スキームを使用できます (Connections Using DNS SRV Records を参照)。

user: 認証プロセスに提供する MySQL ユーザーアカウント。

password: 認証プロセスに使用するパスワード。

host: サーバーインスタンスが実行されているホスト。 値には、ホスト名、IPv4 アドレスまたは IPv6 アドレスを指定できます。 ホストが指定されていない場合、デフォルトは localhost です。

port: ターゲット MySQL サーバーが接続をリスニングしている TCP/IP ネットワークポート。 ポートが指定されていない場合、デフォルトは、X プロトコル 接続の場合は 33060、クラシック MySQL プロトコル 接続の場合は 3306 です。

socket: Unix ソケットファイルへのパスまたは Windows 名前付きパイプの名前。 値はローカルファイルパスです。 URI のような文字列では、パーセントエンコーディングを使用するか、パスをカッコで囲んでエンコードする必要があります。 カッコを使用すると、/ディレクトリセパレータ文字などの文字をパーセントエンコードする必要がなくなります。 たとえば、Unix ソケット/tmp/mysql.sock を使用して root@localhost として接続するには、root@localhost?socket=%2Ftmp%2Fmysql.sock としてパーセントエンコーディングを使用するか、root@localhost?socket=(/tmp/mysql.sock) としてカッコを使用してパスを指定します。

schema: 接続のデフォルトデータベース。 データベースが指定されていない場合、接続にはデフォルトのデータベースはありません。

ssl-mode: 接続に必要なセキュリティ状態。 次のモードを使用できます:

これらのモードの詳細は、暗号化接続のコマンドオプション の --ssl-mode オプションの説明を参照してください。

ssl-ca: PEM 形式の X.509 認証局ファイルへのパス。

ssl-capath: PEM 形式の X.509 認証局ファイルを含むディレクトリへのパス。

ssl-cert: PEM 形式の X.509 証明書ファイルへのパス。

ssl-cipher: TLSv1.2 までの TLS プロトコルを使用する接続に使用する暗号。

ssl-crl: PEM 形式の証明書失効リストを含むファイルへのパス。

ssl-crlpath: PEM 形式の証明書失効リストファイルを含むディレクトリへのパス。

ssl-key: PEM 形式の X.509 キーファイルへのパス。

tls-version : クラシック MySQL プロトコル の暗号化された接続に許可される TLS プロトコル。 このオプションは、MySQL Shell でのみサポートされます。 tls-version (単数形) の値は、TLSv1.1,TLSv1.2 などのカンマ区切りリストです。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。 このオプションは、DISABLED に設定されていない ssl-mode オプションに依存します。

tls-versions : 暗号化された X プロトコル 接続に許可される TLS プロトコル。 tls-versions (plural) の値は、[TLSv1.2,TLSv1.3]などの配列です。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。 このオプションは、DISABLED に設定されていない ssl-mode オプションに依存します。

tls-ciphersuites: 許可される TLS 暗号スイート。 tls-ciphersuites の値は、「TLS 暗号スイート」にリストされている IANA 暗号スイート名のリストです。 詳細は、セクション6.3.2「暗号化された接続 TLS プロトコルおよび暗号」を参照してください。 このオプションは、DISABLED に設定されていない ssl-mode オプションに依存します。

auth-method: 接続に使用する認証方式。 デフォルトは AUTO で、サーバーは推測を試みます。 次のメソッドを使用できます:

X プロトコル 接続の場合、構成された auth-method は、この一連の認証方式にオーバーライドされます: MYSQL41, SHA256_MEMORY, PLAIN.

get-server-public-key: RSA キーペアベースのパスワード交換に必要な公開キーをサーバーにリクエストします。 SSL モード DISABLED を使用して クラシック MySQL プロトコル 経由で MySQL 8.0 サーバーに接続する場合に使用します。 この場合、プロトコルを指定する必要があります。 例:

mysql://user@localhost:3306?get-server-public-key=true

このオプションは、caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 そのプラグインの場合、サーバーは要求されないかぎり公開鍵を送信しません。 このオプションは、そのプラグインで認証されないアカウントでは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、get-server-public-key よりも優先されます。

caching_sha2_password プラグインの詳細は、セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

server-public-key-path: RSA キーペアベースのパスワード交換のためにサーバーが必要とする公開キーのクライアント側コピーを含む、PEM 形式のファイルへのパス名。 SSL モード DISABLED を使用して クラシック MySQL プロトコル 経由で MySQL 8.0 サーバーに接続する場合に使用します。

このオプションは、sha256_password または caching_sha2_password 認証プラグインで認証されるクライアントに適用されます。 これらのプラグインのいずれかで認証されないアカウントでは、このオプションは無視されます。 クライアントがセキュアな接続を使用してサーバーに接続する場合と同様に、RSA ベースのパスワード交換を使用しない場合も無視されます。

server-public-key-path=file_name が指定され、有効な公開キーファイルが指定されている場合は、get-server-public-key よりも優先されます。

sha256_password および caching_sha2_password プラグインの詳細は、セクション6.4.1.3「SHA-256 プラガブル認証」 および セクション6.4.1.2「SHA-2 プラガブル認証のキャッシュ」 を参照してください。

connect-timeout : クライアント ( MySQL Shell など) が応答しない MySQL サーバーへの接続の試行を停止するまで待機する秒数を構成するために使用される整数値。

compression: このオプションは、接続の圧縮をリクエストまたは無効化します。 MySQL 8.0.19 までは、クラシック MySQL プロトコル 接続に対してのみ動作し、MySQL 8.0.20 からは X プロトコル 接続に対しても動作します。

MySQL クライアントごとに、接続圧縮のサポートが異なることに注意してください。 詳細は、クライアントのドキュメントを参照してください。

compression-algorithms および compression-level : これらのオプションは、接続の圧縮をより詳細に制御するために MySQL Shell 8.0.20 以降で使用できます。 これらを指定して、接続に使用される圧縮アルゴリズムと、そのアルゴリズムで使用される数値圧縮レベルを選択できます。 compression のかわりに compression-algorithms を使用して、接続の圧縮をリクエストすることもできます。 MySQL Shell の接続圧縮制御の詳細は、圧縮接続の使用 を参照してください。

connection-attributes: 接続時にアプリケーションプログラムがサーバーに渡すキーと値のペアを制御します。 接続属性の一般情報は、セクション27.12.9「パフォーマンススキーマ接続属性テーブル」 を参照してください。 クライアントは通常、属性のデフォルトセットを定義します。これは無効または有効にできます。 例:

mysqlx://user@host?connection-attributes
mysqlx://user@host?connection-attributes=true
mysqlx://user@host?connection-attributes=false

デフォルトの動作では、デフォルトの属性セットが送信されます。 アプリケーションでは、デフォルト属性に加えて渡される属性を指定できます。 追加の接続属性は、接続文字列の connection-attributes パラメータとして指定します。 connection-attributes パラメータ値は空 (true の指定と同じ)、Boolean 値 (デフォルトの属性セットを有効または無効にする true または false) またはカンマで区切られたリストまたはゼロ以上の key=value 指定子 (デフォルトの属性セットに加えて送信される) である必要があります。 リスト内では、欠落しているキー値は空の文字列として評価されます。 その他の例:

mysqlx://user@host?connection-attributes=[attr1=val1,attr2,attr3=]
mysqlx://user@host?connection-attributes=[]

アプリケーション定義の属性名は内部属性用に予約されているため、_で始めることはできません。

ポート 33065 でリスニングしているローカルサーバーインスタンスへの X プロトコル 接続。

mysqlx://user_name@localhost:33065

ポート 3333 でリスニングしているローカルサーバーインスタンスへの クラシック MySQL プロトコル 接続。

mysql://user_name@localhost:3333

ホスト名、IPv4 アドレスおよび IPv6 アドレスを使用したリモートサーバーインスタンスへの X プロトコル 接続。

mysqlx://user_name@server.example.com/
mysqlx://user_name@198.51.100.14:123
mysqlx://user_name@[2001:db8:85a3:8d3:1319:8a2e:370:7348]

パーセントエンコーディングまたはカッコを使用してパスが指定されたソケットを使用した X プロトコル 接続。

mysqlx://user_name@/path%2Fto%2Fsocket.sock
mysqlx://user_name@(/path/to/socket.sock)

データベースを表すオプションのパスを指定できます。

# use 'world' as the default database
mysqlx://user_name@198.51.100.1/world

# use 'world_x' as the default database, encoding _ as %5F
mysqlx://user_name@198.51.100.2:33060/world%5Fx

オプションのクエリーを指定できます。各クエリーは、key=value ペアまたは単一の key として指定された値で構成されます。 複数の値を指定するには、,文字で区切ります。 key=value と key の値を混在させることができます。 値はリストタイプで、リスト値は外観順に並べられます。 文字列はパーセントでエンコードするか、カッコで囲む必要があります。 次は同等です。

ssluser@127.0.0.1?ssl-ca=%2Froot%2Fclientcert%2Fca-cert.pem\
&ssl-cert=%2Froot%2Fclientcert%2Fclient-cert.pem\
&ssl-key=%2Froot%2Fclientcert%2Fclient-key

ssluser@127.0.0.1?ssl-ca=(/root/clientcert/ca-cert.pem)\
&ssl-cert=(/root/clientcert/client-cert.pem)\
&ssl-key=(/root/clientcert/client-key)

暗号化された接続に使用する TLS バージョンおよび暗号スイートを指定するには:

mysql://user_name@198.51.100.2:3306/world%5Fx?\
tls-versions=[TLSv1.2,TLSv1.3]&tls-ciphersuites=[TLS_DHE_PSK_WITH_AES_128_\
GCM_SHA256, TLS_CHACHA20_POLY1305_SHA256]

ポート 33065 でリスニングしているローカルサーバーインスタンスへの X プロトコル 接続。

{user:'user_name', host:'localhost', port:33065}

ポート 3333 でリスニングしているローカルサーバーインスタンスへの クラシック MySQL プロトコル 接続。

{user:'user_name', host:'localhost', port:3333}

ホスト名、IPv4 アドレスおよび IPv6 アドレスを使用したリモートサーバーインスタンスへの X プロトコル 接続。

{user:'user_name', host:'server.example.com'}
{user:'user_name', host:198.51.100.14:123}
{user:'user_name', host:[2001:db8:85a3:8d3:1319:8a2e:370:7348]}

ソケットを使用した X プロトコル 接続。

{user:'user_name', socket:'/path/to/socket/file'}

データベースを表すオプションのスキーマを指定できます。

{user:'user_name', host:'localhost', schema:'world'}