重新加载搜索分析器 API
编辑重新加载搜索分析器 API
编辑重新加载索引的搜索分析器及其资源。对于数据流，该 API 会重新加载数据流支持索引的搜索分析器和资源。
resp = client.indices.reload_search_analyzers(
index="my-index-000001",
)
print(resp)
resp1 = client.indices.clear_cache(
index="my-index-000001",
request=True,
)
print(resp1)
response = client.indices.reload_search_analyzers( index: 'my-index-000001' ) puts response response = client.indices.clear_cache( index: 'my-index-000001', request: true ) puts response
const response = await client.indices.reloadSearchAnalyzers({
index: "my-index-000001",
});
console.log(response);
const response1 = await client.indices.clearCache({
index: "my-index-000001",
request: "true",
});
console.log(response1);
POST /my-index-000001/_reload_search_analyzers POST /my-index-000001/_cache/clear?request=true
重新加载搜索分析器后，应清除请求缓存，以确保缓存中不包含来自分析器先前版本的响应。
请求
编辑POST /<target>/_reload_search_analyzers
GET /<target>/_reload_search_analyzers
先决条件
编辑- 如果启用了 Elasticsearch 安全功能，则必须对目标数据流、索引或别名具有
manage索引权限。
描述
编辑您可以使用重新加载搜索分析器 API 来获取对synonym_graph或synonym 搜索分析器的词元过滤器中使用的同义词文件的更改。要符合条件，词元过滤器必须具有updateable标志为true，并且只能在搜索分析器中使用。
此 API 不会对索引的每个分片执行重新加载。相反，它会对包含索引分片的每个节点执行重新加载。因此，API 返回的总分片数可能与索引分片数不同。
由于重新加载会影响具有索引分片的每个节点，因此在使用此 API 之前，务必更新集群中每个数据节点上的同义词文件，包括不包含分片副本的节点。这确保了将来重新分配分片时，集群中的所有位置都已更新同义词文件。
路径参数
编辑-
<target> - (必填，字符串) 用于限制请求的数据流、索引和别名的逗号分隔列表。支持通配符(
*)。要定位所有数据流和索引，请使用*或_all。
查询参数
编辑-
allow_no_indices -
(可选，布尔值) 如果为
false，则如果任何通配符表达式、索引别名或_all值仅定位缺失或关闭的索引，则请求将返回错误。即使请求定位其他打开的索引，此行为也适用。例如，如果索引以foo开头，但没有索引以bar开头，则定位foo*,bar*的请求将返回错误。默认为
true。 -
expand_wildcards -
(可选，字符串) 通配符模式可以匹配的索引类型。如果请求可以定位数据流，则此参数决定通配符表达式是否匹配隐藏的数据流。支持逗号分隔的值，例如
open,hidden。有效值为-
all - 匹配任何数据流或索引，包括隐藏的数据流或索引。
-
open - 匹配打开的、非隐藏的索引。也匹配任何非隐藏的数据流。
-
closed - 匹配关闭的、非隐藏的索引。也匹配任何非隐藏的数据流。数据流不能关闭。
-
hidden - 匹配隐藏的数据流和隐藏的索引。必须与
open、closed或两者结合使用。 -
none - 不接受通配符模式。
默认为
open。 -
-
ignore_unavailable - (可选，布尔值) 如果为
false，则如果请求的目标是缺失或关闭的索引，则返回错误。默认为false。
示例
编辑使用创建索引 API创建包含可更新同义词过滤器的搜索分析器的索引。
将以下分析器用作索引分析器会导致错误。
resp = client.indices.create(
index="my-index-000001",
settings={
"index": {
"analysis": {
"analyzer": {
"my_synonyms": {
"tokenizer": "whitespace",
"filter": [
"synonym"
]
}
},
"filter": {
"synonym": {
"type": "synonym_graph",
"synonyms_path": "analysis/synonym.txt",
"updateable": True
}
}
}
}
},
mappings={
"properties": {
"text": {
"type": "text",
"analyzer": "standard",
"search_analyzer": "my_synonyms"
}
}
},
)
print(resp)
response = client.indices.create(
index: 'my-index-000001',
body: {
settings: {
index: {
analysis: {
analyzer: {
my_synonyms: {
tokenizer: 'whitespace',
filter: [
'synonym'
]
}
},
filter: {
synonym: {
type: 'synonym_graph',
synonyms_path: 'analysis/synonym.txt',
updateable: true
}
}
}
}
},
mappings: {
properties: {
text: {
type: 'text',
analyzer: 'standard',
search_analyzer: 'my_synonyms'
}
}
}
}
)
puts response
const response = await client.indices.create({
index: "my-index-000001",
settings: {
index: {
analysis: {
analyzer: {
my_synonyms: {
tokenizer: "whitespace",
filter: ["synonym"],
},
},
filter: {
synonym: {
type: "synonym_graph",
synonyms_path: "analysis/synonym.txt",
updateable: true,
},
},
},
},
},
mappings: {
properties: {
text: {
type: "text",
analyzer: "standard",
search_analyzer: "my_synonyms",
},
},
},
});
console.log(response);
PUT /my-index-000001
{
"settings": {
"index": {
"analysis": {
"analyzer": {
"my_synonyms": {
"tokenizer": "whitespace",
"filter": [ "synonym" ]
}
},
"filter": {
"synonym": {
"type": "synonym_graph",
"synonyms_path": "analysis/synonym.txt",
"updateable": true
}
}
}
}
},
"mappings": {
"properties": {
"text": {
"type": "text",
"analyzer": "standard",
"search_analyzer": "my_synonyms"
}
}
}
}
更新同义词文件后，使用分析器重新加载 API重新加载搜索分析器并获取文件更改。
resp = client.indices.reload_search_analyzers(
index="my-index-000001",
)
print(resp)
response = client.indices.reload_search_analyzers( index: 'my-index-000001' ) puts response
const response = await client.indices.reloadSearchAnalyzers({
index: "my-index-000001",
});
console.log(response);
POST /my-index-000001/_reload_search_analyzers
API 返回以下响应。
{
"_shards": {
"total": 2,
"successful": 2,
"failed": 0
},
"reload_details": [
{
"index": "my-index-000001",
"reloaded_analyzers": [
"my_synonyms"
],
"reloaded_node_ids": [
"mfdqTXn_T7SGr2Ho2KT8uw"
]
}
]
}