properties

properties

タイプマッピング、object fields および nested fields には、properties と呼ばれるサブフィールドが含まれています。これらのプロパティは、object や nested を含む任意の データ型 である可能性があります。プロパティは次のように追加できます：

• インデックスを作成する ときに明示的に定義することによって。
• マッピングタイプを更新する API を使用して追加または更新するときに明示的に定義することによって。
• 新しいフィールドを含むドキュメントをインデックスすることによって 動的に 追加することによって。

以下は、properties をマッピングタイプに追加する例であり、object フィールドおよび nested フィールドです：

Python

resp = client.indices.create(
   index="my-index-000001",
   mappings={
   "properties": {
   "manager": {
   "properties": {
   "age": {
   "type": "integer"
   },
   "name": {
   "type": "text"
   }
   }
   },
   "employees": {
   "type": "nested",
   "properties": {
   "age": {
   "type": "integer"
   },
   "name": {
   "type": "text"
   }
   }
   }
   }
   },
)
print(resp)
resp1 = client.index(
   index="my-index-000001",
   id="1",
   document={
   "region": "US",
   "manager": {
   "name": "Alice White",
   "age": 30
   },
   "employees": [
   {
   "name": "John Smith",
   "age": 34
   },
   {
   "name": "Peter Brown",
   "age": 26
   }
   ]
   },
)
print(resp1)

Ruby

response = client.indices.create(
  index: 'my-index-000001',
  body: {
   mappings: {
   properties: {
   manager: {
   properties: {
   age: {
   type: 'integer'
   },
   name: {
   type: 'text'
   }
   }
   },
   employees: {
   type: 'nested',
   properties: {
   age: {
   type: 'integer'
   },
   name: {
   type: 'text'
   }
   }
   }
   }
   }
  }
)
puts response
response = client.index(
  index: 'my-index-000001',
  id: 1,
  body: {
   region: 'US',
   manager: {
   name: 'Alice White',
   age: 30
   },
   employees: [
   {
   name: 'John Smith',
   age: 34
   },
   {
   name: 'Peter Brown',
   age: 26
   }
   ]
  }
)
puts response

Js

const response = await client.indices.create({
  index: "my-index-000001",
  mappings: {
   properties: {
   manager: {
   properties: {
   age: {
   type: "integer",
   },
   name: {
   type: "text",
   },
   },
   },
   employees: {
   type: "nested",
   properties: {
   age: {
   type: "integer",
   },
   name: {
   type: "text",
   },
   },
   },
   },
  },
});
console.log(response);
const response1 = await client.index({
  index: "my-index-000001",
  id: 1,
  document: {
   region: "US",
   manager: {
   name: "Alice White",
   age: 30,
   },
   employees: [
   {
   name: "John Smith",
   age: 34,
   },
   {
   name: "Peter Brown",
   age: 26,
   },
   ],
  },
});
console.log(response1);

Console

PUT my-index-000001
{
  "mappings": {
   "properties": {
   "manager": {
   "properties": {
   "age":  { "type": "integer" },
   "name": { "type": "text"  }
   }
   },
   "employees": {
   "type": "nested",
   "properties": {
   "age":  { "type": "integer" },
   "name": { "type": "text"  }
   }
   }
   }
  }
}
PUT my-index-000001/_doc/1
{
  "region": "US",
  "manager": {
   "name": "Alice White",
   "age": 30
  },
  "employees": [
   {
   "name": "John Smith",
   "age": 34
   },
   {
   "name": "Peter Brown",
   "age": 26
   }
  ]
}

properties 設定は、同じインデックス内の同じ名前のフィールドに対して異なる設定を持つことが許可されています。新しいプロパティは、更新マッピングAPI を使用して既存のフィールドに追加できます。

Dot notation

内部フィールドは、ドット表記を使用してクエリ、集計などで参照できます：

Python

resp = client.search(
   index="my-index-000001",
   query={
   "match": {
   "manager.name": "Alice White"
   }
   },
   aggs={
   "Employees": {
   "nested": {
   "path": "employees"
   },
   "aggs": {
   "Employee Ages": {
   "histogram": {
   "field": "employees.age",
   "interval": 5
   }
   }
   }
   }
   },
)
print(resp)

Ruby

response = client.search(
  index: 'my-index-000001',
  body: {
   query: {
   match: {
   'manager.name' => 'Alice White'
   }
   },
   aggregations: {
   "Employees": {
   nested: {
   path: 'employees'
   },
   aggregations: {
   "Employee Ages": {
   histogram: {
   field: 'employees.age',
   interval: 5
   }
   }
   }
   }
   }
  }
)
puts response

Js

const response = await client.search({
  index: "my-index-000001",
  query: {
   match: {
   "manager.name": "Alice White",
   },
  },
  aggs: {
   Employees: {
   nested: {
   path: "employees",
   },
   aggs: {
   "Employee Ages": {
   histogram: {
   field: "employees.age",
   interval: 5,
   },
   },
   },
   },
  },
});
console.log(response);

Console

GET my-index-000001/_search
{
  "query": {
   "match": {
   "manager.name": "Alice White"
   }
  },
  "aggs": {
   "Employees": {
   "nested": {
   "path": "employees"
   },
   "aggs": {
   "Employee Ages": {
   "histogram": {
   "field": "employees.age",
   "interval": 5
   }
   }
   }
   }
  }
}

内部フィールドへの完全なパスを指定する必要があります。