首頁 > 軟體

Postgresql常用函數及使用方法大全(看一篇就夠了)

2022-11-15 14:01:47

前言

寫在前面,當我們在用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(欄位名或數值 as 資料型別)

例子:

-- 將文字'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 + 35
-2 - 3-1
*2 * 36
/除(整數除法截斷結果)4 / 22
%模(取餘)5 % 41
^指數(從左至右結合)2.0 ^ 3.08
|/平方根|/ 25.05
||/立方根||/ 27.03
!階乘5 !120
!!階乘(字首操作符)!! 5120
@絕對值@ -5.05
&按位元與91 & 1511
|按位元或323
#按位元互斥或17 # 520
~按位元求反~1-2
<<按位元左移1 << 416
>>按位元右移8 >> 22

2.2 數學運算函數

函數返回型別描述例子結果
abs(x)和輸入相同絕對值abs(-12.43)12.43
cbrt(dp)double立方根cbrt(27.0)3
ceil(dp or numeric)和輸入相同不小於引數的最近的整數ceil(-42.8)-42
ceiling(dp or numeric)和輸入相同不小於引數的最近的整數(ceil的別名)ceiling(-95.3)-95
degrees(dp)dp把弧度轉為角度degrees(0.5)28.6478897565412
div(y numeric, x numeric)numericy/x的整數商div(9,4)2
exp(dp or numeric)和輸入相同指數exp(1.0)2.71828182845905
floor(dp or numeric)和輸入相同不大於引數的最近的整數floor(-42.8)-43
ln(dp or numeric)和輸入相同自然對數ln(2.0)0.693147180559945
log(dp or numeric)和輸入相同以10為底的對數log(100.0)2
log10(dp or numeric)和輸入相同以10為底的對數log10(100.0)2
log(b numeric, x numeric)numeric以b為底的對數log(2.0, 64.0)6.0000000000
mod(y, x)和引數型別相同y/x的餘數mod(9,4)1
pi()dp“π”常數pi()3.14159265358979
power(a dp, b dp)dp求a的b次冪power(9.0, 3.0)729
power(a numeric, b numeric)numeric求a的b次冪power(9.0, 3.0)729
radians(dp)dp把角度轉為弧度radians(45.0)0.785398163397448
round(dp or numeric)和輸入相同圓整為最接近的整數round(42.4)42
round(v numeric, s int)numeric圓整為s位小數數位round(42.4382, 2)42.44
scale(numeric)integer引數的精度(小數點後的位數)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 || stringtext串接‘Hello’ || ‘Word’‘HelloWord’
string || non-string or non-string || stringtext使用一個非字串輸入的串接'Value: ’ || 42Value: 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] )texttrim()的非標準版本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)intstring中的字元數length(‘hello’)5
length(string bytea, encoding name )intstring在給定編碼中的字元數。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]) setoftext使用一個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替換為子串toreplace(‘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-1465 years 1 day
clock_timestamp()timestamp with time zone當前日期和時間(在語句執行期間變化)clock_timestamp()2022-06-14 19:06:54.034672+08
current_datedate當前日期current_date2022-06-14
current_timetime with time zone當前時間(一天中的時間),帶時區current_time19:11:04.336139+08
current_timestamptimestamp with time zone當前日期和時間(當前事務開始時),帶時區current_timestamp2022-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
localtimetime當前時間(一天中的時間),不帶時區localtime19:21:14.958286
localtimestamptimestamp當前日期和時間(當前事務的開始),不帶時區LOCALTIMESTAMP2022-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從年、月、周、日、時、分、秒域建立intervalmake_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_TIMESTAMPtransaction_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 開始的秒)轉換成 timestampto_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返回一個用提供的值和維度初始化好的陣列,可以選擇下界不為1array_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返回陣列中元素的總數,如果陣列為空則返回0cardinality(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]’::int4ranget
<>不等於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’::timestampt
<@範圍被包含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)boolboolYes如果所有輸入值為真則結果為真,否則為假
bool_or(expression)boolboolYes至少一個輸入值為真時結果為真,否則為假
count(*) bigintYes輸入的行數
count(expression)anybigintYesexpression值非空的輸入行的數目
every(expression)boolboolYes等價於bool_and
json_agg(expression)anyjsonNo將值,包含空值,聚整合一個 JSON 陣列
jsonb_agg(expression)anyjsonbNo把值,包含空值,聚合成一個 JSON 陣列
json_object_agg(name, value)(any, any)jsonNo將名字/值對聚整合一個 JSON 物件,值可以為空,但不能是名字。
jsonb_object_agg(name, value)(any, any)jsonbNo把名字/值對聚合成一個 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)xmlxmlNo連線非空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)boolboolYes如果所有輸入值為真則結果為真,否則為假
bool_or(expression)boolboolYes至少一個輸入值為真時結果為真,否則為假
count(*) bigintYes輸入的行數
count(expression)anybigintYesexpression值非空的輸入行的數目
every(expression)boolboolYes等價於bool_and
json_agg(expression)anyjsonNo將值,包含空值,聚整合一個 JSON 陣列
jsonb_agg(expression)anyjsonbNo把值,包含空值,聚合成一個 JSON 陣列
json_object_agg(name, value)(any, any)jsonNo將名字/值對聚整合一個 JSON 物件,值可以為空,但不能是名字。
jsonb_object_agg(name, value)(any, any)jsonbNo把名字/值對聚合成一個 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)xmlxmlNo連線非空XML值

8.3 有序集聚集函數

函數引數型別返回型別部分模式描述
corr(Y, X)double precisiondouble precisionYes相關係數
covar_pop(Y, X)double precisiondouble precisionYes總體協方差
covar_samp(Y, X)double precisiondouble precisionYes樣本協方差
regr_avgx(Y, X)double precisiondouble precisionYes自變數的平均值 (sum(X)/N)
regr_avgy(Y, X)double precisiondouble precisionYes因變數的平均值 (sum(Y)/N)
regr_count(Y, X)double precisionbigintYes兩個表示式都不為空的輸入行的數目
regr_intercept(Y, X)double precisiondouble precisionYes由(X, Y)對決定的最小二乘擬合的線性方程的 y截距
regr_r2(Y, X)double precisiondouble precisionYes相關係數的平方
regr_slope(Y, X)double precisiondouble precisionYes由(X, Y)對決定的最小二乘擬合的線性方程的斜率
regr_sxx(Y, X)double precisiondouble precisionYessum(X^2) - sum(X)^2/N(自變數的“平方和”)
regr_sxy(Y, X)double precisiondouble precisionYessum(X*Y) - sum(X) * sum(Y)/N(自變數乘以因變數的“積之合”)
regr_syy(Y, X)double precisiondouble precisionYessum(Y^2) - sum(Y)^2/N(因變數的“平方和”)
stddev(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYesstddev_samp的歷史別名
stddev_pop(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYes輸入值的總體標準偏差
stddev_samp(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYes輸入值的樣本標準偏差
variance(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYesvar_samp的歷史別名
var_pop(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYes輸入值的總體方差(總體標準偏差的平方)
var_samp(expression)smallint、int、 bigint、real、double precision或numeric浮點引數為double precision,否則為numericYes輸入值的樣本方差(樣本標準偏差的平方)

8.4 有序資料集

函數直接引數型別聚集引數型別返回型別部分模式描述
mode() WITHIN GROUP (ORDER BY sort_expression) 任何可排序型別與排序表示式相同No返回最頻繁的輸入值(如果有多個頻度相同的值就選第一個)
percentile_cont(fraction) WITHIN GROUP (ORDER BY sort_expression)double precisiondouble 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”bigintNo假想行的排名,為重複的行留下間隔
dense_rank(args) WITHIN GROUP (ORDER BY sorted_args)VARIADIC “any”VARIADIC “any”bigintNo假想行的排名,不留間隔
percent_rank(args) WITHIN GROUP (ORDER BY sorted_args)VARIADIC “any”VARIADIC “any”double precisionNo假想行的相對排名,範圍從 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.條件類函數

函數語法使用說明使用例子
caseCASE WHEN condition THEN result [WHEN …] [ELSE result] ENDCASE子句可以用於任何表示式可以出現的地方。每一個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
coalesceCOALESCE(value [, …])返回它的第一個非空引數的值。當且僅當所有引數都為空時才會返回空。它常用於在為顯示目的檢索資料時用預設值替換空值。COALESCE(description, short_description, ‘(none)’)
nullifNULLIF(value1, value2)當value1和value2相等時,NULLIF返回一個空值。 否則它返回value1。NULLIF(value, ‘(none)’)
greatestGREATEST(value [, …])從一個任意的數位表示式列表裡選取最大的數值。列表中的 NULL 數值將被忽略。只有所有表示式的結果都是 NULL 的時候,結果才會是 NULL。greatest(2,5,1)
leastGREATEST(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 = '模式')

總結

到此這篇關於Postgresql常用函數及使用方法詳解的文章就介紹到這了,更多相關Postgresql函數使用內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com