《mysqlAPI最详细的讲解知识课件》由会员分享,可在线阅读,更多相关《mysqlAPI最详细的讲解知识课件(129页珍藏版)》请在金锄头文库上搜索。
1、第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 API函数描述25.2.4. C API预处理语句25.2.5. C API预处理语句的数据
2、类型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的常见问题25.4. MySQL Perl API25.5. MySQL C+ API25.5.
3、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的基础。 本章还介绍了libmysqld库(嵌入式服务器),以及对应用程序开发人员有用的一些程序。 25.1.l
4、ibmysqld,嵌入式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服务器。 主要优点在于,增加了速度,并使得嵌入式应用程序的管理更简单。 嵌入式服务器库是以MySQL的客户端服务器版本为基础的,采
5、用C/C+语言编写。 其结果是嵌入式服务器也是用C/C+语言编写的。 在其他语言中,嵌入式服务器不可用。 API与嵌入式MySQL版本和客户端服务器版本等效。 要想更改旧的线程式应用程序以使用嵌入式库,正常情况下,仅需添加对下述函数的调用即可。 函数何时调用mysql_server_init()应在调用任何其他MySQL函数之前调用,最好是在main()函数中调用。mysql_server_end()应在程序退出前调用。mysql_thread_init()应在你所创建的、用于访问MySQL的每个线程中调用。mysql_thread_end()应在调用pthread_exit()之前调用。随后
6、,必须将你的代码与libmysqld.a链接起来,而不是libmysqlclient.a。在libmysqlclient.a中还包含mysql_server_xxx()函数,使用这类函数,通过将应用程序链接到恰当的库,即可在嵌入式版本和客户端服务器版本之间切换。 请参见25.2.12.1节,“mysql_server_init()”。 嵌入式服务器和独立服务器之间的一项差别在于,对于嵌入式服务器,默认情况下,连接鉴定是禁止的。 对于嵌入式服务器,要想使用鉴定功能,可在激活“configure”以配置MySQL分发版时使用“-with-embedded-privilege-control”选项。
7、 25.1.2.使用libmysqld编译程序要想获得libmysqld库,应使用“-with-embedded-server”选项配置MySQL。 请参见2.8.2节,“典型配置选项”。 将你的程序与libmysqld链接时,还必须包含系统的pthread库以及MySQL服务器使用的一些库。 执行“mysql_config -libmysqld-libs”,可获得库的完整列表。 对于线程程序的编译和链接,必须使用正确的标志,即使你未在代码中直接调用任何线程函数也同样。 要想编译C程序以包含必要文件,并将MySQL服务器库嵌入到程序的编译版本中,可使用GNU C编译器(gcc)。 编译器需要知
8、道各种文件的位置,并需了解如何编译程序的指令。 在下面的示例中,介绍了如何从命令行编译程序的方法: gcc mysql_test.c -o mysql_test -lz /usr/local/mysql/bin/mysql_config -include -libmysqld-libs在gcc命令后紧跟着未编译C程序文件的名称。 接下来,给定的“-o”选项指明,它后面的文件名是编译器将输出文件的名称,即编译后的程序。 在下一行的代码中,通知编译器获取包含文件和库的位置,以及在其上进行编译的系统的其他设置。 由于“mysql_config”存在的问题,在此添加了“-lz”选项(压缩)。 “mys
9、ql_config”部分包含在backticks中,而不是单引号内。 25.1.3.使用嵌入式MySQL服务器时的限制嵌入式服务器存在下述限制: 不支持ISAM表。 (这样做的主要目的是为了使库更小)。 没有自定义函数(UDF)。 没有对核心转储的堆栈跟踪。 没有内部RAID支持。 (由于大多数当前操作系统均支持大文件,通常情况下不需要它)。 不能将其设置为“主”或“从”(无复制)。 在内存较低的系统上,可能无法使用很大的结果集。 不能使用套接字或TCP/IP从外部进程连接到嵌入式服务器。 但是,你可以连接到中间应用程序,随后,该中间应用程序可代表远程客户端或外部进程连接到嵌入式服务器。 通过
10、编辑“mysql_embed.h”包含文件并重新编译MySQL,可更改某些限制。 25.1.4.与嵌入式服务器一起使用的选项对于任何能够与mysqld服务器端口监督程序一起给定的选项,也可以与嵌入式服务器库一起使用。在数组中,可将服务器选项作为参量指定给用于初始化服务器的mysql_server_init()。也能在诸如f的选项文件中给定它们。要想为C程序指定选项文件,请使用“-defaults-file”选项作为函数mysql_server_init()的第2个参量的元素之一。关于mysql_server_init()函数的更多信息,请参见25.2.12.1节,“mysql_server_i
11、nit()”。使用选项文件,能够简化客户端服务器应用程序和嵌入了MySQL的应用程序之间的切换。将常用选项置于server组。它们可被两种MySQL版本读取。客户端服务器选项应被放在mysqld部分。将嵌入式MySQL服务器库的选项放在embedded部分。将与应用程序相关的选项放在标记为ApplicationName_SERVER的部分。请参见4.3.2节,“使用选项文件”。25.1.5.嵌入式服务器中尚需完成的事项(TODO) 我们将提供一些选项以省去MySQL的某些部分,从而使库变得更小。 仍有很多速度优化工作需要完成。 错误将被写入stderr。我们将增加1个选项为它们指定文件名。 使
12、用嵌入式版本时,需要更改InnoDB,使之不再冗长。如果你的数据库不含InnoDB表,要想抑制相关消息,可为组libmysqd_server下的选项文件增加“-skip-innodb”选项,或在用mysql_server_init()初始化服务器时添加该选项。25.1.6.嵌入式服务器示例在Linux或FreeBSD系统上,无需更改就能使用下面这两个示例程序。对于其他操作系统,需要进行小的修改,主要是文件路径。设计这两个示例的目的在于,为你提供足够的细节信息,以便理解问题,它们是实际应用程序的必要组成部份。第1个示例十分直观。第2个示例采用了一些错误检查功能,略为复杂。在第1个示例的后面,给出
13、了用于编译程序的命令行条目。在第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_options)/ sizeof(char *);static char *server_g
14、roups = 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_EMBEDDED_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(mysql); mysql_server_end();