> ES 9.4 给 ES|QL 加了 Views：把一段查询定义成有名字的视图，之后在 `FROM` 里当索引用。本文讲清定义方式、嵌套与分支上限、预览阶段的限制，以及它和子查询、`FORK` 怎么选。

## **说明**

本文描述问题及解决方法同样适用于 [腾讯云 Elasticsearch Service（ES）](https://cloud.tencent.com/document/product/845)。

## 先说痛点

写 ES|QL 的时候，总有几段查询会反复出现：固定的过滤条件、固定的字段重命名、固定的派生字段。以前要么每次复制粘贴，要么在应用层封一层。

9.4 加进来的 **ES|QL Views**，给了一个更直接的办法：把这段查询定义成一个有名字的视图，之后在 `FROM` 里当索引用。

先把状态说清楚，免得你看完就想往生产上放：**9.4 技术预览**，而且 **serverless 不可用**。官方 `esql-views.md` 文档头部写的是 `stack: preview 9.4.0`、`serverless: unavailable`（[v9.5.4 文档 4–5 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L4-L5)）。

## 它到底是什么

先看官方是怎么定义的（[12–17 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L12-L17)）：

> A view is a virtual index with fields that are produced from the output of an ES|QL query.
> Each view has a name and a definition. The definition is a complete ES|QL query, with source commands and processing commands.
> The view name can be used within an index pattern in the `FROM` command of any normal ES|QL query, as well as within another view definition.
> When the main query is executed, all referenced views are also executed independently.
> This ensures up-to-date results from all source indexes referenced by both the main query and the view definitions themselves.
> The final output combines all these results into a single list, including any duplicate rows.

拆开看有五点：

- 视图是个**虚拟索引**，字段来自一条 ES|QL 查询的输出。
- 它有**名字**和**定义**，定义就是一条完整的 ES|QL 查询（source 命令 + 处理命令都有）。
- 这个名字可以用在任何查询的 `FROM` 索引模式里，**也可以被另一个视图引用**。
- 主查询执行时，被引用的视图会**各自独立执行**，所以拿到的是源索引的最新数据，不是缓存快照。
- 结果合并成一个列表，**重复行会保留**，不会帮你去重。

## 什么时候该用

官方列了四种场景（[19–26 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L19-L26)），翻过来就是：

- **复用一段命名查询**：把常用的管道包成视图，之后按名字引用，不用每个请求都重复一遍。
- **抽象通用转换**：把重命名、类型转换、派生字段集中在一个地方，用的人只看到一组稳定的列，不用关心底层结构。
- **组合多个预处理过的数据源**：一个源定义一个视图，各自带自己的过滤或聚合，然后在一条 `FROM` 里一起查。
- **给下游工具减负**：看板、告警、临时分析的人直接查 `FROM my_view`，不用知道背后是哪些索引、哪些命令。

第三条我个人觉得最实用——以前要在一个查询里合并几个口径不同的数据源，只能写很长的管道或者在应用层拼。

## 怎么定义，怎么用

用 REST API 定义。假设有这样一条查询（这是官方示例，[views_plain_addresses](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/commands/examples/views.csv-spec/views_plain_addresses.md#L3-L14)）：

```esql
FROM addresses
| RENAME city.country.name AS country
| EVAL country = CASE(country == "United States of America", "United States", country)
| STATS count=COUNT() BY country
```

结果是：

| count:long | country:keyword |
|---|---|
| 1 | Japan |
| 1 | Netherlands |
| 1 | United States |

把它定义成视图（[42–52 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L42-L52)）：

```console
PUT /_query/view/country_addresses
{
    "query": """
        FROM addresses
        | RENAME city.country.name AS country
        | EVAL country = CASE(country == "United States of America", "United States", country)
        | STATS count=COUNT() BY country
        """
}
```

然后直接查视图名，输出跟上面那条查询一模一样（[views_country_addresses 示例](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/commands/examples/views.csv-spec/views_country_addresses.md#L3-L11)）：

```esql
FROM country_addresses
```

用起来就跟普通索引一样。官方说法是（[63–68 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L63-L68)）：`FROM` 后面是逗号分隔的索引或视图名列表，**支持通配符和 date-math**。

几个要注意的行为：

- 一边有、另一边没有的字段，会填 `null`（[77 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L77)）。
- 视图可以嵌套，深度上限 **10**（[82 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L82)）。
- 分支因子上限 **8**，而且 views、subqueries、`FORK` 是**共用**这个额度的（[86–88 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L86-L88)）。官方举的例子：一个索引模式里引用 4 个视图 + 4 个子查询可以，再多一个就超限，查询直接失败。

## 进阶一点的用法

**一个 `FROM` 里合并多个视图。** 官方示例定义了三个视图 `country_airports`、`country_addresses`、`country_languages`，分别从三个源索引统计每个国家的文档数，然后一起查（[99–112 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L99-L112)）。同一个国家会在多个视图里都出现，于是产生多行；想要合并就再套一层 `STATS ... SUM(count) BY country`。通配符也能用，比如把所有 `country_*` 视图一次性查出来再做 `SUM`。

**视图里可以写 `LOOKUP JOIN`。** 这个挺实用：

```console
PUT /_query/view/airports_mp_filtered
{
    "query": """
        FROM airports
        | RENAME abbrev AS code
        | LOOKUP JOIN airports_mp ON abbrev == code
        | WHERE abbrev IS NOT NULL
        | DROP code
       """
}
```

这个视图里的行，都是 `airports` 里能在 `airports_mp` 索引匹配到 `abbrev` 的那些（[125–139 行](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md#L125-L139)）。官方还举了个用法：把视图和索引写进同一个 `FROM`，对比"只在 `airports` 里的"和"在视图里的"各有多少。

## 限制，这部分要认真看

视图在预览阶段，限制不算少（[官方限制片段](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/common/view_limitations.md#L1-L48)）：

- **视图定义里基本不能用 `FORK` 和子查询**，除非分支点能通过 query compaction 合并掉。
- 嵌套和分支可以组合，但**分支点不能超过一个**。视图里可以有子查询，但那个视图就不能再和其他视图一起用了。
- **跨集群**：不支持远端视图。`FROM cluster:view` 只会去匹配远端的同名**索引**；如果远端真有个视图，查询会失败。反过来，**如果远端有个索引跟本地视图同名，查询也会失败**。
- **查询参数不能用在视图定义里**，所以主查询传的参数不会影响视图结果。
- **已知问题**：主查询上的 Query DSL 过滤，目前会作用到视图定义里的源索引上，后续版本会改成作用于视图的输出——这个行为变化要留意。`METADATA` 在视图内外的行为也还会变。

说白了，跨集群和参数这两块，现阶段基本别指望。

## 视图、子查询、`FORK` 怎么选

这三个是近亲，官方专门做了对比（[对比片段](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/common/comparing_views_subqueries_fork.md#L6-L37)）。用一句话区分：

- **`FORK`**：对**同一份**已有数据做并行多分支处理，每个分支拿到的输入行和列都一样；一个查询只能有一个 `FORK`。
- **子查询**：每个分支可以有自己的 `FROM`，来源可以完全不同。
- **视图**：可复用的**命名**查询，当虚拟索引用。

它们的共同点也很明确：都是**查询时才执行**（所以结果是最新的）、列取并集（缺的填 `null`）、最大分支数都是 8、一般不允许嵌套分支（视图能通过 compaction 绕一部分）。

还有两条容易忽略：

- **视图名在索引命名空间里唯一**，不能和已有索引同名，反过来也一样。
- 视图可以嵌套，但**不能循环引用**（`viewA` → `viewB` → `viewC` → `viewA` 不行），循环是在主查询执行时才检测的。

## 小结

| 项 | 结论 |
|---|---|
| 版本 | 9.4 起，技术预览 |
| Serverless | 不可用 |
| 定义方式 | `PUT /_query/view/<name>`，body 里是完整 ES|QL 查询 |
| 用法 | `FROM` 里当索引用，支持通配符和 date-math |
| 结果 | 各视图独立执行后合并，重复行保留，缺列填 `null` |
| 嵌套深度 | 10 |
| 分支上限 | 8（views + subqueries + `FORK` 共用） |
| 主要限制 | 视图内一般不能用 `FORK`/子查询；不支持远端视图；不能用查询参数 |

## 写在最后

视图解决的是一个很朴素的问题：同一段 ES|QL 别再到处复制。如果你的看板、告警里反复出现同一段查询，值得把它抽成视图试一下，尤其是"把几个口径不同的数据源合到一条 `FROM` 里"这种场景，视图会比手写长管道清爽得多。

但要记住它**还是技术预览**：跨集群和查询参数这两块现在基本用不了，嵌套深度、分支数也有上限。先在测试环境和内部看板上试，别急着把核心告警迁过来。

## 参考

- [ES|QL Views 官方文档 @ v9.5.4](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/esql-views.md)
- [视图限制片段 @ v9.5.4](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/common/view_limitations.md)
- [视图 / 子查询 / FORK 对比 @ v9.5.4](https://github.com/elastic/elasticsearch/blob/v9.5.4/docs/reference/query-languages/esql/_snippets/common/comparing_views_subqueries_fork.md)
- [9.4.0 发布说明 highlights @ v9.5.0](https://github.com/elastic/elasticsearch/blob/v9.5.0/docs/release-notes/index.md#L441-L447)

> 本文对照 Elasticsearch `v9.5.4` 标签的官方文档与 `v9.5.0` 标签的发布说明核对，示例均取自官方示例文件。撰写时未启动集群、未运行测试。


ES 9.4 给 ES|QL 加了 Views：把一段查询定义成有名字的视图，之后在 FROM 里当索引用。本文讲清定义方式、嵌套与分支上限、预览阶段的限制，以及它和子查询、FORK 怎么选。

ES|QL 终于有视图了：把常用查询变成一个"虚拟索引"

ES 9.4 给 ES|QL 加了 Views：把一段查询定义成有名字的视图，之后在 FROM 里当索引用。

官方产研

云计算

后端

大数据

ES|QL Views是ES9.4新增的虚拟索引功能，通过PUT/_query/view/<name>定义完整ES|QL查询，可在FROM中当索引用，支持嵌套（深度10）和通配符。各视图独立执行后合并结果，重复行保留。注意：技术预览阶段，serverless不可用，不支持跨集群和查询参数，分支上限8（与子查询、FORK共用）。适合复用固定查询和组合多数据源场景。

2026上云采购 | AI焕新·智启新局

bigdata-class

serverless-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

ES|QL Views是ES9.4新增的虚拟索引功能，通过PUT/_query/view/<name>定义完整ES|QL查询，可在FROM中当索引用，支持嵌套（深度10）和通配符。各视图独立执行后合并结果，重复行保留。注意：技术预览阶段，serverless不可用，不支持跨集群和查询参数，分支上限8（与子查询、FORK...

ES|QL 终于有视图了：把常用查询变成一个"虚拟索引"-腾讯云开发者社区-腾讯云

ES|QL 终于有视图了：把常用查询变成一个"虚拟索引"

ES|QL 终于有视图了：把常用查询变成一个"虚拟索引"

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐