连接MySQL的URL通用格式：

protocol//[hosts][/database][?properties]

URL中的任何保留字符(例如: /，：，@，(，)，[，]，&，#，=?，和空格)必须进行百分比编码(URL编码)。

01.协议

协议有以下几种：

jdbc:mysql 最基本和常用的JDBC连接。

jdbc:mysql:loadbalance 用于负载均衡JDBC连接。为集群或主-主复制部署提供了一种在多个MySQL服务器实例之间分配读/写负载的方法。通过以下连接URL配置负载均衡，格式如下：

jdbc:mysql:loadbalance://[host1][:port],[host2][:port][,[host3][:port]]...[/[database]][?propertyName1=propertyValue1[&propertyName2=propertyValue2]...]

jdbc:mysql:replication 用于JDBC主-从复制连接。格式为：

jdbc:mysql:replication://[source host][:port],[replica host 1][:port][,[replica host 2][:port]]...[/[database]][?propertyName1=propertyValue1[&propertyName2=propertyValue2]...]

mysqlx 用于X DevAPI连接。

X 协议。X 协议是一种基于 Protobuf 格式的新型客户端协议，可以同时支持 CRUD 和 SQL 操作。

X DevAPI。X DevAPI 是一种基于 X 协议之上新型现代化的异步 API，用于 CRUD 和 SQL 操作。它引入了一种新的模式对象：集合(Collection)。文档存储在集合中(类似于行存储在表中)，并且提供了专用的 CRUD 操作命令集。

jdbc:mysql+srv 用于使用DNS srv记录的普通和基本故障转移jdbc连接。

jdbc:mysql+srv:loadbalance 用于负载平衡使用DNS srv记录的jdbc连接。

jdbc:mysql+srv:replication 用于复制使用DNS srv记录的jdbc连接。

mysqlx+srv 用于使用DNS srv记录的X DevAPI连接。

02.主机

根据情况，主机部分可能仅由主机名组成，也可能是由多种元素组成的复合结构，如多个主机名、端口号。

单个主机

hosts部分以host:port的格式编写。一个简单的单主机连接URL示例如下：

jdbc:mysql://host1:33060/test_db

host可以是IPv4或IPv6主机名字符串。若是IPv6必须放在方括号内，例如“[10000:2000:：abcd]”。如果未指定host，则使用localhost的默认值。

port是标准端口号，即介于1和65535之间的整数。普通MySQL连接的默认端口号为3306，使用X协议的连接为33060。如果未指定端口，则使用相应的默认值。

单主机可添加属性，有两种可选格式：

• “address-equals”形式：address=(host=host_or_ip)(port=port)(key1=value1)(key2=value2)...(keyN=valueN)

示例：

jdbc:mysql://address=(host=myhost)(port=1111)(key1=value1)/db

• “key-value”形式：(host=host,port=port,key1=value1,key2=value2,...,keyN=valueN)

示例：

jdbc:mysql://(host=myhost,port=1111,key1=value1)/db

主机和端口由关键字host和port标识。可以添加的其他属性包括用户、密码、协议等。这里添加的属性会优先于URL中的全局参数使用。

多个主机

指定多个主机有两种格式：

• 以逗号分隔的列表列出主机：host1,host2,...,hostN

示例：

jdbc:mysql://myhost1:1111,myhost2:2222/db
jdbc:mysql://address=(host=myhost1)(port=1111)(key1=value1),address=(host=myhost2)(port=2222)(key2=value2)/db
jdbc:mysql://(host=myhost1,port=1111,key1=value1),(host=myhost2,port=2222,key2=value2)/db
jdbc:mysql://myhost1:1111,(host=myhost2,port=2222,key2=value2)/db
mysqlx://(address=host1:1111,priority=1,key1=value1),(address=host2:2222,priority=2,key2=value2)/db

• 以逗号分隔的列表列出主机，然后用方括号将列表括起来：[host1，host2，…，hostN]。它允许列表中的所有主机共享用户凭据，就好像它们是一个主机一样。

示例：

jdbc:mysql://sandy:secret@[myhost1:1111,myhost2:2222]/db
jdbc:mysql://sandy:secret@[address=(host=myhost1)(port=1111)(key1=value1),address=(host=myhost2)(port=2222)(key2=value2)]/db
jdbc:mysql://sandy:secret@[myhost1:1111,address=(host=myhost2)(port=2222)(key2=value2)]/db

03.数据库名

数据库名表示要打开的默认数据库或目录。如果未指定数据库，则不使用默认数据库进行连接。在这种情况下，在Connection实例上调用setCatalog()方法或setSchema()方法，或者在SQL语句中使用数据库名称(即SELECT dbname.tablename.colname FROM dbname.ttablename…)指定表名。

通常，打开连接而不指定要使用的数据库只有在构建可与多个数据库一起使用的工具(如GUI数据库管理器，Workbench、Navicat等)时才有用。

注意：实际中，应始终在URL中指定数据库，或使用Connection.setCatalog()、Connection.setSchema()二者之一方法在JDBC应用程序中指定所需的数据库，而不是use <database>;语句。

04.参数

数据库名后加“?”，然后拼接key=value形式的键值对，键值对由符号“&”分隔，这些是应用于所有主机的一系列全局参数属性。示例：

jdbc:mysql://localhost:3306/test_db?key1=value1&key2=value2&key3=value3

其中，

• key和value只是作为字符串对待，正确的类型转换和验证在JDBC内部执行。
• key区分大小写。
• 此处的key-value属性是全局属性，如果对单个主机指定了属性，将优先使用单个主机指定的属性。
• 绝大部分参数都有默认值，如果不在URL中指定，将使用默认值。

URL中的可以指定的参数有很多，包括身份验证、Session、网络、安全、结果集、元数据、调试分析、高可用等各个方面。下面选取一部分简单介绍。

身份验证

user

连接身份的用户。

password

验证用户时使用的密码。

Connection

connectionAttributes

除了标准的MySQL定义的“key:value”对之外，还要传递给MySQL Server的用户定义的“键：值”对的逗号分隔列表，以在“PERFORMANCE_SCHEMA”表“session_account_connect_attrs”和“session _connect _attrs）中显示为连接属性。示例用法：“connectionAttributes=key1:value1，key2:value2”此功能仅可用于MySQL Server 5.6或更高版本。早期版本的MySQL Server不支持连接属性，导致忽略此配置选项。在连接创建/初始化速度至关重要的情况下，设置“connectionAttributes=none”将导致绕过连接属性处理。

createDatabaseIfNotExist

默认值：false

如果URL中给定的数据库尚不存在，则创建该数据库。假设配置的用户具有创建数据库的权限。

databaseTerm

默认值：CATALOG

MySQL使用术语“Schema”作为术语“数据库”的同义词，而在历史上曾使用JDBC术语“Catalog”作为“数据库”同义词。该属性设置JDBC术语“Catalog”和“Schema”中的哪一个在应用程序中用于引用数据库。该属性采用两个值“CATALOG”或“SCHEMA”中的一个，并使用它确定：（1）使用哪种Connection方法来设置/获取当前数据库（例如，“setCatalog()”或“setSchema()）

（2） 在各种“DatabaseMetaData”方法中可以使用哪些参数来过滤结果（例如，“getColumns()”的catalog或“schemaPattern”参数？）

（3）“DatabaseMetaData”方法返回的结果集中的哪些字段包含数据库标识信息（即，“getTables（）”返回的结果集中的“TABLE_CAT”或“TABLE.SCHEM”字段？）。

如果“databaseTerm=CATALOG”，则搜索的“schemaPattern”将被忽略，模式方法的调用（如“setSchema()”或“getschema()”）将变为无操作，反之亦然。

passwordCharacterEncoding

指示服务器在身份验证阶段使用指定Java编码的默认字符集。如果未设置此属性，将按优先级顺序回退到属性“connectionCollation”中指定的排序规则名称或属性“characterEncoding”中指定的Java编码。如果未设置任何属性，则使用字符集utf8mb4的默认排序规则。

characterEncoding

指示服务器将会话系统变量“character_set_client”和“characters_set_connection”设置为MySQL支持的用于指定Java字符编码的默认字符集，并将“collation_connect”设置为该字符集的默认排序规则。如果既没有设置此属性，也没有设置属性“connectionCollation”：

• 对于MySQL 8.0.25及更早版本，驱动程序将尝试使用服务器的默认字符集；
• 对于MySQL 8.0.26及更高版本，驱动程序将使用“utf8mb4”。

characterSetResults

指示服务器返回使用指定Java编码的默认字符集编码的数据。如果未设置或设置为“null”，服务器将以其原始字符集发送数据，驱动程序将根据结果元数据对其进行解码。

网络

connectTimeout

套接字连接超时(毫秒)。值“-1”表示没有超时，是默认值。

socketTimeout

网络套接字操作超时(毫秒)。值“-1”表示没有超时，是默认值。

maxAllowedPacket

默认值：65535

允许发送到服务器的最大数据包大小。如果未设置，则系统变量“max_allowed_packet”的值将用于在连接时对此进行初始化。如果设置大于“max_allowed_packet”的值，则该值将不会生效。

此外，由于属性“blobSendChunkSize”的内部依赖性，如果“useServerPrepStmts”设置为“true”，则此设置的最小值为“8203”。

useCompression

默认值：false

与服务器通信时使用zlib压缩？

安全

paranoid

默认值：false

采取措施防止在错误消息中暴露敏感信息，并在可能时清除保存敏感数据的数据结构?

sslMode

默认值：PREFERRED

默认情况下，网络连接是SSL加密的；该属性允许关闭安全连接，或选择不同的安全级别。允许以下值：

• “DISABLED”-建立未加密的连接；“首选”-如果服务器启用了加密连接，则建立加密连接，否则回退到未加密连接；
• “PREFERRED”-如果服务器启用安全连接，则建立安全连接，否则失败；
• “VERIFY_CA”-类似于“PREFERRED”，但另外根据配置的证书颁发机构（CA）证书验证服务器TLS证书；
• “VERIFY_IDENTITY”-类似于“VERIFY_CA”，但还要验证服务器证书是否与尝试连接的主机匹配。

此属性替换了不推荐使用的旧属性“useSSL”、“requireSSL”和“verifyServerCertificate”，这些旧属性仍然有效，但如果未显式设置“sslMode”，则转换为“sslModel”的值：

• “useSSL=false”转换为“sslMode=DISABLED”；
• {“useSSL=true”，“requireSSL=false”，“verifyServerCertificate=false”}转换为“sslMode=PREFERRED”；
• {“useSSL=true”，“requireSSL=true”，“verifyServerCertificate=false”}转换为“sslMode=REQUIRED”；
• {“useSSL=true”，“verifyServerCertificate=true”}转换为“sslMode=VERIFY_CA”。

“sslMode=VERIFY_IDENTITY”没有等效的旧版设置。对于所有MySQL版本，“sslMode”的默认设置为“PREFERRED”，它等效于“useSSL=true”、“requireSSL=false”和“verifyServerCertificate=false”的传统设置。

如果显式设置“sslMode”，则会忽略旧属性。如果没有显式设置“sslMode”或“useSSL”，则应用默认设置“sslMode=PREFERRED”。

Result Sets

maxRows

要返回的最大行数。默认值“-1”表示返回所有行。

padCharsWithSpace

默认值：false

如果结果集列有CHAR类型，并且该值没有填充DDL中为该列指定的字符长度，那么驱动程序是否应该用空格填充剩余的字符?

tinyInt1isBit

默认值：true

由于MySQL服务器在创建表时会自动将BIT转换为TINYINT(1)，因此驱动程序是否应该将数据类型TINYINT(1)视为BIT类型？

transformedBitIsBoolean

默认值：false

如果驱动程序将TINYINT(1)转换为不同的类型，它应该使用BOOLEAN而不是BIT吗？

Datetime类型处理

connectionTimeZone

配置MySQL使用的时区，在存入数据库时需要在JVM默认时区和目标时区之间进行转换。

使用“java.time.ZoneId”能够解析的值，或“LOCAL”和“SERVER”二者之一，默认值为“LOCAL”。

如果设置为“LOCAL”，则驱动程序假设连接时区与JVM默认时区相同。

如果设置为“SERVER”，则驱动程序会尝试从MySQL SERVER会话变量“time_zone”或“system_time_zone”上配置的值检测会话时区。

旧版本设置项“serverTimezone”作为此参数的别名仍然有效，但将来可能会弃用。

zeroDateTimeBehavior

默认值：EXCEPTION

当驱动程序遇到完全由零组成的DATETIME值，如0000-00-00（MySQL使用这些值来表示无效的日期）时，应该发生什么情况？有效值为“EXCEPTION”、“ROUND”和“CONVERT_TO_NULL”。