SQLite学习手册(内置函数)

SQLite学习手册(目录)

https://www.cnblogs.com/stephen-liu74/archive/2012/01/22/2328757.html

https://www.cnblogs.com/stephen-liu74/archive/2012/02/15/2322027.html

一、聚合函数：

    SQLite中支持的聚合函数在很多其他的关系型数据库中也同样支持，因此我们这里将只是给出每个聚集函数的简要说明，而不在给出更多的示例了。这里还需要进一步说明的是，对于所有聚合函数而言，distinct关键字可以作为函数参数字段的前置属性，以便在进行计算时忽略到所有重复的字段值，如count(distinct x)。

函数	说明
avg(x)	该函数返回在同一组内参数字段的平均值。对于不能转换为数字值的String和BLOB类型的字段值，如'HELLO'，SQLite会将其视为0。avg函数的结果总是浮点型，唯一的例外是所有的字段值均为NULL，那样该函数的结果也为NULL。
count(x|*)	count(x)函数返回在同一组内，x字段中值不等于NULL的行数。count(*)函数返回在同一组内的数据行数。
group_concat(x[,y])	该函数返回一个字符串，该字符串将会连接所有非NULL的x值。该函数的y参数将作为每个x值之间的分隔符，如果在调用时忽略该参数，在连接时将使用缺省分隔符","。再有就是各个字符串之间的连接顺序是不确定的。
max(x)	该函数返回同一组内的x字段的最大值，如果该字段的所有值均为NULL，该函数也返回NULL。
min(x)	该函数返回同一组内的x字段的最小值，如果该字段的所有值均为NULL，该函数也返回NULL。
sum(x)	该 函数返回同一组内的x字段值的总和，如果字段值均为NULL，该函数也返回NULL。如果所有的x字段值均为整型或者NULL，该函数返回整型值，否则就 返回浮点型数值。最后需要指出的是，如果所有的数据值均为整型，一旦结果超过上限时将会抛出"integer overflow"的异常。
total(x)	该函数不属于标准SQL，其功能和sum基本相同，只是计算结果比sum更为合理。比如当所有字段值均为NULL时，和sum不同的是，该函数返回0.0。再有就是该函数始终返回浮点型数值。该函数始终都不会抛出异常。

二、核心函数：

    以下函数均为SQLite缺省提供的内置函数，其声明和描述见如下列表：

函数	说明
abs(X)	该函数返回数值参数X的绝对值，如果X为NULL，则返回NULL，如果X为不能转换成数值的字符串，则返回0，如果X值超出Integer的上限，则抛出"Integer Overflow"的异常。
changes()	该函数返回最近执行的INSERT、UPDATE和DELETE语句所影响的数据行数。我们也可以通过执行C/C++函数sqlite3_changes()得到相同的结果。
coalesce(X,Y,...)	返回函数参数中第一个非NULL的参数，如果参数都是NULL，则返回NULL。该函数至少2个参数。
ifnull(X,Y)	该函数等同于两个参数的coalesce()函数，即返回第一个不为NULL的函数参数，如果两个均为NULL，则返回NULL。
length(X)	如果参数X为字符串，则返回字符的数量，如果为数值，则返回该参数的字符串表示形式的长度，如果为NULL，则返回NULL。
lower(X)	返回函数参数X的小写形式，缺省情况下，该函数只能应用于ASCII字符。
ltrim(X[,Y])	如果没有可选参数Y，该函数将移除参数X左侧的所有空格符。如果有参数Y，则移除X左侧的任意在Y中出现的字符。最后返回移除后的字符串。
max(X,Y,...)	返回函数参数中的最大值，如果有任何一个参数为NULL，则返回NULL。
min(X,Y,...)	返回函数参数中的最小值，如果有任何一个参数为NULL，则返回NULL。
nullif(X,Y)	如果函数参数相同，返回NULL，否则返回第一个参数。
random()	返回整型的伪随机数。
replace(X,Y,Z)	将字符串类型的函数参数X中所有子字符串Y替换为字符串Z，最后返回替换后的字符串，源字符串X保持不变。
round(X[,Y])	返回数值参数X被四舍五入到Y刻度的值，如果参数Y不存在，缺省参数值为0。
rtrim(X[,Y])	如果没有可选参数Y，该函数将移除参数X右侧的所有空格符。如果有参数Y，则移除X右侧的任意在Y中出现的字符。最后返回移除后的字符串。
substr(X,Y[,Z])	返回函数参数X的子字符串，从第Y位开始(X中的第一个字符位置为1)截取Z长度的字符，如果忽略Z参数，则取第Y个字符后面的所有字符。如果Z的值为负数，则从第Y位开始，向左截取abs(Z)个字符。如果Y值为负数，则从X字符串的尾部开始计数到第abs(Y)的位置开始。
total_changes()	该函数返回自从该连接被打开时起，INSERT、UPDATE和DELETE语句总共影响的行数。我们也可以通过C/C++接口函数sqlite3_total_changes()得到相同的结果。
trim(x[,y])	如果没有可选参数Y，该函数将移除参数X两侧的所有空格符。如果有参数Y，则移除X两侧的任意在Y中出现的字符。最后返回移除后的字符串。
upper(X)	返回函数参数X的大写形式，缺省情况下，该函数只能应用于ASCII字符。
typeof(X)	返回函数参数数据类型的字符串表示形式，如"Integer、text、real、null"等。

三、日期和时间函数：

    SQLite主要支持以下四种与日期和时间相关的函数，如：
    1). date(timestring, modifier, modifier, ...)
    2). time(timestring, modifier, modifier, ...)
    3). datetime(timestring, modifier, modifier, ...)
    4). strftime(format, timestring, modifier, modifier, ...)
    以上所有四个函数都接受一个时间字符串作为参数，其后再跟有0个或多个修改符。其中strftime()函数还接受一个格式字符串作为其第一个参数。strftime()和C运行时库中的同名函数完全相同。至于其他三个函数，date函数的缺省格式为："YYYY-MM-DD"，time函数的缺省格式为："HH:MM:SS"，datetime函数的缺省格式为："YYYY-MM-DD HH:MM:SS"。   
   1. strftime函数的格式信息：

格式	说明
%d	day of month: 00
%f	fractional seconds: SS.SSS
%H	hour: 00-24
%j	day of year: 001-366
%J	Julian day number
%m	month: 01-12
%M	minute: 00-59
%s	seconds since 1970-01-01
%S	seconds: 00-59
%w	day of week 0-6 with Sunday==0
%W	week of year: 00-53
%Y	year: 0000-9999
%%	%

    需要额外指出的是，其余三个时间函数均可用strftime来表示，如：
    date(...)         strftime('%Y-%m-%d', ...)
    time(...)         strftime('%H:%M:%S', ...)
    datetime(...)   strftime('%Y-%m-%d %H:%M:%S', ...)
    
    2. 时间字符串的格式：
    见如下列表：
    1). YYYY-MM-DD
    2). YYYY-MM-DD HH:MM
    3). YYYY-MM-DD HH:MM:SS
    4). YYYY-MM-DD HH:MM:SS.SSS
    5). HH:MM
    6). HH:MM:SS
    7). HH:MM:SS.SSS
    8). now
    5)到7)中只是包含了时间部分，SQLite将假设日期为2000-01-01。8)表示当前时间。
   
   3. 修改符：
    见如下列表：
    1). NNN days
    2). NNN hours
    3). NNN minutes
    4). NNN.NNNN seconds
    5). NNN months
    6). NNN years
    7). start of month
    8). start of year
    9). start of day
    10).weekday N     
    1)到6)将只是简单的加减指定数量的日期或时间值，如果NNN的值为负数，则减，否则加。7)到9)则将时间串中的指定日期部分设置到当前月、年或日的开始。10)则将日期前进到下一个星期N，其中星期日为0。注：修改符的顺序极为重要，SQLite将会按照从左到右的顺序依次执行修改符。
    
    4. 示例：
    --返回当前日期。
    sqlite> SELECT date('now');  
    2012-01-15    
    --返回当前月的最后一天。
    sqlite> SELECT date('now','start of month','1 month','-1 day');
    2012-01-31
    --返回从1970-01-01 00:00:00到当前时间所流经的秒数。
    sqlite> SELECT strftime('%s','now');
    1326641166    
    --返回当前年中10月份的第一个星期二是日期。
    sqlite> SELECT date('now','start of year','+9 months','weekday 2');
    2012-10-02   

SQLite学习手册(数据表和视图)

https://www.cnblogs.com/stephen-liu74/archive/2012/02/13/2321668.html

一、创建数据表:

    该命令的语法规则和使用方式与大多数关系型数据库基本相同，因此我们还是以示例的方式来演示SQLite中创建表的各种规则。但是对于一些SQLite特有的规则，我们会给予额外的说明。注：以下所有示例均是在sqlite自带命令行工具中完成的。
    1). 最简单的数据表：
    sqlite> CREATE TABLE testtable (first_col integer);
    这里需要说明的是，对于自定义数据表表名，如testtable，不能以sqlite_开头，因为以该前缀定义的表名都用于sqlite内部。

    2). 创建带有缺省值的数据表：
    sqlite> CREATE TABLE testtable (first_col integer DEFAULT 0, second_col varchar DEFAULT 'hello');

    3). 在指定数据库创建表：
    sqlite> ATTACH DATABASE 'd:/mydb.db' AS mydb;
    sqlite> CREATE TABLE mydb.testtable (first_col integer);
    这里先通过ATTACH DATABASE命令将一个已经存在的数据库文件attach到当前的连接中，之后再通过指定数据库名的方式在目标数据库中创建数据表，如mydb.testtable。关于该规则还需要给出一些额外的说明，如果我们在创建数据表时没有指定数据库名，那么将会在当前连接的main数据库中创建该表，在一个连接中只能有一个main数据库。如果需要创建临时表，就无需指定数据库名，见如下示例：
    --创建两个表，一个临时表和普通表。
    sqlite> CREATE TEMP TABLE temptable(first_col integer);
    sqlite> CREATE TABLE testtable (first_col integer);    
    --将当前连接中的缓存数据导出到本地文件，同时退出当前连接。
    sqlite> .backup d:/mydb.db
    sqlite> .exit
    --重新建立sqlite的连接，并将刚刚导出的数据库作为主库重新导入。
    sqlite> .restore d:/mydb.db
    --查看该数据库中的表信息，通过结果可以看出临时表并没有被持久化到数据库文件中。
    sqlite> .tables
    testtable   

    4). "IF NOT EXISTS"从句：
    如果当前创建的数据表名已经存在，即与已经存在的表名、视图名和索引名冲突，那么本次创建操作将失败并报错。然而如果在创建表时加上"IF NOT EXISTS"从句，那么本次创建操作将不会有任何影响，即不会有错误抛出，除非当前的表名和某一索引名冲突。
    sqlite> CREATE TABLE testtable (first_col integer);
    Error: table testtable already exists
    sqlite> CREATE TABLE IF NOT EXISTS testtable (first_col integer);

    5). CREATE TABLE ... AS SELECT：
    通过该方式创建的数据表将与SELECT查询返回的结果集具有相同的Schema信息，但是不包含缺省值和主键等约束信息。然而新创建的表将会包含结果集返回的所有数据。
    sqlite> CREATE TABLE testtable2 AS SELECT * FROM testtable;    
    sqlite> .schema testtable2
    CREATE TABLE testtable2(first_col INT);
    .schema命令是sqlite3命令行工具的内置命令，用于显示当前数据表的CREATE TABLE语句。   

    6). 主键约束：
    --直接在字段的定义上指定主键。
    sqlite> CREATE TABLE testtable (first_col integer PRIMARY KEY ASC);
    --在所有字段已经定义完毕后，再定义表的数约束，这里定义的是基于first_col和second_col的联合主键。
    sqlite> CREATE TABLE testtable2 (
       ...>     first_col integer,
       ...>     second_col integer,
       ...>     PRIMARY KEY (first_col,second_col)
       ...> );
    和其他关系型数据库一样，主键必须是唯一的。

    7). 唯一性约束：
    --直接在字段的定义上指定唯一性约束。
    sqlite> CREATE TABLE testtable (first_col integer UNIQUE);
    --在所有字段已经定义完毕后，在定义表的唯一性约束，这里定义的是基于两个列的唯一性约束。
    sqlite> CREATE TABLE testtable2 (
       ...>     first_col integer,
       ...>     second_col integer,
       ...>     UNIQUE (first_col,second_col)
       ...> );    
    在SQLite中，NULL值被视为和其他任何值都是不同的，这样包括和其他的NULL值，如下例：
    sqlite> DELETE FROM testtable;
    sqlite> SELECT count(*) FROM testtable;
    count(*)
    ----------
    0
    sqlite> INSERT INTO testtable VALUES(NULL);
    sqlite> INSERT INTO testtable VALUES(NULL);
    sqlite> SELECT count(*) FROM testtable;
    count(*)
    ----------
    2    
    由此可见，两次插入的NULL值均插入成功。

    8). 为空(NOT NULL)约束：
    sqlite> CREATE TABLE testtable(first_col integer NOT NULL);
    sqlite> INSERT INTO testtable VALUES(NULL);
    Error: testtable.first_col may not be NULL
    从输出结果可以看出，first_col已经被定义了非空约束，因此不能在插入NULL值了。   

    9). 检查性约束：
    sqlite> CREATE TABLE testtable (first_col integer CHECK (first_col < 5));
    sqlite> INSERT INTO testtable VALUES(4);
    sqlite> INSERT INTO testtable VALUES(20); -- 20违反了字段first_col的检查性约束(first_col < 5)
    Error: constraint failed
    --和之前的其它约束一样，检查性约束也是可以基于表中的多个列来定义的。    
    sqlite> CREATE TABLE testtable2 (
       ...>     first_col integer,
       ...>     second_col integer,
       ...>     CHECK (first_col > 0 AND second_col < 0)
       ...> );

二、表的修改：

    SQLite对ALTER TABLE命令支持的非常有限，仅仅是修改表名和添加新字段。其它的功能，如重命名字段、删除字段和添加删除约束等均为提供支持。
    1). 修改表名：
    需要先说明的是，SQLite中表名的修改只能在同一个数据库中，不能将其移动到Attached数据库中。再有就是一旦表名被修改后，该表已存在的索引将不会受到影响，然而依赖该表的视图和触发器将不得不重新修改其定义。
    sqlite> CREATE TABLE testtable (first_col integer);
    sqlite> ALTER TABLE testtable RENAME TO testtable2;
    sqlite> .tables
    testtable2    
    通过.tables命令的输出可以看出，表testtable已经被修改为testtable2。   

    2). 新增字段：
    sqlite> CREATE TABLE testtable (first_col integer);
    sqlite> ALTER TABLE testtable ADD COLUMN second_col integer;
    sqlite> .schema testtable
    CREATE TABLE "testtable" (first_col integer, second_col integer);    
    通过.schema命令的输出可以看出，表testtable的定义中已经包含了新增字段。   
    关于ALTER TABLE最后需要说明的是，在SQLite中该命令的执行时间是不会受到当前表行数的影响，也就是说，修改有一千万行数据的表和修改只有一条数据的表所需的时间几乎是相等的。
   
三、表的删除：

    在SQLite中如果某个表被删除了，那么与之相关的索引和触发器也会被随之删除。在很多其他的关系型数据库中是不可以这样的，如果必须要删除相关对象，只能在删除表语句中加入WITH CASCADE从句。见如下示例：
    sqlite> CREATE TABLE testtable (first_col integer);
    sqlite> DROP TABLE testtable;
    sqlite> DROP TABLE testtable;
    Error: no such table: testtable
    sqlite> DROP TABLE IF EXISTS testtable;    
    从上面的示例中可以看出，如果删除的表不存在，SQLite将会报错并输出错误信息。如果希望在执行时不抛出异常，我们可以添加IF EXISTS从句，该从句的语义和CREATE TABLE中的完全相同。
    
四、创建视图：

    我们这里只是给出简单的SQL命令示例，具体的含义和技术细节可以参照上面的创建数据表部分，如临时视图、"IF NOT EXISTS"从句等。
    1). 最简单的视图：
    sqlite> CREATE VIEW testview AS SELECT * FROM testtable WHERE first_col > 100;    
    
    2). 创建临时视图：
    sqlite> CREATE TEMP VIEW tempview AS SELECT * FROM testtable WHERE first_col > 100;
    
    3). "IF NOT EXISTS"从句：
    sqlite> CREATE VIEW testview AS SELECT * FROM testtable WHERE first_col > 100;
    Error: table testview already exists
    sqlite> CREATE VIEW IF NOT EXISTS testview AS SELECT * FROM testtable WHERE first_col > 100;
   
五、删除视图：

    该操作的语法和删除表基本相同，因此这里只是给出示例：
    sqlite> DROP VIEW testview;
    sqlite> DROP VIEW testview;
    Error: no such view: testview
    sqlite> DROP VIEW IF EXISTS testview;