华为云用户手册

to_date(text [DEFAULT return_value ON CONVERSION ERROR [, fmt]]) 描述：将字符串text按fmt指定的格式转换成DATE类型的值。不指定fmt时，在参数a_format_version值为10c和a_format_dev_version值为s1的情况下，按参数nls_timestamp_format所指定的格式转换；若不指定参数a_format_version和a_format_dev_version，则按照固定fmt = 'yyyy-mm-dd hh24-mi-ss'进行转换。 参数： text：任何计算结果为CHAR、VARCHAR2、NCHAR、NVARCHAR2、TEXT类型字符串的表达式。输入null，返回null。 DEFAULT return_value ON CONVERSION ERROR：可选参数，在参数a_format_version值为10c且a_format_dev_version值为s1的情况下，用于当text转换DATE类型失败时指定返回值return_value。return_value可以是表达式或者绑定的变量，需要能够转换为CHAR、VARCHAR2、NCHAR、NVARCHAR2、TEXT类型或者是null。return_value转换为DATE类型数据的方法与text转换为DATE类型数据相同，如果return_value转换为DATE类型数据失败，该函数报错。 fmt：可选参数。指定text的日期时间模型格式。缺省时，text需要符合默认的日期格式的要求。fmt指定为J时，text需要为整数。 返回值类型：timestamp without time zone 示例： 1 2 3 4 5 6 7 8 9 10 gaussdb=# SELECT to_date('2015-08-14'); to_date --------------------- 2015-08-14 00:00:00 (1 row) gaussdb=# SELECT to_date('05 Dec 2000', 'DD Mon YYYY'); to_date --------------------- 2000-12-05 00:00:00 (1 row) gaussdb=# SET a_format_version='10c'; SET gaussdb=# SET a_format_dev_version='s1'; SET gaussdb=# SHOW nls_timestamp_format; nls_timestamp_format ---------------------------- DD-Mon-YYYY HH:MI:SS.FF AM (1 row) gaussdb=# SELECT to_date('12-jan-2022' DEFAULT '12-apr-2022' ON CONVERSION ERROR); to_date --------------------- 2022-01-12 00:00:00 (1 row) gaussdb=# SELECT to_date('12-ja-2022' DEFAULT '12-apr-2022' ON CONVERSION ERROR); to_date --------------------- 2022-04-12 00:00:00 (1 row) gaussdb=# SELECT to_date('2022-12-12' DEFAULT '2022-01-01' ON CONVERSION ERROR, 'yyyy-mm-dd'); to_date --------------------- 2022-12-12 00:00:00 (1 row) 在参数a_format_version值为10c和a_format_dev_version值为s1的情况下，年份的输入超过9999时，系统可能不报错。如to_date('99999-12-12', 'yyyy-mm-dd hh24:mi:ss')结果为9999-09-12 12:00:00。年输入超过9999时，超过4位后面的数字会解析为下一个fmt，to_timestamp同样有此限制。

to_clob(char/nchar/varchar/nvarchar/varchar2/nvarchar2/text/raw) 描述：将RAW类型或者文本字符集类型CHAR、NCHAR、VARCHAR、VARCHAR2、NVARCHAR、NVARCHAR2、TEXT转成CLOB类型。 返回值类型：clob 示例： 1 2 3 4 5 gaussdb=# SELECT to_clob('ABCDEF'::RAW(10)); to_clob --------- ABCDEF (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('hello111'::CHAR(15)); to_clob ---------- hello111 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('gauss123'::NCHAR(10)); to_clob ---------- gauss123 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('gauss234'::VARCHAR(10)); to_clob ---------- gauss234 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('gauss345'::VARCHAR2(10)); to_clob ---------- gauss345 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('gauss456'::NVARCHAR2(10)); to_clob ---------- gauss456 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_clob('World222!'::TEXT); to_clob ----------- World222! (1 row)

to_date(text) 描述：将文本类型的值转换为指定格式的时间戳。 格式一：无分隔符日期，如20150814，需要包括完整的年月日。 格式二：带分隔符日期，如2014-08-14，分隔符可以是单个任意非数字字符。 返回值类型：timestamp without time zone 示例： 1 2 3 4 5 gaussdb=# SELECT to_date('2015-08-14'); to_date --------------------- 2015-08-14 00:00:00 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s1的情况下，nls_timestamp_format值为YYYY-MM-DD HH24:MI:SS。

to_date(text, text) 描述：将字符串类型的值转换为指定格式的日期。 返回值类型：timestamp without time zone 示例： 1 2 3 4 5 gaussdb=# SELECT to_date('05 Dec 2000', 'DD Mon YYYY'); to_date --------------------- 2000-12-05 00:00:00 (1 row)

to_char(timestamp, text) 描述：将时间戳类型的值转换为指定格式的字符串。 返回值类型：text 示例： 1 2 3 4 5 gaussdb=# SELECT to_char(current_timestamp, 'HH12:MI:SS'); to_char ---------- 10:55:59 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s1的情况下，to_char函数会对错误的fmt报错。 如果不是在兼容模式下，to_char函数对于错误的fmt会原样输出，如fmt为FF10，会匹配到FF1进行格式化输出，然后原样输出0。

to_nchar(numeric/smallint/integer/bigint/double precision/real[, fmt]) 描述：将一个整型或者浮点类型的值转换为指定格式的字符串。 可选参数fmt可以为以下几类：十进制字符、“分组”符、正负号和货币符号，每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：9、0、,（千分隔符）、.（小数点），详情请参见表1。 模板可以有类似FM的修饰词，但FM不判断排查由模板0指定而输出的0。 要将整型类型的值转换成对应16进制值的字符串，使用模板X或x。 返回值类型：text 示例： 1 2 3 4 5 gaussdb=# SELECT to_nchar(1485,'9,999'); to_nchar --------- 1,485 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_nchar( 1148.5,'9,999.999'); to_nchar ------------ 1,148.500 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_nchar(148.5,'990999.909'); to_nchar ------------- 0148.500 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_nchar(123,'XXX'); to_nchar --------- 7B (1 row) 此函数仅在ORA兼容模式中（即sql_compatibility='ORA'）、且参数a_format_version值为10c和a_format_dev_version值为s2时生效。开启参数时支持$、C、TM、TM9、TME、U格式。同时在该参数下，不支持TH、PL、SG格式的fmt。

to_char(datetime/interval [, fmt]) 描述：将一个DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE或者TIMESTAMP WITH LOCAL TIME ZONE类型的DATETIME或者INTERVAL值按照fmt（用于格式化日期和时间值的模板）指定的格式转换为TEXT类型。 fmt可以为以下几类：日期、时间、星期、季度和世纪。每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：HH、MI、SS、YYYY、MM、DD，详情请参见表1。 fmt可以有修饰词，常用的修饰词是FM，可以用来判断排查前导的零或尾随的空白。 返回值类型：text 示例： 1 2 3 4 5 gaussdb=# SELECT to_char(current_timestamp,'HH12:MI:SS'); to_char ---------- 10:19:26 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_char(current_timestamp,'FMHH12:FMMI:FMSS'); to_char ---------- 10:19:46 (1 row)

to_nchar(datetime/interval [, fmt]) 描述：将一个DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE或者TIMESTAMP WITH LOCAL TIME ZONE类型的DATETIME或者INTERVAL值按照fmt（用于格式化日期和时间值的模板）指定的格式转换为TEXT类型。 可选参数fmt可以为以下几类：日期、时间、星期、季度和世纪。每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：HH、MI、SS、YYYY、MM、DD，详情请参见8.6.8.5-表 用于日期/时间格式化的格式。 模板可以有修饰词，常用的修饰词是FM，可以用来判断排查前导的零或尾随的空白。 返回值类型：text 示例： 1 2 3 4 5 gaussdb=# SELECT to_nchar(current_timestamp,'HH12:MI:SS'); to_nchar ---------- 10:19:26 (1 row) 1 2 3 4 5 gaussdb=# SELECT to_nchar(current_timestamp,'FMHH12:FMMI:FMSS'); to_nchar ---------- 10:19:46 (1 row)

to_nchar(string) 描述：将CHAR、VARCHAR、VARCHAR2、CLOB类型转换为TEXT类型。如使用该函数对CLOB类型进行转换，且待转换CLOB类型的值超出目标类型的范围，则会报错。 返回值类型：text 示例： 1 2 3 4 5 gaussdb=# SELECT to_nchar('01110'); to_nchar --------- 01110 (1 row)

to_binary_float(expr DEFAULT return_value ON CONVERSION ERROR) 描述：将expr转换成float4类型的值，若失败则返回默认值return_value。 参数：expr支持number、float4、float8数值类型，以及可以隐式转换为字符串的数值类型，当expr为非数值类型或非字符串类型时，则会报错。 返回值类型：float4 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT to_binary_float(1e2 DEFAULT 12 ON CONVERSION ERROR); to_binary_float ------------------ 100 (1 row) gaussdb=# SELECT to_binary_float('aa' DEFAULT 12 ON CONVERSION ERROR); to_binary_float ------------------ 12 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_float函数。

to_binary_float(expr DEFAULT return_value ON CONVERSION ERROR, fmt) 描述：将expr经过指定的fmt匹配后转换成float4类型的数值，若失败则返回默认值return_value。 参数：expr/fmt支持char、nchar、varchar2、nvarchar2类型的字符串，expr还支持可以隐式转换为字符串类型的数值类型。 返回类型：float4 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT to_binary_float('12-' DEFAULT 10 ON CONVERSION ERROR, '99S'); to_binary_float ------------------ -12 (1 row) gaussdb=# SELECT to_binary_float('aa-' DEFAULT 12 ON CONVERSION ERROR, '99S'); to_binary_float ------------------ 12 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_float函数。

to_binary_float(expr) 描述：将expr转换成float4类型的值。 参数：expr支持number、float4、float8数值类型，以及可以隐式转换为数值类型的字符串。 返回值类型：float4 示例： 1 2 3 4 5 gaussdb=# SELECT to_binary_float('12345678'); to_binary_float ------------------ 1.23457e+07 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_float函数。

to_binary_float(expr, fmt) 描述：将expr经过指定的fmt匹配后转换成float4类型的数值。 参数：expr/fmt支持char、nchar、varchar2、nvarchar2类型的字符串，expr还支持可以隐式转换为字符串类型的数值类型。 返回值类型：float4 示例： 1 2 3 4 5 gaussdb=# SELECT to_binary_float('1,2,3', '9,9,9'); to_binary_float ------------------ 123 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_float函数。

to_binary_double(expr DEFAULT return_value ON CONVERSION ERROR, fmt) 描述：将expr经过指定的fmt匹配后转换成float8类型的数值，若失败则返回默认值return_value。 参数：expr/fmt支持char、nchar、varchar2、nvarchar2类型的字符串，expr还支持可以隐式转换为字符串的数值类型。 返回类型：float8 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT to_binary_double('12-' DEFAULT 10 ON CONVERSION ERROR, '99S'); to_binary_double ------------------ -12 (1 row) gaussdb=# SELECT to_binary_double('aa-' DEFAULT 12 ON CONVERSION ERROR, '99S'); to_binary_double ------------------ 12 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_double函数。

to_blob(raw) 描述：将RAW类型转成BLOB类型。 返回值类型：blob 示例： 1 2 3 4 5 gaussdb=# SELECT to_blob('0AADD343CDBBD'::RAW(10)); to_blob ---------------- 00AADD343CDBBD (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_blob函数。

to_binary_double(expr, fmt) 描述：将expr经过指定的fmt匹配后转换成float8类型的数值 参数：expr/fmt支持char、nchar、varchar2、nvarchar2类型的字符串，expr还支持可以隐式转换为字符串类型的数值类型。 返回值类型：float8 示例： 1 2 3 4 5 gaussdb=# SELECT to_binary_double('1,2,3', '9,9,9'); to_binary_double ------------------ 123 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_double函数。

cast(x as y [DEFAULT z ON CONVERSION ERROR][,fmt]) 描述：类型转换函数，将x转换成y指定的类型。当sql_compatibility = 'MYSQL'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后，若y是char类型，则该函数会将x转换成varchar类型。 参数： x为该函数中待转换的数据，其类型和值需要支持转换为目标类型y。 DEFAULT z ON CONVERSION ERROR为可选参数，当尝试将x转换成y指定的类型失败时，则将z转换成y指定的类型。 fmt为可选参数，当y是以下数据类型时可以指定fmt参数： int1/int2/int4/int8/int16/float4/float8/numeric：则fmt的作用与to_number(expr [,fmt])函数相同； date/timestamp/timestamp with time zone：则fmt的作用与to_date(string [,fmt])/to_timestamp(string [,fmt]) /to_timestamp_tz(string [,fmt])函数相同。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 gaussdb=# SELECT cast('22-oct-1997' as timestamp); timestamp --------------------- 1997-10-22 00:00:00 (1 row) gaussdb=# SELECT cast('22-ocX-1997' as timestamp DEFAULT '22-oct-1997' ON CONVERSION ERROR, 'DD-Mon-YYYY'); timestamp --------------------- 1997-10-22 00:00:00 (1 row) gaussdb=# CREATE DATABASE gaussdb_m WITH dbcompatibility 'MYSQL'; gaussdb=# \c gaussdb_m -- 设置兼容版本控制参数 gaussdb_m=# SET b_format_version='5.7'; gaussdb_m=# SET b_format_dev_version='s1'; gaussdb_m=# SELECT cast('aaa' as char); varchar --------- aaa (1 row) 此函数在参数a_format_version值为10c且a_format_dev_version值为s1的情况下，支持DEFAULT z ON CONVERSION ERROR及fmt语法。

to_binary_double(expr) 描述：将expr转换成float8类型的值。 参数：expr支持number、float4、float8数值类型，以及可以隐式转换为数值类型的字符串。 返回值类型：float8 示例： 1 2 3 4 5 gaussdb=# SELECT to_binary_double('12345678'); to_binary_double ------------------ 12345678 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_double函数。

to_binary_double(expr DEFAULT return_value ON CONVERSION ERROR) 描述：将expr转换成float8类型的值，若失败则返回默认值return_value。 参数：expr支持number、float4、float8数值类型，以及可以隐式转换为字符串的数值类型。当expr为非数值类型或非字符串类型时，则会报错。 返回值类型：float8 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT to_binary_double(1e2 DEFAULT 12 ON CONVERSION ERROR); to_binary_double ------------------ 100 (1 row) gaussdb=# SELECT to_binary_double('aa' DEFAULT 12 ON CONVERSION ERROR); to_binary_double ------------------ 12 (1 row) 在参数a_format_version值为10c且a_format_dev_version值为s2的情况下，支持to_binary_double函数。

cast(x AS {SIGNED | UNSIGNED} [INT | INTEGER]) 描述：类型转换函数，将x转换成BIGINT SIGNED或BIGINT UNSIGNED类型。 参数：x是该函数中待转换的数据，其类型和值需要支持转换为目标类型INT。 返回值类型：BIGINT SIGNED或BIGINT UNSIGNED 示例： 1 2 3 4 5 gaussdb=# SELECT CAST(12 AS UNSIGNED); uint8 ------- 12 (1 row)

hll_add(hll, hll_hashval) 描述：把hll_hashval加入到hll中。 返回值类型：hll 示例： 1 2 3 4 5 gaussdb=# SELECT hll_add(hll_empty(), hll_hash_integer(1)); hll_add ---------------------------------------------------------------------------- \x484c4c08000002002b0900000000000000f03f3e2921ff133fbaed3e2921ff133fbaed00 (1 row)

hll_union(hll, hll) 描述：把两个hll数据结构union成一个。 返回值类型：hll 示例： 1 2 3 4 5 gaussdb=# SELECT hll_union(hll_add(hll_empty(), hll_hash_integer(1)), hll_add(hll_empty(), hll_hash_integer(2))); hll_union -------------------------------------------------------------------------------------------- \x484c4c10002000002b090000000000000000400000000000000000b3ccc49320cca1ae3e2921ff133fbaed00 (1 row)

hll_empty(int32 log2m, int32 log2explicit, int64 log2sparse, int32 duplicatecheck) 描述：创建空的hll并依次指定参数log2m、log2explicit、log2sparse、duplicatecheck。duplicatecheck取0或者1，表示是否开启该模式，默认情况下该模式会关闭。若输入-1，则duplicatecheck采用内置默认值。 返回值类型：hll 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT hll_empty(10, 4, 8, 0); hll_empty ------------------------------------------------------------ \x484c4c00000000001204000000000000000000000000000000000000 (1 row) gaussdb=# SELECT hll_empty(10, 4, 8, -1); hll_empty ------------------------------------------------------------ \x484c4c00000000001204000000000000000000000000000000000000 (1 row)

hll_add_rev(hll_hashval, hll) 描述：把hll_hashval加入到hll中，和hll_add功能一样，只是参数位置进行了交换。 返回值类型：hll 示例： 1 2 3 4 5 gaussdb=# SELECT hll_add_rev(hll_hash_integer(1), hll_empty()); hll_add_rev ---------------------------------------------------------------------------- \x484c4c08000002002b0900000000000000f03f3e2921ff133fbaed3e2921ff133fbaed00 (1 row)

hll_empty(int32 log2m, int32 log2explicit) 描述：创建空的hll并依次指定参数log2m、log2explicit。log2explicit取值范围是0到12，0表示直接跳过Explicit模式。该参数可以用来设置Explicit模式的阈值大小，在数据段长度达到2log2explicit后切换为Sparse模式或者Full模式。若输入-1，则log2explicit采用内置默认值。 返回值类型: hll 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT hll_empty(10, 4); hll_empty ------------------------------------------------------------ \x484c4c00000000001304000000000000000000000000000000000000 (1 row) gaussdb=# SELECT hll_empty(10, -1); hll_empty ------------------------------------------------------------ \x484c4c00000000002b04000000000000000000000000000000000000 (1 row)

hll_empty() 描述：创建一个空的hll。 返回值类型：hll 示例： 1 2 3 4 5 gaussdb=# SELECT hll_empty(); hll_empty ------------------------------------------------------------ \x484c4c00000000002b05000000000000000000000000000000000000 (1 row)

hll_empty(int32 log2m) 描述：创建空的hll并指定参数log2m，取值范围是10到16。若输入-1，则采用内置默认值。 返回值类型：hll 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT hll_empty(10); hll_empty ------------------------------------------------------------ \x484c4c00000000002b04000000000000000000000000000000000000 (1 row) gaussdb=# SELECT hll_empty(-1); hll_empty ------------------------------------------------------------ \x484c4c00000000002b05000000000000000000000000000000000000 (1 row)

hll_empty(int32 log2m, int32 log2explicit, int64 log2sparse) 描述：创建空的hll并依次指定参数log2m、log2explicit、log2sparse。log2sparse取值范围是0到14，0表示直接跳过Sparse模式。该参数可以用来设置Sparse模式的阈值大小，在数据段长度达到2log2sparse后切换为Full模式。若输入-1，则log2sparse采用内置默认值。 返回值类型：hll 示例： 1 2 3 4 5 6 7 8 9 10 11 gaussdb=# SELECT hll_empty(10, 4, 8); hll_empty ------------------------------------------------------------ \x484c4c00000000001204000000000000000000000000000000000000 (1 row) gaussdb=# SELECT hll_empty(10, 4, -1); hll_empty ------------------------------------------------------------ \x484c4c00000000001304000000000000000000000000000000000000 (1 row)

gs_recent_barrier_buffer_info(start_time text, end_time text) 描述：根据用户输入的时间范围，进行相应的barrier信息查询，获取time_stamp、 CS N、LSN和standard_time。 返回值类型：records 说明：调用该函数的用户需要具有SYSADMIN权限或具有OPRADMIN权限。输入参数start_time和end_time采用“年-月-日 时间”格式，其中时间采用clock格式。查询最大时间跨度为1天，超出跨度约束，根据查询起始时间将结束时间自动转换为极限边界进行查询。例如： gaussdb=# SELECT * FROM gs_recent_barrier_buffer_info('2024-01-15 23:27:50', '2024-01-15 23:28:00'); timestamp | lsn | csn | standard_time ------------+-------------------+----------+--------------------- 1705332470 | 00000000/15FFBBA0 | 41020421 | 2024-01-15 23:27:50 1705332471 | 00000000/15FFBDF0 | 41020422 | 2024-01-15 23:27:51 1705332472 | 00000000/15FFC058 | 41020423 | 2024-01-15 23:27:52 1705332472 | 00000000/15FFC0F8 | 41020424 | 2024-01-15 23:27:52 1705332473 | 00000000/15FFC348 | 41020425 | 2024-01-15 23:27:53 1705332474 | 00000000/15FFC598 | 41020426 | 2024-01-15 23:27:54 1705332475 | 00000000/15FFC638 | 41020427 | 2024-01-15 23:27:55 1705332476 | 00000000/15FFC888 | 41020428 | 2024-01-15 23:27:56 1705332476 | 00000000/15FFDC80 | 41020433 | 2024-01-15 23:27:56 1705332477 | 00000000/15FFDD20 | 41020434 | 2024-01-15 23:27:57 1705332478 | 00000000/15FFDF70 | 41020435 | 2024-01-15 23:27:58 1705332479 | 00000000/15FFE1D8 | 41020436 | 2024-01-15 23:27:59 1705332480 | 00000000/15FFE278 | 41020437 | 2024-01-15 23:28:00 1705332480 | 00000000/15FFE4C8 | 41020438 | 2024-01-15 23:28:00 (14 rows)

gs_download_obs_media_file(slot_name cstring, src cstring, dest cstring) 描述：根据用户输入的归档槽（slot_name）、下载原地址（src）和本地目标地址（dest），下载OBS文件。 返回值类型：void 说明：调用该函数的用户需要具有SYSADMIN权限或具有OPRADMIN权限。下载目录仅允许为$GAUSS LOG 目录。例如： gaussdb=# SELECT * FROM gs_download_obs_media_file('ssh','cn_5001/pg_xlog/000000010000000000000019_02_01_00000000_00000000_00000003','/data/gauss/log/stwang/test'); gs_download_obs_media_file ------------------------------ (1 row)