搜索应用程序搜索
编辑搜索应用程序搜索编辑
此功能处于测试阶段，可能会发生变化。其设计和代码不如正式的 GA 功能成熟，因此按原样提供，不作任何保证。测试功能不受正式 GA 功能支持 SLA 的约束。
根据指定的查询参数，使用与搜索应用程序关联的搜索模板或默认模板（如果未指定）生成并执行 Elasticsearch 查询。未指定的模板参数将被分配其默认值（如果适用）。
请求编辑
POST _application/search_application/<name>/_search
先决条件编辑
需要对搜索应用程序的支持别名具有读取权限。
路径参数编辑
-
typed_keys - （可选，布尔值）如果为
true，则聚合和建议器的名称将在响应中以其各自的类型作为前缀。默认为false。
请求正文编辑
-
params - （可选，字符串到对象的映射）用于从与搜索应用程序关联的搜索模板生成 Elasticsearch 查询的查询参数。如果在
params中未指定搜索模板中使用的参数，则将使用该参数的默认值。
可以将搜索应用程序配置为验证搜索模板参数。有关更多信息，请参阅 put search application API 中的 dictionary 参数。
响应代码编辑
-
400 -
传递给搜索模板的参数无效。例子包括
- 缺少必需参数
- 参数数据类型无效
- 参数值无效
-
404 - 搜索应用程序
<name>不存在。
例子编辑
以下示例对名为 my-app 的搜索应用程序执行搜索，该应用程序使用 文本搜索示例 中的搜索模板
POST _application/search_application/my-app/_search
{
"params": {
"query_string": "my first query",
"text_fields": [
{"name": "title", "boost": 5},
{"name": "description", "boost": 1}
]
}
}
生成的 Elasticsearch 查询如下所示
{
"from": 0,
"size": 10,
"query": {
"multi_match": {
"query": "my first query",
"fields": [
"description^1.0",
"title^5.0"
]
}
},
"explain": false
}
在这种情况下，请求中未指定 from、size 和 explain 参数，因此将使用搜索模板中指定的默认值。
预期的响应是来自已生成并执行的 Elasticsearch 查询的搜索结果。响应格式与 Elasticsearch 搜索 API 使用的格式相同
{
"took": 5,
"timed_out": false,
"_shards": {
"total": 1,
"successful": 1,
"skipped": 0,
"failed": 0
},
"hits": {
"total": {
"value": 1,
"relation": "eq"
},
"max_score": 0.8630463,
"hits": ...
}
}