GaussDB常用基础函数介绍与示例

--numrange(numeric, numeric, [text])

--描述：表示一个范围。

--返回类型：范围元素类型

--lower(anyrange)

--描述：范围的下界。

--返回类型：范围元素类型

--upper(anyrange)

--描述：范围的上界

--返回类型：范围元素类型

--isempty(anyrange)

--描述：范围是否为空

--返回类型：Boolean

SELECT numrange(1,2.5) AS RESULT1

      ,numrange(1,2.5, '()') AS RESULT2

      ,lower(numrange(1,2.5)) AS RESULT3

      ,upper(numrange(1,2.5)) AS RESULT4

      ,isempty(numrange(1,2.5)) AS RESULT5 ;     

--RANK()

--描述：RANK函数为各组内值生成跳跃排序序号，其中，相同的值具有相同序号。

--描述：ROW_NUMBER函数为各组内值生成连续排序序号，其中，相同的值其序号也不相同。

--返回值类型：BIGINT

--sum(expression)

--描述：所有输入行的expression总和。

--返回类型： 通常情况下输入数据类型和输出数据类型是相同的，但以下情况会发生类型转换：

--对于SMALLINT或INT输入，输出类型为BIGINT。

--对于BIGINT输入，输出类型为NUMBER 。

--对于浮点数输入，输出类型为DOUBLE PRECISION。

--max(expression)、min(expression)

--描述：所有输入行中expression的最大值、最小值。

--参数类型：任意数组、数值、字符串、日期/时间类型。

--返回类型：与参数数据类型相同

--avg(expression)

--描述：所有输入值的均值（算术平均）。

--返回类型：对于任何整数类型输入，结果都是NUMBER类型。对于任何浮点输入，结果都是DOUBLE PRECISION类型。否则和输入数据类型相同。

--count(expression) 描述：返回表中满足expression不为NULL的行数。  count(*) 描述：返回表中的记录行数。

--返回类型：BIGINT

select sum(column1),max(column1),min(column1),avg(column1),count(column1),count(*) from test1

--array_agg(expression)

--描述：将所有输入值（包括空）连接成一个数组。

--返回类型：参数类型的数组

--string_agg(expression, delimiter)

--描述：将输入值连接成为一个字符串，用分隔符分开。

--返回类型：和参数数据类型相同。

select array_agg(column1),string_agg(column1,'|') from test1

--listagg(expression [, delimiter]) WITHIN GROUP(ORDER BY order-list)

--描述：将聚集列数据按WITHIN GROUP指定的排序方式排列，并用delimiter指定的分隔符拼接成一个字符串。

--expression：必选。指定聚集列名或基于列的有效表达式，不支持DISTINCT关键字和VARIADIC参数。

--delimiter：可选。指定分隔符，可以是字符串常数或基于分组列的确定性表达式，缺省时表示分隔符为空。

--order-list：必选。指定分组内的排序方式。

--返回类型：text

select  column1,listagg(column2,'|') within group(order by column1) from test1 group by column1;

--current_catalog

--描述：当前数据库的名称（在标准SQL中称"catalog"）。

--返回值类型：name

--current_database()

--描述：当前数据库的名称。

--返回值类型：name

--current_schema()

--描述：当前模式的名称。

--返回值类型：name

--备注：current_schema返回在搜索路径中第一个顺位有效的模式名。（如果搜索路径为空则返回NULL，没有有效的模式名也返回NULL）。如果创建表或者其他命名对象时没有声明目标模式，则将使用这些对象的模式。

SELECT current_catalog,current_database(),current_schema();

--current_user

--描述：当前执行环境下的用户名。

--返回值类型：name

--备注：current_user是用于权限检查的用户标识。通常，他表示会话用户，但是可以通过SET ROLE改变他。在函数执行的过程中随着属性SECURITY DEFINER的改变，其值也会改变。

--definer_current_user

--描述：当前执行环境下的用户名。

--返回值类型：name

--备注：大多数情况下definer_current_user和current_user结果相同，但在存储过程中执行该函数会返回定义当前存储过程的用户名。

select current_user,definer_current_user();

--inet_client_addr()

--描述：连接的远端地址。inet_client_addr返回当前客户端的IP地址。

--说明：此函数只有在远程连接模式下有效。

--返回值类型：inet

--inet_client_port()

--描述：连接的远端端口。inet_client_port返回当前客户端的端口号。

--说明：此函数只有在远程连接模式下有效。

--返回值类型：int

--inet_server_addr()

--描述：连接的本地地址。inet_server_addr返回服务器接收当前连接用的IP地址。

--说明：此函数只有在远程连接模式下有效。

--返回值类型：inet

--inet_server_port()

--描述：连接的本地端口。inet_server_port返回接收当前连接的端口号。如果是通过Unix-domain socket连接的，则所有这些函数都返回NULL。

--说明：此函数只有在远程连接模式下有效。

--返回值类型：int

SELECT  inet_client_addr(),inet_server_port(),inet_server_addr(),inet_server_port();

--pg_postmaster_start_time()

--描述：服务器启动时间。pg_postmaster_start_time返回服务器启动时的timestamp with time zone。

--返回值类型：timestamp with time zone

select  pg_postmaster_start_time() ;

--opengauss_version()

--描述：引用的openGauss内核版本信息。

--返回值类型：text

--version()

--描述：版本信息。version返回一个描述服务器版本信息的字符串。

--返回值类型：text

--getdatabaseencoding()

--描述：获取数据库编码方式。

--返回值类型：name

select opengauss_version(),version(),getdatabaseencoding();

--session_user

--描述：会话用户名。

--返回值类型：name

--备注：session_user通常是连接当前数据库的初始用户，不过系统管理员可以用SET SESSION AUTHORIZATION修改这个设置。

--user

--描述：等价于current_user。

--返回值类型：name

--getpgusername()

--描述：获取数据库用户名。

--返回值类型：name

SELECT session_user,user,current_user;

--pg_get_tabledef(table_name)

--描述：根据table_name获取表定义。

--返回类型：text

--备注：pg_get_tabledef重构出表定义的CREATE语句，包含了表定义本身、索引信息、comments信息。

--对于表对象依赖的group、schema、tablespace、server等信息，需要用户自己去创建，表定义里不会有这些对象的创建语句。

--pg_get_viewdef(view_name)

--描述：为视图获取底层的SELECT命令

select * from pg_get_tabledef('test1'),pg_get_viewdef('test1_view');

--has_any_column_privilege(user, table, privilege)

--描述：指定用户是否有访问表任何列的权限。

--返回类型：Boolean

--has_any_column_privilege(table, privilege)

--描述：当前用户是否有访问表任何列的权限，合法参数类型见表2。

--返回类型：Boolean

--has_column_privilege(user, table, column, privilege)

--描述：指定用户是否有访问列的权限。

--返回类型：Boolean

--has_column_privilege(table, column, privilege)

--描述：当前用户是否有访问列的权限，合法参数类型见表3。

--返回类型：Boolean

--以上的table、column 可以替换成database、function、schema、sequence、tablespace等对象

--参数privilege：SELECT：允许对表的指定列执行SELECT语句。  INSERT：允许对表的指定列执行INSERT语句。UPDATE：允许对表的指定列执行UPDATE语句。

--REFERENCES：允许创建一个外键约束。COMMENT：允许对表的指定列执行COMMENT语句。

select has_any_column_privilege('root','test1','select'),has_any_column_privilege('test1','select')

--creditcardmasking(col text, letter char default 'x')

--描述：将col字符串后四位之前的数字使用letter替换。

--参数：待替换的字符串、替换字符。

--返回值类型：text

--alldigitsmasking(col text, letter char default '0')

--描述：将col字符串中出现的数字使用letter替换。

--参数：待替换的字符串、替换字符。

--返回值类型：text

--randommasking(col text)

--描述：将col字符串中的字符随机化。

--参数：待替换的字符串、替换字符。

--返回值类型：text

--shufflemasking(col text)

--描述：将col字符串中的字符乱序排列。

--参数：待替换的字符串、替换字符。

--返回值类型：text

select creditcardmasking('15021750702', '*'),alldigitsmasking('123abc','0'),randommasking('123abc'),shufflemasking('123abc');