跳到主要内容

清除缓存 API

清除一个或多个索引的缓存。对于数据流，API 清除流的备份索引的缓存。

POST /my-index-000001/_cache/clear

请求​

POST /<target>/_cache/clear

POST /_cache/clear

前置条件​

  • 如果 Elasticsearch 安全特性启用，你使用此 API 必须有 manage 索引权限。

路径参数​

  • <target>

    （可选，字符串）限制请求的逗号分隔的数据流、索引和别名的列表。支持通配符（）。要以所有数据流和索引为目标，忽略此参数或使用 `或_all`。

查询参数​

  • allow_no_indices

    （可选，布尔值）如果为 false，任何通配符、索引别名或 _all 值只针对丢失或关闭的索引，请求将返回一个错误。即使请求以其他开启索引为目标，此行为也适用。例如，如果一个索引以 foo 开头，而没有索引以 bar 开头，则以 foo*,bar* 为目标的请求将返回错误。

    默认为 true。

  • expand_wildcards

    （可选，字符串）通配符表达式可以匹配的索引类型。如果请求可以数据流为目标，则此参数确定通配符表达式是否匹配隐藏的数据流。支持逗号分隔的值，如 open,hidden。有效的值有：

    1. all 匹配任何数据流或索引，包括 hidden（隐藏的）。
    2. open 匹配 open（开启）、非隐藏的索引。也匹配任何非隐藏的数据流。
    3. closed 匹配 closed（关闭）、非隐藏的索引。也匹配任何非隐藏的数据流。数据流不能关闭。
    4. hidden 匹配隐藏数据流和隐藏索引。必须与 open、closed 或一起使用。
    5. none 不接受通配符表达式。

    默认为 open。

  • fielddata

    （可选，布尔值）如果为 true，清除字段缓存。

    使用 fields 字段仅清除特定字段的缓存。

  • fields

    （可选，字符串）逗号分隔用于限制 fielddata 参数的字段名字列表。

    默认为所有字段。

    提示

    此参数不支持对象或字段别名。

  • index

    （可选，字符串）用于限制请求的，逗号分隔的索引名字。

  • ignore_unavailable

    （可选，布尔值）如果为 true，丢失或关闭的索引不包含在响应中。

    默认为 false。

  • query

    （可选，布尔值）如果为 true，清除查询缓存。

  • request

    （可选，布尔值）如果为 true，清除请求缓存。

示例​

清除指定缓存​

默认情况，清除缓存 API 清除所有缓存。你可以通过以下以下查询参数为 true 来清除指定缓存：

  • fielddata
  • query
  • request
POST /my-index-000001/_cache/clear?fielddata=true  
POST /my-index-000001/_cache/clear?query=true
POST /my-index-000001/_cache/clear?request=true
  1. 第一个请求，仅清除字段缓存
  2. 第二个请求，仅清除查询缓存
  3. 第三个请求，仅清除请求缓存

清除指定字段缓存​

为了只清除指定指定字段缓存，使用 fields 查询参数：

POST /my-index-000001/_cache/clear?fields=foo,bar
  1. 此请求清除字段 foo 和 bar 的缓存

清除所有数据流和索引的缓存​

POST /_cache/clear

原文链接