索引
自 2.5 引入
在 **索引管理** 部分,您可以执行 索引 API 中可用的操作。
索引策略
策略是定义索引可能状态、当索引进入给定状态时要执行的操作以及状态之间转换必须满足的条件的配置。
- 状态:索引的可能状态,包括新索引的默认状态。例如,您可以将状态命名为
hot
、warm
或delete
。更多信息,请参阅状态。 - 操作:当索引进入给定状态时,您希望插件执行的任何操作,例如执行翻转。更多信息,请参阅操作。
- 转换:索引进入新状态必须满足的条件。例如,如果索引超过 8 周,您可能希望将其移至
delete
状态。更多信息,请参阅转换。
您还可以上传 JSON 文档来指定索引策略。
您可以完全灵活地设计策略。您可以创建任何状态,转换为任何其他状态,并在每个状态中指定任意数量的操作。
要将策略附加到索引,请执行以下步骤:
- 在 **索引管理** 下,选择 **索引策略**。
- 选择要将策略附加到的一个或多个索引。
- 选择 **应用策略** 按钮。
- 从 **策略 ID** 菜单中,选择您创建的策略。查看策略预览。
- (可选):如果您的策略包含翻转操作,请指定一个翻转别名。请确保该别名已存在。有关翻转操作的更多信息,请参阅翻转。
- 选择 **应用** 按钮。
将策略附加到索引后,索引状态管理 (ISM) 会创建一个作业,该作业默认每 5 分钟运行一次,以执行策略操作、检查条件并将索引转换为不同状态。要更改此作业的默认时间间隔,请参阅设置。
如果集群状态为红色,则策略作业不会运行。
托管索引
要将策略附加到索引,请执行以下步骤:
- 在 **索引管理** 下,选择 **管理索引**。
- 选择要将策略附加到的一个或多个索引。
- 选择 **更改策略** 按钮。
- 选择 **应用策略** 按钮。
索引
**索引** 部分显示 OpenSearch 集群中的索引列表。对于每个索引,您可以看到其健康状态(绿色
、黄色
或 红色
)、策略(如果索引由策略管理)、状态、总大小、主分片大小、文档总数、已删除文档、主分片数和副本数。
以下是三种索引健康状态:
- 绿色:所有主分片和副本分片均已分配。
- 黄色:至少一个副本分片未分配。
- 红色:至少一个主分片未分配。
创建索引
虽然您可以使用文档作为基础创建索引,但您也可以创建空索引以供以后使用。
要创建索引,请选择 **索引管理** 部分 **索引** 下方的 **创建索引** 按钮。然后通过设置以下参数来定义索引:
- 索引名称
- 主分片数量
- 副本数量
- 刷新间隔
您还可以使用可视化编辑器或 JSON 编辑器添加字段和对象。
**高级设置** 允许您上传 JSON 配置。
应用策略
如果您分析时间序列数据,您可能希望优先处理新数据而不是旧数据。您可能需要定期对旧索引执行某些操作,例如减少副本数量或删除它们。
ISM 是一个插件,它允许您根据索引年龄、索引大小或文档数量的变化触发定期管理操作的自动化。您可以定义策略来自动处理索引翻转或删除,以适应您的用例。
例如,您可以定义一个策略,在 30 天后将您的索引移至 **read_only** 状态,然后在 90 天的设定期限后将其删除。您还可以设置策略,以便在索引被删除时向您发送通知消息。
您可能希望在一定时间后执行索引翻转,或者在非高峰时段对索引运行 **force_merge** 操作,以提高高峰时段的搜索性能。
要应用策略,请从 **索引管理** 下的 **索引** 列表中选择要应用策略的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **应用策略**,如下图所示。
关闭索引
关闭索引操作会关闭一个索引。索引关闭后,您无法向其中添加数据或搜索其中的任何数据。
要关闭索引,请从 **索引管理** 下的 **索引** 列表中选择要关闭的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **关闭**。
打开索引
打开索引操作会打开一个已关闭的索引,允许您向其中添加数据或搜索其中的数据。
要打开索引,请从 **索引管理** 下的 **索引** 列表中选择要打开的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **打开**。
重建索引
重建索引操作允许您将所有数据或部分数据从源索引复制到目标索引。
要重建索引,请从 **索引管理** 下的 **索引** 列表中选择索引。然后选择 **操作** 按钮,并从下拉列表中选择 **重建索引**,如下图所示。
缩减索引
缩减索引操作会将现有索引中的所有数据复制到一个新的主分片更少的索引中。
要缩减索引,请从 **索引管理** 下的 **索引** 列表中选择要缩减的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **缩减**,如下图所示。
拆分索引
拆分索引操作将现有只读索引拆分为一个新索引,将每个主分片拆分成新索引中的多个主分片。
要拆分索引,请从 **索引管理** 下的 **索引** 列表中选择要拆分的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **拆分**,如下图所示。
刷新索引
刷新索引使索引的新更新对搜索操作可见。
刷新操作只能应用于开放索引。
要刷新所有索引,请从 **操作** 下拉列表中选择 **刷新**。
要刷新特定索引,请从 **索引管理** 下的 **索引** 列表中选择该索引。然后从 **操作** 下拉列表中选择 **刷新**。
刷新索引(写入磁盘)
刷新(flush)操作执行 Lucene 提交,将段写入磁盘并启动新的事务日志。
刷新操作只能应用于开放索引。
要刷新所有索引,请从 **操作** 下拉列表中选择 **刷新**。
要刷新特定索引,请从 **索引管理** 下的 **索引** 列表中选择该索引。然后从 **操作** 下拉列表中选择 **刷新**。
清除索引缓存
清除缓存操作只能应用于开放索引。
要清除所有索引缓存,请从 **操作** 下拉列表中选择 **清除缓存**。
要清除特定索引缓存,请从 **索引管理** 下的 **索引** 列表中选择该索引。然后从 **操作** 下拉列表中选择 **清除缓存**。
删除索引
如果您不再需要某个索引,可以使用删除索引操作将其删除。
要删除索引,请从 **索引管理** 下的 **索引** 列表中选择要删除的索引。然后选择 **操作** 按钮,并从下拉列表中选择 **删除**。
模板
索引模板允许您使用预定义的映射和设置初始化新索引。例如,如果您持续索引日志数据,您可以定义一个索引模板,使所有索引具有相同数量的分片和副本,如下图所示。
创建模板
要创建模板,请在 **索引管理** 下的 **模板** 页面上选择 **创建模板** 按钮。
接下来,定义模板:
- 输入模板名称。
- 选择模板类型。
- 指定您要使用的任何索引模式。
- 设置模板的优先级。
- 选择一个索引别名。
- 设置主分片数量。
- 设置副本数量。
- 设置刷新间隔。
- 使用可视化编辑器或 JSON 编辑器为您的索引映射添加字段和对象。
- 在 **高级设置** 下,您可以使用逗号分隔列表指定高级索引设置,如下图所示。
编辑模板
要编辑模板,请从模板列表中选择要编辑的模板。接下来,选择 **操作** 下拉列表,然后选择 **编辑** 选项。
删除模板
要删除模板,请从模板列表中选择要删除的模板。接下来,选择 **操作** 下拉列表,然后选择 **删除** 选项。
别名
别名是一个虚拟索引名称,可以指向一个或多个索引。如果您的数据分布在多个索引中,与其跟踪要查询哪些索引,不如创建一个别名并转而查询它,如下图所示。
创建别名
要创建别名,请执行以下步骤:
- 在“索引管理”下的“别名”页面上,选择“创建别名”按钮。
- 指定别名名称。
- 输入要包含在别名中的索引或索引模式。
- 如下图所示,选择“创建别名”。
编辑别名
要编辑别名,请执行以下步骤
- 选择要编辑的别名。
- 选择“操作”按钮。
- 从下拉列表中选择“编辑”。
删除别名
要删除别名,请执行以下步骤
- 选择要编辑的别名。
- 选择“操作”按钮。
- 从下拉列表中选择“删除”。
刷新别名
刷新别名可使对索引所做的最新更新对搜索操作可见。
刷新操作只能应用于与指定别名关联的打开索引。
要刷新特定别名,请从“索引管理”下的“别名”列表中选择该别名。然后从“操作”下拉列表中选择“刷新”。
刷写别名
刷新(flush)操作执行 Lucene 提交,将段写入磁盘并启动新的事务日志。
刷写操作只能应用于与指定别名关联的打开索引。
要刷写别名,请从“索引管理”下的“别名”列表中选择该别名。然后从“操作”下拉列表中选择“刷写”。
清除别名缓存
“清除缓存操作”只能应用于与指定别名关联的打开索引。
要清除别名缓存,请从“索引管理”下的“别名”列表中选择该别名。然后从“操作”下拉列表中选择“清除缓存”。
汇总作业
“索引管理”下的“汇总作业”部分允许您创建或更新索引汇总作业。
要创建汇总作业,请执行以下步骤
- 在“索引管理”下的“汇总作业”页面上,选择“创建汇总作业”按钮。
- 设置名称、源索引和目标索引。
- 选择下一步。
- 设置时间戳字段和间隔类型。
- (可选)设置其他聚合和指标。
- 选择下一步。
- 在“调度”下,选中或取消选中“默认启用作业”。
- 设置“连续”、“执行频率”、“汇总间隔”和“每次执行的页面数”设置。
- 此外,您可以设置执行延迟。
- 选择下一步。
- 查看汇总作业的设置,然后选择“创建”。
您还可以通过选择“汇总作业”页面上的相应按钮来启用和禁用汇总作业。
转换作业
您可以使用转换作业创建、启动、停止和完成操作。
要创建转换作业,请执行以下步骤
- 在“索引管理”下的“转换作业”页面上,选择“创建转换作业”按钮。
- 设置名称、源索引和目标索引。
- 选择下一步。
- 选择要转换的字段。从表格中,通过选择字段名称旁边的“+”来选择要转换的字段。
- 选择下一步。
- 选中或取消选中“默认启用作业”。
- 设置转换执行间隔以及计划是否连续。
- (可选)在“高级”下拉列表下设置每次执行的页面数。
- 选择下一步。
- 查看汇总作业的设置,然后选择“创建”。
您还可以通过选择“转换作业”页面上的相应按钮来启用和禁用汇总作业。
长时间运行操作的状态检查
某些索引操作需要额外的时间才能完成(通常超过 30 秒,但可能长达数十分钟或数小时)。这会在“索引”页面上的索引状态列中进行跟踪。
您可以检查重新索引、收缩和拆分操作的状态,因为它们是一次性、非递归操作。
安全集成
权限控制通过现有的权限或操作组进行管理,这些权限或操作组在 API 级别强制执行。目前没有 UI 级别的权限控制。具有访问 ISM 插件权限的用户能够查看新页面。如果他们有权运行相关的 API,他们也可以进行更改。
错误处理
与 API 调用类似,如果操作立即失败,您将收到错误消息通知。但是,如果是一个长时间运行的操作,您将在失败时收到失败通知,或者您可以在“索引”页面上检查索引状态。