Elasticsearch

在 Elasticsearch 中搜索、索引和管理数据

配置

搜索

操作
搜索
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
搜索查询
json
{ "match": { "field": "搜索词" } }
结果数量
10
偏移量
0
排序
json
[{ "field": { "order": "asc" } }]
包含字段
field1, field2(逗号分隔)
排除字段
field1, field2(逗号分隔)
搜索(elasticsearch_search)

使用 Query DSL 在 Elasticsearch 中搜索文档。返回匹配的文档及其评分和元数据。

输入
参数类型必填说明
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL(自托管部署)
cloudIdstring否Elastic Cloud ID(云端部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证用户名
passwordstring否基本认证密码
indexstring是要搜索的索引名称
querystring否JSON 字符串形式的 Query DSL
fromnumber否分页起始偏移量(默认:0)
sizenumber否返回结果数量(默认:10)
sortstring否JSON 字符串形式的排序规则
sourceIncludesstring否要包含在 _source 中的字段列表,以逗号分隔
sourceExcludesstring否要从 _source 中排除的字段列表,以逗号分隔
trackTotalHitsboolean否跟踪准确的总命中数(默认:true)
输出
参数类型描述
took数字搜索耗时(毫秒)
timed_out布尔值搜索是否超时
hits对象搜索结果,包含总数和匹配的文档
aggregationsJSON聚合结果(如有)

索引文档

操作
索引文档
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
文档 ID
留空以自动生成 ID
文档*
json
{ "field": "value", "another_field": 123 }
刷新
默认
索引文档 (elasticsearch_index_document)

在 Elasticsearch 中索引(创建或更新)文档。

输入
参数类型必填描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是目标索引名称
documentIdstring否文档 ID (未提供时自动生成)
documentstring是文档正文,JSON 字符串
refreshstring否刷新策略:true、false 或 wait_for
输出
参数类型描述
_indexstring存储文档的索引
_idstring文档 ID
_versionnumber文档版本
resultstring操作结果 (已创建或已更新)

获取文档

操作
获取文档
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
文档 ID*
unique-document-id
包含的字段
field1, field2(逗号分隔)
排除的字段
field1, field2(逗号分隔)
获取文档(elasticsearch_get_document)

根据 ID 从 Elasticsearch 检索文档。

输入
参数类型必填说明
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (适用于自托管)
cloudIdstring否Elastic Cloud ID (适用于云部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是索引名称
documentIdstring是要检索的文档 ID
sourceIncludesstring否要包含的字段列表,以逗号分隔
sourceExcludesstring否要排除的字段列表,以逗号分隔
输出
参数类型说明
_indexstring索引名称
_idstring文档 ID
_versionnumber文档版本
foundboolean是否找到该文档
_sourcejson文档内容

更新文档

操作
更新文档
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
文档 ID*
unique-document-id
部分文档*
json
{ "field_to_update": "new_value" }
冲突时重试
3
更新文档 (elasticsearch_update_document)

使用文档合并部分更新 Elasticsearch 中的文档。

输入
参数类型必填描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方法:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是索引名称
documentIdstring是要更新的文档 ID
documentstring是要合并为 JSON 字符串的部分文档
retryOnConflictnumber否版本冲突时的重试次数
输出
参数类型描述
_indexstring索引名称
_idstring文档 ID
_versionnumber新文档版本
resultstring操作结果 (updated 或 noop)

删除文档

操作
删除文档
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方法
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
文档 ID*
unique-document-id
刷新
默认
删除文档 (elasticsearch_delete_document)

按 ID 删除 Elasticsearch 中的文档。

输入
参数类型必填说明
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云端部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是索引名称
documentIdstring是要删除的文档 ID
refreshstring否刷新策略:true、false 或 wait_for
输出
参数类型说明
_indexstring索引名称
_idstring文档 ID
_versionnumber文档版本
resultstring操作结果 (deleted 或 not_found)

批量操作

操作
批量操作
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
批量操作*
json
{ "index": { "_index": "my-index", "_id": "1" } } { "field": "value" } { "delete": { "_index": "my-index", "_id": "2" } }
刷新
默认
批量操作 (elasticsearch_bulk)

在单个请求中执行多个索引、创建、删除或更新操作,以实现高性能。

输入
参数类型必填描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证用户名
passwordstring否基本认证密码
indexstring否未指定索引的操作的默认索引
operationsstring是批量操作,格式为 NDJSON 字符串 (换行分隔的 JSON)
refreshstring否刷新策略:true、false 或 wait_for
输出
参数类型描述
tooknumber批量操作所花费的时间(毫秒)
errorsboolean是否有任何操作出错
itemsarray每个操作的结果

统计文档数量

操作
统计文档数量
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
查询
json
{ "match": { "field": "value" } }
统计文档数量 (elasticsearch_count)

统计 Elasticsearch 中匹配查询的文档数量。

输入
参数类型必需描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是要统计文档数量的索引名称
querystring否用于过滤文档的可选查询 (JSON 字符串)
输出
参数类型描述
countnumber匹配查询的文档数量
_shardsobject分片统计信息

创建索引

操作
创建索引
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
索引设置
json
{ "number_of_shards": 1, "number_of_replicas": 1 }
索引映射
json
{ "properties": { "field": { "type": "text" } } }
创建索引(elasticsearch_create_index)

创建新索引,可选配置设置和映射。

输入
参数类型必填描述
deploymentType字符串是部署类型:self_hosted 或 cloud
host字符串否Elasticsearch 主机 URL(用于自托管)
cloudId字符串否Elastic Cloud ID(用于云端部署)
authMethod字符串是认证方式:api_key 或 basic_auth
apiKey字符串否Elasticsearch API 密钥
username字符串否用于基本认证的用户名
password字符串否用于基本认证的密码
index字符串是要创建的索引名称
settings字符串否索引设置(JSON 字符串)
mappings字符串否索引映射(JSON 字符串)
输出
参数类型描述
acknowledged布尔值请求是否已被确认
shards_acknowledged布尔值分片是否已被确认
index字符串已创建的索引名称

删除索引

操作
删除索引
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
删除索引(elasticsearch_delete_index)

删除索引及其所有文档。此操作不可逆。

输入
参数类型必填描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
indexstring是要删除的索引名称
输出
参数类型描述
acknowledgedboolean删除是否已确认

获取索引信息

操作
获取索引信息
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
索引名称*
my-index
获取索引信息 (elasticsearch_get_index)

检索索引信息,包括设置、映射和别名。

输入
参数类型是否必需描述
deploymentType字符串是部署类型:self_hosted 或 cloud
host字符串否Elasticsearch 主机 URL (用于自托管)
cloudId字符串否Elastic Cloud ID (用于云部署)
authMethod字符串是认证方式:api_key 或 basic_auth
apiKey字符串否Elasticsearch API 密钥
username字符串否基本认证的用户名
password字符串否基本认证的密码
index字符串是要检索信息的索引名称
输出
参数类型描述
indexJSON索引信息,包括别名、映射和设置

集群健康

操作
集群健康
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
云 ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
等待状态
无
超时(秒)
30
集群健康(elasticsearch_cluster_health)

获取 Elasticsearch 集群的健康状态。

输入
参数类型必填说明
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (自托管)
cloudIdstring否Elastic Cloud ID (云端部署)
authMethodstring是认证方式:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证用户名
passwordstring否基本认证密码
waitForStatusstring否等待集群达到此状态:green、yellow 或 red
timeoutstring否等待操作的超时时间 (例如 30s、1m)
输出
参数类型说明
cluster_namestring集群名称
statusstring集群健康状态:green、yellow 或 red
number_of_nodesnumber集群节点总数
number_of_data_nodesnumber数据节点数量
active_shardsnumber活跃分片数量
unassigned_shardsnumber未分配分片数量

集群统计

操作
集群统计
部署类型
自托管
Elasticsearch 主机
https://localhost:9200
当 deploymentType 为 'self_hosted' 时显示。
Cloud ID
deployment-name:base64-encoded-data
当 deploymentType 为 'cloud' 时显示。
认证方式
API 密钥
API 密钥
••••••••
当 authMethod 为 'api_key' 时显示。
用户名
输入用户名
当 authMethod 为 'basic_auth' 时显示。
密码
••••••••
当 authMethod 为 'basic_auth' 时显示。
集群统计 (elasticsearch_cluster_stats)

获取 Elasticsearch 集群的全面统计信息。

输入
参数类型必填描述
deploymentTypestring是部署类型:self_hosted 或 cloud
hoststring否Elasticsearch 主机 URL (用于自托管)
cloudIdstring否Elastic Cloud ID (用于云部署)
authMethodstring是认证方法:api_key 或 basic_auth
apiKeystring否Elasticsearch API 密钥
usernamestring否基本认证的用户名
passwordstring否基本认证的密码
输出
参数类型描述
cluster_namestring集群名称
statusstring集群健康状态
nodesobject节点统计信息,包括数量和版本
indicesobject索引统计信息,包括文档数量和存储大小

使用说明

将 Elasticsearch 集成到工作流中,以实现强大的搜索、索引和数据管理。支持文档 CRUD 操作、高级搜索查询、批量操作、索引管理和集群监控。适用于自托管和 Elastic Cloud 部署。

注意事项

  • 类别:tools
  • 类型:elasticsearch