MySQL :: X DevAPI 用户指南 :: 2.2.6 连接属性

X DevAPI 用户指南 / ... / 连接属性

2.2.6 连接属性

连接属性是应用程序在连接时可以传递给服务器的键值对，以便存储在 PERFORMANCE_SCHEMA 表 session_account_connect_attrs 和 session_connect_attrs 中。连接属性有两种不同的类型。

客户端定义的属性是由客户端隐式编码的保留键值映射。客户端定义的属性集因客户端而异 - 有关详细信息，请参阅客户端的 X DevAPI 参考。客户端定义的属性默认情况下会发送到服务器。
用户定义的属性是由用户或应用程序提供的键值映射。

X DevAPI 通过连接参数 connection-attributes（Connector/J 中为 xdevapi.connection-attributes）支持 MySQL 连接属性，该参数通过 getSession() 和 getClient() 方法设置。以下是使用该参数的不同方法。

当不使用该参数时，这些参数的设置等效于默认行为（即发送客户端定义的属性）。
- connection-attributes
- connection-attributes=
- connection-attributes=true
- connection-attributes=[]
connection-attributes=false 阻止发送任何连接属性，包括客户端定义的属性。
connection-attributes=[key1=value1,key2=value2, ...] 作为键值对发送用户定义的连接属性，以及客户端定义的连接属性。当键值对中缺少值时，会为该属性设置空值。

以下是一个配置连接属性的连接字符串的通用示例。

mysqlx://user:password@localhost:33060?connection-attributes=[key1=value1,key2=value2,key3=]