华为云用户手册

string [NOT] LIKE pattern [ESCAPE escape-character] 描述：模式匹配函数。 如果pattern不包含百分号或者下划线，该模式只代表它本身，这时候LIKE的行为就像等号操作符。在pattern里的下划线（_）匹配任何单个字符；而一个百分号（%）匹配零或多个任何字符。 要匹配下划线或者百分号本身，在pattern里相应的字符必须前导逃逸字符。缺省的逃逸字符是反斜杠，但是用户可以用ESCAPE子句指定一个。要匹配逃逸字符本身，写两个逃逸字符。 返回值类型：boolean 示例： 12345 SELECT 'AA_BBCC' LIKE '%A@_B%' ESCAPE '@' AS RESULT; result-------- t(1 row) 12345 SELECT 'AA_BBCC' LIKE '%A@_B%' AS RESULT; result-------- f(1 row) 12345 SELECT 'AA@_BBCC' LIKE '%A@_B%' AS RESULT; result-------- t(1 row)

replace(string varchar, search_string varchar, replacement_string varchar) 描述：把字符串string中所有子字符串search_string替换成子字符串replacement_string。 返回值类型：varchar 示例： 12345 SELECT replace('jack and jue','j','bl'); replace ---------------- black and blue(1 row)

rpad(string varchar, length int [, fill varchar]) 描述：使用填充字符fill（缺省时为空白），把string填充到length长度。如果string已经比length长则将其从尾部截断。 length参数在 GaussDB (DWS)中表示字符长度。一个汉字长度计算为一个字符。 返回值类型：varchar 示例： 12345 SELECT rpad('hi',5,'xyza'); rpad------- hixyz(1 row) 12345 SELECT rpad('hi',5,'abcdefg'); rpad ------- hiabc(1 row)

substring(string from pattern) 描述：截取匹配POSIX正则表达式的子字符串。如果没有匹配它返回空值，否则返回文本中匹配模式的那部分。 返回值类型：text 示例： 1 2 3 4 5 6 7 8 9101112131415 SELECT substring('Thomas' from '...$'); substring----------- mas(1 row)SELECT substring('foobar' from 'o(.)b'); substring -------- o(1 row)SELECT substring('foobar' from '(o(.)b)'); substring -------- oob(1 row) 如果POSIX正则表达式模式包含任何圆括号，那么将返回匹配第一对子表达式（对应第一个左圆括号的） 的文本。如果想在表达式里使用圆括号而又不想导致这个例外，那么可以在整个表达式外边加上一对圆括号。

quote_nullable(value anyelement) 描述：将给定的参数值转化为text，加上引号作为文本。 返回值类型：text 示例： 12345 SELECT quote_nullable(42.5); quote_nullable---------------- '42.5'(1 row) 如果出现如下写法，定值将进行转义。 12345 SELECT quote_nullable(E'O\'42.5'); quote_nullable ---------------- 'O''42.5'(1 row) 如果出现如下写法，反斜杠会写入两次。 12345 SELECT quote_nullable('O\42.5'); quote_nullable---------------- E'O\\42.5'(1 row) 如果参数为NULL，返回NULL。 12345 SELECT quote_nullable(NULL); quote_nullable---------------- NULL(1 row)

regexp_replace(string, pattern, replacement [,flags ]) 描述：替换匹配POSIX正则表达式的子字符串。 如果没有匹配pattern，那么返回不加修改的string串。 如果有匹配，则返回的string串里面的匹配子串将被replacement串替换掉。 replacement串可以包含\n， 其中\n是1到9， 表明string串里匹配模式里第n个圆括号子表达式的子串应该被插入， 并且它可以包含\&表示应该插入匹配整个模式的子串。 可选的flags参数包含零个或多个改变函数行为的单字母标记，见下表。 表1 flags参数的可选项 选项 描述 g 表示替换每一个匹配的子字符串而不仅仅是第一个（默认仅替换第一个匹配的子字符串）。 B 默认情况下使用Henry Spencer正则库及其正则语法。指定B选项后，表示优先选用boost regex正则库及其正则语法。 以下两种情况在指定了B选项时，也会自动转换为选择Henry Spencer正则库及其正则语法： flags同时指定了p、q、w、x中的任意个字符。 string或pattern参数中含有多字节字符。 b 表示按照BRE(POSIX Basic Regular Expression)匹配模式的规则进行匹配。 c 大小写敏感匹配。 e 表示按照ERE(POSIX Extended Regular Expression)匹配模式的规则进行匹配。当b和e都未指定时，如果选用的是Henry Spencer正则库，则按照ARE(Advanced Regular Expression，类似于Perl Regular Expression)匹配模式的规则进行匹配；如果选用的是boost regex正则库，则按照Perl Regular Expression匹配模式的规则进行匹配。 i 大小写不敏感匹配。 m 换行敏感匹配，与选项n同义。 n 换行敏感匹配。此选项生效时，换行符影响元字符(.、^、$和[^)的匹配。 p 部分换行敏感匹配，此选项生效时，换行符影响元字符(.和[^)的匹配。部分是相对选项n而言。 q 重置正则表达式为加双引号的文本字符串，所有都是普通字符。 s 非换行敏感匹配。 t 紧凑语法（缺省）。该选项生效时，所有字符都很重要。 w 反部分换行敏感匹配，此选项生效时，换行符影响元字符(^和$)的匹配。部分是相对选项n而言。 x 扩展语法。与紧凑语法相对，在扩展的语法中，正则表达式中的空白字符被忽略。空白字符包括空格、水平制表符、新行、和任何属于space字符表的字符。 返回值类型：varchar 示例： 1 2 3 4 5 6 7 8 910 SELECT regexp_replace('Thomas', '.[mN]a.', 'M'); regexp_replace---------------- ThM(1 row)SELECT regexp_replace('foobarbaz','b(..)', E'X\\1Y', 'g') AS RESULT; result ------------- fooXarYXazY(1 row)

regexp_like(source_string, pattern [, match_parameter]) 描述：正则表达式的模式匹配函数。 source_string为源字符串，pattern为正则表达式匹配模式。 match_parameter为匹配选项，可取值为： 'i'：大小写不敏感。 'c'：大小写敏感。 'n'：允许正则表达式元字符“.”匹配换行符。 'm'：将source_string视为多行。 若忽略match_parameter选项，默认为大小写敏感，“.”不匹配换行符，source_string视为单行。 返回值类型：boolean 示例： 12345 SELECT regexp_like('ABC', '[A-Z]'); regexp_like------------- t(1 row) 12345 SELECT regexp_like('ABC', '[D-Z]'); regexp_like------------- f(1 row) 12345 SELECT regexp_like('abc', '[A-Z]','i'); regexp_like------------- t(1 row) 12345 SELECT regexp_like('abc', '[A-Z]'); regexp_like------------- f(1 row)

regexp_matches(string text, pattern text [, flags text]) 描述：返回string中所有匹配POSIX正则表达式的子字符串。如果pattern不匹配，该函数不返回行。如果模式不包含圆括号子表达式，则每一个被返回的行都是一个单一元素的文本数组，其中包括匹配整个模式的子串。如果模式包含圆括号子表达式，该函数返回一个文本数组，它的第n个元素是匹配模式的第n个圆括号子表达式的子串。 flags参数为可选参数，包含零个或多个改变函数行为的单字母标记。i表示进行大小写无关的匹配，g表示替换每一个匹配的子字符串而不仅仅是第一个。 如果提供了最后一个参数，但参数值是空字符串（''），且数据库SQL兼容模式设置为ORA的情况下，会导致返回结果为空集。这是因为ORA兼容模式将''作为NULL处理，避免此类行为的方式有如下几种： 将数据库SQL兼容模式改为TD； 不提供最后一个参数，或最后一个参数不为空字符串。 返回值类型：setof text[] 示例： 1 2 3 4 5 6 7 8 910111213141516 SELECT regexp_matches('foobarbequebaz', '(bar)(beque)'); regexp_matches---------------- {bar,beque}(1 row)SELECT regexp_matches('foobarbequebaz', 'barbeque'); regexp_matches ---------------- {barbeque}(1 row)SELECT regexp_matches('foobarbequebazilbarfbonk', '(b[^b]+)(b[^b]+)', 'g'); regexp_matches -------------- {bar,beque} {bazil,barf}(2 rows) 如果没有子查询，当regexp_matches函数没有匹配上时，不会输出表中的数据。这通常不是所需的返回结果，应避免这种写法，建议可使用regexp_substr函数来实现相同的功能。 1 2 3 4 5 6 7 8 910111213141516 SELECT * FROM tab; c1 | c2 -----+----- dws | dws(1 row)SELECT c1, regexp_matches(c2, '(bar)(beque)') FROM tab; c1 | regexp_matches ----+----------------(0 rows)SELECT c1, c2, (SELECT regexp_matches(c2, '(bar)(beque)')) FROM tab; c1 | c2 | regexp_matches -----+-----+---------------- dws | dws | (1 row)

regexp_split_to_array(string text, pattern text [, flags text ]) 描述：用POSIX正则表达式作为分隔符，分隔string。和regexp_split_to_table相同，不过regexp_split_to_array会把它的结果以一个text数组的形式返回。 返回值类型：text[] 示例： 12345 SELECT regexp_split_to_array('hello world', E'\\s+'); regexp_split_to_array----------------------- {hello,world}(1 row)

quote_nullable(string text) 描述：返回适用于在SQL语句里当作字符串使用的形式（使用适当的引号进行界定）。 返回值类型：text 示例： 12345 SELECT quote_nullable('hello'); quote_nullable ---------------- 'hello'(1 row) 如果出现如下写法，text文本将进行转义。 12345 SELECT quote_nullable(E'O\'hello'); quote_nullable---------------- 'O''hello'(1 row) 如果出现如下写法，反斜杠会写入两次。 12345 SELECT quote_nullable('O\hello'); quote_nullable---------------- E'O\\hello'(1 row) 如果参数为NULL，返回NULL。 12345 SELECT quote_nullable(NULL); quote_nullable---------------- NULL(1 row)

concat(str1,str2) 描述：将字符串str1和str2连接并返回。 ORA和TD兼容模式下，返回结果为所有非NULL字符串的连接。 MySQL兼容模式下，入参中存在NULL时，返回结果为NULL。 返回值类型：varchar 示例： 12345 SELECT concat('Hello', ' World!'); concat -------------- Hello World!(1 row)

quote_literal(string text) 描述：返回适用于在SQL语句里当作文本使用的形式（使用适当的引号进行界定）。 返回值类型：text 示例： 12345 SELECT quote_literal('hello'); quote_literal --------------- 'hello'(1 row) 如果出现如下写法，text文本将进行转义。 12345 SELECT quote_literal(E'O\'hello'); quote_literal--------------- 'O''hello'(1 row) 如果出现如下写法，反斜杠会写入两次。 12345 SELECT quote_literal('O\hello'); quote_literal --------------- E'O\\hello'(1 row) 如果参数为NULL，返回空。如果参数可能为null，通常使用函数quote_nullable更适用。 12345 SELECT quote_literal(NULL); quote_literal ---------------(1 row)

quote_literal(value anyelement) 描述：将给定的值强制转换为text，加上引号作为文本。 返回值类型：text 示例： 12345 SELECT quote_literal(42.5); quote_literal --------------- '42.5'(1 row) 如果出现如下写法，定值将进行转义。 12345 SELECT quote_literal(E'O\'42.5'); quote_literal--------------- 'O''42.5'(1 row) 如果出现如下写法，反斜杠会写入两次。 12345 SELECT quote_literal('O\42.5'); quote_literal --------------- E'O\\42.5'(1 row)

convert_to(string text, dest_encoding name) 描述：将字符串转化为dest_encoding的编码格式。 返回值类型：bytea 示例： 1 2 3 4 5 6 7 8 910 SELECT convert_to('some text', 'UTF8'); convert_to---------------------- \x736f6d652074657874(1 row)SELECT convert_to('database', 'gbk'); convert_to-------------------- \x6461746162617365(1 row)

decode(string text, format text) 描述：将二进制数据从文本数据中解码。 返回值类型：bytea 示例： 1 2 3 4 5 6 7 8 91011 SELECT decode('ZGF0YWJhc2U=', 'base64'); decode -------------- \x6461746162617365(1 row)SELECT convert_from('\x6461746162617365','utf-8'); convert_from-------------- database(1 row)

instr(string,substring[,position,occurrence]) 描述：从字符串string的position（缺省时为1）所指的位置开始查找并返回第occurrence（缺省时为1）次出现子串substring的位置的值。 当position为0时，返回0。 当position为负数时，从字符串倒数第n个字符往前逆向搜索。n为position的绝对值。 本函数以字符为计算单位，如一个汉字为一个字符。 返回值类型：integer 示例： 12345 SELECT instr('corporate floor','or', 3); instr ------- 5(1 row) 12345 SELECT instr('corporate floor','or',-3,2); instr ------- 2(1 row)

locate(substring,string[,position]) 描述：从字符串string的position（缺省时为1）所指的位置开始查找并返回第一次出现子串substring位置的值。以字符为计算单位。当string中不存在substring时，返回0。 返回值类型：integer 示例： 12345 SELECT locate('ball','football'); locate -------- 5(1 row) 12345 SELECT locate('er','soccerplayer','6'); locate -------- 11 (1 row)

convert(string bytea, src_encoding name, dest_encoding name) 描述：以dest_encoding指定的目标编码方式转化字符串bytea。src_encoding指定源编码方式，在该编码下，string必须是合法的。 返回值类型：bytea 示例： 12345 SELECT convert('text_in_utf8', 'UTF8', 'GBK'); convert ---------------------------- \x746578745f696e5f75746638(1 row) 如果源编码格式到目标编码格式的转化规则不存在，则字符串不进行任何转换直接返回，如GBK和LATIN1之间的转换规则是不存在的，具体转换规则可以通过查看系统表pg_conversion获得。 示例： 1 2 3 4 5 6 7 8 91011121314151617181920212223 show server_encoding; server_encoding ----------------- LATIN1(1 row)SELECT convert_from('some text', 'GBK'); convert_from -------------- some text(1 row)db_latin1=# SELECT convert_to('some text', 'GBK'); convert_to ---------------------- \x736f6d652074657874(1 row)db_latin1=# SELECT convert('some text', 'GBK', 'LATIN1'); convert ---------------------- \x736f6d652074657874(1 row)

convert_from(string bytea, src_encoding name) 描述：以数据库的编码方式转化字符串bytea。 src_encoding指定源编码方式，在该编码下，string必须是合法的。 返回值类型：text 示例： 1 2 3 4 5 6 7 8 910 SELECT convert_from('text_in_utf8', 'UTF8'); convert_from-------------- text_in_utf8(1 row)SELECT convert_from('\x6461746162617365','gbk'); convert_from-------------- database(1 row)

quote_ident(string text) 描述：返回适用于SQL语句的标识符形式（使用适当的引号进行界定）。只有在必要的时候才会添加引号（字符串包含非标识符字符或者会转换大小写的字符）。返回值中嵌入的引号会被双写。 返回值类型：text 示例： 12345 SELECT quote_ident('hello world'); quote_ident-------------- "hello world"(1 row)

lpad(string varchar, length int[, repeat_string varchar]) 描述：在string的左侧添上一系列的repeat_string（缺省为空白）来组成一个总长度为n的新字符串。 如果string本身的长度比指定的长度length长，则本函数将把string截断并把前面长度为length的字符串内容返回。 返回值类型：varchar 示例： 12345 SELECT lpad('PAGE 1',15,'*.'); lpad ----------------- *.*.*.*.*PAGE 1(1 row) 12345 SELECT lpad('hello world',5,'abcd'); lpad ------- hello(1 row)

overlay(string placing string FROM int [for int]) 描述：替换子字符串。FROM int表示从第一个string的第几个字符开始替换，for int表示替换第一个string的字符数目。 返回值类型：text 示例： 12345 SELECT overlay('hello' placing 'world' from 2 for 3 ); overlay --------- hworldo(1 row)

position(substring in string) 描述：指定子字符串在字符串中的位置。若string中没有substring，则返回0。 返回值类型：integer 示例： 1 2 3 4 5 6 7 8 91011 SELECT position('ing' in 'string'); position---------- 4(1 row)SELECT position('ing' in 'strin'); position---------- 0(1 row)

操作符类型解析 从系统表PG_OPERATOR中选出要考虑的操作符。如果可以找到一个参数类型以及参数个数都一致的操作符，那么这个操作符就是最终使用的操作符。如果找到了多个备选的操作符，那么将从中选择一个最合适的。 寻找最优匹配。 丢弃输入类型不匹配以及无法隐式转换成匹配的候选操作符。unknown文本在这种情况下可以转换成任何类型。如果只剩下一个候选操作符，则使用，否则继续下一步。 查看所有候选操作符，并保留输入类型最匹配的操作符。此时，域被看作和其基本类型相同。如果没有完全匹配的操作符，则保留所有候选。如果只剩下一个候选操作符，则使用，否则继续下一步。 查看所有候选操作符，保留需要类型转换时接受（属于输入数据类型的类型范畴的）首选类型位置最多的操作符。如果没有接受首选类型的操作符，则保留所有候选。如果只剩下一个候选操作符，则使用，否则继续下一步。 如果有任何输入参数是unknown类型，请检查其余候选操作符对应参数位置的类型范畴。在每一个能够接受string类型范畴的位置使用string类型（这种偏向字符串的做法合理，因为unknown文本跟字符串相似）。另外，如果所有剩下的候选操作符都接受相同的类型范畴，则选择该类型范畴，否则会报错（因为在没有更多线索的条件下无法作出正确的选择）。现在丢弃不接受选定类型范畴的候选操作符。此外，如果有任意候选操作符接受该范畴中的首选类型，则丢弃该参数接受非首选类型的候选操作符。如果没有一个操作符能被保留，则保留所有候选。如果只剩下一个候选操作符，则使用，否则继续下一步。 如果同时有unknown和已知参数，并且所有已知参数都是相同的类型，那么假设unknown参数也属于该类型，并检查哪些候选操作符在unknown参数位置接受该类型。如果只有一个操作符符合，则使用。否则，报错。

overlay(string placing string from int [for int]) 描述：替换子串。 返回值类型：bytea 示例： 12345 SELECT overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3) AS RESULT; result ---------------- \x5402036d6173(1 row)

btrim(string bytea,bytes bytea) 描述：从string的开头和结尾删除只包含bytes中字节的最长的字符串。 返回值类型：bytea 示例： 12345 SELECT btrim(E'\\000trim\\000'::bytea, E'\\000'::bytea) AS RESULT; result ------------ \x7472696d(1 row)

substring(string [from int] [for int]) 描述：截取子串。 返回值类型：bytea 示例： 12345 SELECT substring(E'Th\\000omas'::bytea from 2 for 3) AS RESULT; result ---------- \x68006f(1 row) 截取时间，获取小时数： 12345 select substring('2022-07-18 24:38:15',12,2)AS RESULT; result----------- 24(1 row)

create_wdr_snapshot() 描述：创建性能数据快照。 返回值类型：text 该函数只有数据库管理员SYSADMIN才可以执行，非管理员执行会提示无权限。 该函数只能在CN上执行，在DN上执行会返回：“WDR snapshot can only be created on coordinator.”。 执行该函数前需确认enable_wdr_snapshot参数处于开启状态。如果enable_wdr_snapshot为off，执行该函数会返回：“WDR snapshot request can't be executed, because GUC parameter 'enable_wdr_snapshot' is off.”。 如果执行该函数时，快照线程由于节点重启等原因尚未启动，会提示错误：“WDR snapshot request can not be accepted, please retry later.”。 如果执行该函数失败，会提示：“Cannot respond to WDR snapshot request.”。 如果执行成功，会返回：“WDR snapshot request has been submitted.”。该提示表明创建快照请求已发送至后台快照线程，但不代表创建快照成功。

pg_export_snapshot() 描述：保存当前的快照并返回它的标识符。 返回值类型：text 备注：函数pg_export_snapshot保存当前的快照并返回一个文本字符串标识此快照。这个字符串必须传递给想要导入快照的客户端。可用在set transaction snapshot snapshot_id时导入snapshot，但是应用的前提是该事务设置了REPEATABLE READ隔离级别。该函数的输出不可用做set transaction snapshot的输入。 示例： 12345 SELECT pg_export_snapshot(); pg_export_snapshot-------------------- 00000000000A7128-1(1 row)

kill_snapshot(scope cstring) 描述：中止后台快照线程。该函数向后台快照线程发送中止信号并等待线程结束。 输入参数scope：表示操作范围。该参数取值范围为local和global。 local表示中止当前CN上的快照线程。 global表示不仅会中止当前CN上的快照线程，还会向集群中所有其他CN发送中止快照线程的请求，即中止集群中所有CN上的快照线程。 如果输入其他值，则报错“Scope is invalid, use "local" or "global".”。 输入参数可为空，表示默认取值为local。 返回值类型：无 该函数只有数据库管理员SYSADMIN才有权执行，非管理员执行会提示无权限。 该函数只能在CN上执行，在DN上执行会提示：“kill_snapshot can only be executed on coordinator.”； 执行该函数会向后台快照线程发送中止信号并等待其结束。如果100s内快照线程仍未中止则会报错：“Kill snapshot thread failed”；