› ›

搜索文档

编辑

搜索文档编辑

已索引的文档可供近乎实时地搜索。

有关搜索请求的完整说明，请参阅 Elasticsearch 文档：搜索数据、查询 DSL 和搜索 API。

简单搜索查询编辑

可以组合多种类型的搜索查询。我们将从简单的文本匹配查询开始，在 products 索引中搜索自行车。

搜索结果具有 hits 属性，其中包含与查询匹配的文档以及有关索引中存在的匹配总数的信息。

总数值带有一个关系，指示总数是精确的（eq - 等于）还是近似的（gte - 大于或等于）。

每个返回的文档都带有其相关性得分及其在索引中的位置的附加信息。

String searchText = "bike";

SearchResponse<Product> response = esClient.search(s -> s
    .index("products") 
    .query(q -> q      
        .match(t -> t   
            .field("name")  
            .query(searchText)
        )
    ),
    Product.class      
);

TotalHits total = response.hits().total();
boolean isExactResult = total.relation() == TotalHitsRelation.Eq;

if (isExactResult) {
    logger.info("There are " + total.value() + " results");
} else {
    logger.info("There are more than " + total.value() + " results");
}

List<Hit<Product>> hits = response.hits().hits();
for (Hit<Product> hit: hits) {
    Product product = hit.source();
    logger.info("Found product " + product.getSku() + ", score " + hit.score());
}

	我们要搜索的索引的名称。
	搜索请求的查询部分（搜索请求还可以具有其他组件，例如聚合）。
	从众多可用的查询变体中选择一个。我们在这里选择匹配查询（全文搜索）。
	配置匹配查询：我们在 `name` 字段中搜索一个词。
	匹配文档的目标类。我们在这里使用 `Product`，就像在获取请求示例中一样。

与获取操作类似，您可以通过使用相应的目标类（例如 JSON-P 的 JsonValue 或 Jackson 的 ObjectNode）而不是 Product 来获取与查询匹配的文档作为原始 JSON。

嵌套搜索查询编辑

Elasticsearch 允许组合单个查询以构建更复杂的搜索请求。在下面的示例中，我们将搜索价格最高为 200 的自行车。

String searchText = "bike";
double maxPrice = 200.0;

// Search by product name
Query byName = MatchQuery.of(m -> m 
    .field("name")
    .query(searchText)
)._toQuery(); 

// Search by max price
Query byMaxPrice = RangeQuery.of(r -> r
    .field("price")
    .gte(JsonData.of(maxPrice)) 
)._toQuery();

// Combine name and price queries to search the product index
SearchResponse<Product> response = esClient.search(s -> s
    .index("products")
    .query(q -> q
        .bool(b -> b 
            .must(byName) 
            .must(byMaxPrice)
        )
    ),
    Product.class
);

List<Hit<Product>> hits = response.hits().hits();
for (Hit<Product> hit: hits) {
    Product product = hit.source();
    logger.info("Found product " + product.getSku() + ", score " + hit.score());
}

	我们正在分别创建针对各个条件的查询。
	`MatchQuery` 是一个查询变体，我们必须将其转换为 `Query` 联合类型。有关其他详细信息，请参阅变体类型。
	Elasticsearch 范围查询接受各种值类型。我们在这里创建最高价格的 JSON 表示形式。
	搜索查询是一个布尔查询，它结合了文本搜索和最高价格查询。
	两个查询都添加为 `must`，因为我们希望结果匹配所有条件。

模板化搜索编辑

搜索模板是可以使用不同变量运行的存储搜索。搜索模板允许您在不修改应用程序代码的情况下更改搜索。

在运行模板搜索之前，您首先必须创建模板。这是一个存储的脚本，它返回搜索请求正文，通常定义为 Mustache 模板。此存储的脚本可以在应用程序外部创建，也可以使用 Java API 客户端创建

// Create a script
esClient.putScript(r -> r
    .id("query-script") 
    .script(s -> s
        .lang("mustache")
        .source("{\"query\":{\"match\":{\"{{field}}\":\"{{value}}\"}}}")
    ));

要创建的模板脚本的标识符。

要使用搜索模板，请使用 searchTemplate 方法引用脚本并为其参数提供值

SearchTemplateResponse<Product> response = esClient.searchTemplate(r -> r
        .index("some-index")
        .id("query-script") 
        .params("field", JsonData.of("some-field")) 
        .params("value", JsonData.of("some-data")),
    Product.class
);

List<Hit<Product>> hits = response.hits().hits();
for (Hit<Product> hit: hits) {
    Product product = hit.source();
    logger.info("Found product " + product.getSku() + ", score " + hit.score());
}

	要使用的模板脚本的标识符。
	模板参数值。

有关更深入的信息，请参阅 Elasticsearch 搜索模板文档。

以上示例的源代码可以在 Java API 客户端测试中找到。

« 通过 ID 读取文档聚合 »