SQLite3学习笔记4:打开和关闭数据库 + 创建表(C API)
2026/7/27 21:25:09 网站建设 项目流程

前置知识(C API 核心)

  1. 编译依赖:Ubuntu 下编译 C 代码必须链接 sqlite3 库(-lsqlite3),否则会报 “未定义引用” 错误;
  2. 核心数据类型sqlite3 *是数据库句柄(嵌入式中建议设为静态 / 全局,避免频繁打开 / 关闭);
  3. 错误处理:所有 sqlite3 函数返回值都是 int 型,SQLITE_OK(0)表示成功,其他值为错误码;
  4. 错误信息sqlite3_errmsg(db)返回错误描述字符串,是调试定位问题的核心手段。

核心函数详解

函数名原型核心作用注意事项
sqlite3_openint sqlite3_open(const char *filename, sqlite3 **ppDb);打开 / 创建数据库路径需是可写路径(如/mnt/embedded_db.db),ppDb是输出参数
sqlite3_closeint sqlite3_close(sqlite3 *db);关闭数据库必须调用,否则内存泄漏;关闭前需确保无未完成的 SQL 操作
sqlite3_execint sqlite3_exec(sqlite3 *db, const char *sql, int (*callback)(void*,int,char**,char**), void *arg, char **errmsg);执行 SQL 语句通用接口,创建表 / 插入 / 更新 / 删除时无需回调函数,callback传 NULL
sqlite3_errmsgconst char *sqlite3_errmsg(sqlite3 *db);获取错误信息错误时打印,调试必备

完整 C 代码示例

创建文件sqlite3_c_demo1.c

#include<stdio.h>#include<stdlib.h>#include<sqlite3.h>intmain(intargc,char*argv[]){sqlite3*db=NULL;// 数据库句柄(嵌入式中建议设为静态/全局)char*err_msg=NULL;// 错误信息缓冲区(需手动释放)intret=SQLITE_OK;// SQLite函数返回值// 1. 打开/创建数据库(路径和命令行的embedded_db.db一致)ret=sqlite3_open("embedded_db.db",&db);if(ret!=SQLITE_OK){fprintf(stderr,"[ERROR] 打开数据库失败: %s\n",sqlite3_errmsg(db));sqlite3_close(db);// 即使失败也要尝试关闭,避免资源泄漏return-1;}printf("[INFO] 数据库打开/创建成功\n");// 2. 定义创建表的SQL语句(和命令行的表结构完全一致)constchar*create_table_sql="CREATE TABLE IF NOT EXISTS device_params (""id INTEGER PRIMARY KEY AUTOINCREMENT, ""param_name TEXT NOT NULL, ""param_value REAL NOT NULL, ""update_ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP);";// 3. 执行创建表的SQL语句(callback=NULL,arg=NULL)ret=sqlite3_exec(db,create_table_sql,NULL,NULL,&err_msg);if(ret!=SQLITE_OK){fprintf(stderr,"[ERROR] 创建表失败: %s\n",err_msg);sqlite3_free(err_msg);// 释放错误信息缓冲区sqlite3_close(db);return-1;}printf("[INFO] 表创建成功(已存在则忽略)\n");// 4. 关闭数据库ret=sqlite3_close(db);if(ret!=SQLITE_OK){fprintf(stderr,"[ERROR] 关闭数据库失败: %s\n",sqlite3_errmsg(db));return-1;}printf("[INFO] 数据库关闭成功\n");return0;}

操作步骤

  1. 编译代码(必须链接 sqlite3 库)
gcc sqlite3_c_demo1.c -o sqlite3_c_demo1 -lsqlite3
  1. 运行程序
./sqlite3_c_demo1

输出如下:

[INFO]数据库打开/创建成功[INFO]表创建成功(已存在则忽略)[INFO]数据库关闭成功
  1. 验证表是否创建成功(用命令行交叉验证):
sqlite3 embedded_db.db".tables"

输出如下:

device_params

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询