Manticore Search 表结构及设置更新指南

Manticore Search 表结构及设置更新指南

manticoresearch manticoresoftware/manticoresearch: 这是一个用于快速搜索和索引数据的搜索引擎。适合用于需要快速搜索和索引数据的场景。特点：易于使用，支持多种数据格式，具有高性能和可扩展性。 项目地址: https://gitcode.com/gh_mirrors/ma/manticoresearch

概述

本文将详细介绍如何在 Manticore Search 中更新表结构和设置。作为一款高性能的全文搜索引擎，Manticore Search 提供了灵活的 ALTER TABLE 语法来满足不同场景下的表结构调整需求。

RT模式下的表结构更新

基本语法

在实时(RT)模式下，可以使用以下语法修改表结构：

-- 添加列
ALTER TABLE 表名 ADD COLUMN 列名 数据类型 [engine='columnar']

-- 删除列
ALTER TABLE 表名 DROP COLUMN 列名

-- 修改列类型
ALTER TABLE 表名 MODIFY COLUMN 列名 新数据类型

支持的数据类型

Manticore Search 支持丰富的数据类型，包括但不限于：

• 数值类型：INT/INTEGER、BIGINT、FLOAT
• 布尔类型：BOOL
• 时间类型：TIMESTAMP
• 复合类型：MULTI(多值整数)、MULTI_LARGE(多值大整数)、JSON
• 字符串类型：STRING/TEXT
• 全文索引类型：支持多种索引存储组合

重要注意事项

1. 备份优先：执行 ALTER 操作前强烈建议备份表文件，以防意外断电导致数据损坏
2. 操作限制：添加列时表不可查询；不支持分布式表；不能删除 id 列
3. 字段特性：
   • 新添加的列默认值为0
   • 同时作为全文字段和字符串属性的列需要分两次删除
4. 存储引擎：可为属性指定 engine='columnar' 使用列式存储(JSON类型除外)

实际操作示例

-- 查看表结构
DESC rt;

-- 添加整数列
ALTER TABLE rt ADD COLUMN test integer;

-- 删除列
ALTER TABLE rt DROP COLUMN group_id;

-- 添加全文索引字段
ALTER TABLE rt ADD COLUMN title text indexed;

-- 添加字符串属性
ALTER TABLE rt ADD COLUMN title text attribute;

RT模式下的全文设置更新

语法说明

ALTER TABLE 表名 全文设置名='值'[, 全文设置名2='值']

特性说明

1. 仅影响新文档：修改全文设置仅对新插入的文档生效
2. 字符表示例：修改 charset_table 后，已有文档仍使用旧字符表处理
3. 查询优化：系统会自动为不同版本的文档使用合适的处理方式

实际操作示例

-- 创建表并限制可搜索字符
CREATE TABLE rt(title text) charset_table='a,b,c';

-- 插入文档并查询
INSERT INTO rt(title) VALUES('abcd');
SELECT * FROM rt WHERE MATCH('abcd');

-- 扩展可搜索字符
ALTER TABLE rt charset_table='a,b,c,d';

-- 新文档将使用新字符表
INSERT INTO rt(title) VALUES('abcd');
SELECT * FROM rt WHERE MATCH('abcd');

表重命名操作

语法说明

ALTER TABLE 原表名 RENAME 新表名;

注意事项

1. 此功能需要额外组件的支持
2. 仅适用于实时(RT)模式下的表

普通模式下的表重建

语法说明

ALTER TABLE 表名 RECONFIGURE

特性说明

1. 配置更新：使配置文件中的新分词、词法分析等设置生效
2. 不影响已有数据：仅对新文档应用新设置
3. 内部机制：强制将当前RAM块保存为新磁盘块并调整表头

二级索引重建

语法说明

ALTER TABLE 表名 REBUILD SECONDARY

使用场景

1. 属性更新后二级索引被禁用
2. 加载旧版本二级索引时自动禁用
3. 需要更新到新版本索引功能

分布式表修改

语法说明

ALTER TABLE 分布式表名 [local='本地表名'], [agent='主机:端口:远程表'] ...

注意事项

1. 修改分布式表需要额外组件的支持
2. 语法与创建时类似，只需将CREATE改为ALTER

最佳实践建议

1. 变更前备份：任何结构变更前都应备份数据
2. 分批操作：大量变更考虑分批执行
3. 监控影响：关注变更期间的性能影响
4. 测试验证：在生产环境应用前充分测试

通过本文介绍的各种ALTER操作，您可以灵活调整Manticore Search表结构，满足业务发展需求。根据具体场景选择合适的变更方式，并遵循最佳实践，可以确保变更过程平稳可靠。

manticoresearch manticoresoftware/manticoresearch: 这是一个用于快速搜索和索引数据的搜索引擎。适合用于需要快速搜索和索引数据的场景。特点：易于使用，支持多种数据格式，具有高性能和可扩展性。 项目地址: https://gitcode.com/gh_mirrors/ma/manticoresearch