说明

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

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

例子

声明

NVL(str1,replace_with)

说明

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

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

声明

SLEEP(duration)

说明

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

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

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

例子

声明

说明

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

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

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

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

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

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