New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« 检索内部命中 使用查询规则进行搜索 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›搜索您的数据 ›搜索 API

搜索分片路由

编辑

搜索分片路由

编辑

为了防止硬件故障并提高搜索容量，Elasticsearch 可以将索引的数据副本存储在多个节点上的多个分片中。在运行搜索请求时，Elasticsearch 会选择一个包含索引数据副本的节点，并将搜索请求转发到该节点的分片。此过程称为搜索分片路由或路由。

自适应副本选择

编辑

默认情况下，Elasticsearch 使用自适应副本选择来路由搜索请求。此方法使用分片分配感知和以下条件来选择符合条件的节点

  • 协调节点和符合条件的节点之间先前请求的响应时间
  • 符合条件的节点运行先前搜索所花费的时间
  • 符合条件的节点的 search 线程池 的队列大小

自适应副本选择旨在减少搜索延迟。但是，您可以使用集群设置 API 将 cluster.routing.use_adaptive_replica_selection 设置为 false 来禁用自适应副本选择。如果禁用，Elasticsearch 将使用轮询方法路由搜索请求，这可能会导致搜索速度变慢。

设置偏好

编辑

默认情况下，自适应副本选择会从所有符合条件的节点和分片中进行选择。但是，您可能只想获取本地节点的数据，或者想根据硬件将搜索路由到特定节点。或者，您可能希望将重复搜索发送到同一分片以利用缓存。

要限制符合搜索请求条件的节点和分片集，请使用搜索 API 的 preference 查询参数。

例如，以下请求使用 _local 的 preference 搜索 my-index-000001。这将搜索限制在本地节点上的分片。如果本地节点不包含索引数据的任何分片副本，则该请求将使用自适应副本选择来回退到另一个符合条件的节点。

resp = client.search(
    index="my-index-000001",
    preference="_local",
    query={
        "match": {
            "user.id": "kimchy"
        }
    },
)
print(resp)
response = client.search(
  index: 'my-index-000001',
  preference: '_local',
  body: {
    query: {
      match: {
        'user.id' => 'kimchy'
      }
    }
  }
)
puts response
const response = await client.search({
  index: "my-index-000001",
  preference: "_local",
  query: {
    match: {
      "user.id": "kimchy",
    },
  },
});
console.log(response);
GET /my-index-000001/_search?preference=_local
{
  "query": {
    "match": {
      "user.id": "kimchy"
    }
  }
}
Copy as curlTry in Elastic 

您还可以使用 preference 参数，根据提供的字符串将搜索路由到特定分片。如果集群状态和所选分片没有更改，则使用相同 preference 字符串的搜索将以相同的顺序路由到相同的分片。

我们建议使用唯一的 preference 字符串，例如用户名或 Web 会话 ID。此字符串不能以 _ 开头。

您可以使用此选项为频繁使用且资源密集型搜索提供缓存结果。如果分片的数据没有更改，则使用相同 preference 字符串的重复搜索将从相同的分片请求缓存中检索结果。对于时间序列用例（例如日志记录），旧索引中的数据很少更新，可以直接从此缓存中提供。

以下请求使用 my-custom-shard-string 的 preference 字符串搜索 my-index-000001。

resp = client.search(
    index="my-index-000001",
    preference="my-custom-shard-string",
    query={
        "match": {
            "user.id": "kimchy"
        }
    },
)
print(resp)
response = client.search(
  index: 'my-index-000001',
  preference: 'my-custom-shard-string',
  body: {
    query: {
      match: {
        'user.id' => 'kimchy'
      }
    }
  }
)
puts response
const response = await client.search({
  index: "my-index-000001",
  preference: "my-custom-shard-string",
  query: {
    match: {
      "user.id": "kimchy",
    },
  },
});
console.log(response);
GET /my-index-000001/_search?preference=my-custom-shard-string
{
  "query": {
    "match": {
      "user.id": "kimchy"
    }
  }
}
Copy as curlTry in Elastic 

如果集群状态或所选分片发生更改，则相同的 preference 字符串可能不会以相同的顺序将搜索路由到相同的分片。这可能是由于多种原因造成的，包括分片重定位和分片故障。节点也可能拒绝搜索请求，在这种情况下，Elasticsearch 会将其重新路由到另一个节点。

使用路由值

编辑

在索引文档时，您可以指定一个可选的路由值，该值将文档路由到特定分片。

例如，以下索引请求使用 my-routing-value 路由文档。

resp = client.index(
    index="my-index-000001",
    routing="my-routing-value",
    document={
        "@timestamp": "2099-11-15T13:12:00",
        "message": "GET /search HTTP/1.1 200 1070000",
        "user": {
            "id": "kimchy"
        }
    },
)
print(resp)
response = client.index(
  index: 'my-index-000001',
  routing: 'my-routing-value',
  body: {
    "@timestamp": '2099-11-15T13:12:00',
    message: 'GET /search HTTP/1.1 200 1070000',
    user: {
      id: 'kimchy'
    }
  }
)
puts response
const response = await client.index({
  index: "my-index-000001",
  routing: "my-routing-value",
  document: {
    "@timestamp": "2099-11-15T13:12:00",
    message: "GET /search HTTP/1.1 200 1070000",
    user: {
      id: "kimchy",
    },
  },
});
console.log(response);
POST /my-index-000001/_doc?routing=my-routing-value
{
  "@timestamp": "2099-11-15T13:12:00",
  "message": "GET /search HTTP/1.1 200 1070000",
  "user": {
    "id": "kimchy"
  }
}
Copy as curlTry in Elastic 

您可以在搜索 API 的 routing 查询参数中使用相同的路由值。这确保了搜索在用于索引文档的同一分片上运行。

resp = client.search(
    index="my-index-000001",
    routing="my-routing-value",
    query={
        "match": {
            "user.id": "kimchy"
        }
    },
)
print(resp)
response = client.search(
  index: 'my-index-000001',
  routing: 'my-routing-value',
  body: {
    query: {
      match: {
        'user.id' => 'kimchy'
      }
    }
  }
)
puts response
const response = await client.search({
  index: "my-index-000001",
  routing: "my-routing-value",
  query: {
    match: {
      "user.id": "kimchy",
    },
  },
});
console.log(response);
GET /my-index-000001/_search?routing=my-routing-value
{
  "query": {
    "match": {
      "user.id": "kimchy"
    }
  }
}
Copy as curlTry in Elastic 

您还可以提供多个以逗号分隔的路由值

resp = client.search(
    index="my-index-000001",
    routing="my-routing-value,my-routing-value-2",
    query={
        "match": {
            "user.id": "kimchy"
        }
    },
)
print(resp)
response = client.search(
  index: 'my-index-000001',
  routing: 'my-routing-value,my-routing-value-2',
  body: {
    query: {
      match: {
        'user.id' => 'kimchy'
      }
    }
  }
)
puts response
const response = await client.search({
  index: "my-index-000001",
  routing: "my-routing-value,my-routing-value-2",
  query: {
    match: {
      "user.id": "kimchy",
    },
  },
});
console.log(response);
GET /my-index-000001/_search?routing=my-routing-value,my-routing-value-2
{
  "query": {
    "match": {
      "user.id": "kimchy"
    }
  }
}
Copy as curlTry in Elastic 

搜索并发和并行

编辑

默认情况下，Elasticsearch 不会根据请求命中的分片数量拒绝搜索请求。但是，命中大量分片会显著增加 CPU 和内存使用率。

有关防止具有大量分片的索引的提示，请参阅调整分片大小。

您可以使用 max_concurrent_shard_requests 查询参数来控制每个节点上的搜索请求可以命中的最大并发分片数。这可以防止单个请求使集群过载。该参数默认为最大 5。

resp = client.search(
    index="my-index-000001",
    max_concurrent_shard_requests="3",
    query={
        "match": {
            "user.id": "kimchy"
        }
    },
)
print(resp)
response = client.search(
  index: 'my-index-000001',
  max_concurrent_shard_requests: 3,
  body: {
    query: {
      match: {
        'user.id' => 'kimchy'
      }
    }
  }
)
puts response
const response = await client.search({
  index: "my-index-000001",
  max_concurrent_shard_requests: 3,
  query: {
    match: {
      "user.id": "kimchy",
    },
  },
});
console.log(response);
GET /my-index-000001/_search?max_concurrent_shard_requests=3
{
  "query": {
    "match": {
      "user.id": "kimchy"
    }
  }
}
Copy as curlTry in Elastic 

您还可以使用 action.search.shard_count.limit 集群设置来设置搜索分片限制，并拒绝命中过多分片的请求。您可以使用集群设置 API 配置 action.search.shard_count.limit。

« 检索内部命中 使用查询规则进行搜索 »

On this page

Was this helpful?
Feedback