标签:
Because nested objects are indexed as separate hidden documents, we can’t query them directly. Instead, we have to use the nested
query to access them:
GET /my_index/blogpost/_search { "query": { "bool": { "must": [ { "match": { "title": "eggs" }}, { "nested": { "path": "comments", "query": { "bool": { "must": [ { "match": { "comments.name": "john" }}, { "match": { "comments.age": 28 }} ] }}}} ] }}}
①Thetitle
clause operates on the root document.
②Thenested
clause “steps down” into the nestedcomments
field. It no longer has access to fields in the root document, nor fields in any other nested document.
③ Thecomments.name
andcomments.age
clauses operate on the same nested document
nested
field can contain other nested
fields. Similarly, a nested
query can contain othernested
queries. The nesting hierarchy is applied as you would expect.Of course, a nested
query could match several nested documents. Each matching nested document would have its own relevance score, but these multiple scores need to be reduced to a single score that can be applied to the root document.
By default, it averages the scores of the matching nested documents. This can be controlled by setting thescore_mode
parameter to avg
, max
, sum
, or even none
(in which case the root document gets a constant score of 1.0
).
GET /my_index/blogpost/_search
{
"query": {
"bool": {
"must": [
{ "match": { "title": "eggs" }},
{
"nested": {
"path": "comments",
"score_mode": "max",
"query": {
"bool": {
"must": [
{ "match": { "comments.name": "john" }},
{ "match": { "comments.age": 28 }}
]
}}}}
]
}}}
_score
from the best-matching nested document.If placed inside the filter
clause of a Boolean query, a nested
query behaves much like anested
query, except that it doesn’t accept the score_mode
parameter. Because it is being used as a non-scoring query — it includes or excludes, but doesn’t score — a score_mode
doesn’t make sense since there is nothing to score.
curl -XPOST "http://localhost:9200/index-1/movie/" -d‘
{
"title": "The Matrix",
"cast": [
{
"firstName": "Keanu",
"lastName": "Reeves"
},
{
"firstName": "Laurence",
"lastName": "Fishburne"
}
]
}‘
Given many such movies in our index we can find all movies with an actor named "Keanu" using a search request such as:
curl -XPOST "http://localhost:9200/index-1/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"term": {
"cast.firstName": "keanu"
}
}
}
}
}‘
Running the above query indeed returns The Matrix. The same is true if we try to find movies that have an actor with the first name "Keanu" and last name "Reeves":
curl -XPOST "http://localhost:9200/index-1/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"bool": {
"must": [
{
"term": {
"cast.firstName": "keanu"
}
},
{
"term": {
"cast.lastName": "reeves"
}
}
]
}
}
}
}
}‘
Or at least so it seems. However, let‘s see what happens if we search for movies with an actor with "Keanu" as first name and "Fishburne" as last name.
curl -XPOST "http://localhost:9200/index-1/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"bool": {
"must": [
{
"term": {
"cast.firstName": "keanu"
}
},
{
"term": {
"cast.lastName": "fishburne"
}
}
]
}
}
}
}
}‘
Clearly this should, at first glance, not match The Matrix as there‘s no such actor amongst its cast. However, ElasticSearch will return The Matrix for the above query. After all, the movie does contain an author with "Keanu" as first name and (albeit a different) actor with "Fishburne" as last name. Based on the above query it has no way of knowing that we want the two term filters to match the same unique object in the list of actors. And even if it did, the way the data is indexed it wouldn‘t be able to handle that requirement.
Luckily ElasticSearch provides a way for us to be able to filter on multiple fields within the same objects in arrays; mapping such fields as nested. To try this out, let‘s create ourselves a new index with the "actors" field mapped as nested.
curl -XPUT "http://localhost:9200/index-2" -d‘
{
"mappings": {
"movie": {
"properties": {
"cast": {
"type": "nested"
}
}
}
}
}‘
After indexing the same movie document into the new index we can now find movies based on multiple properties of each actor by using a nested filter. Here‘s how we would search for movies starring an actor named "Keanu Fishburne":
curl -XPOST "http://localhost:9200/index-2/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"nested": {
"path": "cast",
"filter": {
"bool": {
"must": [
{
"term": {
"firstName": "keanu"
}
},
{
"term": {
"lastName": "fishburne"
}
}
]
}
}
}
}
}
}
}‘
As you can see we‘ve wrapped our initial bool filter in a nested filter. The nested filter contains a path property where we specify that the filter applies to the cast property of the searched document. It also contains a filter (or a query) which will be applied to each value within the nested property.
As intended, running the abobe query doesn‘t return The Matrix while modifying it to instead match "Reeves" as last name will make it match The Matrix. However, there‘s one caveat.
If we go back to our very first query, filtering only on actors first names without using a nested filter, like the request below, we won‘t get any hits.
curl -XPOST "http://localhost:9200/index-2/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"term": {
"cast.firstName": "keanu"
}
}
}
}
}‘
This happens because movie documents no longer have cast.firstName fields. Instead each element in the cast array is, internally in ElasticSearch, indexed as a separate document.
Obviously we can still search for movies based only on first names amongst the cast, by using nested filters though. Like this:
curl -XPOST "http://localhost:9200/index-2/movie/_search" -d‘
{
"query": {
"filtered": {
"query": {
"match_all": {}
},
"filter": {
"nested": {
"path": "cast",
"filter": {
"term": {
"firstName": "keanu"
}
}
}
}
}
}
}‘
The above request returns The Matrix. However, sometimes having to use nested filters or queries when all we want to do is filter on a single property is a bit tedious. To be able to utilize the power of nested filters for complex criterias while still being able to filter on values in arrays the same way as if we hadn‘t mapped such properties as nested we can modify our mappings so that the nested values will also be included in the parent document. This is done using theinclude_in_parent property, like this:
curl -XPUT "http://localhost:9200/index-3" -d‘
{
"mappings": {
"movie": {
"properties": {
"cast": {
"type": "nested",
"include_in_parent": true
}
}
}
}
}‘
In an index such as the one created with the above request we‘ll both be able to filter on combinations of values within the same complex objects in the actors array using nested filters while still being able to filter on single fields without using nested filters. However, we now need to carefully consider where to use, and where to not use, nested filters in our queries as a query for "Keanu Fishburne" will match The Matrix using a regular bool filter while it won‘t when wrapping it in a nested filter. In other words, when using include_in_parent we may get unexpected results due to queries matching documents that it shouldn‘t if we forget to use nested filters.
PS. For updates about new posts, sites I find useful and the occasional rant you can follow me on Twitter. You are also most welcome to subscribe to the RSS-feed.
Read the doc on elasticsearch.org
As its name suggests, it can be an array of native types (string, int, …) but also an array of objects (the basis used for “objects” and “nested”).
Here are some valid indexing examples :
{ "Article" : [ { "id" : 12 "title" : "An article title", "categories" : [1,3,5,7], "tag" : ["elasticsearch", "symfony",‘Obtao‘], "author" : [ { "firstname" : "Francois", "surname": "francoisg", "id" : 18 }, { "firstname" : "Gregory", "surname" : "gregquat" "id" : "2" } ] } }, { "id" : 13 "title" : "A second article title", "categories" : [1,7], "tag" : ["elasticsearch", "symfony",‘Obtao‘], "author" : [ { "firstname" : "Gregory", "surname" : "gregquat", "id" : "2" } ] } }
You can find different Array :
We explicitely specify this “simple” type as it can be more easy/maintainable to store a flatten value rather than the complete object.
Using a non relational structure should make you think about a specific model for your search engine :
The inner objects are just the JSON object association in a parent. For example, the “authors” in the above example. The mapping for this example could be :
fos_elastica: clients: default: { host: %elastic_host%, port: %elastic_port% } indexes: blog : types: article : mappings: title : ~ categories : ~ tag : ~ author : type : object properties : firstname : ~ surname : ~ id : type : integer
You can Filter or Query on these “inner objects”. For example :
query: author.firstname=Francois
will return the post with the id 12 (and not the one with the id 13).
You can read more on the Elasticsearch website
Inner objects are easy to configure. As Elasticsearch documents are “schema less”, you can index them without specify any mapping.
The limitation of this method lies in the manner as ElasticSearch stores your data. Reusing the above example, here is the internal representation of our objects :
[ { "id" : 12 "title" : An article title", "categories" : [1,3,5,7], "tag" : ["elasticsearch", "symfony",‘Obtao‘], "author.firstname" : ["Francois","Gregory"], "author.surname" : ["Francoisg","gregquat"], "author.id" : [18,2] } { "id" : 13 "title" : "A second article", "categories" : [1,7], "tag" : ["elasticsearch", "symfony",‘Obtao‘], "author.firstname" : ["Gregory"], "author.surname" : ["gregquat"], "author.id" : [2] } ]
The consequence is that the query :
{ "query": { "filtered": { "query": { "match_all": {} }, "filter": { "term": { "firstname": "francois", "surname": "gregquat" } } } } }
author.firstname=Francois AND surname=gregquat
will return the document “12″. In the case of an inner object, this query can by translated as “Who has at least one author.surname = gregquat and one author.firstname=francois”.
To fix this problem, you must use the nested.
First important difference : nested must be specified in your mapping.
The mapping looks like an object one, only the type changes :
fos_elastica: clients: default: { host: %elastic_host%, port: %elastic_port% } indexes: blog : types: article : mappings: title : ~ categories : ~ tag : ~ author : type : nested properties : firstname : ~ surname : ~ id : type : integer
This time, the internal representation will be :
[ { "id" : 12 "title" : "An article title", "categories" : [1,3,5,7], "tag" : ["elasticsearch", "symfony",‘Obtao‘], "author" : [{ "firstname" : "Francois", "surname" : "Francoisg", "id" : 18 }, { "firstname" : "Gregory", "surname" : "gregquat", "id" : 2 }] }, { "id" : 13 "title" : "A second article title", "categories" : [1,7], "tags" : ["elasticsearch", "symfony",‘Obtao‘], "author" : [{ "firstname" : "Gregory", "surname" : "gregquat", "id" : 2 }] } ]
This time, we keep the object structure.
Nested have their own filters which allows to filter by nested object. If we go on with our example (with the limitation of inner objects), we can write this query :
{ "query": { "filtered": { "query": { "match_all": {} }, "filter": { "nested" : { "path" : "author", "filter": { "bool": { "must": [ { "term" : { "author.firsname": "francois" } }, { "term" : { "author.surname": "gregquat" } } ] } } } } } } }
hi
We can translate it as “Who has an author object whose surname is equal to ‘gregquat’ and whose firstname is ‘francois’”. This query will return no result.
There is still a problem which is penalizing when working with bug objects : when you want to change a single value of the nester, you have to reindex the whole parent document (including the nested).
If the objects are heavy, and often updated, the impact on performances can be important.
To fix this problem, you can use the parent/child associations.
Parent/child associations are very similar to OneToMany relationships (one parent, several children).
The relationship remains hierarchical : an object type is only associated to one parent, and it’s impossible to create a ManyToMany relationship.
We are going to link our article to a category :
fos_elastica: clients: default: { host: %elastic_host%, port: %elastic_port% } indexes: blog : types: category : mappings : id : ~ name : ~ description : ~ article : mappings: title : ~ tag : ~ author : ~ _routing: required: true path: category _parent: type : "category" identifier: "id" #optional as id is the default value property : "category" #optional as the default value is the type value
When indexing an article, a reference to the Category will also be indexed (category.id).
So, we can index separately categories and article while keeping the references between them.
Like for nested, there are Filters and Queries that allow to search on parents or children :
{ "query": { "has_child": { "type": "article", "query" : { "filtered": { "query": { "match_all": {}}, "filter" : { "term": {"tag": "symfony"} } } } } } }
This query will return the Categories that have at least one article tagged with “symfony”.
The queries are here written in JSON, but are easily transformable into PHP with the Elastica library.
标签:
原文地址:http://www.cnblogs.com/zhc-hnust/p/5441179.html