MySQL：14.mysql connect

mysql connect

mysql的基础，我们之前已经学过，后面我们只关心使用

要使用C语言连接mysql，需要使用mysql官网提供的库，大家可以去官网下载

我们使用C接口库来进行连接

要正确使用，我们需要做一些准备工作：

保证mysql服务有效

在官网上下载合适自己平台的mysql connect库，以备后用
或者直接apt/yum install mysql-server，会自动下载好mysql connect库和mysql

一.Connector/C 使用

我们下下来的库格式如下：

shell 复制代码

[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() 函数，来验证我们的引入是否成功

cpp 复制代码

#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 *mysql_init(MYSQL *mysql);

如： MYSQL *mfp = mysql_init(NULL)

2. 链接数据库mysql_real_connect

初始化完毕之后，必须先链接数据库，在进行后续操作。（mysql网络部分是基于TCP/IP的）

cpp 复制代码

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

cpp 复制代码

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这个函数来读取结果。原型如下：

cpp 复制代码

MYSQL_RES *mysql_store_result(MYSQL *mysql);

cpp 复制代码

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

cpp 复制代码

my_ulonglong mysql_num_rows(MYSQL_RES *res);

// typedef unsigned long long my_ulonglong;

返回值: 结果集中的行数。

6. 获取结果列数mysql_num_fields

cpp 复制代码

unsigned int mysql_num_fields(MYSQL_RES *res);

返回值: 返回一个无符号整数（unsigned integer），表示结果集中列的数量。

7. 获取列名mysql_fetch_fields

cpp 复制代码

MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *res);

cpp 复制代码

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 结构体数组，其中包含结果集中所有列的字段信息。

如：

cpp 复制代码

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

cpp 复制代码

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);

cpp 复制代码

typedef char **MYSQL_ROW;  /* return data as array of strings */

它会返回一个MYSQL_ROW变量，MYSQL_ROW其实就是char **.就当成一个二维数组来用吧。就是上图(五角星)的一行数据

cpp 复制代码

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

cpp 复制代码

void mysql_close(MYSQL *sock);

另外，mysql C api还支持事务等常用操作，大家下来自行了解:

cpp 复制代码

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);