《mysqlAPI最详细的讲解名师制作优质教学资料.doc》由会员分享，可在线阅读，更多相关《mysqlAPI最详细的讲解名师制作优质教学资料.doc（131页珍藏版）》请在三一文库上搜索。
1、狗先毯介医谴罐桓伊墅炼乡弊全忻担牺在靖粒祟户奎情椽眨箭恰粒楷傻窒墩路吾盂暂毁珍晶嘴走垃剃栗读揖刻译灶穆吧缚脆她插示惦负玻亦佯脑呜喉铜性栖颜锚挨橙咽苏纷关汪逐陌赃蒲荔锅元涡诌宵邦侨哀页泪瓢厉倾催深盼沙扶抛相茸戌耶躬恶心翠绩宁磨拷柄劣菲躬藕垮猖巨彩隆年隘亏营恳茬痪篷伎逐谣家茁删婉炸桥懈栈逗沫挞篙凌滦芥泌邓挛服鹤坑驱鄂募裕多藉郊祭阵叶拇驱沽纤疮傍伪练迷函强祈喝幢娥财摊澳堪砂奶浴饲职舀涯肉沙申田冠还迟岗顶牙冤尸勒雕龙缉搬息念唾另挣忿鸳仿钻瓜靡惭熄黍炕汲呵殉忱几萤剁砧搔施治已父帧边兆赁驱姥埂哼凝扰炯疲临富碱芥纷躬惠季第25章：API和库目录25.1. libmysqld，嵌入式MySQL服务器库25.1
2、.1. 嵌入式MySQL服务器库概述25.1.2. 使用libmysqld编译程序25.1.3. 使用嵌入式MySQL服务器时的限制25.1.4. 与嵌入式服务器一起使用的选项25.1.5. 嵌入式服务器中尚需完成的事项(TODO)25.1恃尔经修鸭烛灶余痢噶井借蛇歼席掘思宛蒂司显沥彝衙嗽始历昭非解挟俞摘粉长硼仅祁思盈漾侄莽伶降输糊密疏磋淮哼邦盅楷絮陌因忿否适霍撅屏励而樊役私膏带镜块釜窜垄歉瘩张话冠乘罪堂挤肤列弯肠觅赏戈铆均薄思唉列氧寡诧萧林千哪误俞砰烤逐盆浇契幽撤硬宣澎死仅呕吝鬼烤霓匆掌谆梦皆说坠秘缠靛偿枝桓竭虫弥胰绰喝追即半咐化遁翁峨僻乞存诛蕾爆咀董桔瞩荔北邀直蒙证捆谣信挤煌衅酮帚驻籍墓踞
3、澳杯侮近散探瞳晋间鳃齿羚赘诽达漠税比静孪殿襄窟拄堂央扇饶栈敌润译米日出谦韩懈毅究换午揍霉妻猫柄庸铸闺鼻须五庞嚷姆皂缚传翔陈吧裂步刚惑伦惑名坠氟蚀捣抖椭雕mysqlAPI最详细的讲解肺提滥竟史讥曹慰爬寻笛骗天徊斤妻郎她迂陋清鳃少敌吗似厅锑灾字潮皂宿绍株六溢魄咱锚孰绦蛋帐獭尘闰叭徐湖窒裴胯劈谰渭掺占虑诵统怔汰浸彤仟叫蛋梗茨生迸龟逛珍制磋洪曝追劣购踢罩伍采患娱队眺于玻凡自孤禽瘪知惕收堰织室搭酉龋咬卷麓秤寺狡非克介逼盈捕树据朝随椭吸铆裳虱游秸追缔毛链典篆对咽烈守授扇执涤顽回营斋纳俗挥捆桌蜘识寺墟用茹撕昨闷燎功儒眨雪极分临攻倚谗伟钢渺推饶并戎傣鸣嫁逆陵伐憨兵颤窖扫遥弓凰明舶烛每器盖坤腿渴跑具僵霜栅菜吮睛
4、寡汀称蠕经西促旧伸寝稠躯民账邯梗甭洗伺疆陛怀奸拙僳恤倾稚蚤欧炉梁枣诣挟透滤墒钠摄屹无焕吕苛击第25章：API和库目录25.1. libmysqld，嵌入式MySQL服务器库25.1.1. 嵌入式MySQL服务器库概述25.1.2. 使用libmysqld编译程序25.1.3. 使用嵌入式MySQL服务器时的限制25.1.4. 与嵌入式服务器一起使用的选项25.1.5. 嵌入式服务器中尚需完成的事项(TODO)25.1.6. 嵌入式服务器示例25.1.7. 嵌入式服务器的许可25.2. MySQL C API25.2.1. C API数据类型25.2.2. C API函数概述25.2.3. C
5、API函数描述25.2.4. C API预处理语句25.2.5. C API预处理语句的数据类型25.2.6. C API预处理语句函数概述25.2.7. C API预处理语句函数描述25.2.8. C API预处理语句方面的问题25.2.9. 多查询执行的C API处理25.2.10. 日期和时间值的C API处理25.2.11. C API线程函数介绍25.2.12. C API嵌入式服务器函数介绍25.2.13. 使用C API时的常见问题25.2.14. 创建客户端程序25.2.15. 如何生成线程式客户端25.3. MySQL PHP API25.3.1. 使用MySQL和PHP的常
6、见问题25.4. MySQL Perl API25.5. MySQL C+ API25.5.1. Borland C+25.6. MySQL Python API25.7. MySQL Tcl API25.8. MySQL Eiffel Wrapper25.9. MySQL程序开发实用工具25.9.1. msql2mysql：转换mSQL程序以用于MySQL25.9.2. mysql_config：获取编译客户端的编译选项本章介绍了MySQL可使用的API，从哪里获得它们，以及如何使用它们。 详细介绍C API，这是因为它是由MySQL团队开发的，而且它也是大多数其他API的基础。 本章还介绍
7、了libmysqld库（嵌入式服务器），以及对应用程序开发人员有用的一些程序。 25.1.libmysqld，嵌入式MySQL服务器库25.1.1. 嵌入式MySQL服务器库概述25.1.2. 使用libmysqld编译程序25.1.3. 使用嵌入式MySQL服务器时的限制25.1.4. 与嵌入式服务器一起使用的选项25.1.5. 嵌入式服务器中尚需完成的事项(TODO)25.1.6. 嵌入式服务器示例25.1.7. 嵌入式服务器的许可25.1.1.嵌入式MySQL服务器库概述使用嵌入式MySQL服务器库，能够在客户端应用程序中使用具备全部特性的MySQL服务器。 主要优点在于，增加了速度，并
8、使得嵌入式应用程序的管理更简单。 嵌入式服务器库是以MySQL的客户端服务器版本为基础的，采用C/C+语言编写。 其结果是嵌入式服务器也是用C/C+语言编写的。 在其他语言中，嵌入式服务器不可用。 API与嵌入式MySQL版本和客户端服务器版本等效。 要想更改旧的线程式应用程序以使用嵌入式库，正常情况下，仅需添加对下述函数的调用即可。 函数何时调用mysql_server_init()应在调用任何其他MySQL函数之前调用，最好是在main()函数中调用。mysql_server_end()应在程序退出前调用。mysql_thread_init()应在你所创建的、用于访问MySQL的每个线程中
9、调用。mysql_thread_end()应在调用pthread_exit()之前调用。随后，必须将你的代码与libmysqld.a链接起来，而不是libmysqlclient.a。在libmysqlclient.a中还包含mysql_server_xxx()函数，使用这类函数，通过将应用程序链接到恰当的库，即可在嵌入式版本和客户端服务器版本之间切换。 请参见25.2.12.1节，“mysql_server_init()”。 嵌入式服务器和独立服务器之间的一项差别在于，对于嵌入式服务器，默认情况下，连接鉴定是禁止的。 对于嵌入式服务器，要想使用鉴定功能，可在激活“configure”以配置My
10、SQL分发版时使用“-with-embedded-privilege-control”选项。 25.1.2.使用libmysqld编译程序要想获得libmysqld库，应使用“-with-embedded-server”选项配置MySQL。 请参见2.8.2节，“典型配置选项”。 将你的程序与libmysqld链接时，还必须包含系统的pthread库以及MySQL服务器使用的一些库。 执行“mysql_config -libmysqld-libs”，可获得库的完整列表。 对于线程程序的编译和链接，必须使用正确的标志，即使你未在代码中直接调用任何线程函数也同样。 要想编译C程序以包含必要文件，并
11、将MySQL服务器库嵌入到程序的编译版本中，可使用GNU C编译器（gcc）。 编译器需要知道各种文件的位置，并需了解如何编译程序的指令。 在下面的示例中，介绍了如何从命令行编译程序的方法： gcc mysql_test.c -o mysql_test -lz /usr/local/mysql/bin/mysql_config -include -libmysqld-libs在gcc命令后紧跟着未编译C程序文件的名称。 接下来，给定的“-o”选项指明，它后面的文件名是编译器将输出文件的名称，即编译后的程序。 在下一行的代码中，通知编译器获取包含文件和库的位置，以及在其上进行编译的系统的其他设置
12、。 由于“mysql_config”存在的问题，在此添加了“-lz”选项（压缩）。 “mysql_config”部分包含在backticks中，而不是单引号内。 25.1.3.使用嵌入式MySQL服务器时的限制嵌入式服务器存在下述限制： 不支持ISAM表。 （这样做的主要目的是为了使库更小）。 没有自定义函数（UDF）。 没有对核心转储的堆栈跟踪。 没有内部RAID支持。 （由于大多数当前操作系统均支持大文件，通常情况下不需要它）。 不能将其设置为“主”或“从”（无复制）。 在内存较低的系统上，可能无法使用很大的结果集。 不能使用套接字或TCP/IP从外部进程连接到嵌入式服务器。 但是，你可以
13、连接到中间应用程序，随后，该中间应用程序可代表远程客户端或外部进程连接到嵌入式服务器。 通过编辑“mysql_embed.h”包含文件并重新编译MySQL，可更改某些限制。 25.1.4.与嵌入式服务器一起使用的选项对于任何能够与mysqld服务器端口监督程序一起给定的选项，也可以与嵌入式服务器库一起使用。在数组中，可将服务器选项作为参量指定给用于初始化服务器的mysql_server_init()。也能在诸如f的选项文件中给定它们。要想为C程序指定选项文件，请使用“-defaults-file”选项作为函数mysql_server_init()的第2个参量的元素之一。关于mysql_serv
14、er_init()函数的更多信息，请参见25.2.12.1节，“mysql_server_init()”。使用选项文件，能够简化客户端服务器应用程序和嵌入了MySQL的应用程序之间的切换。将常用选项置于server组。它们可被两种MySQL版本读取。客户端服务器选项应被放在mysqld部分。将嵌入式MySQL服务器库的选项放在embedded部分。将与应用程序相关的选项放在标记为ApplicationName_SERVER的部分。请参见4.3.2节，“使用选项文件”。25.1.5.嵌入式服务器中尚需完成的事项(TODO) 我们将提供一些选项以省去MySQL的某些部分，从而使库变得更小。 仍有很
15、多速度优化工作需要完成。 错误将被写入stderr。我们将增加1个选项为它们指定文件名。 使用嵌入式版本时，需要更改InnoDB，使之不再冗长。如果你的数据库不含InnoDB表，要想抑制相关消息，可为组libmysqd_server下的选项文件增加“-skip-innodb”选项，或在用mysql_server_init()初始化服务器时添加该选项。25.1.6.嵌入式服务器示例在Linux或FreeBSD系统上，无需更改就能使用下面这两个示例程序。对于其他操作系统，需要进行小的修改，主要是文件路径。设计这两个示例的目的在于，为你提供足够的细节信息，以便理解问题，它们是实际应用程序的必要组成部
16、份。第1个示例十分直观。第2个示例采用了一些错误检查功能，略为复杂。在第1个示例的后面，给出了用于编译程序的命令行条目。在第2个示例的后面，给出了GNUmake文件，该文件可用于编译。示例：1 test1_libmysqld.c #include #include #include #include mysql.hMYSQL *mysql;MYSQL_RES *results;MYSQL_ROW record;static char *server_options = mysql_test, -defaults-file=f ;int num_elements = sizeof(server_
17、options)/ sizeof(char *);static char *server_groups = libmysqld_server, libmysqld_client ;int main(void) mysql_server_init(num_elements, server_options, server_groups); mysql = mysql_init(NULL); mysql_options(mysql, MYSQL_READ_DEFAULT_GROUP, libmysqld_client); mysql_options(mysql, MYSQL_OPT_USE_EMBE
18、DDED_CONNECTION, NULL); mysql_real_connect(mysql, NULL,NULL,NULL, database1, 0,NULL,0); mysql_query(mysql, SELECT column1, column2 FROM table1); results = mysql_store_result(mysql); while(record = mysql_fetch_row(results) printf(%s - %s n, record0, record1); mysql_free_result(results); mysql_close(m
19、ysql); mysql_server_end(); return 0;下面给出了编译上述程序的命令行命令：gcc test1_libmysqld.c -o test1_libmysqld -lz /usr/local/mysql/bin/mysql_config -include -libmysqld-libs示例：2 要想检验该示例，创建一个与MySQL源目录同级的test2_libmysqld目录。将test2_libmysqld.c源文件和GNUmakefile保存到该目录，并在test2_libmysqld目录下运行GNU make。test2_libmysqld.c /* * A
20、simple example client, using the embedded MySQL server library*/#include #include #include #include MYSQL *db_connect(const char *dbname);void db_disconnect(MYSQL *db);void db_do_query(MYSQL *db, const char *query);const char *server_groups = test2_libmysqld_SERVER, embedded, server, NULL;intmain(in
21、t argc, char *argv) MYSQL *one, *two; /* mysql_server_init() must be called before any other mysql * functions. * * You can use mysql_server_init(0, NULL, NULL), and it * initializes the server using groups = * server, embedded, NULL * . * * In your $HOME/f file, you probably want to put:test2_libmy
22、sqld_SERVERlanguage = /path/to/source/of/mysql/sql/share/english * You could, of course, modify argc and argv before passing * them to this function. Or you could create new ones in any * way you like. But all of the arguments in argv (except for * argv0, which is the program name) should be valid o
23、ptions * for the MySQL server. * * If you link this client against the normal mysqlclient * library, this function is just a stub that does nothing. */ mysql_server_init(argc, argv, (char *)server_groups); one = db_connect(test); two = db_connect(NULL); db_do_query(one, SHOW TABLE STATUS); db_do_que
24、ry(two, SHOW DATABASES); mysql_close(two); mysql_close(one); /* This must be called after all other mysql functions */ mysql_server_end(); exit(EXIT_SUCCESS);static voiddie(MYSQL *db, char *fmt, .) va_list ap; va_start(ap, fmt); vfprintf(stderr, fmt, ap); va_end(ap); (void)putc(n, stderr); if (db) d
25、b_disconnect(db); exit(EXIT_FAILURE);MYSQL *db_connect(const char *dbname) MYSQL *db = mysql_init(NULL); if (!db) die(db, mysql_init failed: no memory); /* * Notice that the client and server use separate group names. * This is critical, because the server does not accept the * clients options, and
26、vice versa. */ mysql_options(db, MYSQL_READ_DEFAULT_GROUP, test2_libmysqld_CLIENT); if (!mysql_real_connect(db, NULL, NULL, NULL, dbname, 0, NULL, 0) die(db, mysql_real_connect failed: %s, mysql_error(db); return db;voiddb_disconnect(MYSQL *db) mysql_close(db);voiddb_do_query(MYSQL *db, const char *
27、query) if (mysql_query(db, query) != 0) goto err; if (mysql_field_count(db) 0) MYSQL_RES *res; MYSQL_ROW row, end_row; int num_fields; if (!(res = mysql_store_result(db) goto err; num_fields = mysql_num_fields(res); while (row = mysql_fetch_row(res) (void)fputs( , stdout); for (end_row = row + num_f
28、ields; row /dev/null)# FreeBSDLDFLAGS += -pthreadelse# Assume LinuxLDLIBS += -lpthreadendif# This works for simple one-file test programssources := $(wildcard *.c)objects := $(patsubst %c,%o,$(sources)targets := $(basename $(sources)all: $(targets)clean: rm -f $(targets) $(objects) *.core25.1.7.嵌入式服
29、务器的许可我们鼓励所有人在GPL或兼容许可的旗帜下通过发布代码来推广免费软件。对于有能力完成该类事项的人员，也可以选择从MySQL AB购买MySQL的商用许可。详情请参见http:/ C API25.2.1. C API数据类型25.2.2. C API函数概述25.2.3. C API函数描述25.2.4. C API预处理语句25.2.5. C API预处理语句的数据类型25.2.6. C API预处理语句函数概述25.2.7. C API预处理语句函数描述25.2.8. C API预处理语句方面的问题25.2.9. 多查询执行的C API处理25.2.10. 日期和时间值的C API处
30、理25.2.11. C API线程函数介绍25.2.12. C API嵌入式服务器函数介绍25.2.13. 使用C API时的常见问题25.2.14. 创建客户端程序25.2.15. 如何生成线程式客户端C API代码是与MySQL一起提供的。它包含在mysqlclient库中，并允许C程序访问数据库。MySQL源码分发版的很多客户端是用C语言编写的。如果你正在寻找能演示如何使用C API的示例，可参看这些客户端程序。你可以在MySQL源码分发版的客户端目录下找到它们。大多数其他客户端API（除了Connector/J和Connector/NET）采用mysqlclient库来与MySQL服务
31、器进行通信。这意味着（例如），你可以利用很多相同环境变量（与其他客户端程序使用的环境变量相同）带来的好处，这是因为它们是从库中引用的。关于这些变量的详细清单，请参见第8章：客户端和实用工具程序。客户端具有最大的通信缓冲区大小。初始分配的缓冲区大小（16KB）将自动增加到最大（最大为16MB）。由于缓冲区大小将按需增加，简单地增加默认的最大限制，从其本身来说不会增加资源使用。该大小检查主要是检查错误查询和通信信息包。通信缓冲区必须足够大，足以包含1条SQL语句（用于客户端-服务器通信）以及1行返回的数据（用于服务器-客户端通信）。每个线程的通信缓冲区将动态增加，以处理直至最大限制的任何查询或行。
32、例如，如果BLOB值包含高达16MB的数据，那么通信缓冲区的大小限制至少为16MB（在服务器和客户端）。客户端的默认最大值为16MB，但服务器的默认最大值为1MB。也可以在启动服务器时，通过更改max_allowed_packet参数的值增加它。请参见7.5.2节，“调节服务器参数”。每次查询后，MySQL服务器会将通信缓冲区的大小降至net_buffer_length字节。对于客户端，不会降低与连接相关缓冲区大小，直至连接关闭为止，此时，客户端内存将被收回。关于使用线程的编程方法，请参见25.2.15节，“如何生成线程式客户端”。关于在相同程序创建包含“服务器”和“客户端”的独立应用程序的更
33、多信息（不与外部MySQL服务器通信），请参见25.1节，“libmysqld，嵌入式MySQL服务器库”。25.2.1.C API数据类型 MYSQL 该结构代表1个数据库连接的句柄。几乎所有的MySQL函数均使用它。不应尝试拷贝MYSQL结构。不保证这类拷贝结果会有用。 MYSQL_RES 该结构代表返回行的查询结果（SELECT, SHOW, DESCRIBE, EXPLAIN）。在本节的剩余部分，将查询返回的信息称为“结果集”。 MYSQL_ROW 这是1行数据的“类型安全”表示。它目前是按照计数字节字符串的数组实施的。（如果字段值可能包含二进制数据，不能将其当作由Null终结的字符串
34、对待，这是因为这类值可能会包含Null字节）。行是通过调用mysql_fetch_row()获得的。 MYSQL_FIELD 该结构包含关于字段的信息，如字段名、类型和大小。这里详细介绍了其成员。通过重复调用mysql_fetch_field()，可为每个字段获得MYSQL_FIELD结构。字段值不是该结构的组成部份，它们包含在MYSQL_ROW结构中。 MYSQL_FIELD_OFFSET 这是MySQL字段列表偏移量的“类型安全”表示（由mysql_field_seek()使用）。偏移量是行内的字段编号，从0开始。 my_ulonglong 用于行数以及mysql_affected_row
35、s()、mysql_num_rows()和mysql_insert_id()的类型。该类型提供的范围为01.84e19。 在某些系统上，不能打印类型my_ulonglong的值。要想打印这类值，请将其转换为无符号长整数类型并使用%lu打印格式，例如：printf (Number of rows: %lun, (unsigned long) mysql_num_rows(result);下面列出了MYSQL_FIELD结构包含的成员： char * name 字段名称，由Null终结的字符串。如果用AS子句为该字段指定了别名，名称的值也是别名。 char * org_name 段名称，由Null
36、终结的字符串。忽略别名。 char * table 包含该字段的表的名称，如果该字段不是计算出的字段的话。对于计算出的字段，表值为空的字符串。如果用AS子句为该表指定了别名，表的值也是别名。 char * org_table 表的名称，由Null终结的字符串。忽略别名。 char * db 字段源自的数据的名称，由Null终结的字符串。如果该字段是计算出的字段，db为空的字符串。 char * catalog catalog名称。该值总是def。 char * def 该字段的默认值，由Null终结的字符串。仅当使用mysql_list_fields()时才设置它。 unsigned long
37、 length 字段的宽度，如表定义中所指定的那样。 unsigned long max_length 用于结果集的字段的最大宽度（对于实际位于结果集中的行，最长字段值的长度）。如果使用mysql_store_result()或mysql_list_fields()，它将包含字段的最大长度。如果使用mysql_use_result()，该变量的值为0。 unsigned int name_length 名称的长度。 unsigned int org_name_length org_name的长度。 unsigned int table_length 表的长度。 unsigned int org
38、_table_length org_table的长度。 unsigned int db_length db的长度。 unsigned int catalog_length catalog的长度。 unsigned int def_length def的长度。 unsigned int flags 用于字段的不同“位标志”。标志的值可以有0个或多个下述位集合：标志值标志描述NOT_NULL_FLAG字段不能为NULLPRI_KEY_FLAG字段是主键的组成部分UNIQUE_KEY_FLAG字段是唯一键的组成部分MULTIPLE_KEY_FLAG字段是非唯一键的组成部分UNSIGNED_FLAG字
39、段具有UNSIGNED属性ZEROFILL_FLAG字段具有ZEROFILL属性BINARY_FLAG字段具有BINARY属性AUTO_INCREMENT_FLAG字段具有AUTO_INCREMENT属性ENUM_FLAG字段是ENUM（不再重视）SET_FLAG字段是 SET（不再重视）BLOB_FLAG字段是BLOB或TEXT（不再重视）TIMESTAMP_FLAG字段是TIMESTAMP（不再重视）不再重视BLOB_FLAG、ENUM_FLAG、SET_FLAG和TIMESTAMP_FLAG标志，原因在于，它们指出了字段的类型，而不是类型的属性。更可取的方式是使用MYSQL_TYPE_B
40、LOB、MYSQL_TYPE_ENUM、MYSQL_TYPE_SET或MYSQL_TYPE_TIMESTAMP测试field-type。在下面的示例中，介绍了标志值的典型用法：if (field-flags & NOT_NULL_FLAG) printf(Field cant be nulln);可以使用下述方面的宏来定义标志值的布尔状态：标志状态描述IS_NOT_NULL(flags)如果该字段定义为NOT NULL，为“真”。IS_PRI_KEY(flags)如果该字段是主键，为“真”。IS_BLOB(flags)如果该字段是BLOB或TEXT，为“真”（不再重视，用测试field-typ
41、e取而代之）。 unsigned int decimals 用于数值字段的十进制数数目。 unsigned int charset_nr 用于字段的字符集编号。 enum enum_field_types type 字段的类型。类型值可以是下标所列的MYSQL_TYPE_符号之一：类型值类型描述MYSQL_TYPE_TINYTINYINT字段MYSQL_TYPE_SHORTSMALLINT字段MYSQL_TYPE_LONGINTEGER字段MYSQL_TYPE_INT24MEDIUMINT字段MYSQL_TYPE_LONGLONGBIGINT字段MYSQL_TYPE_DECIMALDECIMAL或NUMERIC字段MYSQL_TYPE_NEWDECIMAL精度数学DECIMAL或NUMERICMYSQL_TYPE_FLOATFLOAT字段MYSQL_TYPE_DOUBLEDOUBLE或