⌘+k ctrl+k
1.4 (LTS)
搜索快捷键 cmd + k | ctrl + k
全文搜索

DuckDB 通过 fts 扩展支持全文搜索。全文索引允许查询快速搜索长文本字符串中单个单词的所有出现位置。

示例:莎士比亚语料库

以下是构建莎士比亚戏剧全文索引的示例。

CREATE TABLE corpus AS
    SELECT * FROM 'https://blobs.duckdb.org/data/shakespeare.parquet';
DESCRIBE corpus;
列名 (column_name) 列类型 (column_type) null key 默认值 (default) 额外信息 (extra)
line_id VARCHAR 是 (YES) NULL NULL NULL
play_name VARCHAR 是 (YES) NULL NULL NULL
line_number VARCHAR 是 (YES) NULL NULL NULL
speaker VARCHAR 是 (YES) NULL NULL NULL
text_entry VARCHAR 是 (YES) NULL NULL NULL

每一行的文本位于 text_entry 中,每一行的唯一键位于 line_id 中。

创建全文搜索索引

首先,我们创建索引,指定表名、唯一 ID 列以及要索引的列。我们将仅索引 text_entry 这一列,其中包含戏剧中台词的文本。

PRAGMA create_fts_index('corpus', 'line_id', 'text_entry');

现在可以使用 Okapi BM25 排名函数对该表进行查询。没有匹配项的行将返回 NULL 分数。

莎士比亚关于黄油(butter)说了些什么?

SELECT
    fts_main_corpus.match_bm25(line_id, 'butter') AS score,
    line_id, play_name, speaker, text_entry
FROM corpus
WHERE score IS NOT NULL
ORDER BY score DESC;
score line_id play_name speaker text_entry
4.427313429798464 H4/2.4.494 亨利四世 搬运工 像黄油一样肥。
3.836270302568675 H4/1.2.21 亨利四世 福斯塔夫 蛋和黄油的序幕。
3.836270302568675 H4/2.1.55 亨利四世 内侍 他们已经起床,要吃蛋和黄油;
3.3844488405497115 H4/4.2.21 亨利四世 福斯塔夫 烤面包加黄油,心里却没有
3.3844488405497115 H4/4.2.62 亨利四世 亨利王子 已经把你做成了黄油。但告诉我,杰克,谁的
3.3844488405497115 AWW/4.1.40 终成眷属 帕罗尔 黄油贩子的嘴,并给自己买另一个
3.3844488405497115 AYLI/3.2.93 皆大欢喜 试金石 像去市场的黄油贩子一样排队。
3.3844488405497115 KL/2.4.132 李尔王 弄臣 对他的马很好,给它的干草抹上了黄油。
3.0278411214953107 AWW/5.2.9 终成眷属 小丑 从此不再吃任何命运黄油抹过的鱼。
3.0278411214953107 MWW/2.2.260 温莎的风流娘儿们 福斯塔夫 绞死他,那个机械的咸黄油流氓!我将
3.0278411214953107 MWW/2.2.284 温莎的风流娘儿们 福特 宁愿相信一个弗莱明人能保管我的黄油,休牧师
3.0278411214953107 MWW/3.5.7 温莎的风流娘儿们 福斯塔夫 我要把我的大脑拿出来抹上黄油,然后给
3.0278411214953107 MWW/3.5.102 温莎的风流娘儿们 福斯塔夫 热得像黄油;一个不断溶解的人
2.739219044070792 H4/2.4.115 亨利四世 亨利王子 你难道从未见过泰坦亲吻一盘黄油吗?

与标准索引不同,全文索引不会随着底层数据的更改而自动更新,因此您需要 PRAGMA drop_fts_index(my_fts_index) 并在适当的时候重新创建它。

关于生成语料库表的说明

有关更多详细信息,请参阅 “从 JSON 生成用于全文搜索的莎士比亚语料库”博客文章

  • 各列为:line_id, play_name, line_number, speaker, text_entry。
  • 为了使全文搜索正常工作,我们需要为每一行提供一个唯一键。
  • line_id KL/2.4.132 的意思是《李尔王》,第 2 幕,第 4 场,第 132 行。
© 2025 DuckDB 基金会,阿姆斯特丹,荷兰
行为准则 商标使用指南