New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« 测试查询规则集 存储库计量 API »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›REST API

重新加载搜索分析器 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
Copy as curlTry in Elastic 

重新加载搜索分析器后，您应该清除请求缓存，以确保它不包含从先前版本的分析器派生的响应。

请求

编辑

POST /<目标>/_reload_search_analyzers

GET /<目标>/_reload_search_analyzers

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能，则您必须拥有目标数据流、索引或别名的 manage 索引权限。

描述

编辑

您可以使用重新加载搜索分析器 API 来获取synonym_graph或synonym标记过滤器在搜索分析器中使用的同义词文件的更改。要符合条件，标记过滤器必须具有 updateable 标志 true 并且只能在搜索分析器中使用。

此 API 不会为索引的每个分片执行重新加载。相反，它会为包含索引分片的每个节点执行重新加载。因此，API 返回的总分片计数可能与索引分片数量不同。

由于重新加载会影响具有索引分片的每个节点，因此在使用此 API 之前，务必更新群集中每个数据节点上的同义词文件，包括不包含分片副本的节点。这确保了同义词文件在群集中任何地方都得到更新，以防将来分片被重新定位。

路径参数

编辑
<目标>
（必需，字符串）用于限制请求的数据流、索引和别名的逗号分隔列表。支持通配符（*）。要定位所有数据流和索引，请使用 * 或 _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"              
      }
    }
  }
}
Copy as curlTry in Elastic 

包含同义词文件。

将标记过滤器标记为可更新。

将分析器标记为搜索分析器。

更新同义词文件后，使用分析器重新加载 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
Copy as curlTry in Elastic 

API 返回以下响应。

{
  "_shards": {
    "total": 2,
    "successful": 2,
    "failed": 0
  },
  "reload_details": [
    {
      "index": "my-index-000001",
      "reloaded_analyzers": [
        "my_synonyms"
      ],
      "reloaded_node_ids": [
        "mfdqTXn_T7SGr2Ho2KT8uw"
      ]
    }
  ]
}
« 测试查询规则集 存储库计量 API »

On this page

Was this helpful?
Feedback