作者：来自 Elastic Laura Trotta
使用 IntelliJ IDEA 的新插件，在你的 IDE 中构建并运行 ES|QL 查询。
通过 Elasticsearch 实践操作：深入了解 Elasticsearch Labs 仓库中的示例 notebooks，开始免费云试用，或现在就在你的本地机器上尝试 Elastic。
Elasticsearch 查询语言（ ES|QL ）是 Elasticsearch 的管道式查询语言，旨在实现直观的数据查询和操作。请参考我们的入门指南以了解更多信息。
Elasticsearch Java 客户端通过 DSL 支持 ES|QL 查询，但目前它将查询视为简单 字符串 ，没有专门的辅助工具；虽然 Kibana 提供了出色的 UI 来构建 ES|QL查询，但我们也意识到，有时在集成开发环境（ IDE ）中拥有编写应用程序所需的一切会带来更好的体验。因此，在 Java 客户端将其类型支持扩展到 ES|QL 之前，我们编写了一个 IntelliJ IDEA 插件，用于自动补全、语法检查、显示文档以及执行 ES|QL 查询。
该插件目前支持 Java、 Kotlin 和纯文本文件，以防 Java 虚拟机（ JVM ）不是你的选择。
请在 JetBrains Marketplace 页面和 GitHub 仓库中查看它，以获取更多信息。
前提条件
- IDE：Intellij IDEA 版本 >= 253（ community 或 ultimate ）
使用方法
像安装其他插件一样在 Intellij IDEA 中安装该插件，可以通过 JetBrains marketplace，或者进入 Settings -> Plugins -> Marketplace 并搜索 " esql "。
以下示例使用 Java 编写，但也支持 Kotlin，使用方式基本相同。
创建一个文本块字符串，在其上方写一个简单注释 " ES|QL "，即可完成。
ini
`
1. // ES|QL
2. String query = """
3. """;
`AI写代码然后一切即可正常工作，你已经准备好编写你的查询。
为什么使用文本块而不是简单字符串？ES|QL 语法在多种上下文中接受引号，对其进行转义会在语法检查器中触发其他错误，因此我们选择使用文本块来保持简单。
对于 txt 文件来说更简单，因为你只需添加该注释，然后直接在下方开始编写查询：
arduino
`// ES|QL`AI写代码连接到服务器 实例
该插件可以连接到 Elasticsearch 服务器实例，以获取索引和字段名称，然后将它们添加到自动补全选项中。请在屏幕左下角（或你放置工具的位置）查找 Elastic 标志，并配置你到任意服务器实例的连接：
自动补全
在文本块中开始输入时，会自动打开自动补全弹窗，它会返回一个可接受的命令/值列表，帮助你正确继续编写查询。如果你想手动触发自动补全，可以使用 IDE 的快捷键 ctrl + space：
语法检查
该插件会高亮查询中的错误，并说明需要修复的内容：
文档
将光标悬停在命令上会显示文档，说明该命令的用途以及其正确语法：
运行查询
连接到服务器实例后，你可以点击 Elastic 图标旁边的绿色按钮来运行查询：结果将显示在工具窗口中：
或者如果你正在编写应用程序，可以像这样使用 Java 客户端：
ini
`
1. // ES|QL
2. String query = """
3. FROM my-index
4. | SORT year DESC
5. | LIMIT 10
6. """;
8. try (ElasticsearchClient client = ElasticsearchClient.of(e -> e
9. .host(serverUrl)
10. .apiKey(apiKey))) {
12. client.esql().query(QueryRequest.of(qr -> qr.query(query)));
14. }
`AI写代码查看我们之前关于 ES|QL Java Client 的文章，以获取将 ES|QL 结果映射到 Java 对象的完整示例。
它是如何工作的？
这里没有 AI 参与；该插件基于 ES|QL ANTLR 语法来实现自动补全和语法检查，并使用 Elasticsearch 文档来展示说明。
结论
该插件仍处于实验阶段，因此欢迎你在 GitHub 仓库中提交任何 bug 或功能请求。