描述

BIN_TO_NUM 将位向量转换为其等效数字。

语法

     BIN_TO_NUM(VARIADIC integer []) returns int
    

通用规则

注意

参见

示例

SELECT BIN_TO_NUM(1,0,1,0) FROM DUAL;
 bin_to_num
------------
         10
(1 row)
    

描述

执行按位 AND 操作。

语法

     BITAND(int1 integers, int2 integers) returns bigint
    

通用规则

示例

在以下示例中，返回数字字面值 5 和 3 的 AND 操作结果。

    SELECT BITAND(5,3) FROM DUAL;
     bitand
    -------
          1
    (1 row)
    

描述

执行按位 OR 操作。

语法

     BITOR(int1 bigint, int2 bigint) returns bigint
    

通用规则

注意

参见

示例

在以下示例中，返回数字字面值 5 和 3 的 OR 操作结果。

SELECT BITOR(5,3) FROM DUAL;
 bitor
-------
     7
(1 row)
    

描述

执行按位异或操作。

语法

     BITXOR(int1 bigint, int2 bigint) returns bigint
    

通用规则

注意

参见

示例

在以下示例中，返回数字字面值 5 和 3 的 XOR 操作结果。

SELECT BITXOR(5,3) FROM DUAL;
 bitxor
--------
      6
(1 row
    

描述

计算一个数字的双曲余弦。

语法

     COSH(num numeric) returns double precision
    

通用规则

示例

在以下示例中，返回数字字面值 2.236 的双曲余弦值。

    SELECT COSH(2.236) FROM DUAL;
          cosh
    -----------------
    4.7313591000247
    (1 row)
    

描述

MOD返回n2除以n1的余数。如果n1为0，则返回n2。

语法

     MOD(n2 bigint, n1 bigint) returns bigint
     MOD(n2 integer, n1 integer) returns integer
     MOD(n2 numeric, n1 numeric) returns numeric
     MOD(n2 smallint, n1 smallint) returns smallint
    

General rules

注意

示例

SELECT mod(5,2) FROM DUAL;
 mod
-----------
      1
    

描述

返回n2除以n1的余数。

语法

     REMAINDER(n2 numeric, n1 numeric) returns numeric
    

通用规则

注意

参见

示例

SELECT REMAINDER(5.5,2) FROM DUAL;
 remainder
-----------
      -0.5
(1 row)
    

描述

该函数将n四舍五入为整数位。

语法

     ROUND_TIES_TO_EVEN(n NUMERIC,integer int4 DEFAULT 0) returns numeric
    

通用规则

注意

参见

示例

以下示例将一个数字向右舍入到小数点后一位：

SELECT ROUND_TIES_TO_EVEN(45.177,1) "ROUND_EVEN" FROM DUAL;
 ROUND_EVEN
------------
       45.2
(1 row)
    

以下示例将一个数字向左舍入到小数点前一位：

SELECT ROUND_TIES_TO_EVEN(45.177,-1) "ROUND_EVEN" FROM DUAL;
 ROUND_EVEN
------------
         50
(1 row)
    

描述

计算一个数字的双曲正弦。

语法

     SINH(num numeric) returns double precision
    

通用规则

示例

在以下示例中，返回数字1.414的双曲正弦。

    SELECT SINH(1.414) FROM DUAL;
          sinh
    -----------------
    1.93460168824956
    (1 row)
    

描述

计算一个数字的双曲正切。

语法

     TANH(num numeric) returns double precision
    

通用规则

示例

在以下示例中，返回数字3的双曲正切。

    SELECT TANH(3) FROM DUAL;
          tanh
    -----------------
    0.995054753686731
    (1 row)
    

描述

计算大于等于一个数的最小整数，当输入参数是interval类型时，会先获取其天数并将其转成数值后再计算。

语法

     CEIL(i interval) returns number
     CEIL(n numeric) returns numeric
     CEIL(d double precision) returns numeric
    

通用规则

示例

在以下示例中，返回大于等于一个数的最小整数，当输入参数是interval类型时，先获取其天数，这是个数值，然后再返回大于等于这个数值的最小整数。

    select ceil(sysdate - '2023-01-01'::date) FROM dual ;
     ceil
     ------
       335
     (1 row)

    select ceil(sysdate - to_date('2023-11-27','yyyy-mm-dd')) FROM dual;
     ceil
    ------
        5
    (1 row)

    select ceil(sysdate - to_date('2023-01-01','yyyy-mm-dd')) FROM dual;
     ceil
    ------
      335
    (1 row)
    

描述

从字符串的开头和结尾删除指定的字符。

语法

     BTRIM(str text) returns text
     BTRIM(str text, trimChars text) returns text
     BTRIM(str clob) returns clob
     BTRIM(str clob, trimChars clob) returns clob
    

通用规则

注意

信息

LightDB 的 BTRIM 通用规则如下：

参见

示例

在以下示例中，返回从字符串 "aabcaba" 的开头和结尾删除 "a" 后的字符串。

    SELECT BTRIM('aabcaba','a') FROM DUAL;
     btrim
    -------
     bcab
    (1 row)
    

描述

返回字符串中子字符串的位置。

语法

     INSTR(str1 text, str2 text) returns integer
     INSTR(str1 text, str2 text, startPos integer) returns integer
     INSTR(str1 text, str2 text, startPos integer, occurrences integer) returns integer
    

通用规则

示例

在以下示例中，字符串 "ABCACBCAAC" 中找到了字符 "BC"，并返回了这些字符的位置。

    SELECT INSTR('ABCACBCAAC','BC') FROM DUAL;
     instr
    -------
         2
    (1 row)

    SELECT INSTR('ABCACBCAAC','BC',-1,2) FROM DUAL;
     instr
    -------
         2
    (1 row)
    

描述

INSTRB 函数使用字节搜索字符串中的子字符串，并返回第一个指定出现的子字符串字节所在字符串的位置。

语法

     INSTRB( p_source text, p_search text, p_position int4  default 1, p_occurrence  int4  default 1) RETURNS integer
    

通用规则

注意

请参见

示例

在下面的例子中，找到字符串“hhh测试onhx”中的字符“on”，并返回那些字节的位置。

SELECT INSTRB('hhh测试onhx', 'on') FROM DUAL;
 instrb
--------
     10
(1 row)

SELECT INSTRB('hhh测试onhx on xxxx', 'on', 7, 2) FROM DUAL;
 instrb
--------
     15
(1 row)
    

描述

返回字符串中字符的数量。

语法

     LENGTH(str text) returns integer
    

通用规则

注意

上面的 LENGTH 规范使用 orafce 来确定其行为，这与 LightDB 的 LENGTH 不同。必须修改 search_path 参数，以使其按照 orafce 规范运行。

信息

LightDB 的 LENGTH 的通用规则如下：

参见

示例

在以下示例中，返回表 t1 中列 col2（使用 CHAR(10) 定义）中的字符数。

    SELECT col2,LENGTH(col2) FROM t1 WHERE col1 = '1001';
        col2    | length
    ------------+--------
     AAAAA      |     10
    (1 row)
    

描述

返回字符串的字节数。

语法

     LENGTHB(str text) returns integer
    

通用规则

示例

在以下示例中，返回表 t1 中列 col2（使用 CHAR(10) 定义）中的字节数。请注意，在第二个 SELECT 语句中，"*" 中的每个字符占用 3 个字节，总共占用 9 个字节，并且为 7 个尾随空格添加了 7 个字节。这将得出结果为 16 个字节。

    SELECT col2,LENGTHB(col2) FROM t1 WHERE col1 = '1001';
         col2      | lengthb
    ---------------+---------
     AAAAA         |      10
    (1 row)

    SELECT col2,LENGTHB(col2) FROM t1 WHERE col1 = '1004';
         col2      | lengthb
    ---------------+---------
     ***           |      16
    (1 row)
    

描述

使用一系列的字符填充一个字符串，使其达到指定的长度。

语法

     LPAD(x bigint, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     LPAD(x integer, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     LPAD(x smallint, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     LPAD(x numeric, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     LPAD(str text, len integer) returns text
     LPAD(str text, len integer, paddingStr text | char | varchar2 | nvarchar2) returns text
     LPAD(str clob, len integer) returns clob
     LPAD(str clob, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns clob
     LPAD(str char, len integer) returns varchar2
     LPAD(str char, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     LPAD(str varchar, len integer) returns varchar2
     LPAD(str varchar, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     LPAD(str varchar2, len integer) returns varchar2
     LPAD(str varchar2, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     LPAD(str nvarchar2, len integer) returns nvarchar2
     LPAD(str nvarchar2, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns nvarchar2
    

通用规则

注意

上面的 LPAD 规范使用 orafce 实现，其行为与 LightDB 的 LPAD 不同。必须修改 search_path 参数才能使其按照 orafce 规范工作。

信息

LightDB 的 LPAD 的通用规则如下：

参见

示例

在下面的示例中，返回一个通过使用 "a" 填充字符串 "abc" 的左侧而形成的 10 个字符的字符串。

    SELECT LPAD('abc',10,'a') FROM DUAL;
        lpad
    ------------
     aaaaaaaabc
    (1 row)
    

描述

从字符串的开头删除指定的字符。

语法

     LTRIM(str text) returns text
     LTRIM(str text, trimChars text) returns text
     LTRIM(str clob) returns clob
     LTRIM(str clob, trimChars clob) returns clob
    

通用规则

注意

上面的 LTRIM 规范使用 orafce 实现，其行为与 LightDB 的 LTRIM 不同。必须修改 search_path 参数才能使其按照 orafce 规范工作。

信息

LightDB的LTRIM的通用规则如下：

参见

示例

在以下示例中，将返回从“aabcab”的开头中移除“ab”的字符串。

    SELECT LTRIM('aabcab','ab') FROM DUAL;
     ltrim
    -------
     cab
    (1 row)
    

描述

返回表示区域设置（COLLATE）的词法顺序的字节字符串。

语法

     NLSSORT(str text) returns bytea
     NLSSORT(str text, locale text) returns bytea
    

通用规则

使用SELECT语句设置set_nls_sort的示例

     SELECT set_nls_sort('en_US.UTF8');
    

注意

如果指定区域编码，请确保它与数据库编码匹配。

参见

有关可以指定的语言环境信息，请参阅LightDB文档中的“服务器管理”>“本地化”>“语言环境支持”部分。

示例

在以下示例中，返回按“da_DK.UTF8”排序表t3的列col2的结果。

    SELECT col1,col2 FROM t3 ORDER BY NLSSORT(col2,'da_DK.UTF8');
     col1 |    col2
    ------+------------
     2001 | abcdef
     1001 | aabcababc
     3001 | aacbaab
    (3 row)
    

描述

在字符串中搜索正则表达式，并返回匹配项的计数。

语法

     REGEXP_COUNT(string text, pattern text) returns integer
     REGEXP_COUNT(string text, pattern text, startPos integer) returns integer
     REGEXP_COUNT(string text, pattern text, startPos integer, flags text) returns integer
    

通用规则

flags的值可以包括以下一个或多个字符：

如果省略了flags，那么：

注意

如果使用REGEXP_COUNT函数，则需要事先在search_path中指定"oracle"。

参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

    SELECT REGEXP_COUNT('a'||CHR(10)||'d', 'a.d') FROM DUAL;
     regexp_count
    --------------
                0
    (1 row)

    SELECT REGEXP_COUNT('a'||CHR(10)||'d', 'a.d', 1, 'm') FROM DUAL;
     regexp_count
    --------------
                0
    (1 row)

    SELECT REGEXP_COUNT('a'||CHR(10)||'d', 'a.d', 1, 'n') FROM DUAL;
     regexp_count
    --------------
                1
    (1 row)

    SELECT REGEXP_COUNT('a'||CHR(10)||'d', '^d$', 1, 'm') FROM DUAL;
     regexp_count
    --------------
                1
    (1 row)
    

描述

返回在字符串中找到模式匹配的开始或结束位置。

语法

     REGEXP_INSTR(string text, pattern text) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer, return_opt integer) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer, return_opt integer, flags text) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer, return_opt integer, flags text) returns integer
     REGEXP_INSTR(string text, pattern text, startPos integer, occurrence integer, return_opt integer, flags text, group integer) returns integer
    

通用规则

注意

如果使用REGEXP_INSTR函数，则需要事先在search_path中指定"oracle"。

参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

    SELECT REGEXP_INSTR('1234567890', '(123)(4(56)(78))') FROM DUAL;
     regexp_instr
    --------------
                1
    (1 row)

    SELECT REGEXP_INSTR('1234567890', '(4(56)(78))', 3) FROM DUAL;
     regexp_instr
    --------------
                4
    (1 row)

    SELECT REGEXP_INSTR('123 123456 1234567, 1234567 1234567 12', '[^ ]+', 1, 6) FROM DUAL;
     regexp_instr
    --------------
               37

    (1 row)

    SELECT REGEXP_INSTR('199 Oretax Prayers, Riffles Stream, CA', '[S|R|P][[:alpha:]]{6}', 3, 2, 1) FROM DUAL;
     regexp_instr
    --------------
               28
    (1 row)
    

描述

在查询的WHERE子句中使用，使得查询返回与给定模式匹配的行。

语法

     REGEXP_LIKE(string text, pattern text) returns boolean
     REGEXP_LIKE(string text, pattern text, flags text) returns boolean
    

通用规则

注意

如果使用REGEXP_LIKE函数，需要预先指定“oracle”作为search_path。

参见

有关如何编辑search_path的信息，请参见“使用orafce的注意事项”。

示例

    SELECT REGEXP_LIKE('a'||CHR(10)||'d', 'a.d', 'm') FROM DUAL;
     regexp_like
    -------------
     f
    (1 row)

    SELECT REGEXP_LIKE('a'||CHR(10)||'d', 'a.d', 'n') FROM DUAL;
     regexp_like
    -------------
     t
    (1 row)
    

描述

返回与调用函数中指定的模式匹配的字符串。

语法

     REGEXP_SUBSTR(string text, pattern text) returns text
     REGEXP_SUBSTR(string text, pattern text, startPos integer) returns text
     REGEXP_SUBSTR(string text, pattern text, startPos integer, occurrence numeric) returns text
     REGEXP_SUBSTR(string text, pattern text, startPos integer, occurrence numeric, flags text) returns text
     REGEXP_SUBSTR(string text, pattern text, startPos integer, occurrence numeric, flags text, group int) returns text
     REGEXP_SUBSTR(string CLOB, pattern text) returns clob
    

通用规则

注意

如果使用REGEXP_SUBSTR函数，需要预先指定“oracle”作为search_path。

参见

有关如何编辑search_path的信息，请参见“使用orafce的注意事项”。

示例

    SELECT REGEXP_SUBSTR('number of your street, zipcode town, FR', ',[^,]+') FROM DUAL;
     regexp_substr
    ----------------
     , zipcode town
    (1 row)

    SELECT regexp_substr('number of your street, zipcode town, FR', ',[^,]+', 24) FROM DUAL;
     regexp_substr
    ---------------
     , FR
    (1 row)

    SELECT regexp_substr('number of your street, zipcode town, FR', ',[^,]+', 1, 2) FROM DUAL;
     regexp_substr
    ---------------
     , FR
    (1 row)

    SELECT regexp_substr('1234567890 1234567890', '(123)(4(56)(78))', 1, 1, 'i', 0) FROM DUAL;
     regexp_substr
    ---------------
     12345678
    (1 row)

    SELECT regexp_substr('1234567890 1234567890', '(123)(4(56)(78))', 1, 1.9, 'i', 0) FROM DUAL;
     regexp_substr
    ---------------
     12345678
    (1 row)
    

描述

返回与调用函数中指定的模式匹配的字符串。

语法

     REGEXP_REPLACE(string text, pattern text, replace_string text, startPos integer,
     occurrence integer, flags text) returns text
     REGEXP_REPLACE(string clob, pattern text, replace_string text) returns clob
    

通用规则

注意

如果使用 REGEXP_REPLACE 函数，则需要提前指定 "oracle" 作为 search_path。

参见

有关如何编辑 search_path 的信息，请参阅 "使用 orafce 的注释"。

示例

    SELECT regexp_replace('512.123.4567 612.123.4567', '([[:digit:]]{3})\.([[:digit:]]{3})\.([[:digit:]]{4})', '(\1) \2-\3') FROM DUAL;
            regexp_replace
    -------------------------------
     (512) 123-4567 (612) 123-4567
    (1 row)

    SELECT oracle.REGEXP_REPLACE('number   your     street,    zipcode  town, FR', '( ){2,}', ' ', 9);
                 regexp_replace
    ----------------------------------------
     number   your street, zipcode town, FR
    (1 row)

    SELECT oracle.REGEXP_REPLACE('number   your     street,    zipcode  town, FR', '( ){2,}', ' ', 9, 2);
                   regexp_replace
    ---------------------------------------------
     number   your     street, zipcode  town, FR
    (1 row)
    

描述

返回将每个 search_string 的出现替换为 replacement_string 的字符串。

语法

     REPLACE(string text, pattern text) returns text
     REPLACE(string text, pattern text, replace_string text) returns text
     REPLACE(string uuid, pattern text, replace_string text) returns text
     REPLACE(string CLOB, pattern text) returns CLOB
     REPLACE(string CLOB, pattern text, replace_string text) returns CLOB
    

通用规则

注意

上述 REPLACE 规范使用 orafce 来实现其行为，这与 LightDB 的 REPLACE 不同。必须修改 search_path 参数，以使其按照 orafce 规范进行操作。

信息

LightDB 的 REPLACE 的通用规则如下：

参见

有关如何编辑 search_path 的信息，请参阅 "使用 orafce 的注释"。

示例

SELECT REPLACE('abcdAbcdasd', 'a') FROM DUAL;
  replace
-----------
 bcdAbcdsd
(1 row)

SELECT REPLACE('abcdAbcdasd', 'a','c') FROM DUAL;
   replace
-------------
 cbcdAbcdcsd
(1 row)

SELECT REPLACE('abcdAbcdasd', NULL,'c') FROM DUAL;
   replace
-------------
 abcdAbcdasd
(1 row)

SELECT REPLACE('abcdAbcdasd', 'a',NULL) FROM DUAL;
  replace
-----------
 bcdAbcdsd
(1 row)
    

描述

使用一系列字符将字符串右侧填充到指定的长度。

语法

     RPAD(x bigint, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     RPAD(x integer, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     RPAD(x smallint, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     RPAD(x numeric, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | integer) returns varchar2
     RPAD(str text, len integer) returns text
     RPAD(str text, len integer, paddingStr text | char | varchar2 | nvarchar2) returns text
     RPAD(str clob, len integer) returns clob
     RPAD(str clob, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns clob
     RPAD(str char, len integer) returns varchar2
     RPAD(str char, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     RPAD(str varchar, len integer) returns varchar2
     RPAD(str varchar, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     RPAD(str varchar2, len integer) returns varchar2
     RPAD(str varchar2, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns varchar2
     RPAD(str nvarchar2, len integer) returns nvarchar2
     RPAD(str nvarchar2, len integer, paddingStr text | clob | char | varchar | varchar2 | nvarchar2 | bigint | integer | smallint | numeric) returns nvarchar2
    

通用规则

注意

上述 RPAD 规范使用 orafce 来实现其行为，这与 LightDB 的 RPAD 不同。必须修改 search_path 参数，以使其按照 orafce 规范进行操作。

信息

LightDB 的 RPAD 的通用规则如下：

参见

示例

在以下示例中，返回通过使用 "a" 右侧填充字符串 "abc" 形成的长度为 10 个字符的字符串。

    SELECT RPAD('abc',10,'a') FROM DUAL;
        rpad
    ------------
     abcaaaaaaa
    (1 row)
    

描述

从字符串末尾删除指定的字符。

语法

     RTRIM(str text) returns text
     RTRIM(str text, trimChars text) returns text
     RTRIM(str clob) returns clob
     RTRIM(str clob, trimChars text) returns clob
    

通用规则

注意

上述 RTRIM 规范使用 orafce 来实现其行为，这与 LightDB 的 RTRIM 不同。必须修改 search_path 参数，以使其与 orafce 规范的行为相同。

信息

LightDB 的 RTRIM 的通用规则如下：

请参见

示例

在下面的示例中，将从“aabcab”的结尾中删除“ab”字符串并返回。

    SELECT RTRIM('aabcab','ab') FROM DUAL;
     rtrim
    -------
     aabc
    (1 row)
    

描述

SOUNDEX返回一个包含char的语音表示的字符字符串。 此函数可让您比较不同拼写但在英语中发音相似的单词。

语法

     SOUNDEX(str text) returns text
    

通用规则

注意

如果使用SOUNDEX函数，则需要事先在search_path中指定“oracle”。

请参见

参阅“使用orafce的注意事项”了解如何编辑search_path。

示例

在下面的示例中，将从“aabcab”的结尾中删除“ab”字符串并返回。

SELECT SOUNDEX('SMYTHE')=SOUNDEX('Smith') as same FROM DUAL;
 same
------
 t
(1 row)
    

描述

使用字符指定位置和长度提取字符串的一部分。

语法

     SUBSTR(str text, startPos integer) returns text
     SUBSTR(str text, startPos numeric) returns text
     SUBSTR(str text, startPos integer, len integer) returns text
     SUBSTR(str text, startPos numeric, len numeric) returns text
     SUBSTR(str CLOB, startPos number) returns CLOB
     SUBSTR(str CLOB, startPos number, len number) returns CLOB
    

通用规则

注意

信息

LightDB的SUBSTRING的通用规则如下：

请参见

示例

在下面的示例中，提取了字符串“ABCDEFG”的部分内容。

    SELECT SUBSTR('ABCDEFG',3,4) "Substring" FROM DUAL;
     Substring
    -----------
     CDEF
    (1 row)

    SELECT SUBSTR('ABCDEFG',-5,4) "Substring" FROM DUAL;
     Substring
    -----------
     CDEF
    (1 row)
    

描述

使用字节指定位置和长度提取字符串的一部分。

语法

     SUBSTRB(str text, startPos integer) returns varchar2
     SUBSTRB(str text, startPos integer, len integer) returns varchar2
    

通用规则

注意

SUBSTRB的外部规范与orafce添加的SUBSTR不同，符合LightDB的SUBSTRING。

示例

在下面的示例中，提取了字符串“aaabbbccc”的部分内容。

    SELECT SUBSTRB('aaabbbccc',4,3) FROM DUAL;
     substrb
    -----------
     bbb
    (1 row)

    SELECT SUBSTRB('aaabbbccc',-2,6) FROM DUAL;
     substrb
    -----------
     aaa
    (1 row)
    

描述

拼接两个字符串

语法

     CONCAT(str1 TEXT, str2 TEXT) returns TEXT
     CONCAST(str1 CLOB, str2 CLOB) returns CLOB
    

通用规则

样例

    SELECT concat('a', 'b') FROM DUAL;
     concat
    --------
     ab
    (1 row)

    SELECT concat(to_clob('a'), 'b') FROM DUAL;
     concat
    --------
     ab
    (1 row)
    

描述

UPPER 返回所有字母为大写的字符串

语法

     UPPER(string TEXT) returns TEXT
     UPPER(string CLOB) returns CLOB
    

通用规则

样例

    SELECT UPPER('hello world') FROM DUAL;
        upper
    -------------
     HELLO WORLD
    (1 row)

    SELECT UPPER(to_clob('hello world')) FROM DUAL;
        upper
    -------------
     HELLO WORLD
    (1 row)
    

描述

对日期添加月份。

语法

     ADD_MONTHS(date DATE, months INTEGER) returns DATE
     ADD_MONTHS(date TIMESTAMP WITH TIME ZONE, months INTEGER) returns TIMESTAMP
    

通用规则

注意

如果使用orafce的DATE类型，则需要提前指定search_path为“oracle”。

请参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

下面的示例显示了在日期2016年5月1日上添加3个月的结果。

    SELECT ADD_MONTHS(DATE'2016/05/01',3) FROM DUAL;
         add_months
    ---------------------
     2016-08-01 00:00:00
    (1 row)
    

描述

返回数据库时区的值。

语法

     DBTIMEZONE() returns text
    

通用规则

注意

参见

示例

在以下示例中，返回DBTIMEZONE结果。

     SELECT DBTIMEZONE() FROM DUAL;
      dbtimezone
     ------------
      GMT
     (1 row)
    

描述

返回指定日期所在月份的最后一天。

语法

     LAST_DAY(date DATE) returns DATE
     LAST_DAY(date TIMESTAMPTZ) returns TIMESTAMPTZ
    

通用规则

注意

如果使用orafce的DATE类型，则需要提前在search_path中指定“oracle”。

参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

在以下示例中，返回“2016年2月1日”的最后一天。

    SELECT LAST_DAY(DATE'2016/02/01') FROM DUAL;
         last_day
    ---------------------
     2016-02-29 00:00:00
    (1 row)
    

描述

返回两个日期之间的月数。

语法

     MONTHS_BETWEEN(date1 DATE, date2 DATE) returns NUMERIC
     MONTHS_BETWEEN(date1 TIMESTAMP WITH TIME ZONE, date2 TIMESTAMP WITH TIME ZONE) returns NUMERIC
    

通用规则

注意

如果使用orafce的DATE类型，则需要提前在search_path中指定“oracle”。

参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

在以下示例中，返回2016年3月15日和2015年11月15日之间月份的差异。

     SELECT MONTHS_BETWEEN(DATE'2016/03/15', DATE'2015/11/15') FROM DUAL;
      months_between
     ----------------
                    4
     (1 row)
    

描述

返回指定日期之后的第一个特定星期几的日期。

语法

     NEXT_DAY(date DATE, dayOfWk TEXT) returns DATE
     NEXT_DAY(date DATE, dayOfWk INTEGER) returns DATE
     NEXT_DAY(date TIMESTAMP WITH TIME ZONE, dayOfWk TEXT) returns TIMESTAMP
     NEXT_DAY(date TIMESTAMP WITH TIME ZONE, dayOfWk INTEGER) returns TIMESTAMP
    

通用规则

可指定的星期几值

注意

参见

有关如何编辑 search_path 的信息，请参阅 "使用 orafce 的注意事项"。

示例

在下面的示例中，返回 "2016 年 5 月 1 日" 或之后的第一个星期五的日期。

    SELECT NEXT_DAY(DATE'2016/05/01', 'Friday') FROM DUAL;
          next_day
    ---------------------
     2016-05-06 00:00:00
    (1 row)
    

描述

对日期进行四舍五入。

语法

     ROUND(date DATE) returns DATE
     ROUND(date DATE, fmt TEXT) returns DATE
     ROUND(date TIMESTAMP WITH TIME ZONE) returns TIMESTAMP WITH TIME ZONE
     ROUND(date TIMESTAMP WITH TIME ZONE, fmt TEXT) returns TIMESTAMP WITH TIME ZONE
     ROUND(date TIMESTAMP WITHOUT TIME ZONE) returns TIMESTAMP WITHOUT TIME ZONE
     ROUND(date TIMESTAMP WITHOUT TIME ZONE, fmt TEXT) returns TIMESTAMP WITHOUT TIME ZONE
    

通用规则

可指定的格式模型值

示例

在下面的示例中，返回按本周的星期日进行四舍五入的 "2016 年 6 月 20 日 18:00:00" 的结果。

    SELECT ROUND(TIMESTAMP'2016/06/20 18:00:00','DAY') FROM DUAL;
             round
    ------------------------
     2016-06-19 00:00:00+09
    (1 row)
    

描述

返回会话的时区。

语法

     SESSIONTIMEZONE() returns text
    

通用规则

注意

参见

有关如何编辑search_path的信息，请参阅“使用orafce的注意事项”。

示例

在下面的示例中，返回会话的时区。

    SELECT SESSIONTIMEZONE() FROM DUAL;
     sessiontimezone
    -----------------
     Japan
    (1 row)
    

描述

返回系统日期。

语法

     SYSDATE() returns oracle.date
    

通用规则

注意

参见

示例

在下面的示例中，返回系统日期。

    SELECT SYSDATE() FROM DUAL;
           sysdate
    ---------------------
     2016-06-22 08:06:51
    (1 row)
    

描述

截取日期部分。

语法

     TRUNC(date DATE) returns DATE
     TRUNC(date DATE, fmt TEXT) returns DATE
     TRUNC(date TIMESTAMP WITH TIME ZONE) returns TIMESTAMP WITH TIME ZONE
     TRUNC(date TIMESTAMP WITH TIME ZONE, fmt TEXT) returns TIMESTAMP WITH TIME ZONE
     TRUNC(date TIMESTAMP WITHOUT TIME ZONE) returns TIMESTAMP WITHOUT TIME ZONE
     TRUNC(date TIMESTAMP WITHOUT TIME ZONE, fmt TEXT) returns TIMESTAMP WITHOUT TIME ZONE
    

通用规则

参见

有关可以为格式模型指定的值的信息，请参阅“ROUND”。

示例

在下面的示例中，返回截取了日期部分的"August 10, 2016 15:30:00"。

    SELECT TRUNC(TIMESTAMP'2016/08/10 15:30:00','DDD') FROM DUAL;
             trunc
    ------------------------
     2016-08-10 00:00:00+09
    (1 row)
    

描述

返回时区偏移量。

语法

     TZ_OFFSET(text) returns text
    

通用规则

注意

参见

示例

SELECT TZ_OFFSET('Asia/Shanghai') FROM DUAL;
 tz_offset
-----------
 08:00:00
(1 row)
    (1 row)
    

描述

CONVERT将一个字符字符串从一个字符集转换为另一个字符集。

语法

     CONVERT(str TEXT,dest_char_set TEXT,source_char_set TEXT DEFAULT 'utf8') returns TEXT
    

通用规则

注意

参见

示例

 SELECT CONVERT('娴嬭瘯', 'gbk', 'utf8') from dual; FROM DUAL;
 convert
---------
 测试
(1 row)
    

描述

NUMTOYMINTERVAL将数字转换为INTERVAL YEAR TO MONTH文字。

语法

     NUMTOYMINTERVAL(n numeric, interval_unit text) returns interval
    

通用规则

注意

参见

示例

SELECT NUMTOYMINTERVAL(1,'YEAR') FROM DUAL;
 numtoyminterval
-----------------
 1 year
(1 row)
    

描述

TO_BLOB(raw)将RAW值转换为BLOB值。

语法

     TO_BLOB(raw) returns blob
    

注意

参见

示例

SELECT TO_BLOB(UTL_RAW.CAST_TO_RAW('测试')) FROM DUAL;
    to_blob
----------------
 \xe6b58be8af95
(1 row)
    

描述

将一个值转换为字符串。

语法

     TO_CHAR(num SMALLINT) returns TEXT
     TO_CHAR(num INTEGER) returns TEXT
     TO_CHAR(num BIGINT) returns TEXT
     TO_CHAR(num REAL) returns TEXT
     TO_CHAR(num DOUBLE PRECISION) returns TEXT
     TO_CHAR(num NUMERIC) returns TEXT
     TO_CHAR(date TIMESTAMP) returns TEXT
     TO_CHAR(TEXT) returns TEXT

     TO_CHAR(date TIMESTAMP, fmt TEXT) returns TEXT
     TO_CHAR(date TIMESTAMP WITH TIME ZONE, fmt TEXT) returns TEXT

     TO_CHAR(date TIMESTAMP, fmt TEXT, nls_date_language TEXT) returns TEXT
     TO_CHAR(date TIMESTAMP WITH TIME ZONE, fmt TEXT, nls_date_language TEXT) returns TEXT
    

通用规则

注意

参见

示例

在以下示例中，将数字值“123.45”作为字符串返回。

     SELECT TO_CHAR(123.45) FROM DUAL;
      to_char
     ---------
      123.45
     (1 row)

     SELECT to_char (sysdate, 'YYYY-MM-DD', 'NLS_DATE_LANGUAGE=''SIMPLIFIED CHINESE''' );
      to_char
      ------------
      2023-12-04
      (1 row)
    

描述

根据指定的格式将字符串转换为日期。

语法

     TO_DATE(str TEXT) returns TIMESTAMP
     TO_DATE(str TEXT, fmt TEXT) returns TIMESTAMP
     TO_DATE(oracle.date) returns TIMESTAMP
    

通用规则

注意

信息

LightDB中TO_DATE指定数据类型格式的通用规则如下：

参见

示例

在以下示例中，将字符串“2016/12/31”转换为日期并返回。

     SELECT TO_DATE('2016/12/31','YYYY/MM/DD') FROM DUAL;
            to_date
     ---------------------
      2016-12-31 00:00:00
     (1 row)

     SELECT to_date('2009-01-02'::oracle.date);
           to_date
     ---------------------
     2009-01-02 00:00:00
     (1 row)
    

描述

将单字节字符串转换为多字节字符串。

语法

     TO_MULTI_BYTE(str TEXT) returns TEXT
    

通用规则

示例

在以下示例中，将“abc123”转换为全角字符并返回。

     SELECT TO_MULTI_BYTE('abc123') FROM DUAL;
      to_multi_byte
     ---------------
        ******
     (1 row)
    

“******”是多字节的“abc123”。

描述

根据指定的格式将值转换为数字。

语法

     TO_NUMBER(str TEXT) returns NUMERIC
     TO_NUMBER(num NUMERIC) returns NUMERIC
     TO_NUMBER(num NUMERIC, fmt NUMERIC) returns NUMERIC
    

通用规则

详见

有关数字值格式的信息，请参阅LightDB文档中的"The SQL Language" > "Functions and Operators" > "Data Type Formatting Functions"。

示例

在以下示例中，将数字字面值“-130.5”转换为数字值并返回。

     SELECT TO_NUMBER(-130.5) FROM DUAL;
      to_number
     -----------
         -130.5
     (1 row)
    

描述

将多字节字符串转换为单字节字符串。

语法

     TO_SINGLE_BYTE(str TEXT) returns TEXT
    

通用规则

示例

在以下示例中，“******”被转换为半角字符并返回。 “******”是多字节字符串“xyz999”。

     SELECT TO_SINGLE_BYTE('******') FROM DUAL;
      to_single_byte
     ----------------
      xyz999
     (1 row)
    

描述

ASCIISTR以一个字符串或解析为字符串的表达式作为其参数，并返回数据库字符集中字符串的ASCII版本。

语法

     ASCIISTR(str TEXT) returns TEXT
    

通用规则

示例

在以下示例中，“Ä”被转换为“\00C4”。

     SELECT ASCIISTR('ABÄCDE') FROM DUAL;
      asciistr
     ----------------
      AB\00C4CDE
     (1 row)
    

描述

ASCII以一个字符串或解析为字符串的表达式作为其参数，并返回第一个字符的数据库字符集中的值。

语法

     ASCIISTR(str TEXT) returns BIGINT
    

通用规则

示例

在以下示例中，“Ä”被转换为UTF-8中的“50052”。

     SELECT ORACLE.ASCII('Ä') FROM DUAL;
      ascii
     -------
      50052
     (1 row)
    

描述

将整数错误代码转换为长度为5的字符串错误代码。

语法

     SQLCODE_TO_SQLSTATE(code INTEGER) returns TEXT
    

通用规则

示例

在以下示例中，转换错误码2。

     select SQLCODE_TO_SQLSTATE(2);
      sqlcode_to_sqlstate
     ---------------------
      20000
     (1 row)
    

描述

将字符字符串或数值转换为CLOB值。

语法

     TO_CLOB(str TEXT) returns CLOB
  

通用规则

示例

CREATE TABLE testorafce_to_clob (
    col_char CHAR(10),
    col_varchar2 VARCHAR2(20),
    col_varchar VARCHAR(20),
    col_nchar NCHAR(10),
    col_nvarchar2 NVARCHAR2(20),
    col_smallint smallint,
    col_integer integer,
    col_bigint bigint,
    col_decimal decimal,
    col_numeric numeric,
    col_real real,
    col_double double precision,
    col_clob CLOB,
    col_raw raw(10)
);

INSERT INTO testorafce_to_clob (col_char, col_varchar2, col_varchar, col_nchar, col_nvarchar2, col_smallint, col_integer, col_bigint, col_decimal, col_numeric, col_real, col_double, col_clob, col_raw)
VALUES ('ABC1', 'Hello', 'world', 'hello', 'world', 1, 2, 3, 4, 5, 6, 7, 'This is a CLOB', 'AB');

INSERT INTO testorafce_to_clob (col_char, col_varchar2, col_varchar, col_nchar, col_nvarchar2, col_smallint, col_integer, col_bigint, col_decimal, col_numeric, col_real, col_double, col_clob, col_raw)
VALUES ('ABC2', 'Hello', 'world', 'hello', 'world', 1, 2, 3, 4, 5, 6, 7, 'This is a CLOB', '1');

INSERT INTO testorafce_to_clob (col_char, col_varchar2, col_varchar, col_nchar, col_nvarchar2, col_smallint, col_integer, col_bigint, col_decimal, col_numeric, col_real, col_double, col_clob, col_raw)
VALUES ('ABC3', 'Hello', 'world', 'hello', 'world', 1, 2, 3, 4, 5, 6, 7, to_clob('This is a CLOB'), '1AB456789');

SELECT  to_clob(col_char) AS clob_char,
        to_clob(col_varchar2) AS clob_varchar2,
        to_clob(col_varchar) AS col_varchar,
        to_clob(col_nchar) AS clob_nchar,
        to_clob(col_nvarchar2) AS clob_nvarchar2,
        to_clob(col_clob) AS clob_clob,
        to_clob(col_smallint) AS col_smallint,
        to_clob(col_integer) AS col_integer,
        to_clob(col_bigint) AS col_bigint,
        to_clob(col_decimal) AS col_decimal,
        to_clob(col_numeric) AS col_numeric,
        to_clob(col_real) AS col_real,
        to_clob(col_double) AS col_double,
        to_clob(col_raw) AS clob_nclob
        FROM testorafce_to_clob order by col_char asc;

clob_char  | clob_varchar2 | col_varchar | clob_nchar | clob_nvarchar2 |   clob_clob    | col_smallint | col_integer | col_bigint | col_decimal | col_numeric | col_real | col_double | clob_nclob
------------+---------------+-------------+------------+----------------+----------------+--------------+-------------+------------+-------------+-------------+----------+------------+------------
ABC1       | Hello         | world       | hello      | world          | This is a CLOB | 1            | 2           | 3          | 4           | 5           | 6        | 7          | AB
ABC2       | Hello         | world       | hello      | world          | This is a CLOB | 1            | 2           | 3          | 4           | 5           | 6        | 7          | 01
ABC3       | Hello         | world       | hello      | world          | This is a CLOB | 1            | 2           | 3          | 4           | 5           | 6        | 7          | 01AB456789
(3 rows)
          

描述

RAWTOHEX将传入值转换为包含其十六进制表示形式的字符值。

语法

     RAWTOHEX(test_raw RAW) returns TEXT
     RAWTOHEX(test_text TEXT) returns TEXT
     RAWTOHEX(test_uuid UUID) returns VARCHAR2
    

通用规则

示例

      select rawtohex(sys_guid());
                   rawtohex
      ----------------------------------
      6466c654a5dc4755902b70d0e6ea6eb6
      (1 row)
    

描述

ROWIDTOCHAR将传入值ORACLE的tid类型的ROWID转换为varchar2形式的字符值。

语法

     ROWIDTOCHAR(test_rowid TID) returns VARCHAR2
    

通用规则

示例

    drop TABLE if EXISTS rowidtochar_t1;
    create table rowidtochar_t1
    (
        id int not null
    );
    insert into rowidtochar_t1 values(1);
    select rowidtochar(rowid) from rowidtochar_t1;
    rowidtochar
    -------------
    (0,1)
    (1 row)
    

描述

比较值，如果它们匹配，则返回相应的值。

语法

     DECODE(expr, srch,  result)
     DECODE(expr, srch,  result,  default)
     DECODE(expr, srch1, result1, srch2, result2)
     DECODE(expr, srch1, result1, srch2, result2, default)
     DECODE(expr, srch1, result1, srch2, result2, srch3, result3)
     DECODE(expr, srch1, result1, srch2, result2, srch3, result3, default)
    

通用规则

Y：可以转换

S：可转换一些数据类型

N：无法转换

*1：可转换日期/时间类型的数据类型如下所示：

Y：可以转换

N：无法转换

示例

在下面的示例中，将比较并转换表t1中col3的值为不同的值。 如果col3值匹配搜索值1，则返回的结果值是“one”。 如果col3值不与搜索值1、2或3中的任何一个匹配，则返回默认值“other number”。

     SELECT col1,
            DECODE(col3, 1, 'one',
                         2, 'two',
                         3, 'three',
                         'other number') "num-word"
            FROM t1;
     col1  | num-word
     ------+----------
      1001 | one
      1002 | two
      1003 | three
     (3 rows)
    

描述

确定指定条件的值是TRUE还是FALSE。

语法

     LNNVL(cond BOOLEAN) returns BOOLEAN
    

通用规则

示例

在以下示例中，当col3的值为2000或更低或为空时，返回表t1的col1和col3。

     SELECT col1,col3 FROM t1 WHERE LNNVL( col3 > 2000 );
      col1 | col3
     ------+------
      1001 | 1000
      1002 | 2000
      2002 |
     (3 row)
    

描述

当值不是数字（NaN）时返回替代值。

语法

     NANVL(expr FLOAT4,  substitute FLOAT4)  returns FLOAT4
     NANVL(expr FLOAT8,  substitute FLOAT8)  returns FLOAT8
     NANVL(expr NUMERIC, substitute NUMERIC) returns NUMERIC
     NANVL(expr FLOAT4,  substitute VARCHAR) returns FLOAT4
     NANVL(expr FLOAT8,  substitute VARCHAR) returns FLOAT8
     NANVL(expr NUMERIC, substitute VARCHAR) returns NUMERIC
    

通用规则

示例

在以下示例中，如果表t1中的col1的值是NaN值，则返回“0”。

     SELECT col1, NANVL(col3,0) FROM t1;
      col1 | nanvl
     ------+-------
      2001 |     0
     (1 row)
    

描述

当值为NULL时返回替代值。

语法

     NVL(expr1 anyelement, expr2 anyelement) return anyelement
    

通用规则

示例

在以下示例中，如果表t1中的col1的值是NULL值，则返回“IS NULL”。

     SELECT col2, NVL(col1,'IS NULL') "nvl" FROM t1;
      col2 |   nvl
     ------+---------
      aaa  | IS NULL
     (1 row)
    

描述

根据值是否为NULL或非NULL返回替代值。

语法

     NVL2(expr anyelement, substitute1 anyelement, substitute2 anyelement) return anyelement
    

通用规则

示例

在以下示例中，如果表t1中列col1中的值为NULL，则返回“IS NULL”，如果不为NULL，则返回“IS NOT NULL”。

     SELECT col2, NVL2(col1,'IS NOT NULL','IS NULL') FROM t1;
      col2 |   nvl2
     ------+---------
      aaa  | IS NULL
      bbb  | IS NOT NULL
     (2 row)
    

描述

ANY_VALUE函数返回表达式（expr）的一个非确定性值。

语法

     ANY_VALUE(expr anyelement) returns anyelement
    

通用规则

注意

参见

示例

create table test_any_value(key1 int, key2 int);
insert into test_any_value values(1, 1);
select any_value(key2)  from test_any_value group by key1;
 any_value
-----------
         1
(1 row)
    

描述

BIT_AND_AGG是一个位运算聚合函数，返回位与运算的结果。

语法

     BIT_AND_AGG(numeric) returns int
    

通用规则

注意

参见

示例

select bit_and_agg(column1)  from (values (1),(2),(4),(8)) x;
 bit_and_agg
-------------
           0
(1 row)
    

描述

BIT_OR_AGG是一个位运算聚合函数，返回位或运算的结果。

语法

     BIT_OR_AGG(numeric) returns int
    

通用规则

注意

参见

示例

select bit_or_agg(column1)  from (values (1),(2),(4),(8)) x;
 bit_or_agg
------------
         15
(1 row)
    

描述

BIT_XOR_AGG是一个位运算聚合函数，返回位异或操作的结果。

语法

     BIT_XOR_AGG(numeric) returns int
    

通用规则

注意

参见

示例

select bit_xor_agg(column1)  from (values (1),(3),(4),(8)) x;
 bit_xor_agg
-------------
          14
(1 row)
    

描述

总体峰度函数KURTOSIS_POP主要用于确定给定分布中的异常值特征。

语法

     KURTOSIS_POP(numeric) returns numeric
    

通用规则

注意

参见

示例

select kurtosis_pop(column1) from  (values (1),(2),(4),(8)) x;
      kurtosis_pop
-------------------------
 -1.09897920604914942667
(1 row)
    

描述

样本峰度(KURTOSIS_SAMP)函数主要用于确定给定分布中的异常值特征。

语法

     KURTOSIS_SAMP(numeric) returns numeric
    

总则

注意

参见

示例

select kurtosis_samp(column1) from  (values (1),(2),(4),(8)) x;
   kurtosis_samp
--------------------
 0.7576559546313793
(1 row)
    

描述

返回一个由字符串值组成的连接的、带分隔符的列表。

语法

     LISTAGG(strExpr TEXT) returns TEXT
     LISTAGG(strExpr TEXT, delimiter TEXT) []returns TEXT
     LISTAGG(strExpr TEXT, delimiter TEXT ON OVERFLOW TRUNCATE) []returns TEXT
     LISTAGG(strExpr TEXT, delimiter TEXT ON OVERFLOW ERROR) []returns TEXT
    

总则

示例

在下面的示例中，返回由表t1中列col2的值组成的、以“:”为分隔符的结果。

     SELECT LISTAGG(col2,':') FROM t1;
           listagg
     -------------------
      AAAAA:BBBBB:CCCCC
     (1 row)
    

在下面的示例中，使用over中的within group。

CREATE TABLE EMP
(   EMPNO    NUMBER(4, 0),
    ENAME    VARCHAR2(10),
    JOB      VARCHAR2(9),
    MGR      NUMBER(4, 0),
    HIREDATE DATE,
    SAL      NUMBER(7, 2),
    COMM     NUMBER(7, 2),
    DEPTNO   NUMBER(2, 0),
    DNAME    VARCHAR2(100),
    CONSTRAINT PK_EMP PRIMARY KEY (EMPNO)
);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7369, 'SMITH',  'CLERK',    7902, to_date('1980-12-17','yyyy-mm-dd'), 800.00,  null,    20, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7499, 'ALLEN',  'SALESMAN', 7698, to_date('1981-02-20','yyyy-mm-dd'), 1600.00, 300.00,  30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7521, 'WARD',   'SALESMAN', 7698, to_date('1981-02-22','yyyy-mm-dd'), 1250.00, 500.00,  30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7566, 'JONES',  'MANAGER',  7839, to_date('1981-04-02','yyyy-mm-dd'), 2975.00, null,    20, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7654, 'MARTIN', 'SALESMAN', 7698, to_date('1981-09-28','yyyy-mm-dd'), 1250.00, 1400.00, 30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7698, 'BLAKE',  'MANAGER',  7839, to_date('1981-05-01','yyyy-mm-dd'), 2850.00, null,    30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7782, 'CLARK',  'MANAGER',  7839, to_date('1981-06-09','yyyy-mm-dd'), 2450.00, null,    10, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7788, 'SCOTT',  'ANALYST',  7566, to_date('1987-04-19','yyyy-mm-dd'), 3000.00, null,    20, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7839, 'KING',   'PRESIDENT',null, to_date('1981-11-17','yyyy-mm-dd'), 5000.00, null,    10, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7844, 'TURNER', 'SALESMAN', 7698, to_date('1981-09-08','yyyy-mm-dd'), 1500.00, 0.00,    30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7876, 'ADAMS',  'CLERK',    7788, to_date('1987-05-23','yyyy-mm-dd'), 1100.00, null,    20, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7900, 'JAMES',  'CLERK',    7698, to_date('1981-12-03','yyyy-mm-dd'), 950.00,  null,    30, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7902, 'FORD',   'ANALYST',  7566, to_date('1981-12-03','yyyy-mm-dd'), 3000.00, null,    20, null);
insert into EMP (EMPNO, ENAME, JOB, MGR, HIREDATE, SAL, COMM, DEPTNO, DNAME) values (7934, 'MILLER', 'CLERK',    7782, to_date('1982-01-23','yyyy-mm-dd'), 1300.00, null,    10, null);

select listagg(ename, ',') within group(order by ename) over(partition by deptno) as enames,
       deptno,
       ename
  from EMP;
                enames                | deptno | ename
--------------------------------------+--------+--------
 CLARK,KING,MILLER                    |     10 | CLARK
 CLARK,KING,MILLER                    |     10 | KING
 CLARK,KING,MILLER                    |     10 | MILLER
 ADAMS,FORD,JONES,SCOTT,SMITH         |     20 | ADAMS
 ADAMS,FORD,JONES,SCOTT,SMITH         |     20 | FORD
 ADAMS,FORD,JONES,SCOTT,SMITH         |     20 | JONES
 ADAMS,FORD,JONES,SCOTT,SMITH         |     20 | SCOTT
 ADAMS,FORD,JONES,SCOTT,SMITH         |     20 | SMITH
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | ALLEN
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | BLAKE
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | JAMES
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | MARTIN
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | TURNER
 ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD |     30 | WARD
(14 rows)

    

描述

计算一组数字的中位数。

语法

     MEDIAN(numExpr REAL) returns REAL
     MEDIAN(numExpr DOUBLE PRECISION) returns DOUBLE PRECISION
    

通用规则

示例

在下面的示例中，返回表t1中列col3的中位数。

     SELECT MEDIAN(col3) FROM t1;
      median
     --------
        2000
     (1 row)
    

描述

SKEWNESS_POP是一个聚合函数，主要用于确定给定分布中的对称性。

语法

     SKEWNESS_POP(numeric) returns numeric
    

通用规则

注意

参见

示例

SELECT SKEWNESS_POP(column1) from  (values (1),(2),(4),(8)) x;
      skewness_pop
------------------------
 0.65680773449969915746
(1 row)
    

描述

SKEWNESS_SAMP是一个聚合函数，主要用于确定给定分布中的对称性。

语法

     SKEWNESS_SAMP(numeric) returns numeric
    

通用规则

注意

参见

示例

SELECT SKEWNESS_SAMP(column1) from  (values (1),(2),(4),(8)) x;
     skewness_samp
------------------------
 1.13762436695768880892
(1 row)
    

描述

返回一个由字符串值组成的连接的、带逗号分隔符的列表。

语法

     WY_CONCAT(strExpr TEXT) returns CLOB
    

总则

示例

在下面的示例中，返回由表t1中列col2的值组成的、以“,”为分隔符的结果。

     SELECT WY_CONCAT(col2) FROM t1;
           wy_concat
     -------------------
      AAAAA,BBBBB,CCCCC
     (1 row)
    

描述

返回一个值的内部信息。

语法

     DUMP(expr TEXT) returns VARCHAR
     DUMP(expr TEXT, fmt INTEGER) returns VARCHAR
    

通用规则

注意

DUMP命令输出的信息将是完整的内部信息。因此，由于产品更新等原因，这些值可能会发生变化。

示例

在下面的示例中，将返回表t1中列col1的内部信息。

     SELECT col1, DUMP(col1) FROM t1;
      col1 |                dump
     ------+------------------------------------
      1001 | Typ=25 Len=8: 32,0,0,0,49,48,48,49
      1002 | Typ=25 Len=8: 32,0,0,0,49,48,48,50
      1003 | Typ=25 Len=8: 32,0,0,0,49,48,48,51
     (3 row)
    

描述

NLS_CHARSET_ID返回与字符集名称字符串对应的字符集ID编号。

语法

     NLS_CHARSET_ID(str text) returns integer
    

通用规则

注意

参见

示例

下面的示例返回字符集的字符集ID：

SELECT NLS_CHARSET_ID('AL32UTF8') FROM DUAL;
 nls_charset_id
----------------
            873
(1 row)
    

描述

NLS_CHARSET_NAME返回与ID编号对应的字符集名称。

语法

     NLS_CHARSET_NAME(str text) returns integer
    

通用规则

注意

参见

示例

下面的示例返回与字符集ID编号873对应的字符集：

SELECT NLS_CHARSET_NAME(873) FROM DUAL;
 nls_charset_name
------------------
 AL32UTF8
(1 row)
    

描述

返回与上下文命名空间相关联的参数在当前时刻的值。

语法

     SYS_CONTEXT(namespace text, parameter text, length int4 default 256) returns text
    

通用规则

注意

LightDB提供以下内置命名空间：

注意

参见

示例

下面的语句返回登录到数据库的用户的名称：

SELECT SYS_CONTEXT ('USERENV', 'SESSION_USER') FROM DUAL;
 sys_context
-------------
 lightdb
(1 row)
    

描述

返回有关当前会话的信息

语法

     USERENV(parameter text) returns text
    

通用规则

注意

参见

示例

下面的示例返回当前会话的LANGUAGE参数：

SELECT USERENV('LANGUAGE') "Language" FROM DUAL;
  Language
-------------
 en_US.UTF-8
(1 row)
    

描述

返回一个空的CLOB

语法

     EMPTY_CLOB() RETURNS clob
    

通用规则

注意

参见

示例

select length(empty_clob()) FROM DUAL;
 length
--------
      0
(1 row)
    

select count(*) from dual where empty_clob() is null;
 count
-------
     0
(1 row)
    

create table foo (a int, b clob default empty_clob());
insert into foo(a) values(1);
insert into foo values (2, 'hello');
select count(*) from foo where b is not null;
 count
-------
     2
(1 row)
select count(*) from foo where length(b) > 0;
 count
-------
     1
(1 row)
    

描述

返回一个空的 BLOB

语法

     EMPTY_BLOB() RETURNS blob
    

通用规则

样例

select length(empty_blob()) FROM DUAL;
 length
--------
      0
(1 row)
    

select count(*) from dual where empty_blob() is null;
 count
-------
     0
(1 row)
    

create table foo (a int, b blob default empty_blob());
insert into foo(a) values(1);
insert into foo values (2, to_blob('616263'));
select count(*) from foo where b is not null;
 count
-------
     2
(1 row)
select count(*) from foo where length(b) > 0;
 count
-------
     1
(1 row)
    

描述

ORA_HASH是一个计算给定表达式哈希值的函数。此函数可用于操作，例如分析数据子集和生成随机样本。

语法

     ORA_HASH(p_data anyelement,p_buckets int4, p_seed int4) RETURNS int
    

通用规则

注意

参见

示例

select ora_hash('abcdAbcdasd'::text) FROM DUAL;
 ora_hash
-----------
 303228277
(1 row)
    

描述

VSIZE函数返回expr内部表示的字节数。如果expr为null，则该函数返回null。

语法

     VSIZE(anyelement) RETURNS integer
    

通用规则

注意

参见

示例

select vsize(123456789) FROM DUAL;
 vsize
-------
     4
(1 row)
    

描述

这些函数用于修改具有视图依赖关系的表。 递归备份所有依赖视图，然后修改基表，最后重新创建所有备份视图。

DEPS_SAVE_AND_DROP_DEPENDENCIES函数用于保存和删除表的依赖关系。

DEPS_RESTORE_DEPENDENCIES函数用于恢复表的依赖关系。

语法

     DEPS_SAVE_AND_DROP_DEPENDENCIES(name, name default current_schema()::name, jsonb default '{}'::jsonb) RETURNS void
     DEPS_RESTORE_DEPENDENCIES(name, name default current_schema()::name, jsonb default '{}'::jsonb)
    

通用规则

注意

示例

create table test_t(key1 int);
create view test_t_v as select * from test_t;
begin;
select deps_save_and_drop_dependencies('test_t');
alter table test_t modify key1 number;
select * from deps_restore_dependencies('test_t');
commit;
    

描述

PLVSTR.IS_PREFIX会在一个字符串或数字是另一个字符串或数字的前缀时返回true。

语法

     PLVSTR.IS_PREFIX(p bigint, prefix bigint) RETURNS boolean
     PLVSTR.IS_PREFIX(p integer, prefix integer) RETURNS boolean
     PLVSTR.IS_PREFIX(p text, prefix text) RETURNS boolean
    

通用规则

例子

select plvstr.is_prefix(111, 11) FROM DUAL;
is_prefix
-----------
t
(1 row)
select plvstr.is_prefix('abc', 'AB') from dual;
is_prefix
 -----------
f
(1 row)
    

描述

判断某个年份是否是闰年

语法

     PLVDATE.ISLEAPYEAR(date) RETURNS boolean
    

示例

select plvdate.isleapyear(date '2023-01-01') FROM DUAL;
isleapyear
-----------
f

select plvdate.isleapyear(date '2020-01-01') from dual;
isleapyear
 -----------
t
    

描述

timestamp_to_scn函数返回一个事务 ID, 该 ID 对应的事务提交时间戳小于或等于给定的时间戳。

语法

     TIMESTAMP_TO_SCN(timestamptz) RETURNS bigint
    

样例

set orafce.timezone = 'Asia/Shanghai';

select timestamp_to_scn(sysdate) FROM DUAL;
timestamp_to_scn
-----------
12345

    

本节将说明DBMS_ALERT的每个功能。

REGISTER

示例

     PERFORM DBMS_ALERT.REGISTER('sample_alert');
    

REMOVE

示例

     PERFORM DBMS_ALERT.REMOVE('sample_alert');
    

REMOVEALL

示例

     PERFORM DBMS_ALERT.REMOVEALL();
    

SIGNAL

示例

     PERFORM DBMS_ALERT.SIGNAL('ALERT001','message001');
    

注意

如果连续发出 SIGNAL，累积的消息超过一定数量，则可能会输出内存不足错误。如果内存不足，请调用 AITANY 或 WAITONE 来接收警报，并减少累积的消息。

WAITANY

示例

     DECLARE
         alert_name         TEXT := 'sample_alert';
         alert_message      TEXT;
         alert_status       INTEGER;
     BEGIN
         SELECT name,message,status INTO alert_name,alert_message,alert_status FROM DBMS_ALERT.WAITANY(60);
    

WAITONE

示例

     DECLARE
         alert_message   TEXT;
         alert_status    INTEGER;
     BEGIN
         SELECT message,status INTO alert_message,alert_status FROM DBMS_ALERT.WAITONE('sample_alert', 60);
    

下面是 DBMS_ALERT 处理流程的使用示例。

DBMS_ALERT 流程

注意

使用示例

     CREATE FUNCTION send_dbms_alert_exe() RETURNS VOID AS $$
     BEGIN
         PERFORM DBMS_ALERT.SIGNAL('sample_alert','SIGNAL ALERT');
     END;
     $$ LANGUAGE plpgsql;
     SELECT send_dbms_alert_exe();
     DROP FUNCTION send_dbms_alert_exe();
    

     CREATE FUNCTION receive_dbms_alert_exe() RETURNS VOID AS $$
     DECLARE
         alert_name    TEXT := 'sample_alert';
     	alert_message TEXT;
     	alert_status  INTEGER;
     BEGIN
     	PERFORM DBMS_ALERT.REGISTER(alert_name);
     	SELECT message,status INTO alert_message,alert_status FROM DBMS_ALERT.WAITONE(alert_name,300);
     	RAISE NOTICE 'Message : %', alert_message;
     	RAISE NOTICE 'Status  : %', alert_status;
     	PERFORM DBMS_ALERT.REMOVE(alert_name);
     END;
     $$ LANGUAGE plpgsql;
     SELECT receive_dbms_alert_exe();
     DROP FUNCTION receive_dbms_alert_exe();
    

本节介绍了 DBMS_ASSERT 的每个特性。

ENQUOTE_LITERAL

示例

     DECLARE
         q_literal    VARCHAR(256);
     BEGIN
         q_literal := DBMS_ASSERT.ENQUOTE_LITERAL('literal_word');
    

ENQUOTE_NAME

参见

有关布尔类型（TRUE/FALSE）值的信息，请参阅LightDB文档中的“The SQL Language”>“Data Types”>“Boolean Type”。

示例

     DECLARE
         dq_literal    VARCHAR(256);
     BEGIN
         dq_literal := DBMS_ASSERT.ENQUOTE_NAME('TBL001');
    

NOOP

示例

     DECLARE
         literal    VARCHAR(256);
     BEGIN
         literal := DBMS_ASSERT.NOOP('NOOP_WORD');
    

OBJECT_NAME

     ERROR:  invalid object name
    

示例

     DECLARE
         object_name    VARCHAR(256);
     BEGIN
         object_name := DBMS_ASSERT.OBJECT_NAME('SCM001.TBL001');
    

QUALIFIED_SQL_NAME

     ERROR:  string is not qualified SQL name
    

参见

关于可以用作标识符的格式的信息，请参阅LightDB文档中的“The SQL Language”>“Lexical Structure”>“Identifiers and Key Words”。

示例

     DECLARE
         object_name    VARCHAR(256);
     BEGIN
         object_name := DBMS_ASSERT.QUALIFIED_SQL_NAME('SCM002.TBL001');
    

SCHEMA_NAME

     ERROR:  invalid schema name
    

示例

     DECLARE
         schema_name    VARCHAR(256);
     BEGIN
         schema_name := DBMS_ASSERT.SCHEMA_NAME('SCM001');
    

SIMPLE_SQL_NAME

     ERROR:  string is not qualified SQL name
    

参见

关于可以用作标识符的格式的信息，请参阅LightDB文档中的“The SQL Language”>“Lexical Structure”>“Identifiers and Key Words”。请注意，如果指定了使用全角字符的标识符，则会出现错误。如果包含全角字符，请指定带引号的标识符。

示例

     DECLARE
         simple_name    VARCHAR(256);
     BEGIN
         simple_name := DBMS_ASSERT.SIMPLE_SQL_NAME('COL01');
    

下面是 DBMS_ASSERT 的使用示例。

     CREATE FUNCTION dbms_assert_exe() RETURNS VOID AS $$
     DECLARE
     	w_schema VARCHAR(20) := 'public';
     	w_table  VARCHAR(20) := 'T1';
     	w_object VARCHAR(40);
     BEGIN
     	PERFORM DBMS_ASSERT.NOOP(w_schema);
     	PERFORM DBMS_ASSERT.SIMPLE_SQL_NAME(w_table);
     	PERFORM DBMS_ASSERT.SCHEMA_NAME(w_schema);
     	w_object := w_schema || '.' || w_table;
     	PERFORM DBMS_ASSERT.QUALIFIED_SQL_NAME(w_object);
     	PERFORM DBMS_ASSERT.OBJECT_NAME(w_object);
     	RAISE NOTICE 'OBJECT     : %', DBMS_ASSERT.ENQUOTE_LITERAL(w_object);
     	RAISE NOTICE 'TABLE_NAME : %', DBMS_ASSERT.ENQUOTE_NAME(w_table);
     END;
     $$
     LANGUAGE plpgsql;
     SELECT dbms_assert_exe();
     DROP FUNCTION dbms_assert_exe();
    

本节解释了DBMS_DATAPUMP的每个功能。

ADD_FILE

示例

DBMS_DATAPUMP.ADD_FILE(HANDLE => hdl, FILENAME => 'example001.dmp', DIRECTORY => 'DMPDIR');
DBMS_DATAPUMP.ADD_FILE(HANDLE => hdl, FILENAME => 'example001.log', DIRECTORY => 'DMPDIR', FILESIZE => '', FILETYPE => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
    

ATTACH

示例

DBMS_DATAPUMP.ATTACH(JOB_NAME => 'example001', JOB_OWNER => 'lightdb')
    

METADATA_FILTER

示例

DBMS_DATAPUMP.METADATA_FILTER(HANDLE => hdl, NAME => 'SCHEMA_EXPR', VALUE => 'LIKE ''%HR%''');
DBMS_DATAPUMP.METADATA_FILTER(HANDLE => hdl, NAME => 'NAME_EXPR', VALUE => 'LIKE ''%EMP%''');
    

OPEN

示例

DBMS_DATAPUMP.OPEN(OPERATION => 'EXPORT', JOB_MODE => 'TABLE', REMOTE_LINK => NULL, JOB_NAME => 'EXAMPLE001', VERSION => 'LATEST');
    

SET_PARAMETER

示例

DBMS_DATAPUMP.SET_PARAMETER(HANDLE => hdl, NAME => 'COMPRESSION', VALUE => 'ALL');
    

SET_PARALLEL

示例

DBMS_DATAPUMP.SET_PARALLEL(HANDLE => hdl, DEGREE => 2);
    

START_JOB

示例

DBMS_DATAPUMP.START_JOB(HANDLE => hdl);
    

STOP_JOB

示例

DBMS_DATAPUMP.STOP_JOB(HANDLE => hdl);
    

WAIT_FOR_JOB

示例

DBMS_DATAPUMP.WAIT_FOR_JOB(HANDLE => hdl,JOB_STATE => jbs);
    

下面是DBMS_DATAPUMP的一个使用示例。

--EXPORT JOB
declare
    hdl numeric;
    jbs varchar2;
begin
    hdl := dbms_datapump.open(operation => 'EXPORT', job_mode => 'TABLE', remote_link => NULL, job_name => 'EXAMPLE001', version => 'LATEST');

    dbms_datapump.add_file(handle => hdl, filename => 'example001.dmp', directory => 'DMPDIR');
    dbms_datapump.add_file(handle => hdl, filename => 'example001.log', directory => 'DMPDIR', filesize => '', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);

    dbms_datapump.metadata_filter(handle => hdl, name => 'NAME_EXPR', value => 'LIKE ''%EMP%''');

    dbms_datapump.set_parameter(handle => hdl, name => 'COMPRESSION', value => 'ALL');
    dbms_datapump.set_parallel(handle => hdl, degree => 2);

    dbms_datapump.start_job(handle => hdl);

    dbms_datapump.wait_for_job(handle => hdl,job_state => jbs);

    dbms_datapump.stop_job(handle => hdl);
end;
/

--IMPORT JOB
declare
    hdl numeric;
    jbs varchar2;
begin
    hdl := dbms_datapump.open(operation => 'IMPORT', job_mode => 'TABLE', remote_link => NULL, job_name => 'EXAMPLE001', version => 'LATEST');

    dbms_datapump.add_file(handle => hdl, filename => 'example001.dmp', directory => 'DMPDIR');
    dbms_datapump.add_file(handle => hdl, filename => 'example001.log', directory => 'DMPDIR', filesize => '', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);

    dbms_datapump.set_parallel(handle => hdl, degree => 2);

    dbms_datapump.start_job(handle => hdl);

    dbms_datapump.wait_for_job(handle => hdl,job_state => jbs);

    dbms_datapump.stop_job(handle => hdl);
end;
/
    

本节介绍了DBMS_LOB的每个特性。

INSTR

例子

     select dbms_lob.INSTR('Thomas', 'om') from  dual;
     select dbms_lob.INSTR('Thomas'::blob, utl_raw.CAST_TO_RAW('om')) from  dual;
    

SUBSTR

例子

     select dbms_lob.substr('1234567',1,2) from  dual;
     select dbms_lob.substr('1234567'::blob,1,2) from  dual;
    

GETLENGTH

例子

     select DBMS_LOB.GETLENGTH('abc') from dual;
    

APPEND

例子

declare
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
begin
    dbms_output.serveroutput(true);
    dbms_lob.append(l_blob, 'ext'::blob);
    dbms_output.put_line(l_blob::text);

    dbms_lob.append(l_clob, 'ext'::clob);
    dbms_output.put_line(l_clob);
end;
/
    

COMPARE

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);
    l_result := dbms_lob.compare('abcd'::blob, 'abcd'::blob);
    dbms_output.put_line(l_result);
    l_result := dbms_lob.compare('abcd'::clob, 'abcd'::clob);
    dbms_output.put_line(l_result);

end;
/
    

COPY

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);
    dbms_lob.copy(l_blob, 'new_blob'::blob, 100);
    dbms_output.put_line(l_blob::text);
    dbms_lob.copy(l_blob, 'xnew_blob'::blob, 100, 1, 2);
    dbms_output.put_line(l_blob::text);
    dbms_lob.copy(l_blob, 'xnew_blob'::blob, 100, 2, 2);
    dbms_output.put_line(l_blob::text);
end;
/
    

ERASE

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);

    l_blob := 'abcd'::blob;
    l_amout := 100;
    dbms_output.put_line(l_blob::text);
    dbms_lob.erase(l_blob, l_amout);
    dbms_output.put_line(l_blob::text);

    l_clob := 'abcd'::clob;
    l_amout := 4;
    dbms_lob.erase(l_clob, l_amout);
    dbms_output.put_line(l_clob);
end;
/
    

READ

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);

    l_amout := 5;
    dbms_lob.read('abcde'::blob, l_amout, 1, l_raw_result);
    dbms_output.put_line(l_raw_result);

    l_amout := 5;
    dbms_lob.read('abcde'::clob, l_amout, 1, l_text_result);
    dbms_output.put_line(l_text_result);
end;
/
    

TRIM

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);

    l_blob := 'abcde'::blob;
    dbms_lob.trim(l_blob, 1);
    dbms_output.put_line(l_blob::text);

    l_clob := 'abcde'::clob;
    dbms_lob.trim(l_clob, 1);
    dbms_output.put_line(l_clob);
end;
/
    

WRITE

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);

    l_blob := 'abcde'::blob;
    dbms_lob.write(l_blob, pg_catalog.length(utl_raw.CAST_TO_RAW('测试')), 2, utl_raw.CAST_TO_RAW('测试'));
    dbms_output.put_line(l_blob::text);

    -- write clob
    l_clob := 'abcde'::clob;
    dbms_lob.write(l_clob, 2, 2,'测试'::text);
    dbms_output.put_line(l_clob);
end;
/
    

WRITEAPPEND

例子

declare
    l_result        int;
    l_blob          blob := 'abcd'::blob;
    l_clob          clob := 'abcd'::clob;
    l_raw_result    raw;
    l_amout         INTEGER := 100;
    l_text_result  text;
begin
    dbms_output.serveroutput(true);

    -- writeappend blob
    l_blob := 'abcde'::blob;
    dbms_lob.writeappend(l_blob, pg_catalog.length(utl_raw.CAST_TO_RAW('测试')), utl_raw.CAST_TO_RAW('测试'));
    dbms_output.put_line(l_blob::text);

    -- write clob
    l_clob := 'abcde'::clob;
    dbms_lob.writeappend(l_clob, 2,'测试'::text);
    dbms_output.put_line(l_clob);
end;
/
    

下面展示了DBMS_LOB的使用示例。

     CREATE PROCEDURE dbms_lob_exe() AS $$
     DECLARE
     	str1 text;
        str2 text;
     	pos INTEGER;
        count INTEGER;
     BEGIN
     	str2 := dbms_lob.substr('1234567',2,3);
        pos := dbms_lob.instr('Tech on the net', 'e');
        count := dbms_lob.getlength('1234567');
        raise info 'str2=%,pos=%,count=%', str2, pos, count;
     END;
     $$ LANGUAGE plpgsql;
     call dbms_lob_exe();
     DROP PROCEDURE dbms_lob_exe();
    

本节详细说明了DBMS_OUTPUT的每个功能。

ENABLE

例子

     PERFORM DBMS_OUTPUT.ENABLE(20000);
    

DISABLE

例子

     PERFORM DBMS_OUTPUT.DISABLE();
    

SERVEROUTPUT

参见

请参阅LightDB文档中的“The SQL Language” > “Data Types” > “Boolean Type”以获取有关布尔类型（TRUE/FALSE）值的信息。

例子

     PERFORM DBMS_OUTPUT.SERVEROUTPUT(TRUE);
    

SET SERVEROUTPUT ON/OFF; 等同于 SELECT DBMS_OUTPUT.SERVEROUTPUT(TRUE/FALSE);。

例子

lightdb@oracle=# SET SERVEROUTPUT ON;
 serveroutput 
--------------
 
(1 row)

lightdb@oracle=# SELECT  DBMS_OUTPUT.PUT_LINE('my serveroutput');
my serveroutput
 put_line 
----------
 
(1 row)

lightdb@oracle=# SET SERVEROUTPUT OFF;
 serveroutput 
--------------
 
(1 row)

lightdb@oracle=#  SELECT  DBMS_OUTPUT.PUT_LINE('my serveroutput');
 put_line 
----------
 
(1 row)

lightdb@oracle=# 
    

PUT

示例

     PERFORM DBMS_OUTPUT.PUT('abc');
    

PUT_LINE

示例

     PERFORM DBMS_OUTPUT.PUT_LINE('abc');
    

NEW_LINE

示例

     PERFORM DBMS_OUTPUT.NEW_LINE();
    

GET_LINE

示例

     DECLARE
         buff1   VARCHAR(20);
         stts1   INTEGER;
     BEGIN
         SELECT line,status INTO buff1,stts1 FROM DBMS_OUTPUT.GET_LINE();
    

GET_LINES

示例

     DECLARE
         buff    VARCHAR(20)[10];
         stts    INTEGER := 10;
     BEGIN
         SELECT lines, numlines INTO buff,stts FROM DBMS_OUTPUT.GET_LINES(stts);
    

下面是DBMS_OUTPUT的一个使用示例。

     CREATE FUNCTION dbms_output_exe() RETURNS VOID AS $$
     DECLARE
     	buff1 VARCHAR(20);
     	buff2 VARCHAR(20);
     	stts1 INTEGER;
     	stts2 INTEGER;
     BEGIN
     	PERFORM DBMS_OUTPUT.DISABLE();
     	PERFORM DBMS_OUTPUT.ENABLE();
     	PERFORM DBMS_OUTPUT.SERVEROUTPUT(FALSE);
     	PERFORM DBMS_OUTPUT.PUT('DBMS_OUTPUT TEST 1');
     	PERFORM DBMS_OUTPUT.NEW_LINE();
     	PERFORM DBMS_OUTPUT.PUT_LINE('DBMS_OUTPUT TEST 2');
     	SELECT line,status INTO buff1,stts1 FROM DBMS_OUTPUT.GET_LINE();
     	SELECT line,status INTO buff2,stts2 FROM DBMS_OUTPUT.GET_LINE();
     	PERFORM DBMS_OUTPUT.SERVEROUTPUT(TRUE);
     	PERFORM DBMS_OUTPUT.PUT_LINE(buff1);
     	PERFORM DBMS_OUTPUT.PUT_LINE(buff2);
     END;
     $$ LANGUAGE plpgsql;
     SELECT dbms_output_exe();
     DROP FUNCTION dbms_output_exe();
    

本节将解释 DBMS_PIPE 的每个特点。

CREATE_PIPE

参见

有关布尔类型（TRUE/FALSE）的信息，请参阅 LightDB 文档中的 "The SQL Language" > "Data Types" > "Boolean Type"。

示例

     PERFORM DBMS_PIPE.CREATE_PIPE('P01', 100, FALSE);
    

NEXT_ITEM_TYPE

示例

     DECLARE
         i_iType    INTEGER;
     BEGIN
         i_iType := DBMS_PIPE.NEXT_ITEM_TYPE();
    

PACK_MESSAGE

*1：字符类型在内部转换为TEXT类型。

*2：整数类型在内部转换为NUMERIC类型。

*3：TIMESTAMP类型在内部转换为带时区的TIMESTAMP类型。

示例

     PERFORM DBMS_PIPE.PACK_MESSAGE('Message Test001');
    

PURGE

示例

     PERFORM DBMS_PIPE.PURGE('P01');
    

注意

执行PURGE操作时，本地缓冲区将用于删除管道中的消息。因此，如果管道中仍有任何消息，本地缓冲区将被PURGE覆盖。

RECEIVE_MESSAGE

示例

     DECLARE
         i_Ret    INTEGER;
     BEGIN
         i_Ret := DBMS_PIPE.RECEIVE_MESSAGE('P01', 60);
    

REMOVE_PIPE

示例

     PERFORM DBMS_PIPE.REMOVE_PIPE('P01');
    

RESET_BUFFER

示例

     PERFORM DBMS_PIPE.RESET_BUFFER();
    

SEND_MESSAGE

示例

     DECLARE
         i_Ret    INTEGER;
     BEGIN
         i_Ret := DBMS_PIPE.SEND_MESSAGE('P01', 10, 20);
    

注意

如果达到最大消息数或正在发送的消息太大，则在发送过程中会发生超时。如果发生超时，请使用RECEIVE_MESSAGE接收管道中的任何消息。

UNIQUE_SESSION_NAME

示例

     DECLARE
         p_Name   VARCHAR(30);
     BEGIN
         p_Name := DBMS_PIPE.UNIQUE_SESSION_NAME();
    

UNPACK_MESSAGE_BYTEA