Sqlite使用手册

Sqlite使用手册

SQLite可说是某种「美德软件」（virtueware），作者本人放弃著作权，而给使用SQLite的人以下的「祝福」（blessing）：
May you do good and not evil. 愿你行善莫行恶
May you find forgiveness for yourself and forgive others. 愿你原谅自己宽恕他人
May you share freely, never taking more than you give. 愿你宽心与人分享，所取不多于你所施予

优点：

支援大多数的SQL指令。
一个档案就是一个数据库。不需要安装数据库服务器软件。
完整的Unicode支援（因此没有跨语系的问题）。
速度很快。

建立数据库档案
用sqlite3建立数据库的方法很简单，只要在shell下键入：

# sqlite3 foo.db如果目录下没有foo.db，sqlite3就会建立这个数据库。

使用.help可以取得求助，.quit则是离开（请注意：不是quit）

SQL的指令格式
所以的SQL指令都是以分号（;）结尾的。如果遇到两个减号（--）则代表注解，sqlite3会略过去。

建立资料表
假设我们要建一个名叫film的资料表，只要键入以下指令就可以了：

create table film(title, length, year, starring);这样我们就建立了一个名叫film的资料表，里面有name、length、year、starring四个字段。

这个create table指令的语法为：

create table table_name(field1, field2, field3, ...);table_name是资料表的名称，fieldx则是字段的名字。sqlite3与许多SQL数据库软件不同的是，它不在乎字段属于哪一种资 料型态：sqlite3的字段可以储存任何东西：文字、数字、大量文字（blub），它会在适时自动转换。


建立索引
如果资料表有相当多的资料，我们便会建立索引来加快速度。好比说：

create index film_title_index on film(title);意思是针对film资料表的name字段，建立一个名叫film_name_index的索引。这个指令的语法为

create index index_name on table_name(field_to_be_indexed);一旦建立了索引，sqlite3会在针对该字段作查询时，自动使用该索引。这一切的操作都是在幕后自动发生的，无须使用者特别指令。


加入一笔资料
接下来我们要加入资料了，加入的方法为使用insert into指令，语法为：

insert into table_name values(data1, data2, data3, ...);例如我们可以加入

insert into film values ('Silence of the Lambs, The', 118, 1991, 'Jodie Foster');insert into film values ('Contact', 153, 1997, 'Jodie Foster');insert into film values ('Crouching Tiger, Hidden Dragon', 120, 2000, 'Yun-Fat Chow');insert into film values ('Hours, The', 114, 2002, 'Nicole Kidman');如果该字段没有资料，我们可以填NULL。



查询资料
讲到这里，我们终于要开始介绍SQL最强大的select指令了。我们首先简单介绍select的基本句型：

select columns from table_name where expression;最常见的用法，当然是倒出所有数据库的内容：

select * from film;如果资料太多了，我们或许会想限制笔数：

select * from film limit 10;或是照着电影年份来排列：

select * from film order by year limit 10;或是年份比较

C/C++中调用SQLITE3的基本步骤

创建数据库：

sqlite3 *pDB = NULL;
char * errMsg = NULL;

//打开一个数据库，如果改数据库不存在，则创建一个名字为databaseName的数据库文件
int rc = sqlite3_open(databaseName, &pDB);

if(rc)
{
cout << " Open the database " << databaseName << " failed" << endl;
}

//如果创建成功，添加表

else
{
cout << "create the database successful!" << endl;

//creat the table
int i;
for(i=1; i

//函数参数：第一个为操作数据库的指针，第二句为SQL命令字符串

//第三个参数为callback函数，这里没有用，第四个参数为callback函数

//中的第一个参数，第五个为出错信息

rc = sqlite3_exec(pDB, "CREATE TABLE chn_to_eng(chinese QString, english QString)", 0, 0, &errMsg);

if(rc == SQLITE_OK)
cout << "create the chn_to_eng table successful!" << endl;
else
cout << errMsg << endl;

//同上，插入另一个表

rc = sqlite3_exec(pDB, "CREATE TABLE eng_to_chn(english QString, chinese QString)", 0, 0, &errMsg);

if(rc == SQLITE_OK)
cout << "create the eng_to_chn table successful!" << endl;
else
cout << errMsg << endl;

}

、、、、、、

//往表中添加数据

char chn[]="...";

char eng[]="...";

char value[500];
//定义一条参数SQL命令，其中chn,eng为需要插入的数据
sprintf(value, "INSERT INTO chn_to_eng(chinese, english) VALUES('%s', '%s')", chn, eng);

//use the SQLITE C/C++ API to create and adjust a database.
rc = sqlite3_exec(pDB,
value,
0, 0, &errMsg);

//查询一条记录

char value[500];

//定义一条查询语句，其中条件为当english为target时的中文记录

//print_result_cb为callback函数，在其中可以得到查询的结果，具体见下文
sprintf(value, "SELECT chinese FROM eng_to_chn where english='%s' ", target);

rc = sqlite3_exec(pDB,
value,
print_result_cb, 0, &errMsg);

if(rc == SQLITE_OK)
{
cout << "select the record successful!" << endl;
}
else
{
cout << errMsg << endl;
return false;
}

.......

}

//callback回调函数print_result_cb的编写，其中data为sqlite3_exec中的第四个参数，第二个参数是栏的数目，第三个是栏的名字，第四个为查询得到的值。这两个函数输出所有查询到的结果

int print_result_cb(void* data, int n_columns, char** column_values,
char** column_names)
{
static int column_names_printed = 0;
int i;
if (!column_names_printed) {
print_row(n_columns, column_names);
column_names_printed = 1;
}

print_row(n_columns, column_values);
return 0;
}

void print_row(int n_values, char** values)
{
int i;
for (i = 0; i < n_values; ++i) {
if (i > 0) {
printf("\t");
}

printf("%s", values[i]);

}
printf("\n");
}

大致过程就是如此，具体可以参考SQLITE的API函数说明，见

SQLite语法备忘录

结构定义

CREATE TABLE

创建新表。

语法：

sql-command ::=	CREATE [TEMP | TEMPORARY] TABLE table-name (     column-def [, column-def]*     [, constraint]* )
sql-command ::=	CREATE [TEMP | TEMPORARY] TABLE [database-name.] table-name AS select-statement
column-def ::=	name [type] [[CONSTRAINT name] column-constraint]*
type ::=	typename | typename ( number ) | typename ( number , number )
column-constraint ::=	NOT NULL [ conflict-clause ] | PRIMARY KEY [sort-order] [ conflict-clause ] | UNIQUE [ conflict-clause ] | CHECK ( expr ) [ conflict-clause ] | DEFAULT value | COLLATE collation-name
constraint ::=	PRIMARY KEY ( column-list ) [ conflict-clause ] | UNIQUE ( column-list ) [ conflict-clause ] | CHECK ( expr ) [ conflict-clause ]
conflict-clause ::=	ON CONFLICT conflict-algorithm

CREATE VIEW

创建一个视图（虚拟表），该表以另一种方式表示一个或多个表中的数据。

语法：

sql-command ::=

CREATE [TEMP | TEMPORARY] VIEW [database-name.] view-name AS select-statement

例子：
CREATE VIEW master_view AS
    SELECT * FROM sqlite_master WHERE type='view';
说明：
创建一个名为master_view的视图，其中包括sqlite_master这个表中的所有视图表。

CREATE TRIGGER

创建触发器，触发器是一种特殊的存储过程，在用户试图对指定的表执行指定的数据修改语句时自动执行。

语法：

sql-statement ::=

CREATE [TEMP | TEMPORARY] TRIGGER trigger-name [ BEFORE | AFTER ] database-event ON [database-name .] table-name trigger-action

sql-statement ::=

CREATE [TEMP | TEMPORARY] TRIGGER trigger-name INSTEAD OF database-event ON [database-name .] view-name trigger-action

database-event ::=

DELETE | INSERT | UPDATE | UPDATE OF column-list

trigger-action ::=

[ FOR EACH ROW | FOR EACH STATEMENT ] [ WHEN expression ] BEGIN     trigger-step ; [ trigger-step ; ]* END

trigger-step ::=

update-statement | insert-statement | delete-statement | select-statement

例子：
CREATE TRIGGER update_customer_address UPDATE OF address ON customers
  BEGIN
    UPDATE orders SET address = new.address WHERE customer_name = old.name;
  END;
说明：
创建了一个名为update_customer_address的触发器，当用户更新customers表中的address字段时，将触发并更新orders表中的address字段为新的值。
比如执行如下一条语句：
UPDATE customers SET address = '1 Main St.' WHERE name = 'Jack Jones';
数据库将自动执行如下语句：
UPDATE orders SET address = '1 Main St.' WHERE customer_name = 'Jack Jones';

CREATE INDEX

为给定表或视图创建索引。

语法：

sql-statement ::=	CREATE [UNIQUE] INDEX index-name ON [database-name .] table-name ( column-name [, column-name]* ) [ ON CONFLICT conflict-algorithm ]
column-name ::=	name [ COLLATE collation-name] [ ASC | DESC ]

例子：
CREATE INDEX idx_email ON customers (email);
说明：
为customers表中的email创建一个名为idx_email的字段。

结构删除

DROP TABLE

删除表定义及该表的所有索引。

语法：

sql-command ::=

DROP TABLE [database-name.] table-name

例子：
DROP TABLE customers;

DROP VIEW

删除一个视图。

语法：

sql-command ::=

DROP VIEW view-name

例子：
DROP VIEW master_view;

DROP TRIGGER

删除一个触发器。

语法：

sql-statement ::=

DROP TRIGGER [database-name .] trigger-name

例子：
DROP TRIGGER update_customer_address;

DROP INDEX

删除一个索引。

语法：

sql-command ::=

DROP INDEX [database-name .] index-name

例子：
DROP INDEX idx_email;

数据操作

INSERT

将新行插入到表。

语法：

sql-statement ::=

INSERT [OR conflict-algorithm] INTO [database-name .] table-name [(column-list)] VALUES(value-list) | INSERT [OR conflict-algorithm] INTO [database-name .] table-name [(column-list)] select-statement

UPDATE

更新表中的现有数据。

语法：

sql-statement ::=	UPDATE [ OR conflict-algorithm ] [database-name .] table-name SET assignment [, assignment]* [WHERE expr]
assignment ::=	column-name = expr

DELETE

从表中删除行。

语法：

sql-statement ::=

DELETE FROM [database-name .] table-name [WHERE expr]

SELECT

从表中检索数据。

语法：

sql-statement ::=	SELECT [ALL | DISTINCT] result [FROM table-list] [WHERE expr] [GROUP BY expr-list] [HAVING expr] [compound-op select]* [ORDER BY sort-expr-list] [LIMIT integer [( OFFSET | , ) integer]]
result ::=	result-column [, result-column]*
result-column ::=	* | table-name . * | expr [ [AS] string ]
table-list ::=	table [join-op table join-args]*
table ::=	table-name [AS alias] | ( select ) [AS alias]
join-op ::=	, | [NATURAL] [LEFT | RIGHT | FULL] [OUTER | INNER | CROSS] JOIN
join-args ::=	[ON expr] [USING ( id-list )]
sort-expr-list ::=	expr [sort-order] [, expr [sort-order]]*
sort-order ::=	[ COLLATE collation-name ] [ ASC | DESC ]
compound_op ::=	UNION | UNION ALL | INTERSECT | EXCEPT

REPLACE

类似INSERT

语法：

sql-statement ::=

REPLACE INTO [database-name .] table-name [( column-list )] VALUES ( value-list ) | REPLACE INTO [database-name .] table-name [( column-list )] select-statement

事务处理

BEGIN TRANSACTION

标记一个事务的起始点。

语法：

sql-statement ::=

BEGIN [TRANSACTION [name]]

END TRANSACTION

标记一个事务的终止。

语法：

sql-statement ::=

END [TRANSACTION [name]]

COMMIT TRANSACTION

标志一个事务的结束。

语法：

sql-statement ::=

COMMIT [TRANSACTION [name]]

ROLLBACK TRANSACTION

将事务回滚到事务的起点。

语法：

sql-statement ::=

ROLLBACK [TRANSACTION [name]]

其他操作

COPY

主要用于导入大量的数据。

语法：

sql-statement ::=

COPY [ OR conflict-algorithm ] [database-name .] table-name FROM filename [ USING DELIMITERS delim ]

例子：
COPY customers FROM customers.csv;

EXPLAIN

 

语法：

sql-statement ::=

EXPLAIN sql-statement

PRAGMA

 

语法：

sql-statement ::=

PRAGMA name [= value] | PRAGMA function(arg)

VACUUM

 

语法：

sql-statement ::=

VACUUM [index-or-table-name]

ATTACH DATABASE

附加一个数据库到当前的数据库连接。

语法：

sql-statement ::=

ATTACH [DATABASE] database-filename AS database-name

DETTACH DATABASE

从当前的数据库分离一个使用ATTACH DATABASE附加的数据库。

语法：

sql-command ::=

DETACH [DATABASE] database-name

SQLite内建函数表

算术函数
abs(X)	返回给定数字表达式的绝对值。
max(X,Y[,...])	返回表达式的最大值。
min(X,Y[,...])	返回表达式的最小值。
random(*)	返回随机数。
round(X[,Y])	返回数字表达式并四舍五入为指定的长度或精度。
字符处理函数
length(X)	返回给定字符串表达式的字符个数。
lower(X)	将大写字符数据转换为小写字符数据后返回字符表达式。
upper(X)	返回将小写字符数据转换为大写的字符表达式。
substr(X,Y,Z)	返回表达式的一部分。
randstr()
quote(A)
like(A,B)	确定给定的字符串是否与指定的模式匹配。
glob(A,B)
条件判断函数
coalesce(X,Y[,...])
ifnull(X,Y)
nullif(X,Y)
集合函数
avg(X)	返回组中值的平均值。
count(X)	返回组中项目的数量。
max(X)	返回组中值的最大值。
min(X)	返回组中值的最小值。
sum(X)	返回表达式中所有值的和。
其他函数
typeof(X)	返回数据的类型。
last_insert_rowid()	返回最后插入的数据的ID。
sqlite_version(*)	返回SQLite的版本。
change_count()	返回受上一语句影响的行数。
last_statement_change_count()