25.12.9 性能架构连接属性 table

连接属性是键值对,应用程序可以在连接时将它们传递给服务器。对于基于libmysqlclientClient 端库实现的 C API 的应用程序,mysql_options()mysql_options4()函数定义连接属性集。其他 MySQL 连接器可以提供自己的属性定义方法。

这些性能模式 table 公开了属性信息:

以下划线(_)开头的属性名称仅供内部使用,不应由应用程序创建。该约定允许 MySQL 引入新属性而不会与应用程序属性发生冲突,并使应用程序能够定义自己的与内部属性不发生冲突的属性。

可用的连接属性

给定 Connecting 可见的连接属性集取决于各种因素,例如您的平台,用于构建连接的 MySQL Connector 或 Client 端程序。

libmysqlclientClient 端库设置以下属性:

其他 MySQL 连接器可以定义自己的连接属性。

MySQL Connector/J 定义了以下属性:

MySQL Connector/NET 定义了以下属性:

PHP 定义了取决于其编译方式的属性:

许多 MySQLClient 端程序将program_name属性设置为等于 Client 端名称的值。例如,mysqladminmysqldump分别将program_name设置为mysqladminmysqldump

一些 MySQLClient 端程序定义了其他属性:

连接属性限制

从 Client 端传输到服务器的连接属性数据的数量受到限制:

对于使用 C API 启动的连接,libmysqlclient库在 Client 端的连接属性数据的总大小上施加了 64KB 的限制:导致超出此限制的mysql_options()调用将产生CR_INVALID_PARAMETER_NO错误。其他 MySQL 连接器可能会对可以将多少连接属性数据传输到服务器施加自己的 Client 端限制。

在服务器端,将对连接属性数据进行以下大小检查:

[Warning] Connection attributes of length N were truncated
首页