Context Suggester
完成suggester考虑索引中的所有文档,但通常希望提供通过某些标准过滤和/或提升的suggestion。 例如,您想要suggestion由某些艺术家过滤的歌曲标题,或者要根据其流派提高歌曲标题。
要实现suggestion过滤和/或提升,您可以在配置完成字段时添加上下文映射。 您可以为完成字段定义多个上下文映射。 每个上下文映射都有唯一的名称和类型。 有两种类型:category 和geo。 上下文映射在字段映射中的contexts参数下配置。
以下定义了类型,每个类型都有一个完成字段的两个上下文映射:
PUT place
{
"mappings": {
"shops" : {
"properties" : {
"suggest" : {
"type" : "completion",
"contexts": [
{ # 1
"name": "place_type",
"type": "category",
"path": "cat"
},
{ # 2
"name": "location",
"type": "geo",
"precision": 4
}
]
}
}
}
}
}
PUT place_path_category
{
"mappings": {
"shops" : {
"properties" : {
"suggest" : {
"type" : "completion",
"contexts": [
{ # 3
"name": "place_type",
"type": "category",
"path": "cat"
},
{ # 4
"name": "location",
"type": "geo",
"precision": 4,
"path": "loc"
}
]
},
"loc": {
"type": "geo_point"
}
}
}
}
}
① 定义名为place_type的category上下文,其中类别必须与suggestions一起发送。
② 定义geo context名为location,类别必须与 suggestions 一起发送。
③ 定义名为place_type的category上下文,其中从cat字段读取类别。
④ 定义geo context 名为location,其中从loc字段读到categories 。
添加上下文映射会增加完成字段的索引大小。 完成索引是完全堆驻留,您可以使用Indices Stats监视完成字段索引大小。
类别上下文(Category Context)
category context 允许您在索引时间将一个或多个类别与suggestions相关联。 在查询时,可以根据相关类别对suggestions进行过滤和提升。
映射设置为上面的place_type字段。 如果定义了路径,则从文档中的该路径读取类别,否则它们必须在suggest 字段中发送,如下所示:
PUT place/shops/1
{
"suggest": {
"input": ["timmy's", "starbucks", "dunkin donuts"],
"contexts": {
"place_type": ["cafe", "food"] ①
}
}
}
① 这些suggestions将与 cafe 和 food 类别相关联。
如果映射具有path,则以下索引请求将足以添加categories:
PUT place_path_category/shops/1
{
"suggest": ["timmy's", "starbucks", "dunkin donuts"],
"cat": ["cafe", "food"] ①
}
① 这些suggestions将与 cafe 和 food 类别相关联。
如果上下文映射引用另一个字段,并且类别已明确编入索引,则suggestions将使用这两个类别进行索引。
类别查询
suggestions可以按一个或多个类别进行过滤。 以下过滤了多个类别的suggestions :
POST place/_suggest?pretty
{
"suggest" : {
"prefix" : "tim",
"completion" : {
"field" : "suggest",
"size": 10,
"contexts": {
"place_type": [ "cafe", "restaurants" ]
}
}
}
}
当在查询时未提供类别时,将考虑所有索引文档。 应避免在类别启用完成字段上没有类别的查询,因为它会降低搜索性能。
对某些类别的suggestions可以比其他类别更高。 以下内容按类别过滤suggestions,并增加与某些类别相关联的suggestions:
POST place/_suggest?pretty
{
"suggest" : {
"prefix" : "tim",
"completion" : {
"field" : "suggest",
"size": 10,
"contexts": {
"place_type": [ ①
{ "context" : "cafe" },
{ "context" : "restaurants", "boost": 2 }
]
}
}
}
}
① 与类别咖啡馆和餐馆相关联的上下文查询过滤suggestions,并且将与餐馆相关联的suggestions提高2倍
除了接受类别值之外,上下文查询可以由多个类别上下文子句组成。 类别上下文子句支持以下参数:
context
要过滤/升级的类别的值。 这是强制性的。
boost
应该提高suggestion的分数的因子,通过将增强乘以suggestion权重来计算分数,默认为1
prefix
类别值是否应被视为前缀。 例如,如果设置为true,则可以通过指定类型的类别前缀来过滤类型1,类型2等的类别。 默认为false
地理位置上下文
地理位置上下文允许您将一个或多个地理位置或地理位置隐藏与suggestions在索引时间关联。 在查询时,如果suggestions在指定地理位置的某个距离内,则可以对suggestions进行过滤和提升。
在内部,地理点被编码为具有指定精度的geohashes。
地理映射
除了路径设置,地理上下文映射接受以下设置:
precision
这定义了要建立索引的 geohash 的精度,并且可以指定为距离值(5m,10km等)或原始geohash精度(1..12)。 默认为原始geohash精度值6。
索引时间精度设置设置可在查询时使用的最大geohash精度。
索引地理上下文
地理上下文可以利用suggestions被显式地设置或者经由路径参数从文档中的地理点字段索引,类似于类别上下文。 将多个地理位置上下文与suggestion关联,将对每个地理位置的suggestion建立索引。 以下对具有两个地理位置上下文的suggestion进行索引:
PUT place/shops/1
{
"suggest": {
"input": "timmy's",
"contexts": {
"location": [
{
"lat": 43.6624803,
"lon": -79.3863353
},
{
"lat": 43.6624718,
"lon": -79.3873227
}
]
}
}
}
地理位置查询
suggestions可以根据它们与一个或多个地理点的接近程度而被过滤和提升。 以下过滤suggestions落在由地理点的编码geohash表示的区域内:
POST place/_suggest
{
"suggest" : {
"prefix" : "tim",
"completion" : {
"field" : "suggest",
"size": 10,
"contexts": {
"location": {
"lat": 43.662,
"lon": -79.380
}
}
}
}
}
当指定在查询时具有较低精度的位置时,将考虑落入该区域内的所有suggestions。
位于由geohash表示的区域内的suggestions也可以比其他suggestion更高,如下所示:
POST place/_suggest?pretty
{
"suggest" : {
"prefix" : "tim",
"completion" : {
"field" : "suggest",
"size": 10,
"contexts": {
"location": [ ①
{
"lat": 43.6624803,
"lon": -79.3863353,
"precision": 2
},
{
"context": {
"lat": 43.6624803,
"lon": -79.3863353
},
"boost": 2
}
]
}
}
}
}
① 上下文查询过滤的suggestions落在由(43.662,-79.380)的geohash表示的地理位置(精度为2)下方的suggestions,并提升落在(43.6624803,-79.3863353)的geohash表示形式下的默认精度为6的suggestions乘以因子2。
除了接受上下文值,上下文查询可以由多个上下文子句组成。 类别上下文子句支持以下参数:
context
要过滤或提升suggestion的地理点对象或地理哈希字符串。 这是强制性的。
boost
应该提高suggestion的分数的因子,通过将增强乘以suggestion权重来计算分数,默认为1
precision
geohash对查询地理点进行编码的精度。 这可以指定为距离值(5m,10km等),或作为原始geohash精度(1..12)。 默认为索引时间精度级别。
neighbours
接受精度值数组,在该数组处应考虑相邻的地理散列。 精度值可以是距离值(5m,10km等)或原始geohash精度(1..12)。 默认为生成索引时间精度级别的邻居。
Last updated
Was this helpful?