PostgreSQL学习手册(函数和操做符Ⅲ)

9、序列操做函数：

    序列对象(也叫序列生成器)都是用CREATE SEQUENCE建立的特殊的单行表。一个序列对象一般用于为行或者表生成惟一的标识符。下面序列函数，为咱们从序列对象中获取最新的序列值提供了简单和并发读取安全的方法。

函数	返回类型	描述
nextval(regclass)	bigint	递增序列对象到它的下一个数值而且返回该值。这个动做是自动完成的。即便多个会话并发运行nextval，每一个进程也会安全地收到一个惟一的序列值。
currval(regclass)	bigint	在当前会话中返回最近一次nextval抓到的该序列的数值。(若是在本会话中从未在该序列上调用过nextval，那么会报告一个错误。)请注意由于此函数返回一个会话范围的数值，并且也能给出一个可预计的结果，所以能够用于判断其它会话是否执行过nextval。
lastval()	bigint	返回当前会话里最近一次nextval返回的数值。这个函数等效于currval，只是它不用序列名为参数，它抓取当前会话里面最近一次nextval使用的序列。若是当前会话尚未调用过nextval，那么调用lastval将会报错。
setval(regclass, bigint)	bigint	重置序列对象的计数器数值。设置序列的last_value字段为指定数值而且将其is_called字段设置为true，表示下一次nextval将在返回数值以前递增该序列。
setval(regclass, bigint, boolean)	bigint	重置序列对象的计数器数值。功能等同于上面的setval函数，只是is_called能够设置为true或false。若是将其设置为false，那么下一次nextval将返回该数值，随后的nextval才开始递增该序列。

    对于regclass参数，仅需用单引号括住序列名便可，所以它看上去就像文本常量。为了达到和处理普通SQL对象同样的兼容性，这个字串将被转换成小写，除非该序列名是用双引号括起，如：
    nextval('foo')     --操做序列号foo
    nextval('FOO')    --操做序列号foo
    nextval('"Foo"')   --操做序列号Foo
    SELECT setval('foo', 42);    --下次nextval将返回43
    SELECT setval('foo', 42, true);   
    SELECT setval('foo', 42, false);   --下次nextval将返回42

   
10、条件表达式：

    1. CASE：
    SQL CASE表达式是一种通用的条件表达式，相似于其它语言中的if/else语句。
    CASE WHEN condition THEN result
        [WHEN ...]
        [ELSE result]
    END
    condition是一个返回boolean的表达式。若是为真，那么CASE表达式的结果就是符合条件的result。若是结果为假，那么以相同方式 搜寻随后的WHEN子句。若是没有WHEN condition为真，那么case表达式的结果就是在ELSE子句里的值。若是省略了ELSE子句并且没有匹配的条件，结果为NULL，如：
    MyTest=> SELECT * FROM testtable;
     i
    ---
     1
     2
     3
    (3 rows)
    MyTest=> SELECT i, CASE WHEN i=1 THEN 'one'
    MyTest->                         WHEN i=2 THEN 'two'
    MyTest->                         ELSE 'other'
    MyTest->                END
    MyTest-> FROM testtable;
     i | case
    ---+-------
     1 | one
     2 | two
     3 | other
    (3 rows)
    注：CASE表达式并不计算任何对于判断结果并不须要的子表达式。
    
    2. COALESCE：
    COALESCE返回它的第一个非NULL的参数的值。它经常使用于在为显示目的检索数据时用缺省值替换NULL值。
    COALESCE(value[, ...])
    和CASE表达式同样，COALESCE将不会计算不须要用来判断结果的参数。也就是说，在第一个非空参数右边的参数不会被计算。
    
    3. NULLIF：
    当且仅当value1和value2相等时，NULLIF才返回NULL。不然它返回value1。
    NULLIF(value1, value2)
    MyTest=> SELECT NULLIF('abc','abc');
     nullif
    --------
    
    (1 row)   
    MyTest=> SELECT NULLIF('abcd','abc');
     nullif
    --------
     abcd
    (1 row)

    4. GREATEST和LEAST：
    GREATEST和LEAST函数从一个任意的数字表达式列表里选取最大或者最小的数值。列表中的NULL数值将被忽略。只有全部表达式的结果都是NULL的时候，结果才会是NULL。
    GREATEST(value [, ...])
    LEAST(value [, ...])
    MyTest=> SELECT GREATEST(1,3,5);
     greatest
    ----------
            5
    (1 row) 
    MyTest=> SELECT LEAST(1,3,5,NULL);
     least
    -------
         1
    (1 row)
    
11、数组函数和操做符：

    1. PostgreSQL中提供的用于数组的操做符列表：

操做符	描述	例子	结果
=	等于	ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]	t
<>	不等于	ARRAY[1,2,3] <> ARRAY[1,2,4]	t
<	小于	ARRAY[1,2,3] < ARRAY[1,2,4]	t
>	大于	ARRAY[1,4,3] > ARRAY[1,2,4]	t
<=	小于或等于	ARRAY[1,2,3] <= ARRAY[1,2,3]	t
>=	大于或等于	ARRAY[1,4,3] >= ARRAY[1,4,3]	t
||	数组与数组链接	ARRAY[1,2,3] || ARRAY[4,5,6]	{1,2,3,4,5,6}
||	数组与数组链接	ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]]	{{1,2,3},{4,5,6},{7,8,9}}
||	元素与数组链接	3 || ARRAY[4,5,6]	{3,4,5,6}
||	元素与数组链接	ARRAY[4,5,6] || 7	{4,5,6,7}

    2. PostgreSQL中提供的用于数组的函数列表：

函数	返回类型	描述	例子	结果
array_cat(anyarray, anyarray)	anyarray	链接两个数组	array_cat(ARRAY[1,2,3], ARRAY[4,5])	{1,2,3,4,5}
array_append(anyarray, anyelement)	anyarray	向一个数组末尾附加一个元素	array_append(ARRAY[1,2], 3)	{1,2,3}
array_prepend(anyelement, anyarray)	anyarray	向一个数组开头附加一个元素	array_prepend(1, ARRAY[2,3])	{1,2,3}
array_dims(anyarray)	text	返回一个数组维数的文本表示	array_dims(ARRAY[[1,2,3], [4,5,6]])	[1:2][1:3]
array_lower(anyarray, int)	int	返回指定的数组维数的下界	array_lower(array_prepend(0, ARRAY[1,2,3]), 1)	0
array_upper(anyarray, int)	int	返回指定数组维数的上界	array_upper(ARRAY[1,2,3,4], 1)	4
array_to_string(anyarray, text)	text	使用提供的分隔符链接数组元素	array_to_string(ARRAY[1, 2, 3], '~^~')	1~^~2~^~3
string_to_array(text, text)	text[]	使用指定的分隔符把字串拆分红数组元素	string_to_array('xx~^~yy~^~zz', '~^~')	{xx,yy,zz}

12、系统信息函数：

    1. PostgreSQL中提供的和数据库相关的函数列表：

名字	返回类型	描述
current_database()	name	当前数据库的名字
current_schema()	name	当前模式的名字
current_schemas(boolean)	name[]	在搜索路径中的模式名字
current_user	name	目前执行环境下的用户名
inet_client_addr()	inet	链接的远端地址
inet_client_port()	int	链接的远端端口
inet_server_addr()	inet	链接的本地地址
inet_server_port()	int	链接的本地端口
session_user	name	会话用户名
pg_postmaster_start_time()	timestamp	postmaster启动的时间
user	name	current_user
version()	text	PostgreSQL版本信息

    2. 容许用户在程序里查询对象访问权限的函数：

名字	描述	可用权限
has_table_privilege(user,table,privilege)	用户是否有访问表的权限	SELECT/INSERT/UPDATE/DELETE/RULE/REFERENCES/TRIGGER
has_table_privilege(table,privilege)	当前用户是否有访问表的权限	SELECT/INSERT/UPDATE/DELETE/RULE/REFERENCES/TRIGGER
has_database_privilege(user,database,privilege)	用户是否有访问数据库的权限	CREATE/TEMPORARY
has_database_privilege(database,privilege)	当前用户是否有访问数据库的权限	CREATE/TEMPORARY
has_function_privilege(user,function,privilege)	用户是否有访问函数的权限	EXECUTE
has_function_privilege(function,privilege)	当前用户是否有访问函数的权限	EXECUTE
has_language_privilege(user,language,privilege)	用户是否有访问语言的权限	USAGE
has_language_privilege(language,privilege)	当前用户是否有访问语言的权限	USAGE
has_schema_privilege(user,schema,privilege)	用户是否有访问模式的权限	CREAT/USAGE
has_schema_privilege(schema,privilege)	当前用户是否有访问模式的权限	CREAT/USAGE
has_tablespace_privilege(user,tablespace,privilege)	用户是否有访问表空间的权限	CREATE
has_tablespace_privilege(tablespace,privilege)	当前用户是否有访问表空间的权限	CREATE

    注：以上函数均返回boolean类型。要评估一个用户是否在权限上持有赋权选项，给权限键字附加 WITH GRANT OPTION；好比 'UPDATE WITH GRANT OPTION'。
    3. 模式可视性查询函数：
    那些判断一个对象是否在当前模式搜索路径中可见的函数。 若是一个表所在的模式在搜索路径中，而且没有同名的表出如今搜索路径的更早的地方，那么就说这个表视可见的。 它等效于表能够不带明确模式修饰进行引用。

名字	描述	应用类型
pg_table_is_visible(table_oid)	该表/视图是否在搜索路径中可见	regclass
pg_type_is_visible(type_oid)	该类/视图型是否在搜索路径中可见	regtype
pg_function_is_visible(function_oid)	该函数是否在搜索路径中可见	regprocedure
pg_operator_is_visible(operator_oid)	该操做符是否在搜索路径中可见	regoperator
pg_opclass_is_visible(opclass_oid)	该操做符表是否在搜索路径中可见	regclass
pg_conversion_is_visible(conversion_oid)	转换是否在搜索路径中可见	regoperator

    注：以上函数均返回boolean类型，全部这些函数都须要对象 OID 标识做为检查的对象。
    postgres=# SELECT pg_table_is_visible('testtable'::regclass);
     pg_table_is_visible
    ---------------------
     t
    (1 row)

    4. 系统表信息函数：

名字	返回类型	描述
format_type(type_oid,typemod)	text	获取一个数据类型的SQL名称
pg_get_viewdef(view_oid)	text	为视图获取CREATE VIEW命令
pg_get_viewdef(view_oid,pretty_bool)	text	为视图获取CREATE VIEW命令
pg_get_ruledef(rule_oid)	text	为规则获取CREATE RULE命令
pg_get_ruledef(rule_oid,pretty_bool)	text	为规则获取CREATE RULE命令
pg_get_indexdef(index_oid)	text	为索引获取CREATE INDEX命令
pg_get_indexdef(index_oid,column_no,pretty_bool)	text	为索引获取CREATE INDEX命令， 若是column_no不为零，则是只获取一个索引字段的定义
pg_get_triggerdef(trigger_oid)	text	为触发器获取CREATE [CONSTRAINT] TRIGGER
pg_get_constraintdef(constraint_oid)	text	获取一个约束的定义
pg_get_constraintdef(constraint_oid,pretty_bool)	text	获取一个约束的定义
pg_get_expr(expr_text,relation_oid)	text	反编译一个表达式的内部形式，假设其中的任何Vars都引用第二个参数指出的关系
pg_get_expr(expr_text,relation_oid, pretty_bool)	text	反编译一个表达式的内部形式，假设其中的任何Vars都引用第二个参数指出的关系
pg_get_userbyid(roleid)	name	获取给出的ID的角色名
pg_get_serial_sequence(table_name,column_name)	text	获取一个serial或者bigserial字段使用的序列名字
pg_tablespace_databases(tablespace_oid)	setof oid	获取在指定表空间(OID表示)中拥有对象的一套数据库的OID的集合

    这些函数大多数都有两个变种，其中一个能够选择对结果的"漂亮的打印"。 漂亮打印的格式更容易读，可是缺省的格式更有可能被未来的PostgreSQL版本用一样的方法解释；若是是用于转储，那么尽量避免使用漂亮打印。 给漂亮打印参数传递false生成的结果和那个没有这个参数的变种生成的结果彻底同样。

十三、系统管理函数：

    1. 查询以及修改运行时配置参数的函数：

名字	返回类型	描述
current_setting(setting_name)	text	当前设置的值
set_config(setting_name,new_value,is_local)	text	设置参数并返回新值

    current_setting用于以查询形式获取setting_name设置的当前数值。它和SQL命令SHOW是等效的。 好比：
    MyTest=# SELECT current_setting('datestyle');
     current_setting
    -----------------
     ISO, YMD
    (1 row)
    set_config将参数setting_name设置为new_value。若是is_local设置为true，那么新数值将只应用于当前事务。若是你但愿新的数值应用于当前会话，那么应该使用false。它等效于SQL命令SET。好比：
    MyTest=# SELECT set_config('log_statement_stats','off', false);
     set_config
    ------------
     off
    (1 row)
   
    2. 数据库对象尺寸函数：

名字	返回类型	描述
pg_tablespace_size(oid)	bigint	指定OID表明的表空间使用的磁盘空间
pg_tablespace_size(name)	bigint	指定名字的表空间使用的磁盘空间
pg_database_size(oid)	bigint	指定OID表明的数据库使用的磁盘空间
pg_database_size(name)	bigint	指定名称的数据库使用的磁盘空间
pg_relation_size(oid)	bigint	指定OID表明的表或者索引所使用的磁盘空间
pg_relation_size(text)	bigint	指定名称的表或者索引使用的磁盘空间。这个名字能够用模式名修饰
pg_total_relation_size(oid)	bigint	指定OID表明的表使用的磁盘空间，包括索引和压缩数据
pg_total_relation_size(text)	bigint	指定名字的表所使用的所有磁盘空间，包括索引和压缩数据。表名字能够用模式名修饰。
pg_size_pretty(bigint)	text	把字节计算的尺寸转换成一我的类易读的尺寸单位

    3. 数据库对象位置函数： 

名字	返回类型	描述
pg_relation_filenode(relationregclass)	oid	获取指定对象的文件节点编号(一般为对象的oid值)。
pg_relation_filepath(relationregclass)	text	获取指定对象的完整路径名。

    mydatabase=# select pg_relation_filenode('testtable');
     pg_relation_filenode
    ----------------------
                    17877
    (1 row)   
    mydatabase=# select pg_relation_filepath('testtable');
                 pg_relation_filepath
    ----------------------------------------------
     pg_tblspc/17633/PG_9.1_201105231/17636/17877
    (1 row)   

    该博客中提供的全部信息均源自PostgreSQL官方文档，编写该篇博客的主要目的是便于从此的查阅，特此声明。