Postgresqlの関数の詳細な説明 - 一般的な関数とその使用方法を読むだけで十分です

以前に書いたように、postgresql データベースを使用してデータを取得する場合、データ処理のシナリオに遭遇することは避けられませんが、この記事では、一般的に使用される組み込み関数をいくつかまとめます。

-- 查看postgresql的版本(以下任一语句都可以实现)
select version();
show server_version;

1.フォーマット変換

1.1 フォーマット変換 文字表示変換

フォーマット変換は、二重コロンを使用して直接実行できます。構文は次のとおりです。
フィールド名または値::データ型
例は次のとおりです。

-- 将文本'123'转为int8类型
SELECT
    '123' :: int8 num;
-- 将文本类型字段t1转为int8类型
SELECT
    t1 :: int8 
    from temp;

1.2 データ型を使用して変換を表示する

変換するデータ型を使用します。構文は次のとおりです。
データ型の値の
例:

-- 将文本'123'转为int8类型
SELECT
    int8'123' num;

1.3 フォーマット変換機能の表示変換

データ変換関数 cast を使用して変換します。構文は次のとおりです:
cast (フィールド名または値をデータ型として)
例:

-- 将文本'123'转为int8类型
SELECT
    cast('123' as int4) num;
-- 将文本字段t1转为int类型
SELECT CAST( t1 AS INT ) t1_c 
FROM
    TEMP;

1.4 変換ケース

-- 文本转整数
SELECT CAST
    ( '123' AS int4 );
-- 文本转浮点数字
SELECT CAST
    ( '123.34' AS DECIMAL );
SELECT CAST
    ( '123.34' AS NUMERIC );
-- 数字转文本
SELECT CAST
    ( 123 AS VARCHAR );--可变字符串
SELECT CAST
    ( - 123 AS CHAR ( 2 ) );-- 固定字符串，进行截断，将-123转为'-1'
SELECT CAST
    ( - 123 AS CHAR ( 6 ) );-- 固定字符串，进行空格填充，将-123转为'-123  '
SELECT CAST
    ( 124.94 AS TEXT );--可变字符串,将124.94转为'124.94'
SELECT
    to_char( 124.94, '999D9' );--将124.94转为'124.9',遵循四舍五入
SELECT
    to_char( 124.94, 'FM999.99' );--将124.94转为'124.94'
SELECT
    to_char( - 124.94, 'FM9999999.99' );--将-124.94转为'-124.94'
SELECT
    to_char( - 124.94, 'FM9999999.990' );--将-124.94转为'-124.940'
SELECT
    to_char( 124, '00000' );--左端用零补齐凑够5位，将124转为'00124'
SELECT
    to_char( 124, '99999' );--左端用空格补齐凑够5位，将124转为'  124'
SELECT
    to_char( - 124.945, 'FM999' );--只显示整数部分，遵循四舍五入
-- 时间戳(timestamp)转日期(date)
SELECT CAST
    ( now( ) AS DATE );--普通日期模式
-- 时间戳(timestamp)转文本
SELECT CAST
    ( now( ) AS TEXT );--不指定输出格式
SELECT
    to_char( now( ), 'yyyy-mm-dd' );--指定输出格式;
-- 文本转日期(date)
SELECT
    to_date( '2012-01-01', 'yyyy-mm-dd' );
-- 文本转时间戳(TIMESTAMP)
SELECT
    to_timestamp( '2012-01-01 12:02:01', 'yyyy-mm-dd HH24:MI:SS' );

2. 数学的計算

2.1 数学演算子

オペレーター	説明	例	結果
+	追加	2 + 3	5
-	減らす	2 - 3	-1
*	取った	2×3	6
/	除算 (整数除算は結果を切り捨てます)	4 / 2	2
%	モジュロ (剰余)	5% 4	1
^	指数 (左から右への関連付け)	2.0 ^ 3.0	8
|/	平方根	|/ 25.0	5
||/	立方根	||/ 27.0	3
!	階乗	5 !	120
!!	階乗 (前置演算子)	!! 5	120
@	絶対値	@ -5.0	5
&	ビットごとの AND	91 & 15	11
| |	ビット単位または	32	3
#	ビット単位の XOR	17 #5	20
〜	ビットごとの否定	~1	-2
<<	ビットごとの左シフト	1 << 4	16
>>	ビットごとの右シフト	8 >> 2	2

2.2 数学演算関数

関数	戻り型	説明	例	結果
abs(x)	入力と同じ	絶対値	abs(-12.43)	12.43
cbrt(dp)	ダブル	立方根	cbrt(27.0)	3
ceil(dp または数値)	入力と同じ	引数以上の最も近い整数	天井(-42.8)	-42
天井 (dp または数値)	入力と同じ	引数より小さくない最も近い整数 (ceil の別名)	天井(-95.3)	-95
度(dp)	DP	ラジアンを度に変換する	度(0.5)	28.6478897565412
div(y 数値, x 数値)	数値	y/x の整数商	div(9,4)	2
exp(dp または数値)	入力と同じ	索引	経験値(1.0)	2.71828182845905
フロア (DP または数値)	入力と同じ	引数以下の最も近い整数	床(-42.8)	-43
ln(dp または数値)	入力と同じ	自然対数	ln(2.0)	0.693147180559945
対数 (dp または数値)	入力と同じ	10 を底とする対数	ログ(100.0)	2
log10 (dp または数値)	入力と同じ	10 を底とする対数	log10(100.0)	2
log(b 数値, x 数値)	数値	底 b への対数	ログ (2.0、64.0)	6.0000000000
mod(y, x)	パラメータ型と同じ	y/x の余り	mod(9,4)	1
パイ()	DP	「π」定数	パイ()	3.14159265358979
パワー(a dp, b dp)	DP	a の b 乗を求めます	パワー(9.0, 3.0)	729
power(a 数値, b 数値)	数値	a の b 乗を求めます	パワー(9.0, 3.0)	729
ラジアン(dp)	DP	角度をラジアンに変換する	ラジアン(45.0)	0.785398163397448
round(dp または数値)	入力と同じ	最も近い整数に丸める	ラウンド(42.4)	42
round(v 数値, s int)	数値	小数点以下 s 桁に丸める	ラウンド(42.4382, 2)	42.44
位取り(数値)	整数	引数の精度 (小数点以下の桁数)	scale(8.41)	2
sign(dp or numeric)	和输入相同	参数的符号（-1, 0, +1）	sign(-8.4)	-1
sqrt(dp or numeric)	和输入相同	平方根	sqrt(2.0)	1.4142135623731
trunc(dp or numeric)	和输入相同	截断（向零靠近）	trunc(42.8)	42
trunc(v numeric, s int)	numeric	截断为s位小数位置的数字	trunc(42.4382, 2)	42.43

3.逻辑计算

3.1 逻辑操作符

postgresql中的逻辑操作符，有以下三种：
AND
OR
NOT

3.2 比较操作符

操作符	描述
<	小于
>	大于
<=	小于等于
>=	大于等于
=	等于
<> or !=	不等于

!=操作符在分析器阶段被转换成<>

3.3 比较谓词

谓词	描述
a BETWEEN x AND y	在x和y之间
a NOT BETWEEN x AND y	不在x和y之间
a BETWEEN SYMMETRIC x AND y	在对比较值排序后位于x和y之间
a NOT BETWEEN SYMMETRIC x AND y	在对比较值排序后不位于x和y之间
a IS DISTINCT FROM b	不等于，空值被当做一个普通值
a IS NOT DISTINCT FROM b	等于，空值被当做一个普通值
expression IS NULL	是空值
expression IS NOT NULL	不是空值
expression ISNULL	是空值（非标准语法）
expression NOTNULL	不是空值（非标准语法）
boolean_expression IS TRUE	为真
boolean_expression IS NOT TRUE	为假或未知
boolean_expression IS FALSE	为假
boolean_expression IS NOT FALSE	为真或者未知
boolean_expression IS UNKNOWN	值为未知
boolean_expression IS NOT UNKNOWN	为真或者为假

3.4 比较函数

函数	描述	例子	例子结果
num_nonnulls(VARIADIC “any”)	返回非空参数的数量	num_nonnulls(0, NULL, 1 ,2 ,3)	4
num_nulls(VARIADIC “any”)	返回空参数的数量	num_nulls(0, NULL, 1 ,2 ,3)	1

4.字符串及相关匹配函数

函数	返回类型	描述	例子	结果
string || string	text	串接	‘Hello’ || ‘Word’	‘HelloWord’
string || non-string or non-string || string	text	使用一个非字符串输入的串接	'Value: ’ || 42	Value: 42
bit_length(string)	int	串中的位数	bit_length(‘Hello’)	40
char_length(string) or character_length(string)	int	串中字符数	char_length(‘Hello’)	4
lower(string)	text	将字符串转换为小写形式	lower(‘Hello’)	hello
overlay(string placing string from int [for int])	text	替换子串,for后面是指替换的位数	overlay(‘Hexxx,word’ placing ‘llo’ from 3 for 4)	Helloword
position(substring in string)	int	定位指定子串位置，可利用值是否大于0来判断是否包含子串	position(‘lo’ in ‘hello’)	4
substring(string [from int] [for int])	text	提取子串	substring(‘hello’ from 1 for 3)	hel
substring(string from pattern)	text	提取匹配POSIX正则表达式的子串	substring(‘hello’ from ‘^…’)	hel
substr(string, from [, count])	text	提取子串	substr(‘Hello’, 1, 3)	hel
trim([leading | trailing | both] [characters] from string)	text	从string的开头、结尾或者两端（both是默认值）移除只包含characters（默认是一个空格）中字符的最长字符串	trim(both ‘Hes’ from ‘sHehelloeHs’)	hello
trim([leading | trailing | both] [from] string [, characters] )	text	trim()的非标准版本	trim(both from ‘hhHellohh’, ‘h’) 或trim(‘hhHellohh’, ‘h’)	Tom
upper(string)	text	将字符串转换成大写形式	upper(‘hello’)	HELLO
concat(str “any” [, str “any” [, …] ])	text	串接所有参数的文本表示。NULL 参数被忽略。	concat(‘abcde’, 2, NULL, 22)	abcde222
concat_ws(sep text, str “any” [, str “any” [, …] ])	text	将除了第一个参数外的其他参数用分隔符串接在一起。第一个参数被用作分隔符字符串。NULL 参数被忽略。	concat_ws(‘,’, ‘abcde’, 2, NULL, 22)	abcde,2,22
left(str text, n int)	text	返回字符串中的前n个字符。当n为负时，将返回除了最后|n|个字符之外的所有字符。	left(‘abcde’, 2)	ab
length(string)	int	string中的字符数	length(‘hello’)	5
length(string bytea, encoding name )	int	string在给定编码中的字符数。string必须在这个编码中有效。	length(‘hello’, ‘UTF8’)	5
lpad(string text, length int [, fill text])	text	将string通过前置字符fill（默认是一个空格）填充到长度length。如果string已经长于length，则它被（从右边）截断。	lpad(‘hi’, 5, ‘ab’)	abahi
ltrim(string text [, characters text])	text	从string的开头删除最长的只包含characters（默认是一个空格）的串	ltrim(‘zzzytest’, ‘xyz’)	test
regexp_match(string text, pattern text [, flags text])	text[]	返回一个POSIX正则表达式与string的第一个匹配得到的子串。	regexp_match(‘foobarbequetarz’, ‘(foo)(bar)’)	一行：{foo,bar}
regexp_matches(string text, pattern text [, flags text])	setof text[]	返回一个POSIX正则表达式与string匹配得到的子串	regexp_matches(‘foobarbequetarz’, ‘.ar’, ‘g’)	两行：{bar} {tar}
regexp_replace(string text, pattern text, replacement text [, flags text])	text	替换匹配一个POSIX正则表达式的子串。	regexp_replace(‘Hello’, ‘l+.’, ‘r’)	Her
regexp_split_to_array(string text, pattern text [, flags text ])	text[]	使用一个POSIX正则表达式作为分隔符划分string。	regexp_split_to_array(‘hello world’, ‘\s+’)	一行：{hello,world}
regexp_split_to_table(string text, pattern text [, flags text]) setof	text	使用一个POSIX正则表达式作为分隔符划分string。	regexp_split_to_table(‘hello world’, ‘\s+’)	两行：hello world
repeat(string text, number int)	text	重复string指定的number次	repeat(‘he’, 3)	hehehe
replace(string text, from text, to text)	text	将string中出现的所有子串from替换为子串to	replace(‘hello’, ‘ello’, ‘is’)	his
reverse(str)	text	返回反转的字符串	reverse(‘abcde’)	edcba
right(str text, n int)	text	返回字符串中的最后n个字符。如果n为负，返回除最前面的|n|个字符外的所有字符。	right(‘abcde’, 2)	de
rpad(string text, length int [, fill text])	text	将string通过增加字符fill（默认为一个空格）填充到长度length。如果string已经长于length则它会被截断。	rpad(‘hi’, 5, ‘xy’)	hixyx
rtrim(string text [, characters text])	text	从string的结尾删除最长的只包含characters（默认是一个空格）的串	rtrim(‘testxxzx’, ‘xyz’)	test
split_part(string text, delimiter text, field int)	text	按delimiter划分string并返回给定域（从1开始计算）	split_part(‘you!hello!world!’, ‘!’, 2)	hello
strpos(string, substring)	int	指定子串的位置（和position(substring in string)相同，但是注意相反的参数顺序）	strpos(‘hello’, ‘o’)	5
starts_with(string, prefix)	bool	如果string以prefix开始则返回真。	starts_with(‘alphabet’, ‘alph’)	t

5.时间与日期函数

5.1时间类操作符

操作符	例子	结果
+	date ‘2001-09-28’ + integer ‘7’	date ‘2001-10-05’
+	date ‘2001-09-28’ + interval ‘1 hour’	timestamp ‘2001-09-28 01:00:00’
+	date ‘2001-09-28’ + time ‘03:00’	timestamp ‘2001-09-28 03:00:00’
+	interval ‘1 day’ + interval ‘1 hour’	interval ‘1 day 01:00:00’
+	timestamp ‘2001-09-28 01:00’ + interval ‘23 hours’	timestamp ‘2001-09-29 00:00:00’
+	time ‘01:00’ + interval ‘3 hours’	time ‘04:00:00’
-	- interval ‘23 hours’	interval ‘-23:00:00’
-	date ‘2001-10-01’ - date ‘2001-09-28’	integer ‘3’ (days)
-	date ‘2001-10-01’ - integer ‘7’	date ‘2001-09-24’
-	date ‘2001-09-28’ - interval ‘1 hour’	timestamp ‘2001-09-27 23:00:00’
-	time ‘05:00’ - time ‘03:00’	interval ‘02:00:00’
-	time ‘05:00’ - interval ‘2 hours’	time ‘03:00:00’
-	timestamp ‘2001-09-28 23:00’ - interval ‘23 hours’	timestamp ‘2001-09-28 00:00:00’
-	interval ‘1 day’ - interval ‘1 hour’	interval ‘1 day -01:00:00’
-	timestamp ‘2001-09-29 03:00’ - timestamp ‘2001-09-27 12:00’	interval ‘1 day 15:00:00’
*	900 * interval ‘1 second’	interval ‘00:15:00’
*	21 * interval ‘1 day’	interval ‘21 days’
*	double precision ‘3.5’ * interval ‘1 hour’	interval ‘03:30:00’
/	interval ‘1 hour’ / double precision ‘1.5’	interval ‘00:40:00’

5.2 时间、日期类函数

函数	返回类型	描述	例子	结果
age(timestamp, timestamp)	interval	减去参数，生成一个使用年、月（而不是只用日）的“符号化”的结果	age(timestamp ‘2001-04-10’, timestamp ‘1957-06-13’)	43 years 9 mons 27 days
age(timestamp)	interval	从current_date（在午夜）减去	age(timestamp ‘1957-06-13’)，假如今日为2022-06-14	65 years 1 day
clock_timestamp()	timestamp with time zone	当前日期和时间（在语句执行期间变化）	clock_timestamp()	2022-06-14 19:06:54.034672+08
current_date	date	当前日期	current_date	2022-06-14
current_time	time with time zone	当前时间（一天中的时间），带时区	current_time	19:11:04.336139+08
current_timestamp	timestamp with time zone	当前日期和时间（当前事务开始时），带时区	current_timestamp	2022-06-14 19:11:57.83455+08
date_part(text, timestamp)	double precision	获得子域（等价于extract）	date_part(‘hour’, timestamp ‘2022-06-14 20:38:40’)	20
date_part(text, interval)	double precision	获得子域（等价于extract）	date_part(‘month’, interval ‘2 years 3 months’)	3
date_trunc(text, timestamp)	timestamp	截断到指定精度	date_trunc(‘hour’, timestamp ‘2022-06-14 20:38:40’)	2022-06-14 20:00:00
date_trunc(text, timestamp with time zone, text)	timestamp with time zone	在指定的时区截断到指定的精度	ddate_trunc(‘day’, timestamptz ‘2022-06-14 20:38:40+00’, ‘Australia/Sydney’)	2022-06-14 22:00:00+08
date_trunc(text, interval)	interval	截断到指定精度	date_trunc(‘hour’, interval ‘2 days 3 hours 40 minutes’)	2 days 03:00:00
extract(field from timestamp)	double precision	获得子域	extract(MINUTE from timestamp ‘2022-06-14 20:38:40’)	38
extract(field from interval)	double precision	获得子域	extract(month from interval ‘2 years 3 months’)	3
isfinite(date)	boolean	测试有限日期（不是+/-无限）	isfinite(date ‘2022-06-14’)	true（实际缩写为t）
isfinite(timestamp)	boolean	测试有限时间戳（不是+/-无限）	isfinite(timestamp ‘2022-06-14 21:28:30’)	true（实际缩写为t）
isfinite(interval)	boolean	测试有限间隔	isfinite(interval ‘2 minutes’)	true（实际缩写为t）
justify_days(interval)	interval	调整间隔这样30天时间周期可以表示为月	justify_days(interval ‘35 days’)	1 mon 5 days
justify_hours(interval)	interval	调整间隔这样24小时时间周期可以表示为日	justify_hours(interval ‘27 hours’)	1 day 03:00:00
justify_interval(interval)	interval	使用justify_days和justify_hours调整间隔，使用额外的符号调整	justify_interval(interval ‘1 mon -1 hour’)	29 days 23:00:00
localtime	time	当前时间（一天中的时间），不带时区	localtime	19:21:14.958286
localtimestamp	timestamp	当前日期和时间（当前事务的开始），不带时区	LOCALTIMESTAMP	2022-07-22 19:23:54.073462
make_date(year int, month int, day int)	date	从年、月、日域创建日期	make_date(2022, 7, 15)	2022-07-15
make_interval(years int DEFAULT 0, months int DEFAULT 0, weeks int DEFAULT 0, days int DEFAULT 0, hours int DEFAULT 0, mins int DEFAULT 0, secs double precision DEFAULT 0.0)	interval	从年、月、周、日、时、分、秒域创建interval	make_interval(days => 10)	10 days
make_time(hour int, min int, sec double precision)	time	从时、分、秒域创建时间	make_time(8, 15, 23.5)	08:15:23.5
make_timestamp(year int, month int, day int, hour int, min int, sec double precision)	timestamp	从年、月、日、时、分、秒域创建时间戳	make_timestamp(2013, 7, 15, 8, 15, 23.5)	2013-07-15 08:15:23.5
make_timestamptz(year int, month int, day int, hour int, min int, sec double precision, [ timezone text ])	timestamp with time zone	从年、月、日、时、分、秒域创建带时区的时间戳。如果没有指定timezone， 则使用当前时区。	make_timestamptz(2022, 6, 14, 19, 30, 50.5)	2022-06-14 19:30:50.5+08
now()	timestamp with time zone	当前日期和时间（当前事务的开始），带时区	now()	2022-07-22 19:28:15.804042+08
statement_timestamp()	timestamp with time zone	当前日期和时间（当前语句的开始），在一个事务的第一条命令期间返回值与CURRENT_TIMESTAMP相同	statement_timestamp()	2022-07-22 19:31:35.75589+08
timeofday()	text	当前日期和时间（像clock_timestamp，但是作为一个text字符串）	timeofday()	Fri Jul 22 19:35:19.000959 2022 CST
transaction_timestamp()	timestamp with time zone	当前日期和时间（当前事务的开始）；等同于CURRENT_TIMESTAMP	transaction_timestamp()	2022-07-22 19:34:02.369665+08
to_timestamp(double precision)	timestamp with time zone	把 Unix 时间（从 1970-01-01 00:00:00+00 开始的秒）转换成 timestamp	to_timestamp(1655211000)	2022-06-14 20:50:00+08

6.数组函数

6.1 数组操作符

操作符	描述	例子	结果
=	等于	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,4,3] @> ARRAY[3,1,3]	t
<@	被包含	ARRAY[2,2,7] <@ ARRAY[1,7,4,2,6]	t
&&	重叠（具有公共元素）	ARRAY[1,4,3] && ARRAY[2,1]	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}

6.2 数组函数

函数	返回类型	描述	例子	结果
array_append(anyarray, anyelement)	anyarray	向一个数组的末端追加一个元素	array_append(ARRAY[1,2], 3)	{1,2,3}
array_cat(anyarray, anyarray)	anyarray	连接两个数组	array_cat(ARRAY[1,2,3], ARRAY[4,5])	{1,2,3,4,5}
array_ndims(anyarray)	int	返回数组的维度数	array_ndims(ARRAY[[1,2,3], [4,5,6]])	2
array_dims(anyarray)	text	返回数组的维度的文本表示	array_dims(ARRAY[[1,2,3], [4,5,6]])	[1:2][1:3]
array_fill(anyelement, int[], [, int[]])	anyarray	返回一个用提供的值和维度初始化好的数组，可以选择下界不为1	array_fill(6, ARRAY[3], ARRAY[5])	[5:7]={6,6,6}
array_length(anyarray, int)	int	返回被请求的数组维度的长度	array_length(array[1,2,3], 1)	3
array_lower(anyarray, int)	int	返回被请求的数组维度的下界	array_lower(‘[0:2]={1,2,3}’::int[], 1)	0
array_position(anyarray, anyelement [, int])	int	返回在该数组中从第三个参数指定的元素开始或者第一个元素开始（数组必须是一维的）、第二个参数的第一次出现的下标	array_position(ARRAY[‘sun’,‘mon’,‘tue’,‘wed’,‘thu’,‘fri’,‘sat’], ‘mon’)	2
array_positions(anyarray, anyelement)	int[]	返回在第一个参数给定的数组（数组必须是一维的）中，第二个参数所有出现位置的下标组成的数组	array_positions(ARRAY[‘A’,‘A’,‘B’,‘A’], ‘A’)	{1,2,4}
array_prepend(anyelement, anyarray)	anyarray	向一个数组的首部追加一个元素	array_prepend(1, ARRAY[2,3])	{1,2,3}
array_remove(anyarray, anyelement)	anyarray	从数组中移除所有等于给定值的所有元素（数组必须是一维的）	array_remove(ARRAY[1,2,3,2], 2)	{1,3}
array_replace(anyarray, anyelement, anyelement)	anyarray	将每一个等于给定值的数组元素替换成一个新值	array_replace(ARRAY[1,2,5,4], 5, 3)	{1,2,3,4}
array_to_string(anyarray, text [, text])	text	使用提供的定界符和可选的空串连接数组元素	array_to_string(ARRAY[1, 2, 3, NULL, 5], ‘,’, ‘*’)	‘1,2,3,*,5’
array_upper(anyarray, int)	int	返回被请求的数组维度的上界	array_upper(ARRAY[1,8,3,7], 1)	4
cardinality(anyarray)	int	返回数组中元素的总数，如果数组为空则返回0	cardinality(ARRAY[[1,2],[3,4]])	4
string_to_array(text, text [, text])	text[]	使用提供的定界符和可选的空串将字符串划分成数组元素	string_to_array(‘a-b-c-d-e-g-’, ‘-’, ‘’)	{a,b,c,d,e,g,NULL}
unnest(anyarray)	setof anyelement	将一个数组扩展成一组行	unnest(ARRAY[1,2])	2行：1 2

7.范围函数

7.1 范围操作符

操作符	描述	例子	结果
=	等于	int4range(1,5) = ‘[1,4]’::int4range	t
<>	不等于	numrange(1.1,2.2) <> numrange(1.1,2.3)	t
<	小于	int4range(1,10) < int4range(2,3)	t
>	大于	int4range(1,10) > int4range(1,5)	t
<=	小于等于	numrange(1.1,2.2) <= numrange(1.1,2.2)	t
>=	大于等于	numrange(1.1,2.2) >= numrange(1.1,2.0)	t
@>	包含范围	int4range(2,4) @> int4range(2,3)	t
@>	包含元素	‘[2011-01-01,2011-03-01)’::tsrange @> ‘2011-01-10’::timestamp	t
<@	范围被包含	int4range(2,4) <@ int4range(1,7)	t
<@	元素被包含	42 <@ int4range(1,7)	f
&&	重叠（有公共点）	int8range(3,7) && int8range(4,12)	t
<<	严格左部	int8range(1,10) << int8range(100,110)	t
>>	严格右部	int8range(50,60) >> int8range(20,30)	t
&<	不超过右部	int8range(1,20) &< int8range(18,20) t
&>	不超过左部	int8range(7,20) &> int8range(5,10)	t
-|-	相邻	numrange(1.1,2.2) -|- numrange(2.2,3.3)	t
+	并	numrange(5,15) + numrange(10,20)	[5,20)
*	交	int8range(5,15) * int8range(10,20)	[10,15)
-	差	int8range(5,15) - int8range(10,20)	[5,10)

7.2 范围函数

函数	返回类型	描述	例子	结果
lower(anyrange)	范围的元素类型	范围的下界	lower(numrange(1.1,2.2))	1.1
upper(anyrange)	范围的元素类型	范围的上界	upper(numrange(1.1,2.2))	2.2
isempty(anyrange)	boolean	范围为空？	isempty(numrange(1.1,2.2))	false
lower_inc(anyrange)	boolean	下界包含在内？	lower_inc(numrange(1.1,2.2))	true
upper_inc(anyrange)	boolean	上界包含在内？	upper_inc(numrange(1.1,2.2))	false
lower_inf(anyrange)	boolean	下界无限？	lower_inf(‘(,)’::daterange)	true
upper_inf(anyrange)	boolean	上界无限？	upper_inf(‘(,)’::daterange)	true
range_merge(anyrange, anyrange)	anyrange	包含两个给定范围的最小范围	range_merge(‘[1,2)’::int4range, ‘[3,4)’::int4range)	[1,4)

8.聚集函数

8.1 常用函数

函数	参数类型	返回类型	部分模式	描述
array_agg(expression)	任何非数组类型	参数类型的数组	No	输入值（包括空）被连接到一个数组
array_agg(expression)	任意数组类型	和参数数据类型相同	No	输入数组被串接到一个更高维度的数组中 （输入必须都具有相同的维度并且不能为空或者 NULL）
avg(expression)	smallint, int, bigint、real、double precision、numeric或interval	对于任何整数类型参数是numeric，对于一个浮点参数是double precision，否则和参数数据类型相同	Yes	所有非空输入值的平均值（算术平均）
bit_and(expression)	smallint、int、bigint或bit	与参数数据类型相同	Yes	所有非空输入值的按位与，如果没有非空值则结果是空值
bit_or(expression)	smallint, int, bigint, or bit	与参数数据类型相同	Yes	所有非空输入值的按位或，如果没有非空值则结果是空值
bool_and(expression)	bool	bool	Yes	如果所有输入值为真则结果为真，否则为假
bool_or(expression)	bool	bool	Yes	至少一个输入值为真时结果为真，否则为假
count(*)		bigint	Yes	输入的行数
count(expression)	any	bigint	Yes	expression值非空的输入行的数目
every(expression)	bool	bool	Yes	等价于bool_and
json_agg(expression)	any	json	No	将值，包含空值，聚集成一个 JSON 数组
jsonb_agg(expression)	any	jsonb	No	把值，包含空值，聚合成一个 JSON 数组
json_object_agg(name, value)	(any, any)	json	No	将名字/值对聚集成一个 JSON 对象，值可以为空，但不能是名字。
jsonb_object_agg(name, value)	(any, any)	jsonb	No	把名字/值对聚合成一个 JSON 对象，值可以为空，但不能是名字。
max(expression)	任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组	与参数数据类型相同	Yes	所有非空输入值中expression的最大值
min(expression)	任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组	与参数数据类型相同	Yes	所有非空输入值中expression的最小值
string_agg(expression, delimiter)	(text, text) 或 (bytea, bytea)	与参数数据类型相同	No	非空输入值连接成一个串，用定界符分隔
sum(expression)	smallint、int、 bigint、real、double precision、numeric、 interval或money	对smallint或int参数是bigint，对bigint参数是numeric，否则和参数数据类型相同	Yes	所有非空输入值的expression的和
xmlagg(expression)	xml	xml	No	连接非空XML值

8.2 统计类函数

函数	参数类型	返回类型	部分模式	描述
array_agg(expression)	任何非数组类型	参数类型的数组	No	输入值（包括空）被连接到一个数组
array_agg(expression)	任意数组类型	和参数数据类型相同	No	输入数组被串接到一个更高维度的数组中 （输入必须都具有相同的维度并且不能为空或者 NULL）
avg(expression)	smallint, int, bigint、real、double precision、numeric或interval	对于任何整数类型参数是numeric，对于一个浮点参数是double precision，否则和参数数据类型相同	Yes	所有非空输入值的平均值（算术平均）
bit_and(expression)	smallint、int、bigint或bit	与参数数据类型相同	Yes	所有非空输入值的按位与，如果没有非空值则结果是空值
bit_or(expression)	smallint, int, bigint, or bit	与参数数据类型相同	Yes	所有非空输入值的按位或，如果没有非空值则结果是空值
bool_and(expression)	bool	bool	Yes	如果所有输入值为真则结果为真，否则为假
bool_or(expression)	bool	bool	Yes	至少一个输入值为真时结果为真，否则为假
count(*)		bigint	Yes	输入的行数
count(expression)	any	bigint	Yes	expression值非空的输入行的数目
every(expression)	bool	bool	Yes	等价于bool_and
json_agg(expression)	any	json	No	将值，包含空值，聚集成一个 JSON 数组
jsonb_agg(expression)	any	jsonb	No	把值，包含空值，聚合成一个 JSON 数组
json_object_agg(name, value)	(any, any)	json	No	将名字/值对聚集成一个 JSON 对象，值可以为空，但不能是名字。
jsonb_object_agg(name, value)	(any, any)	jsonb	No	把名字/值对聚合成一个 JSON 对象，值可以为空，但不能是名字。
max(expression)	任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组	与参数数据类型相同	Yes	所有非空输入值中expression的最大值
min(expression)	任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组	与参数数据类型相同	Yes	所有非空输入值中expression的最小值
string_agg(expression, delimiter)	(text, text) 或 (bytea, bytea)	与参数数据类型相同	No	非空输入值连接成一个串，用定界符分隔
sum(expression)	smallint、int、 bigint、real、double precision、numeric、 interval或money	对smallint或int参数是bigint，对bigint参数是numeric，否则和参数数据类型相同	Yes	所有非空输入值的expression的和
xmlagg(expression)	xml	xml	No	连接非空XML值

8.3 有序集聚集函数

函数	参数类型	返回类型	部分模式	描述
corr(Y, X)	double precision	double precision	Yes	相关系数
covar_pop(Y, X)	double precision	double precision	Yes	总体协方差
covar_samp(Y, X)	double precision	double precision	Yes	样本协方差
regr_avgx(Y, X)	double precision	double precision	Yes	自变量的平均值 （sum(X)/N）
regr_avgy(Y, X)	double precision	double precision	Yes	因变量的平均值 （sum(Y)/N）
regr_count(Y, X)	double precision	bigint	Yes	两个表达式都不为空的输入行的数目
regr_intercept(Y, X)	double precision	double precision	Yes	由（X, Y）对决定的最小二乘拟合的线性方程的 y截距
regr_r2(Y, X)	double precision	double precision	Yes	相关系数的平方
regr_slope(Y, X)	double precision	double precision	Yes	由（X, Y）对决定的最小二乘拟合的线性方程的斜率
regr_sxx(Y, X)	double precision	double precision	Yes	sum(X^2) - sum(X)^2/N（自变量的“平方和”）
regr_sxy(Y, X)	double precision	double precision	Yes	sum(X*Y) - sum(X) * sum(Y)/N（自变量乘以因变量的“积之合”）
regr_syy(Y, X)	double precision	double precision	Yes	sum(Y^2) - sum(Y)^2/N（因变量的“平方和”）
stddev(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	stddev_samp的历史别名
stddev_pop(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	输入值的总体标准偏差
stddev_samp(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	输入值的样本标准偏差
variance(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	var_samp的历史别名
var_pop(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	输入值的总体方差（总体标准偏差的平方）
var_samp(expression)	smallint、int、 bigint、real、double precision或numeric	浮点参数为double precision，否则为numeric	Yes	输入值的样本方差（样本标准偏差的平方）

8.4 有序数据集

函数	直接参数类型	聚集参数类型	返回类型	部分模式	描述
mode() WITHIN GROUP (ORDER BY sort_expression)		任何可排序类型	与排序表达式相同	No	返回最频繁的输入值（如果有多个频度相同的值就选第一个）
percentile_cont(fraction) WITHIN GROUP (ORDER BY sort_expression)	double precision	double precision或者interval	与排序表达式相同	No	连续百分率：返回一个对应于排序中指定分数的值，如有必要就在相邻的输入项之间插值
percentile_cont(fractions) WITHIN GROUP (ORDER BY sort_expression)	double precision[]	double precision或者interval	排序表达式的类型的数组	No	多重连续百分率：返回一个匹配fractions参数形状的结果数组， 其中每一个非空元素都用对应于那个百分率的值替换
percentile_disc(fraction) WITHIN GROUP (ORDER BY sort_expression)	double precision	一种可排序类型	与排序表达式相同	No	离散百分率：返回第一个在排序中位置等于或者超过指定分数的输入值
percentile_disc(fractions) WITHIN GROUP (ORDER BY sort_expression)	double precision[]	任何可排序类型	排序表达式的类型的数组	No	多重离散百分率：返回一个匹配fractions参数形状的结果数组， 其中每一个非空元素都用对应于那个百分率的输入值替换

8.5 假想集聚集函数(排序)

函数	直接参数类型	聚集参数类型	返回类型	部分模式	描述
rank(args) WITHIN GROUP (ORDER BY sorted_args)	VARIADIC “any”	VARIADIC “any”	bigint	No	假想行的排名，为重复的行留下间隔
dense_rank(args) WITHIN GROUP (ORDER BY sorted_args)	VARIADIC “any”	VARIADIC “any”	bigint	No	假想行的排名，不留间隔
percent_rank(args) WITHIN GROUP (ORDER BY sorted_args)	VARIADIC “any”	VARIADIC “any”	double precision	No	假想行的相对排名，范围从 0 到 1
cume_dist(args) WITHIN GROUP (ORDER BY sorted_args) VARIADIC “any”	VARIADIC “any”	double precision		No	假想行的相对排名，范围从 1/N 到 1

8.6 分组操作

函数	返回类型	描述
GROUPING(args…)	integer	整数位掩码指示哪些参数不被包括在当前分组集合中

使用方法举例

WITH test_table AS (
	SELECT UNNEST( ARRAY [ '财务', '行政', '销售', '财务', '行政', '行政' ] ) AS depart,
		UNNEST ( ARRAY [ 'A', 'B', 'A', 'C', 'D', 'C' ] ) AS NAME,
		UNNEST ( ARRAY [ 200, 100, 50, 30, 200, 100 ] ) AS donate 
	) SELECT
	depart,
	NAME,
	GROUPING ( depart, NAME ),
	SUM ( donate ),
	COUNT ( donate ) 
FROM
	test_table 
GROUP BY
	ROLLUP ( depart, NAME );

9.条件类函数

函数	语法	使用说明	使用例子
case	CASE WHEN condition THEN result [WHEN …] [ELSE result] END	CASE子句可以用于任何表达式可以出现的地方。每一个condition是一个返回boolean结果的表达式。如果结果为真，那么CASE表达式的结果就是符合条件的result，并且剩下的CASE表达式不会被处理。如果条件的结果不为真，那么以相同方式搜寻任何随后的WHEN子句。如果没有WHEN condition为真，那么CASE表达式的值就是在ELSE子句里的result。如果省略了ELSE子句而且没有条件为真，结果为空。	CASE WHEN a=1 THEN ‘one’ WHEN a=2 THEN ‘two’ ELSE 'other’END
coalesce	COALESCE(value [, …])	返回它的第一个非空参数的值。当且仅当所有参数都为空时才会返回空。它常用于在为显示目的检索数据时用缺省值替换空值。	COALESCE(description, short_description, ‘(none)’)
nullif	NULLIF(value1, value2)	当value1和value2相等时，NULLIF返回一个空值。 否则它返回value1。	NULLIF(value, ‘(none)’)
greatest	GREATEST(value [, …])	从一个任意的数字表达式列表里选取最大的数值。列表中的 NULL 数值将被忽略。只有所有表达式的结果都是 NULL 的时候，结果才会是 NULL。	greatest(2,5,1)
least	GREATEST(value [, …])	从一个任意的数字表达式列表里选取最小的数值。列表中的 NULL 数值将被忽略。只有所有表达式的结果都是 NULL 的时候，结果才会是 NULL。	least(2,6,5)

10.窗口函数

函数	返回类型	描述
row_number()	bigint	当前行在其分区中的行号，从1计
rank()	bigint	带间隙的当前行排名； 与该行的第一个同等行的row_number相同
dense_rank()	bigint	不带间隙的当前行排名； 这个函数计数同等组
percent_rank()	double precision	当前行的相对排名： (rank- 1) / (总行数 - 1)
cume_dist()	double precision	累积分布：(在当前行之前或者平级的分区行数) / 分区行总数
ntile(num_buckets integer)	integer	从1到参数值的整数范围，尽可能等分分区
lag(value anyelement [, offset integer [, default anyelement ]])	和value的类型相同	返回value，它在分区内当前行的之前offset个位置的行上计算；如果没有这样的行，返回default替代（必须和value类型相同）。offset和default都是根据当前行计算的结果。如果忽略它们，则offset默认是1，default默认是空值
lead(value anyelement [, offset integer [, default anyelement ]])	和value类型相同	返回value，它在分区内当前行的之后offset个位置的行上计算；如果没有这样的行，返回default替代（必须和value类型相同）。offset和default都是根据当前行计算的结果。如果忽略它们，则offset默认是1，default默认是空值
first_value(value any)	same type as value	返回在窗口帧中第一行上计算的value
last_value(value any)	和value类型相同	返回在窗口帧中最后一行上计算的value
nth_value(value any, nth integer)	和value类型相同	返回在窗口帧中第nth行（行从1计数）上计算的value；没有这样的行则返回空值

11.查看内部所有函数

如何查看postgresql中所有的函数名称，SQL语句如下：

-- 查看所有函数名，返回类型，及参数个数
SELECT
  pg_proc.proname AS "函数名称",
  pg_type.typname AS "返回值数据类型",
  pg_proc.pronargs AS "参数个数"
FROM
  pg_proc
JOIN pg_type ON (pg_proc.prorettype = pg_type.oid)
-- WHERE pronamespace = (SELECT pg_namespace.oid FROM pg_namespace WHERE nspname = '模式')