全文查询

全文查询是指在文本数据中进行全文搜索或检索的操作。全文查询能够更全面地搜索整个文本，并返回与搜索条件匹配的结果。

语法

使用以下语句进行全文索引查询，指定全文索引列，查找与 search_query 的匹配程度，返回结果为非负数的 DOUBLE，表示该行与 search_query 的相关程度，0 表示没有相关性。

CONTAINS(indexed_column, 'search_query' [, score_label])

SCORE(score_label)

参数说明：

• indexed_column：表示全文索引的列名。

• search_query：VARCHAR2 类型或 CLOB 类型，表示需要搜索的关键字或短语。支持搜索操作符如下：

  • 空格：表示连续短语匹配，按顺序匹配紧邻出现的词。例如 'word1 word2'。支持使用双引号 "" 或大括号 {} 的转义，例如搜索连续短语 "law and order"，直接写 'law and order' 会被解析为 law AND order（逻辑与），解决方法：

    • 使用大括号：'{law and order}'。
    • 使用双引号：'"law and order"'。

  说明

  如果 search_query 参数的查询内容在对应分词器下产生的分词数量过多，可能会导致系统资源消耗增加、响应变慢，甚至影响查询性能。建议保持查询简洁、合理，以获得最佳执行效率。

• score_label：可选参数，NUMBER 类型，表示返回结果的匹配编号。

• SCORE()：可选参数，NUMBER 类型，与 score_label 结合使用，score_label 必须是为 CONTAINS 指定的 score_label，NUMBER 类型，用来输出CONTAINS 的匹配得分（越接近相关性越高）。

使用限制及注意事项

• indexed_column 不存在时，会报错。
• indexed_column 未创建全文索引时，会报错。
• search_query 为 NULL 时，会报错。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, NULL, 1) > 0;。
• search_query 为空字符串时，返回空。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, '', 1) > 0;。
• search_query 为全空格时，返回空。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, ' ', 1) > 0;。
• score_label 为负数时，会报错。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, 'OceanBase', -1) > 0;。
• SCORE 标签未定义时，会报错。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, 'OceanBase', 1) > 0 ORDER BY SCORE(999);。
• SCORE 出现在无 CONTAINS 上下文时，会报错。例如 SELECT SCORE(1) FROM tbl1;。
• 不支持在 GROUP BY、HAVING 子句中使用 SCORE。
• CONTAINS 未比较时，会报错。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, 'OceanBase', 1);。
• CONTAINS 使用小于、等于或小于等于的比较时，会报错。例如 SELECT col1 FROM tbl1 WHERE CONTAINS(col2, 'OceanBase', 1) <= 0;。
• 带全文 filter 的连表查询/表重命名会报错时，会报错。例如 SELECT SCORE(1) FROM tbl2 t1 WHERE CONTAINS(t1.col2, 'OceanBase', 1) >0;。

示例

1. 创建表 tbl1。

   obclient> CREATE TABLE tbl1(
       col1 INT,
       col2 CHAR(50),
       col3 VARCHAR2(500));
   

2. 创建全文索引 ft_idx1_tbl1。

   obclient> CREATE INDEX ft_idx1_tbl1 ON tbl1(col2)
       INDEXTYPE IS CTXSYS.CONTEXT
       PARAMETERS('LEXER SPACE')
       LOCAL;
   

3. 创建全文索引 ft_idx2_tbl1。

   obclient> CREATE INDEX ft_idx2_tbl1 ON tbl1(col3)
       INDEXTYPE IS CTXSYS.CONTEXT
       PARAMETERS('LEXER SPACE')
       LOCAL;
   

4. 向表 tbl1 中添加测试数据。

   obclient> INSERT INTO tbl1 (col1, col2, col3) VALUES 
       (1, 'Hello World', 'This is a test'),
       (2, 'OceanBase', 'OceanBase Database is a native, enterprise-level distributed database developed independently by the OceanBase team'),
       (3, 'Database Management', 'Learn about SQL and database administration'),
       (4, 'Full Text Searching', 'Master the art of full text searching');
   

   返回结果如下：

   Query OK, 4 rows affected
   Records: 4  Duplicates: 0  Warnings: 0
   

5. 使用 CONTAINS 查询。

   obclient> SELECT *
       FROM tbl1
       WHERE CONTAINS(col2, 'OceanBase', 1) > 0;
   

   返回结果如下：

   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+
   | COL1 | COL2                                               | COL3                                                                                                                |
   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+
   |    2 | OceanBase                                          | OceanBase Database is a native, enterprise-level distributed database developed independently by the OceanBase team |
   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+
   1 row in set
   

6. 使用 CONTAINS 查询，并根据 SCORE 排序。

   obclient> SELECT col1, col2, col3, SCORE(1)
       FROM tbl1
       WHERE CONTAINS(col2, 'Database', 1) > 0
       AND col1 >= 2
       ORDER BY SCORE(1) DESC;
   

   返回结果如下：

   +------+----------------------------------------------------+---------------------------------------------+------------------------+
   | COL1 | COL2                                               | COL3                                        | SCORE(1)               |
   +------+----------------------------------------------------+---------------------------------------------+------------------------+
   |    3 | Database Management                                | Learn about SQL and database administration | 1.259496819494492E+000 |
   +------+----------------------------------------------------+---------------------------------------------+------------------------+
   1 row in set
   

7. 多个查询，并使用 score_label 结合 SCORE 输出结果。

   obclient> SELECT col1, col2, col3, SCORE(10), SCORE(20) 
       FROM tbl1
       WHERE CONTAINS (col2, 'Database', 10) > 0
       OR CONTAINS (col3, 'OceanBase', 20) > 0 
       ORDER BY SCORE(10), SCORE(20);
   

   返回结果如下：

   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+------------------------+-------------------------+
   | COL1 | COL2                                               | COL3                                                                                                                | SCORE(10)              | SCORE(20)               |
   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+------------------------+-------------------------+
   |    2 | OceanBase                                          | OceanBase Database is a native, enterprise-level distributed database developed independently by the OceanBase team |                      0 | 1.1331643117640413E+000 |
   |    3 | Database Management                                | Learn about SQL and database administration                                                                         | 1.259496819494492E+000 |                       0 |
   +------+----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------+------------------------+-------------------------+
   2 rows in set
   

相关文档

• 创建索引
• 全文索引