親のIDクエリ
特定の親ドキュメントに対する子ドキュメントを返します joined。同じインデックス内のドキュメント間で親子関係を作成するために、join フィールドマッピングを使用できます。
リクエストの例
インデックス設定
parent_id
クエリを使用するには、インデックスに join フィールドマッピングが含まれている必要があります。parent_id
クエリのためにインデックスを設定する方法を確認するには、次の例を試してください。
- 1. join フィールドマッピングを持つインデックスを作成します。
Python
resp = client.indices.create(
index="my-index-000001",
mappings={
"properties": {
"my-join-field": {
"type": "join",
"relations": {
"my-parent": "my-child"
}
}
}
},
)
print(resp)
Ruby
response = client.indices.create(
index: 'my-index-000001',
body: {
mappings: {
properties: {
"my-join-field": {
type: 'join',
relations: {
"my-parent": 'my-child'
}
}
}
}
}
)
puts response
Js
const response = await client.indices.create({
index: "my-index-000001",
mappings: {
properties: {
"my-join-field": {
type: "join",
relations: {
"my-parent": "my-child",
},
},
},
},
});
console.log(response);
コンソール
PUT /my-index-000001
{
"mappings": {
"properties": {
"my-join-field": {
"type": "join",
"relations": {
"my-parent": "my-child"
}
}
}
}
}
- 2. IDが
1
の親ドキュメントをインデックスします。
Python
resp = client.index(
index="my-index-000001",
id="1",
refresh=True,
document={
"text": "This is a parent document.",
"my-join-field": "my-parent"
},
)
print(resp)
Ruby
response = client.index(
index: 'my-index-000001',
id: 1,
refresh: true,
body: {
text: 'This is a parent document.',
"my-join-field": 'my-parent'
}
)
puts response
Js
const response = await client.index({
index: "my-index-000001",
id: 1,
refresh: "true",
document: {
text: "This is a parent document.",
"my-join-field": "my-parent",
},
});
console.log(response);
コンソール
PUT /my-index-000001/_doc/1?refresh
{
"text": "This is a parent document.",
"my-join-field": "my-parent"
}
- 3. 親ドキュメントの子ドキュメントをインデックスします。
Python
resp = client.index(
index="my-index-000001",
id="2",
routing="1",
refresh=True,
document={
"text": "This is a child document.",
"my-join-field": {
"name": "my-child",
"parent": "1"
}
},
)
print(resp)
Js
const response = await client.index({
index: "my-index-000001",
id: 2,
routing: 1,
refresh: "true",
document: {
text: "This is a child document.",
"my-join-field": {
name: "my-child",
parent: "1",
},
},
});
console.log(response);
コンソール
PUT /my-index-000001/_doc/2?routing=1&refresh
{
"text": "This is a child document.",
"my-join-field": {
"name": "my-child",
"parent": "1"
}
}
クエリの例
次の検索は、IDが 1
の親ドキュメントの子ドキュメントを返します。
Python
resp = client.search(
index="my-index-000001",
query={
"parent_id": {
"type": "my-child",
"id": "1"
}
},
)
print(resp)
Js
const response = await client.search({
index: "my-index-000001",
query: {
parent_id: {
type: "my-child",
id: "1",
},
},
});
console.log(response);
コンソール
GET /my-index-000001/_search
{
"query": {
"parent_id": {
"type": "my-child",
"id": "1"
}
}
}
parent_idのトップレベルパラメータ
type
- (必須、文字列) join フィールドにマッピングされた子関係の名前。
id
- (必須、文字列) 親ドキュメントのID。このクエリは、この親ドキュメントの子ドキュメントを返します。
ignore_unmapped
- (オプション、Boolean) マッピングされていない
type
を無視し、エラーの代わりにドキュメントを返さないかどうかを示します。デフォルトはfalse
です。false
の場合、Elasticsearchはtype
がマッピングされていない場合にエラーを返します。
このパラメータを使用して、type
を含まない可能性のある複数のインデックスをクエリできます。