SQLite3数据库在嵌入式应用之三： 以日志功能为例给出常用命令和C/C++常用API

1、引用：http://www.runoob.com/sqlite/sqlite-c-cpp.html

以下是重要的 C&C++ / SQLite 接口程序，可以满足您在 C/C++ 程序中使用 SQLite 数据库的需求。如果您需要了解更多细节，请查看 SQLite 官方文档。

序号	API & 描述
1	sqlite3_open(const char *filename, sqlite3 **ppDb) 该例程打开一个指向 SQLite 数据库文件的连接，返回一个用于其他 SQLite 程序的数据库连接对象。 如果 filename 参数是 NULL 或 ':memory:'，那么 sqlite3_open() 将会在 RAM 中创建一个内存数据库，这只会在 session 的有效时间内持续。 如果文件名 filename 不为 NULL，那么 sqlite3_open() 将使用这个参数值尝试打开数据库文件。如果该名称的文件不存在，sqlite3_open() 将创建一个新的命名为该名称的数据库文件并打开。
2	sqlite3_exec(sqlite3*, const char *sql, sqlite_callback, void *data, char **errmsg) 该例程提供了一个执行 SQL 命令的快捷方式，SQL 命令由 sql 参数提供，可以由多个 SQL 命令组成。 在这里，第一个参数 sqlite3 是打开的数据库对象，sqlite_callback 是一个回调，data 作为其第一个参数，errmsg 将被返回用来获取程序生成的任何错误。 sqlite3_exec() 程序解析并执行由 sql 参数所给的每个命令，直到字符串结束或者遇到错误为止。
3	sqlite3_close(sqlite3*) 该例程关闭之前调用 sqlite3_open() 打开的数据库连接。所有与连接相关的语句都应在连接关闭之前完成。 如果还有查询没有完成，sqlite3_close() 将返回 SQLITE_BUSY 禁止关闭的错误消息。

2、自己总结的较为通用的SQLite3命名执行接口函数

/******************************************************
*自己总结的较为通用的SQLite3命名执行接口函数
*******************************************************/
typedef struct log_obj{
    char log_file_path[128]; 

    /*sqlite3 staff*/
    sqlite3 *db;
    char SQL_cmd[512];
    int (*call_back)(void *data, int argc, char **argv, char **azColName);
    void *data;
}log_obj;

static int sqlite3_exec_cmd(log_obj *obj)
{
    char *zErrMsg = NULL;
    int rc = 0;

    /*open database*/
    rc = sqlite3_open(obj->log_file_path, &obj->db);
    if(SQLITE_OK != rc)
    {
        printf("Can't open database:%s, errMsg:%s", obj->log_file_path, sqlite3_errmsg(obj->db));
        return -1;
    }

    /* Execute SQL statement */
    rc = sqlite3_exec(obj->db, obj->SQL_cmd, obj->call_back, (void *)obj->data, &zErrMsg);
    if( rc != SQLITE_OK )
    {
        printf("SQL error: %s\n", zErrMsg);
        sqlite3_free(zErrMsg);
        sqlite3_close(obj->db);
        return -1;
    }

    sqlite3_close(obj->db);

    return 0;
}

3、已日志功能为例，总结SQLite3 比较重要的语句

/******************************************************
*SQLite3 比较重要的语句
*******************************************************/
#define LOG_TABLE_NAME " LOG "

/*统计表中有多少条日志*/
#define LOG_GET_COUNT  "SELECT COUNT(*) FROM "LOG_TABLE_NAME

/*将表按照TIME的降序排列，然后从中取一条，这一条位置相对第一条偏移n*/
#define LOG_GET_ONE_LOG  "SELECT * FROM "LOG_TABLE_NAME" ORDER BY TIME DESC LIMIT 1 OFFSET %d;"

/*获取某个时间段之间的日志数目*/
#define LOG_GET_COUNT_PERIOD   "SELECT COUNT(*) FROM "LOG_TABLE_NAME \
                                    "WHERE TIME IN (SELECT TIME FROM "LOG_TABLE_NAME" WHERE TIME BETWEEN  '%s' AND '%s');"

/*获取某个时间段之间日志，每次取一条显示，取的位置相对第一条偏移n*/
#define LOG_GET_ONE_LOG_PERIOD "SELECT * FROM "LOG_TABLE_NAME \
                                    "WHERE TIME IN (SELECT TIME FROM "LOG_TABLE_NAME" WHERE TIME BETWEEN  '%s' AND '%s')  LIMIT 1 OFFSET %d;"

/*删除最早产生的那一条日志*/
#define LOG_DEL_EARLIEST_LOG  "DELETE FROM "LOG_TABLE_NAME" WHERE TIME IN (SELECT MIN(TIME) FORM "LOG_TABLE_NAME");"

/*INSERT 一条新日志*/
#define LOG_INSERT_ONE_LOG     "INSERT INTO "LOG_TABLE_NAME" (DESC1,DESC2,DESC3,TIME)" \
                                    "VALUES ( '%s', '%s', '%s', datetime('now', 'localtime'));"

/*创建表*/
#define LOG_CREATE_TABLE  "CREATE TABLE IF NOT EXISTS "LOG_TABLE_NAME"("  \
                                "ID INTEGER PRIMARY KEY     AUTOINCREMENT," \
                                "DESC1           TEXT     NOT NULL," \
                                "DESC2           TEXT     NOT NULL," \
                                "DESC3           TEXT     NOT NULL," \
                                "TIME              TEXT     NOT NULL);"

/*导出表*/
#define LOG_DOWNLOAD_LOG "./sqlite3 -csv %s \"select DESC1, TIME, DESC2, DESC3 FROM "LOG_TABLE_NAME" ORDER BY TIME DESC\" > %s"

4、以SQLite3和以上命令实现的日志界面示例：