OceanBase 其他函數(shù)

COALESCE

聲明

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

說(shuō)明

依次參考各參數(shù)表達(dá)式，遇到非 NULL 值即停止并返回該值。如果所有的表達(dá)式都是空值，最終將返回一個(gè)空值。

所有表達(dá)式必須是相同類型，或者可以隱性轉(zhuǎn)換為相同的類型。

例子

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)?

說(shuō)明

如果? str1? 為 NULL，則替換成 ?replace_with?。

任何時(shí)候給它一個(gè)空值，它都返回一個(gè)你所選擇的值。這種能夠自動(dòng)替換空值的能力有助于提供看上去更為完善的輸出。其中? str1? 一般是一個(gè)列名。?replace_with ?可以是任何值：直接值（即硬編碼）、對(duì)其他列的引用或者表達(dá)式。

例子

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)?

說(shuō)明

?SLEEP? 函數(shù)根據(jù) ?duration? 指定的數(shù)值暫停相應(yīng)的時(shí)間（單位為秒），并在暫停結(jié)束后返回 0。

• 如果 ?SLEEP? 單獨(dú)執(zhí)行且沒(méi)有被中斷，返回結(jié)果 0

• 如果 ?SLEEP? 單獨(dú)執(zhí)行期間被中斷，返回結(jié)果 1，但不會(huì)返回任何錯(cuò)誤碼

• 如果 ?SLEEP? 是查詢的一部分，且暫停期間被中斷，將會(huì)返回錯(cuò)誤碼 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

全文查找函數(shù)

聲明

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
}

說(shuō)明

OceanBase 數(shù)據(jù)庫(kù)支持使用全文查找函數(shù)來(lái)對(duì)全文索引進(jìn)行查找，并且使用全文查找函數(shù)有以下要求：

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

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

• 全文查找函數(shù)可以通過(guò)上述的關(guān)鍵字來(lái)指定查找模式（目前只支持 NATURAL LANGUAGE MODE 和 BOOLEAN MODE 兩種模式），缺省是 NATURAL LANGUAGE MODE

默認(rèn)情況下或者指定 IN NATURAL LANGUAGE MODE 標(biāo)示符，MATCH…AGAINST 將使用 NATURAL LANGUAGE 模式來(lái)進(jìn)行全文查找，在 NATURAL LANGUAGE 模式下，AGAINST 接受一個(gè)查找字符串，并且按照字符集的比較方式在索引中進(jìn)行查找，對(duì)于表中的每一行數(shù)據(jù)，MATCH 的返回值代表了查找字符串和行中數(shù)據(jù)的相關(guān)度，也就是查找字符串中的文本和數(shù)據(jù)表中的文本相似度。在默認(rèn)情況下，OceanBase 數(shù)據(jù)庫(kù)創(chuàng)建的字符串相關(guān)的列是大小寫不敏感的，因此，全文查找的關(guān)鍵字是不區(qū)分大小寫的。如果需要區(qū)分大小寫，可以為創(chuàng)建全文索引的列指定大小寫敏感的數(shù)據(jù)類型，例如 UTF8MB4_BIN。如果 MATCH...AGAINST 函數(shù)被用在 WHERE 子句中，MATCH 被用來(lái)過(guò)濾跟關(guān)鍵字相關(guān)度不匹配的數(shù)據(jù)，MATCH...AGAINST=0 表示沒(méi)有和關(guān)鍵字相似的數(shù)據(jù)，目前只支持 MATCH...AGAINST=0 和 MATCH...AGAINST>0 兩種形式，即完全不相關(guān)或者有任意一個(gè)關(guān)鍵字相關(guān)即可。AGAINST 參數(shù)中可以接受多個(gè)關(guān)鍵字，關(guān)鍵字之間使用‘ ’隔開(kāi)，表示 OR 關(guān)系，只要有任意一個(gè)關(guān)鍵字匹配，即認(rèn)為符合查找的要求。

可以通過(guò)使用 IN BOOLEAN MODE 關(guān)鍵字來(lái)進(jìn)行 BOOLEAN 模式的全文查找。在這種模式中，關(guān)鍵字前面一些特殊的操作符含有特殊的語(yǔ)義。例如：

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 數(shù)據(jù)庫(kù)的 BOOLEAN 全文查找目前支持以下幾種操作符：

• + 代表 AND 關(guān)系，表示查找結(jié)果中同時(shí)要包含被 + 修飾的關(guān)鍵字
• - 代表 NOT 關(guān)系，表示查找結(jié)果中不能包含被 - 修飾的關(guān)鍵字。
• (no operator) 代表 OR 關(guān)系，表示查找結(jié)果中只要包含任意一個(gè)沒(méi)有操作符修飾的關(guān)鍵字即可

在 BOOLEAN全文 查找模式中有以下幾點(diǎn)需要注意：

• 操作符必須位于關(guān)鍵字的前面，關(guān)鍵字后面的操作符沒(méi)有修飾意義，例如：“+菊花”是有意義的操作符修飾，而“菊花+”中的操作符沒(méi)有修飾意義。
• 操作符和關(guān)鍵字必須緊密相連，不能被其它符號(hào)分割開(kāi)，否則沒(méi)有修飾意義，例如：“+ 菊花”前面的操作符沒(méi)有修飾意義。