MySQL：14.mysql connect
mysql connect
mysql的基础，我们之前已经学过，后面我们只关心使用
要使用C语言连接mysql，需要使用mysql官网提供的库，大家可以去官网下载
我们使用C接口库来进行连接
要正确使用，我们需要做一些准备工作：
- 保证mysql服务有效
- 在官网上下载合适自己平台的mysql connect库，以备后用
或者直接apt/yum install mysql-server，会自动下载好mysql connect库和mysql
一.Connector/C 使用
我们下下来的库格式如下：
[hb@MiWiFi-R1CL-srv lib]$ tree .
.
├── include
│ ├── big_endian.h
│ ├── byte_order_generic.h
│ ├── byte_order_generic_x86.h
│ ├── decimal.h
│ ├── errmsg.h
│ ├── keycache.h
│ ├── little_endian.h
│ ├── m_ctype.h
│ ├── m_string.h
│ ├── my_alloc.h
│ ├── my_byteorder.h
│ ├── my_compiler.h
│ ├── my_config.h
│ ├── my_dbug.h
│ ├── my_dir.h
│ ├── my_getopt.h
│ ├── my_global.h
│ ├── my_list.h
│ ├── my_pthread.h
│ ├── mysql
│ │ ├── client_authentication.h
│ │ ├── client_plugin.h
│ │ ├── client_plugin.h.pp
│ │ ├── get_password.h
│ │ ├── plugin_auth_common.h
│ │ ├── plugin_trace.h
│ │ ├── psi
│ │ │ ├── mysql_file.h
│ │ │ ├── mysql_idle.h
│ │ │ ├── mysql_mdl.h
│ │ │ ├── mysql_memory.h
│ │ │ ├── mysql_ps.h
│ │ │ ├── mysql_socket.h
│ │ │ ├── mysql_sp.h
│ │ │ ├── mysql_stage.h
│ │ │ ├── mysql_statement.h
│ │ │ ├── mysql_table.h
│ │ │ ├── mysql_thread.h
│ │ │ ├── mysql_transaction.h
│ │ │ ├── psi_base.h
│ │ │ ├── psi.h
│ │ │ └── psi_memory.h
│ │ ├── service_my_snprintf.h
│ │ └── service_mysql_alloc.h
│ ├── mysql_com.h
│ ├── mysql_com_server.h
│ ├── mysqld_ername.h
│ ├── mysqld_error.h
│ ├── mysql_embed.h
│ ├── mysql.h
│ ├── mysql_time.h
│ ├── mysql_version.h
│ ├── my_sys.h
│ ├── my_xml.h
│ ├── sql_common.h
│ ├── sql_state.h
│ ├── sslopt-case.h
│ ├── sslopt-longopts.h
│ ├── sslopt-vars.h
│ └── typelib.h
└── lib
├── libmysqlclient.a
├── libmysqlclient_r.a -> libmysqlclient.a
├── libmysqlclient_r.so -> libmysqlclient.so
├── libmysqlclient_r.so.18 -> libmysqlclient.so.18
├── libmysqlclient_r.so.18.3.0 -> libmysqlclient.so.18.3.0
├── libmysqlclient.so -> libmysqlclient.so.18
├── libmysqlclient.so.18 -> libmysqlclient.so.18.3.0
└── libmysqlclient.so.18.3.0
其中include 包含所有的方法声明， lib 包含所有的方法实现（打包成库）
尝试链接mysql client
通过mysql_get_client_info() 函数，来验证我们的引入是否成功
#include <stdio.h>
#include <mysql.h>
int main()
{printf("mysql client Version: %s\n", mysql_get_client_info());return 0;
}[hb@MiWiFi-R1CL-srv lib]$ gcc -o test test.c -I./include -L./lib -lmysqlclient
[hb@MiWiFi-R1CL-srv lib]$ ls
include lib test test.c[hb@MiWiFi-R1CL-srv lib]$ ./test
./test: error while loading shared libraries: libmysqlclient.so.18: cannot open
shared object file: No such file or directory[hb@MiWiFi-R1CL-srv lib]$ export LD_LIBRARY_PATH=./lib ＃动态库查找路径,讲解ldd命令
[hb@MiWiFi-R1CL-srv lib]$ ./test
mysql client Version: 6.1.6
-
我自己5.7的mysgl机器上是-L/usr/lib/x86_64-linux-gnu/-lmysqlclient
-
注:
Mysql端口号尽量不要暴露在公网中，可以修改端口号
修改端口：在/etc/mysql/my.cnf里
[mysqld]下面写：port = 8080 #你要用8080就写8080；否则改回3306修改端口后需要重启mysgl,
sudo systemctl restart mysql.
至此引入库的工作已经做完，接下来就是熟悉接口
二.mysql接口介绍
1. 初始化mysql_init()
要使用库，必须先进行初始化！
MYSQL *mysql_init(MYSQL *mysql);
如： MYSQL *mfp = mysql_init(NULL)
2. 链接数据库mysql_real_connect
初始化完毕之后，必须先链接数据库，在进行后续操作。（mysql网络部分是基于TCP/IP的）
MYSQL *mysql_real_connect(MYSQL *mysql, const char *host,const char *user,const char *passwd,const char *db,unsigned int port,const char *unix_socket,unsigned long clientflag);//建立好链接之后，获取英文没有问题，如果获取中文是乱码：
//设置链接的默认字符集是utf8，原始默认是latin1
mysql_set_character_set(myfd, "utf8");
第一个参数 MYSQL是 C api中一个非常重要的变量（mysql_init的返回值），里面内存非常丰富，有port,dbname,charset等连接基本参数。它也包含了一个叫 st_mysql_methods的结构体变量，该变量里面保存着很多函数指针，这些函数指针将会在数据库连接成功以后的各种数据操作中被调用。mysql_real_connect函数中各参数，基本都是顾名思意。
返回值: 成功返回第一个参数，失败返回nullptr.
3. 下发mysql命令mysql_query
int mysql_query(MYSQL *mysql, const char *q); //p不需要带分号
第一个参数上面已经介绍过，第二个参数为要执行的sql语句,如“select * from table”。
返回值: 成功返回0，失败返回非0.
4. 获取执行结果mysql_store_result
sql执行完以后，如果是查询语句，我们当然还要读取数据，如果update，insert等语句，那么就看下操作成功与否即可。我们来看看如何获取查询结果： 如果mysql_query返回成功，那么我们就通过mysql_store_result这个函数来读取结果。原型如下：
MYSQL_RES *mysql_store_result(MYSQL *mysql);
typedef struct st_mysql_res {my_ulonglong row_count;MYSQL_FIELD *fields;MYSQL_DATA *data;MYSQL_ROWS *data_cursor;unsigned long *lengths; /* column lengths of current row */MYSQL *handle; /* for unbuffered reads */const struct st_mysql_methods *methods;MYSQL_ROW row; /* If unbuffered read */MYSQL_ROW current_row; /* buffer to current row */MEM_ROOT field_alloc;unsigned int field_count, current_field;my_bool eof; /* Used by mysql_fetch_row *//* mysql_stmt_close() had to cancel this result */my_bool unbuffered_fetch_cancelled; void *extension;
} MYSQL_RES;
该函数会调用MYSQL变量中的st_mysql_methods中的 read_rows 函数指针来获取查询的结果。同时该函数会返回MYSQL_RES 这样一个变量，该变量主要用于保存查询的结果。同时该函数malloc了一片内存空间来存储查询过来的数据，所以我们一定要记的 free(result),不然是肯定会造成内存泄漏的。 执行完mysql_store_result以后，其实数据都已经在MYSQL_RES 变量中了，下面的api基本就是读取MYSQL_RES 中的数据。
返回值（Return Values）
返回一个指向
MYSQL_RES结果结构体 的指针，该结构中包含查询结果。如果语句没有返回结果集，或者执行出错，则返回
NULL。要判断是否发生了错误，可以通过以下方式检查：
调用
mysql_error()：
如果返回的字符串非空，表示出现了错误；调用
mysql_errno()：
如果返回的值不为 0，表示出现了错误；调用
mysql_field_count()：
如果返回值为 0，表示该语句没有返回结果集（例如INSERT、UPDATE、DELETE等语句）。
不是用C语言的free释放空间，而是用mysql_free_result.
mysql将所有的数据，读取出来的时候，全部都当做字符串
5. 获取结果行数mysql_num_rows
my_ulonglong mysql_num_rows(MYSQL_RES *res);// typedef unsigned long long my_ulonglong;
返回值: 结果集中的行数。
6. 获取结果列数mysql_num_fields
unsigned int mysql_num_fields(MYSQL_RES *res);
返回值: 返回一个无符号整数（unsigned integer），表示结果集中列的数量。
7. 获取列名mysql_fetch_fields
MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);
typedef struct st_mysql_field {char *name; /* Name of column */char *org_name; /* Original column name, if an alias */char *table; /* Table of column if column was a field */char *org_table; /* Org table name, if table was an alias */char *db; /* Database for table */char *catalog; /* Catalog for table */char *def; /* Default value (set by mysql_list_fields) */unsigned long length; /* Width of column (create length) */unsigned long max_length; /* Max width for selected set */unsigned int name_length;unsigned int org_name_length;unsigned int table_length;unsigned int org_table_length;unsigned int db_length;unsigned int catalog_length;unsigned int def_length;unsigned int flags; /* Div flags */unsigned int decimals; /* Number of decimals in field */unsigned int charsetnr; /* Character set */enum enum_field_types type; /* Type of field. See mysql_com.h for types */void *extension;
} MYSQL_FIELD;
返回值: 返回一个 MYSQL_FIELD 结构体数组，其中包含结果集中所有列的字段信息。
如：
int fields = mysql_num_fields(res);
MYSQL_FIELD *field = mysql_fetch_fields(res);
int i = 0;
for(; i < fields; i++){cout<<field[i].name<<" ";
}
cout<<endl;
8. 获取结果内容mysql_fetch_row
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
typedef char **MYSQL_ROW; /* return data as array of strings */
它会返回一个MYSQL_ROW变量，MYSQL_ROW其实就是char **.就当成一个二维数组来用吧。就是上图(五角星)的一行数据
i = 0;
MYSQL_ROW line;
for(; i < nums; i++){line = mysql_fetch_row(res);int j = 0;for(; j < fields; j++){cout<<line[j]<<" ";}cout<<endl;
}
9. 关闭mysql链接mysql_close
void mysql_close(MYSQL *sock);
另外，mysql C api还支持事务等常用操作，大家下来自行了解:
my_bool STDCALL mysql_autocommit(MYSQL * mysql, my_bool auto_mode);
my_bool STDCALL mysql_commit(MYSQL * mysql);
my_bool STDCALL mysql_rollback(MYSQL * mysql);