MYSQL_C_API详解

上传者：田景文
|
上传时间：2015-04-24
|
密次下载

MYSQL_C_API详解


 mysql api for C 详细介绍(1)
 2009-11-22 16:33
 C API 代码是随MySQL 分发的，它被包含在mysqlclient 库且允许C 程序存取
一个数据库。在 MySQL 源代码分发中的很多客户是用 C 编写的。如果你正
在寻找演示怎样使用C API 的例子，看一下这些客户程序。
 大多数其他客户 API(除了Java 的所有)都使用mysqlclient 库与MySQL 服务器
通信。这意味着，例如，你能利用很多被其他客户程序使用的同一环境变量，因
为他们从库中引用。对这些变量的一张表，见12.1 不同的MySQL 程序的概述。
 客户有一个最大通讯缓冲区大小。初始分配的缓冲区大小(16K 字节) 自动地增
加到最大尺寸(缺省的最大值是 24M)。因为缓冲区大小只是按保证需求而被增
加，简单地增加缺省的最大限制并不造成更多被消耗。该尺寸检查主要是一个对
错误的查询和通讯包的检查。
 通讯缓冲区必须足够大以便一个单独的 SQL 语句(对客户-服务器传输)和一行
返回的数据 (对服务器-客户传输)。每个线程的通讯缓冲区被动态扩大到最大限
制来处理任何查询或行。例如，如果你包含大到16M数据的BLOB 值，你必须
有一个至少 16M 通讯缓冲区限制(在服务器和客户两端)。客户的缺省最大值是
24M，但是在服务器端的缺省最大值是 1M。你可以在服务器启动时通过改变
max_allowed_packet 参数的值来改变它。见10.2.3 调节服务器参数。 MySQL 服
务器在每个查询后缩小每个通讯缓冲区到net_buffer_length 个字节。对客户，与
一个连接相关的缓冲区的大小没被减少，直到连接被关闭，在此时客户内存被回
收。
 如果你用线程的编程，你应该用--with-thread-safe-client 编译MySQL C API，这
将使C API 线程对每个连接更安全。你可以让2 个线程共享相同的连接，只要如
果你做下列事情：
 两个线程不能同时在同一个连接上发送查询到 MySQL。特别是你必须保证在
一个 mysql_query()和 mysql_store_result()之间没有其他线程正在使用同一个连
接。
 许多线程能存取用mysql_store_result()检索出来的不同结果集合。
 如果你使用mysql_use_result，你必须保证没有其他线程在同一个连接上正在询
问任何东西，直到结果集合被关闭。
 20.2 C API 数据类型
 MYSQL
 这个结构表示对一个数据库连接的句柄，它被用于几乎所有的MySQL 函数。
 MYSQL_RES
 这个结构代表返回行的一个查询的 (SELECT, SHOW, DESCRIBE, EXPLAIN)的
结果。从查询返回的信息在本章下文称为结果集合。
 MYSQL_ROW
 这是一个行数据的类型安全(type-safe)的表示。当前它实现为一个计数字节的
字符串数组。（如果字段值可能包含二进制数据，你不能将这些视为空终止串，
因为这样的值可以在内部包含空字节) 行通过调用mysql_fetch_row()获得。
 MYSQL_FIELD
 这个结构包含字段信息，例如字段名、类型和大小。其成员在下面更详细地描

教育资源为主的文档平台

文档分类