---
title: "新增别名"
date: 0001-01-01
description: "在 Easysearch UI 中为索引添加别名。"
summary: "新增别名 #  索引别名可将一个或多个索引映射到一个虚拟名称，方便应用层透明切换索引。
操作步骤 #    进入别名管理页：在左侧导航栏点击「别名」，进入别名列表页面。
  打开新增弹窗：点击页面右上角的「+ 新增」按钮，弹出「新增别名」配置窗口。
   配置别名信息：
 别名：填写自定义的别名名称（如示例中的 test_alias）。 索引：在下拉列表中选择要关联的目标索引（如 testing_index_creation）。 （可选）按需配置过滤规则、索引路由、搜索路由，或开启「是否为写索引」开关。    完成创建：配置完成后，点击「确定」，系统将创建该别名。
  查看结果：别名创建成功后，将在别名列表中展示，代表操作完成。  补充说明 #   一个别名可以关联多个索引，方便跨索引查询；但如果需要通过别名写入数据，则必须指定唯一的「写索引」。 别名名称不能与现有索引名称相同，否则会产生冲突。 过滤规则允许通过别名只暴露索引的部分数据（基于 Query DSL），适用于数据隔离或多租户场景。 索引路由 / 搜索路由可用于控制数据写入和查询时的分片路由策略，优化查询性能。  "
---


# 新增别名

索引别名可将一个或多个索引映射到一个虚拟名称，方便应用层透明切换索引。

## 操作步骤

1. **进入别名管理页**：在左侧导航栏点击「别名」，进入别名列表页面。

2. **打开新增弹窗**：点击页面右上角的「+ 新增」按钮，弹出「新增别名」配置窗口。

{{% load-img "/img/management/aliases/create-alias/image-1.png" %}}

3. **配置别名信息**：
   - **别名**：填写自定义的别名名称（如示例中的 `test_alias`）。
   - **索引**：在下拉列表中选择要关联的目标索引（如 `testing_index_creation`）。
   - （可选）按需配置**过滤规则**、**索引路由**、**搜索路由**，或开启「是否为写索引」开关。

4. **完成创建**：配置完成后，点击「确定」，系统将创建该别名。

{{% load-img "/img/management/aliases/create-alias/image-2.png" %}}

5. **查看结果**：别名创建成功后，将在别名列表中展示，代表操作完成。

{{% load-img "/img/management/aliases/create-alias/image-3.png" %}}

## 补充说明

- 一个别名可以关联多个索引，方便跨索引查询；但如果需要通过别名写入数据，则必须指定唯一的「写索引」。
- 别名名称不能与现有索引名称相同，否则会产生冲突。
- **过滤规则**允许通过别名只暴露索引的部分数据（基于 Query DSL），适用于数据隔离或多租户场景。
- **索引路由 / 搜索路由**可用于控制数据写入和查询时的分片路由策略，优化查询性能。