方案：要使用的传输协议。使用 mysqlx 连接 X 协议连接和 mysql 连接经典 MySQL 协议连接。如果未指定协议，服务器将尝试猜测协议。支持 DNS SRV 的连接器可以使用 mysqlx+srv 方案（见 使用 DNS SRV 记录的连接）。

用户：要提供的 MySQL 用户帐户用于身份验证过程。

密码：用于身份验证过程的密码。

主机：服务器实例正在运行的主机。该值可以是主机名、IPv4 地址或 IPv6 地址。如果未指定主机，默认为 localhost。

端口：目标 MySQL 服务器监听连接的 TCP/IP 网络端口。如果未指定端口，默认为 X 协议连接的 33060 和经典 MySQL 协议连接的 3306。

socket: Unix套接字文件的路径或Windows命名管道的名称。值是本地文件路径。在URI-like字符串中，它们必须被编码，使用百分号编码或将路径括在括号中。括号消除了对目录分隔符字符（如/）的百分号编码的需要。例如，要连接到root@localhost，使用Unix套接字/tmp/mysql.sock，可以使用百分号编码指定路径为root@localhost?socket=%2Ftmp%2Fmysql.sock，或使用括号指定路径为root@localhost?socket=(/tmp/mysql.sock)。

schema: 连接的默认数据库。如果未指定数据库，则连接没有默认数据库。

ssl-mode: 连接的所需安全状态。以下模式是允许的：

有关这些模式的信息，请参阅--ssl-mode选项描述在命令选项用于加密连接中。

ssl-ca: X.509证书颁发机构文件的路径，在PEM格式中。

ssl-capath: 包含X.509证书颁发机构文件的目录的路径，在PEM格式中。

ssl-cert: X.509证书文件的路径，在PEM格式中。

ssl-cipher: 对于使用TLS协议的连接，使用的加密密码为TLSv1.2。

ssl-crl: 包含证书撤销列表的PEM格式文件的路径。

ssl-crlpath: 包含证书撤销列表文件的PEM格式目录的路径。

ssl-key: X.509密钥文件的路径，格式为PEM。

tls-version: 经典MySQL协议加密连接允许的TLS协议。该选项仅支持MySQL Shell。 tls-version（单数）的值是一个逗号分隔的列表，例如 TLSv1.2,TLSv1.3。详细信息，请参阅 第 8.3.2 节，“加密连接TLS协议和密码”。该选项取决于 ssl-mode 选项不被设置为 DISABLED。

tls-versions: 加密X协议连接允许的TLS协议。 tls-versions（复数）的值是一个数组，例如 [TLSv1.2,TLSv1.3]。详细信息，请参阅 第 8.3.2 节，“加密连接TLS协议和密码”。该选项取决于 ssl-mode 选项不被设置为 DISABLED。

tls-ciphersuites: 允许的TLS密码套件。 tls-ciphersuites 的值是一个 IANA 密码套件名称列表，列举在 TLS 密码套件。详细信息，请参阅 第 8.3.2 节，“加密连接TLS协议和密码”。该选项取决于 ssl-mode 选项不被设置为 DISABLED。

auth-method: 连接的身份验证方法。默认为 AUTO，表示服务器尝试猜测。允许的方法包括：

对于X协议连接，任何配置的 auth-method 都将被覆盖为以下身份验证方法序列：MYSQL41、SHA256_MEMORY、PLAIN。

get-server-public-key: 从服务器请求用于 RSA 密钥对基于密码交换的公钥。当使用经典 MySQL 协议连接到 MySQL 8+ 服务器时，使用 SSL 模式 DISABLED。在这种情况下，您必须指定协议。例如：

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 插件的信息，请参阅 第 8.4.1.2 节，“Caching SHA-2 可插拔身份验证”。

server-public-key-path: 包含服务器所需的公钥的文件路径，以便在使用经典 MySQL 协议连接到 MySQL 8+ 服务器时进行 RSA 密钥对基于密码交换。使用 SSL 模式 DISABLED。

此选项适用于使用 sha256_password 或 caching_sha2_password 身份验证插件的客户端。该选项将被忽略，如果客户端使用安全连接连接到服务器，则 RSA 基于密码交换不使用。

如果 server-public-key-path=file_name 指定了一个有效的公钥文件，则它将优先于 get-server-public-key。

有关 sha256_password 和 caching_sha2_password 插件的信息，请参阅 第 8.4.1.3 节，“SHA-256 可插拔身份验证” 和 第 8.4.1.2 节，“Caching SHA-2 可插拔身份验证”。

ssh: 连接到 MySQL 服务器实例的 SSH 服务器的 URI，使用 SSH 隧道连接。URI 格式为 [user@]host[:port]。使用 uri 选项指定目标 MySQL 服务器实例的 URI。有关 MySQL Shell 中的 SSH 隧道连接的信息，请参阅 使用 SSH 隧道。

uri: MySQL 服务器实例的 URI，通过 SSH 隧道从服务器指定的 ssh 选项访问。URI 格式为 [scheme://][user@]host[:port]。不要使用基本连接参数 (scheme、user、host、port) 来指定 MySQL 服务器连接用于 SSH 隧道，只使用 uri 选项。

ssh-password: SSH 服务器连接的密码。

ssh-config-file: SSH 服务器连接的 SSH 配置文件。你可以使用 MySQL Shell 配置选项 ssh.configFile 设置自定义文件作为默认文件，如果未指定此选项。如果 ssh.configFile 未设置，默认为标准 SSH 配置文件 ~/.ssh/config。

ssh-identity-file: 用于 SSH 服务器连接的身份文件。默认情况下，如果未指定此选项，则使用 SSH 代理（如果使用）中的任何身份文件，或者在 SSH 配置文件中，或者标准私钥文件在 SSH 配置文件夹中 (~/.ssh/id_rsa)。

ssh-identity-pass: 由 ssh-identity-file 选项指定的身份文件的密码。

connect-timeout: 一个整数值，用于配置客户端（如 MySQL Shell）等待连接到无响应 MySQL 服务器的秒数。

compression: 此选项请求或禁用连接的压缩。

此选项的可用值为：required，请求压缩并在服务器不支持时失败：preferred，请求压缩并回退到未压缩连接：disabled，请求未压缩连接并在服务器不允许时失败。preferred 是 X 协议连接的默认值，而 disabled 是经典 MySQL 协议连接的默认值。有关 X 插件连接压缩控制的信息，请参阅 第 22.5.5 节，“使用 X 插件的连接压缩”。

压缩算法 和 压缩级别：这些选项在 MySQL Shell 中可用于控制连接压缩。您可以指定它们以选择连接所使用的压缩算法，以及该算法所使用的数字压缩级别。您还可以使用 压缩算法 代替 压缩 来请求连接压缩。有关 MySQL Shell 连接压缩控制的信息，请参阅 使用压缩连接。

连接属性：控制应用程序在连接时传递给服务器的键值对。有关连接属性的一般信息，请参阅 第 29.12.9 节，“性能模式连接属性表”。客户端通常定义一组默认的属性，可以禁用或启用。例如：

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

默认行为是发送默认的属性集。应用程序可以指定要传递的附加连接属性作为连接字符串中的 连接属性 参数。 连接属性 参数值必须为空（与指定 true 相同），布尔值 (true 或 false 以启用或禁用默认属性集），或以逗号分隔的零个或多个 键=值 规范（在默认属性集之外发送）。在列表中，缺少键值将被评估为空字符串。进一步的示例：

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

应用程序定义的属性名称不能以 _ 开头，因为这些名称保留用于内部属性。

使用 X 协议连接到本地服务器实例，监听端口 33065。

mysqlx://user_name@localhost:33065

使用经典的 MySQL 协议连接到本地服务器实例，监听端口 3333。

mysql://user_name@localhost:3333

使用 X 协议连接到远程服务器实例，使用主机名、IPv4 地址和 IPv6 地址。

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]

使用套接字连接，路径使用百分号编码或括号提供。

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

可以指定一个可选的查询，consisting of 值对，例如 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]

使用 X 协议连接到本地服务器实例，监听端口 33065。

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

使用经典的 MySQL 协议连接到本地服务器实例，监听端口 3333。

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

使用 X 协议连接到远程服务器实例，使用主机名、IPv4 地址和 IPv6 地址。

{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'}