C API 提供了对 MySQL c/s 模型的底层访问。C API 代码在 mysqlclient 库中实现。可以从该库中引用到的变量及含义:

环境变量
含义
MYSQL_UNIX_PORT
本地连接的套接字文件
MYSQL_TCP_PORT
默认 tcp 端口
MYSQL_PWD
默认密码
MYSQL_DEBUG

TMPDIR

  客户端与服务端通讯时,客户端会启用一块内存缓冲空间,起始大小为16KB,随着需求会自动增长,默认最大增长到16MB。适当增大这个默认的最大缓存值,不会造成资源浪费,因为缓存的使用依据需要而自动增加。这个最大值的设定,必须能大于一条单独的查询语句(for client-to-server traffic),且大于服务端返回的一条记录的数据量(for server-to-client traffic)。对于客户端库的最大值限制到1GB,服务端最大缓存为1MB。服务端自动增大的缓存会自动释放,客户端不会,客户端需要在关闭连接后才能释放。

1.构建 C API 程序


  使用 gnu gcc 编译 Linux 下的客户端程序。

  指定头文件:-I/usr/local/mysql/include

  连接时选项:-L/usr/local/mysql/lib -lmysqlclient

  查看当前机器编译链接时的选项:

[view@file ~]$ /usr/local/mysql/bin/mysql_config --cflags
-I/usr/local/mysql/include   -g -DNDEBUG
[view@file ~]$ /mysql/bin/mysql_config --libs
-L/usr/local/mysql/lib -lmysqlclient -lpthread -lm -ldl
# 创建动态链接库(Linux下默认创建动态库)
[view@file ~]$ gcc -o progname progname.o
# 创建静态链接库时,需要指定静态库名
[view@file ~]$ gcc -o progname progname.o /usr/local/mysql/lib/libmysqlclient.a


2.C API 函数


  应用程序交互的步骤:
    ①调用 mysql_library_init() 调用MySQL库
    ②调用 mysql_init() 创建数据库连接,调用 mysql_real_connect() 连接到数据库
    ③发送 SQL 语句(mysql_query()、mysql_real_query())
    ④调用 mysql_close() 终止连接
    ⑤调用 mysql_library_end() 释放库调用

  连接数据库

#include
#include"mysql.h"

int main(void){
        MYSQL mysql;
        mysql_init(&mysql);    // 创建连接,在if语句激活连接
        if(NULL != mysql_real_connect(&mysql, "hostname", "username", "password", "dbname", 0, NULL, 0)){
                printf("连接成功。\n");
        }
        else{
                printf("连接失败!\n");
        }
        
        mysql_close(&mysql);    // 断开数据库连接
        return 0;
}