COALESCE

声明

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

说明

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

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

例子

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

NVL

声明

NVL(str1,replace_with)

说明

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

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

例子

  1. obclient> SELECT NVL(NULL, 0), NVL(NULL, 'a');
  2. +--------------+----------------+
  3. | NVL(NULL, 0) | NVL(NULL, 'a') |
  4. +--------------+----------------+
  5. |            0 | a              |
  6. +--------------+----------------+
  7. 1 row in set (0.00 sec)

SLEEP

声明

SLEEP(duration)

说明

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

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

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

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

例子

  1. obclient> SELECT SLEEP(1000);
  2. +------------------+
  3. | SLEEP(1000) |
  4. +------------------+
  5. |          0 |
  6. +------------------+
  8. obclient> SELECT SLEEP(1000);
  9. +------------------+
  10. | SLEEP(1000) |
  11. +------------------+
  12. |          1 |
  13. +------------------+
  15. obclient> SELECT 1 FROM t1 WHERE SLEEP(1000);
  16. ERROR 1317 (70100): Query execution was interrupted

全文查找函数

声明

  1. MATCH (col1,col2,...) AGAINST (expr [search_modifier])
  2. search_modifier:
  3. {
  4.     IN NATURAL LANGUAGE MODE
  5.     | IN NATURAL LANGUAGE MODE WITH QUERY EXPANSION
  6.     | IN BOOLEAN MODE
  7.     | WITH QUERY EXPANSION
  8. }

说明

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 模式的全文查找。在这种模式中，关键字前面一些特殊的操作符含有特殊的语义。例如：

  1. SELECT * FROM t1 WHERE MATCH (a, b) AGAINST ('菊花 茉莉花' IN BOOLEAN MODE);
  2. +----+------------+------------+
  3. | id | a            | b            |
  4. +----+------------+------------+
  5. |  1 | 支付宝        | 菊花茶        |
  6. |  2 | 淘宝          | 茉莉花        |
  7. +----+------------+------------+
  9. SELECT * FROM t1 WHERE MATCH (a, b)
  10.     AGAINST ('+菊花 -茉莉花' IN BOOLEAN MODE);
  11. +----+------------+------------+
  12. | id | a            | b            |
  13. +----+------------+------------+
  14. |  1 | 支付宝        | 菊花茶        |
  15. +----+------------+------------+

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

  • + 代表 AND 关系，表示查找结果中同时要包含被 + 修饰的关键字

  • - 代表 NOT 关系，表示查找结果中不能包含被 - 修饰的关键字。

  • (no operator) 代表 OR 关系，表示查找结果中只要包含任意一个没有操作符修饰的关键字即可

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

  • 操作符必须位于关键字的前面，关键字后面的操作符没有修饰意义，例如：“+菊花”是有意义的操作符修饰，而“菊花+”中的操作符没有修饰意义。

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