null_value

null_value

null 値はインデックス化または検索することができません。フィールドが null に設定されている場合（または空の配列や null 値の配列の場合）、そのフィールドには値がないかのように扱われます。

null_value パラメータを使用すると、指定された値で明示的な null 値を置き換えることができ、インデックス化および検索が可能になります。例えば:

Python

resp = client.indices.create(
   index="my-index-000001",
   mappings={
   "properties": {
   "status_code": {
   "type": "keyword",
   "null_value": "NULL"
   }
   }
   },
)
print(resp)
resp1 = client.index(
   index="my-index-000001",
   id="1",
   document={
   "status_code": None
   },
)
print(resp1)
resp2 = client.index(
   index="my-index-000001",
   id="2",
   document={
   "status_code": []
   },
)
print(resp2)
resp3 = client.search(
   index="my-index-000001",
   query={
   "term": {
   "status_code": "NULL"
   }
   },
)
print(resp3)

Ruby

response = client.indices.create(
  index: 'my-index-000001',
  body: {
   mappings: {
   properties: {
   status_code: {
   type: 'keyword',
   nil_value: 'NULL'
   }
   }
   }
  }
)
puts response
response = client.index(
  index: 'my-index-000001',
  id: 1,
  body: {
   status_code: nil
  }
)
puts response
response = client.index(
  index: 'my-index-000001',
  id: 2,
  body: {
   status_code: []
  }
)
puts response
response = client.search(
  index: 'my-index-000001',
  body: {
   query: {
   term: {
   status_code: 'NULL'
   }
   }
  }
)
puts response

Js

const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
   properties: {
   status_code: {
   type: "keyword",
   null_value: "NULL",
   },
   },
  },
});
console.log(response);
const response1 = await client.index({
  index: "my-index-000001",
  id: 1,
  document: {
   status_code: null,
  },
});
console.log(response1);
const response2 = await client.index({
  index: "my-index-000001",
  id: 2,
  document: {
   status_code: [],
  },
});
console.log(response2);
const response3 = await client.search({
  index: "my-index-000001",
  query: {
   term: {
   status_code: "NULL",
   },
  },
});
console.log(response3);

Console

PUT my-index-000001
{
  "mappings": {
   "properties": {
   "status_code": {
   "type":       "keyword",
   "null_value": "NULL"
   }
   }
  }
}
PUT my-index-000001/_doc/1
{
  "status_code": null
}
PUT my-index-000001/_doc/2
{
  "status_code": []
}
GET my-index-000001/_search
{
  "query": {
   "term": {
   "status_code": "NULL"
   }
  }
}

null_value はフィールドと同じデータ型である必要があります。例えば、long フィールドには文字列 null_value を持つことはできません。

null_value はデータがインデックス化される方法にのみ影響し、_source ドキュメントを変更することはありません。