position_increment_gap

position_increment_gap

Analyzed テキストフィールドは、positions を考慮に入れ、proximity or phrase queries をサポートできるようにします。複数の値を持つテキストフィールドをインデックスする際、値の間に「フェイク」ギャップが追加され、ほとんどのフレーズクエリが値をまたいで一致しないようにします。このギャップのサイズは position_increment_gap を使用して設定され、デフォルトは 100 です。

例えば:

Python

resp = client.index(
   index="my-index-000001",
   id="1",
   document={
   "names": [
   "John Abraham",
   "Lincoln Smith"
   ]
   },
)
print(resp)
resp1 = client.search(
   index="my-index-000001",
   query={
   "match_phrase": {
   "names": {
   "query": "Abraham Lincoln"
   }
   }
   },
)
print(resp1)
resp2 = client.search(
   index="my-index-000001",
   query={
   "match_phrase": {
   "names": {
   "query": "Abraham Lincoln",
   "slop": 101
   }
   }
   },
)
print(resp2)

Ruby

response = client.index(
  index: 'my-index-000001',
  id: 1,
  body: {
   names: [
   'John Abraham',
   'Lincoln Smith'
   ]
  }
)
puts response
response = client.search(
  index: 'my-index-000001',
  body: {
   query: {
   match_phrase: {
   names: {
   query: 'Abraham Lincoln'
   }
   }
   }
  }
)
puts response
response = client.search(
  index: 'my-index-000001',
  body: {
   query: {
   match_phrase: {
   names: {
   query: 'Abraham Lincoln',
   slop: 101
   }
   }
   }
  }
)
puts response

Js

const response = await client.index({
  index: "my-index-000001",
  id: 1,
  document: {
   names: ["John Abraham", "Lincoln Smith"],
  },
});
console.log(response);
const response1 = await client.search({
  index: "my-index-000001",
  query: {
   match_phrase: {
   names: {
   query: "Abraham Lincoln",
   },
   },
  },
});
console.log(response1);
const response2 = await client.search({
  index: "my-index-000001",
  query: {
   match_phrase: {
   names: {
   query: "Abraham Lincoln",
   slop: 101,
   },
   },
  },
});
console.log(response2);

Console

PUT my-index-000001/_doc/1
{
  "names": [ "John Abraham", "Lincoln Smith"]
}
GET my-index-000001/_search
{
  "query": {
   "match_phrase": {
   "names": {
   "query": "Abraham Lincoln"
   }
   }
  }
}
GET my-index-000001/_search
{
  "query": {
   "match_phrase": {
   "names": {
   "query": "Abraham Lincoln",
   "slop": 101
   }
   }
  }
}

position_increment_gap はマッピングで指定できます。例えば:

Python

resp = client.indices.create(
   index="my-index-000001",
   mappings={
   "properties": {
   "names": {
   "type": "text",
   "position_increment_gap": 0
   }
   }
   },
)
print(resp)
resp1 = client.index(
   index="my-index-000001",
   id="1",
   document={
   "names": [
   "John Abraham",
   "Lincoln Smith"
   ]
   },
)
print(resp1)
resp2 = client.search(
   index="my-index-000001",
   query={
   "match_phrase": {
   "names": "Abraham Lincoln"
   }
   },
)
print(resp2)

Ruby

response = client.indices.create(
  index: 'my-index-000001',
  body: {
   mappings: {
   properties: {
   names: {
   type: 'text',
   position_increment_gap: 0
   }
   }
   }
  }
)
puts response
response = client.index(
  index: 'my-index-000001',
  id: 1,
  body: {
   names: [
   'John Abraham',
   'Lincoln Smith'
   ]
  }
)
puts response
response = client.search(
  index: 'my-index-000001',
  body: {
   query: {
   match_phrase: {
   names: 'Abraham Lincoln'
   }
   }
  }
)
puts response

Js

const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
   properties: {
   names: {
   type: "text",
   position_increment_gap: 0,
   },
   },
  },
});
console.log(response);
const response1 = await client.index({
  index: "my-index-000001",
  id: 1,
  document: {
   names: ["John Abraham", "Lincoln Smith"],
  },
});
console.log(response1);
const response2 = await client.search({
  index: "my-index-000001",
  query: {
   match_phrase: {
   names: "Abraham Lincoln",
   },
  },
});
console.log(response2);

Console

PUT my-index-000001
{
  "mappings": {
   "properties": {
   "names": {
   "type": "text",
   "position_increment_gap": 0
   }
   }
  }
}
PUT my-index-000001/_doc/1
{
  "names": [ "John Abraham", "Lincoln Smith"]
}
GET my-index-000001/_search
{
  "query": {
   "match_phrase": {
   "names": "Abraham Lincoln"
   }
  }
}