oceanbase 函数 OceanBase 其他函数

COALESCE

声明

​COALESCE(expr, expr, expr,...)​

说明

依次参考各参数表达式，遇到非 NULL 值即停止并返回该值。如果所有的表达式都是空值，最终将返回一个空值。

所有表达式必须是相同类型，或者可以隐性转换为相同的类型。

例子

obclient> SELECT COALESCE(NULL,NULL,3,4,5), COALESCE(NULL,NULL,NULL);
+---------------------------+--------------------------+
| COALESCE(NULL,NULL,3,4,5) | COALESCE(NULL,NULL,NULL) |
+---------------------------+--------------------------+
|                         3 |                     NULL |
+---------------------------+--------------------------+
1 row in set (0.00 sec)

NVL

声明

​NVL(str1,replace_with)​

说明

如果​ str1​ 为 NULL，则替换成 ​replace_with​。

任何时候给它一个空值，它都返回一个你所选择的值。这种能够自动替换空值的能力有助于提供看上去更为完善的输出。其中​ str1​ 一般是一个列名。​replace_with ​可以是任何值：直接值（即硬编码）、对其他列的引用或者表达式。

例子

obclient> SELECT NVL(NULL, 0), NVL(NULL, 'a');
+--------------+----------------+
| NVL(NULL, 0) | NVL(NULL, 'a') |
+--------------+----------------+
|            0 | a              |
+--------------+----------------+
1 row in set (0.00 sec)

SLEEP

声明

​SLEEP(duration)​

说明

​SLEEP​ 函数根据 ​duration​ 指定的数值暂停相应的时间（单位为秒），并在暂停结束后返回 0。

• 如果 ​SLEEP​ 单独执行且没有被中断，返回结果 0

• 如果 ​SLEEP​ 单独执行期间被中断，返回结果 1，但不会返回任何错误码

• 如果 ​SLEEP​ 是查询的一部分，且暂停期间被中断，将会返回错误码 1317

例子

obclient> SELECT SLEEP(1000);
+------------------+
| SLEEP(1000) |
+------------------+
|          0 |
+------------------+

obclient> SELECT SLEEP(1000);
+------------------+
| SLEEP(1000) |
+------------------+
|          1 |
+------------------+

obclient> SELECT 1 FROM t1 WHERE SLEEP(1000);
ERROR 1317 (70100): Query execution was interrupted

全文查找函数

声明

MATCH (col1,col2,...) AGAINST (expr [search_modifier])
search_modifier:
{
    IN NATURAL LANGUAGE MODE
    | IN NATURAL LANGUAGE MODE WITH QUERY EXPANSION
    | IN BOOLEAN MODE
    | WITH QUERY EXPANSION
}

说明

OceanBase 数据库支持使用全文查找函数来对全文索引进行查找，并且使用全文查找函数有以下要求：

• 全文查找函数 MATCH(col1,col2,...) 中指定的列上必须有全文索引（目前只支持 FULLTEXT CTXCAT 索引）

• 在 FULLTEXT CTXCAT 索引中，全文查找函数 MATCH(col1,col2,...) 中指定的列必须完整的覆盖索引中的全文列，例如 FULLTEXT INDEX(c1, c2, c3), CTXCAT(c2, c3) 必须是 MATCH(c2,c3) 才能完全的匹配

• 全文查找函数可以通过上述的关键字来指定查找模式（目前只支持 NATURAL LANGUAGE MODE 和 BOOLEAN MODE 两种模式），缺省是 NATURAL LANGUAGE MODE

默认情况下或者指定 IN NATURAL LANGUAGE MODE 标示符，MATCH…AGAINST 将使用 NATURAL LANGUAGE 模式来进行全文查找，在 NATURAL LANGUAGE 模式下，AGAINST 接受一个查找字符串，并且按照字符集的比较方式在索引中进行查找，对于表中的每一行数据，MATCH 的返回值代表了查找字符串和行中数据的相关度，也就是查找字符串中的文本和数据表中的文本相似度。在默认情况下，OceanBase 数据库创建的字符串相关的列是大小写不敏感的，因此，全文查找的关键字是不区分大小写的。如果需要区分大小写，可以为创建全文索引的列指定大小写敏感的数据类型，例如 UTF8MB4_BIN。如果 MATCH...AGAINST 函数被用在 WHERE 子句中，MATCH 被用来过滤跟关键字相关度不匹配的数据，MATCH...AGAINST=0 表示没有和关键字相似的数据，目前只支持 MATCH...AGAINST=0 和 MATCH...AGAINST>0 两种形式，即完全不相关或者有任意一个关键字相关即可。AGAINST 参数中可以接受多个关键字，关键字之间使用‘ ’隔开，表示 OR 关系，只要有任意一个关键字匹配，即认为符合查找的要求。

可以通过使用 IN BOOLEAN MODE 关键字来进行 BOOLEAN 模式的全文查找。在这种模式中，关键字前面一些特殊的操作符含有特殊的语义。例如：

SELECT * FROM t1 WHERE MATCH (a, b) AGAINST ('菊花 茉莉花' IN BOOLEAN MODE);
+----+------------+------------+
| id | a            | b            |
+----+------------+------------+
|  1 | 支付宝        | 菊花茶        |
|  2 | 淘宝          | 茉莉花        |
+----+------------+------------+

SELECT * FROM t1 WHERE MATCH (a, b)
    AGAINST ('+菊花 -茉莉花' IN BOOLEAN MODE);
+----+------------+------------+
| id | a            | b            |
+----+------------+------------+
|  1 | 支付宝        | 菊花茶        |
+----+------------+------------+

OceanBase 数据库的 BOOLEAN 全文查找目前支持以下几种操作符：

• + 代表 AND 关系，表示查找结果中同时要包含被 + 修饰的关键字
• - 代表 NOT 关系，表示查找结果中不能包含被 - 修饰的关键字。
• (no operator) 代表 OR 关系，表示查找结果中只要包含任意一个没有操作符修饰的关键字即可

在 BOOLEAN全文 查找模式中有以下几点需要注意：

• 操作符必须位于关键字的前面，关键字后面的操作符没有修饰意义，例如：“+菊花”是有意义的操作符修饰，而“菊花+”中的操作符没有修饰意义。
• 操作符和关键字必须紧密相连，不能被其它符号分割开，否则没有修饰意义，例如：“+ 菊花”前面的操作符没有修饰意义。