CentOS 下使用 GCC 连接数据库的高效实践
一、MySQL 连接与编译要点
- 安装开发包与编译器：在 CentOS 上安装 gcc、mysql-devel（提供头文件与库），并确保 mysqld 已启动。示例：yum -y install gcc mysql-devel；service mysqld start。若缺少头文件或库，将无法编译或链接成功。
- 编译与链接：使用 -I 指定头文件路径、-L 指定库路径、-lmysqlclient 链接客户端库。常见路径为：头文件 /usr/include/mysql/，库文件 /usr/lib64/mysql/（64 位系统）。示例：gcc -o mysql -I/usr/include/mysql/ -L/usr/lib64/mysql/ -lmysqlclient -lz connect.c。
- 运行与常见报错：运行前确认库可被加载（如 64 位库路径正确）；若出现 “error while loading shared libraries: libmysql.so.xx”，将库目录加入 /etc/ld.so.conf 并执行 ldconfig 刷新缓存。
- 连接代码要点：使用 mysql_init / mysql_real_connect / mysql_query / mysql_store_result / mysql_fetch_row / mysql_free_result / mysql_close 流程；连接参数依次为 host、user、password、dbname、port、unix_socket、client_flag。
二、PostgreSQL 连接与编译要点
- 安装开发包：安装 gcc 与 postgresql-devel（提供 libpq 头文件与库），以便使用 libpq 进行连接。
- 编译与链接：使用 -I 指定头文件路径、-L 指定库路径、-lpq 链接库。示例：gcc -c -I/home/pg/include t_test.c；gcc -o test t_test.o -L/home/pg/lib -lpq。
- 连接代码要点：使用 PQconnectdb / PQstatus / PQexec / PQntuples / PQgetvalue / PQclear / PQfinish 流程；连接字符串形如 “host=localhost dbname=test user=pg password=xxx”。
三、ODBC 连接 SQL Server 的实用流程
- 安装驱动与工具：安装 unixODBC、unixODBC-devel（ODBC 驱动管理器与开发文件）与 gcc；若 configure 报 “no acceptable C compiler found in $PATH”，说明未装 gcc。
- 安装 FreeTDS：下载 freetds-stable.tgz，编译安装（示例：./configure --prefix=/usr/local/freetds --with-tdsver=8.0 --enable-msdblib；make；make install）。
- 配置 ODBC：编辑 odbcinst.ini（注册驱动，指定 libtdsodbc.so 路径）与 odbc.ini（定义 DSN、服务器、端口、数据库、字符集等），必要时为驱动库创建软链接以便 ODBC 找到。
- 测试连接：使用 isql 或编写 ODBC 程序测试连通性与查询。
四、常见故障排查清单
- 头文件或库找不到：未装 mysql-devel/postgresql-devel 或路径不在默认搜索路径；安装开发包，编译时用 -I/-L 显式指定，必要时在 /etc/ld.so.conf 增加库目录并运行 ldconfig。
- 链接失败：缺少 -lmysqlclient 或 -lpq；确认库名与位数（32/64 位）匹配。
- 运行时库加载失败：报 “libmysql.so.xx: cannot open shared object file”；执行 ldconfig 或设置 LD_LIBRARY_PATH。
- 服务器连通性：确认 mysqld/postgres 已启动、监听端口（如 3306/5432）开放、防火墙与 SELinux 策略允许访问。
- 认证与权限：核对数据库用户、口令、允许的主机（如 ‘user’@‘localhost’ 与远程网段）、以及对目标库的 GRANT 权限。
- 字符集与 SQL 模式：连接后执行 SET NAMES utf8mb4; 以避免中文乱码；避免使用已废弃的配置项（如 MySQL 5.7 中 default-character-set=utf8 会导致服务启动失败）。
五、实用命令与最小示例
- 安装与启动
- MySQL：sudo yum -y install gcc mysql-devel；sudo service mysqld start
- PostgreSQL：sudo yum -y install gcc postgresql-devel
- ODBC/SQL Server：sudo yum -y install unixODBC unixODBC-devel gcc
- MySQL 最小示例（编译与运行）
- 编译：gcc -o mysql -I/usr/include/mysql/ -L/usr/lib64/mysql/ -lmysqlclient -lz mysql.c
- 运行：./mysql
- PostgreSQL 最小示例（编译与运行）
- 编译：gcc -o test t_test.o -L/home/pg/lib -lpq
- 运行：./test
- 编译参数速查
- MySQL：gcc your.c -o app -I/usr/include/mysql/ -L/usr/lib64/mysql/ -lmysqlclient -lz
- PostgreSQL：gcc your.c -o app -I/usr/include -L/usr/lib64 -lpq
- 连接要点
- MySQL：使用 mysql_init / mysql_real_connect / mysql_query / mysql_store_result / mysql_fetch_row / mysql_free_result / mysql_close
- PostgreSQL：使用 PQconnectdb / PQstatus / PQexec / PQntuples / PQgetvalue / PQclear / PQfinish
- ODBC：正确配置 odbcinst.ini / odbc.ini，用 isql 验证 DSN 连通性
