描述

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
      NLSSORT(str text, 'NLS_SORT=SCHINESE_PINYIN_M') 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)
      

描述

根据由VALUE关键字分隔的键和值列表，构建一个JSON对象。

语法

      JSON_OBJECT(expr VALUE expr, ...) returns json
      

通用规则

注意

对JSON_OBJECT(expr VALUE expr, ...)函数调用，不能在函数前面加模式限定。

键值对数量不能超过100。

示例

在下面的示例中，将返回键值对构成的json文档。

      SELECT JSON_OBJECT('name' VALUE 'John', 'age' VALUE 30) AS json_obj FROM dual;
                json_obj
      -------------------------------
      {"name" : "John", "age" : 30}
      (1 row)
      

描述

JSON数据作为输入并返回其文本表示。

语法

      JSON_SERIALIZE(varchar2) returns json
      

通用规则

注意

JSON_SERIALIZE(varchar2)函数对输入JSON数据格式检查，如果格式有误将返回null。

示例

在下面的示例中，将JSON数据作为输入并返回其文本表示。

      lightdb@oraddd=# SELECT JSON_SERIALIZE ('{"a": {"b":"foo"}}') as json_string FROM dual;
          json_string
      --------------------
      {"a": {"b":"foo"}}
      (1 row)
      

描述

SQL/JSON函数JSON_VALUE在JSON数据中查找指定的标量JSON值。

语法

      JSON_VALUE(expr, path_expression) returns text
      

通用规则

注意

对JSON_VALUE(expr, path_expression)函数调用，不能在函数前面加模式限定。

示例

在下面的示例中，在JSON数据中查找指定路径的标量JSON值。

      select JSON_VALUE('{"key1":"v1","key2":"v2"}', '$.key1');
      json_value
      ------------
      v1
      (1 row)
      

描述

SQL/JSON 函数JSON_TABLE创建JSON数据的关系视图。它将JSON数据评估的结果映射到关系行和列中。您可以使用SQL查询该函数返回的结果作为虚拟关系表。JSON_TABLE的主要目的是为JSON数组中的每个对象创建一行关系数据，并将该对象中的JSON值输出为单独的SQL列值。

语法

      JSON_TABLE(expr, path_expression COLUMNS( column_name Typename [ FORMAT JSON ] PATH path_expression [, column_name [ FORMAT JSON ] PATH path_expression] ))
      

通用规则

注意

您必须仅在SELECT语句的FROM子句中指定JSON_TABLE。

示例

在下面的示例中，查询JSON数据中的特定JSON值。

      SELECT * FROM JSON_TABLE(
          '[{"name":"John","age":30},{"name":"Jane","age":25}]',
          '$[*]' COLUMNS (
              name VARCHAR2(100) PATH '$.name',
              age NUMBER PATH '$.age'
          )
      );
      name | age
      ------+-----
      John |  30
      Jane |  25
      (2 rows)
      

描述

JSON_MERGEPATCH是一种标准化功能，用于使用名为合并补丁的JSON文档修改目标JSON文档。该函数在RFC7396中进行了描述。

语法

      JSON_MERGEPATCH(target_expr, patch_expr)
      

通用规则

注意

JSON_MERGEPATCH 根据目标文档求值补丁文档以生成结果文档。如果目标或补丁文档为NULL，则结果也为NULL。

示例

在下面的示例中，补丁文档合并到目标文档生成结果文档。

      SELECT JSON_MERGEPATCH('{"name":"John","age":30}', '{"age":31,"city":"New York"}') AS json_merged FROM dual;
                        json_merged
      -------------------------------------------------
      {"age": 31, "city": "New York", "name": "John"}
      (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