透传对象字段类型
编辑透传对象字段类型
编辑透传对象扩展了对象的功能，允许在不包含透传对象名称作为前缀的情况下访问其子字段。例如：
resp = client.indices.create(
index="my-index-000001",
mappings={
"properties": {
"attributes": {
"type": "passthrough",
"priority": 10,
"properties": {
"id": {
"type": "keyword"
}
}
}
}
},
)
print(resp)
resp1 = client.index(
index="my-index-000001",
id="1",
document={
"attributes": {
"id": "foo",
"zone": 10
}
},
)
print(resp1)
resp2 = client.search(
index="my-index-000001",
query={
"bool": {
"must": [
{
"match": {
"id": "foo"
}
},
{
"match": {
"zone": 10
}
}
]
}
},
)
print(resp2)
resp3 = client.search(
index="my-index-000001",
query={
"bool": {
"must": [
{
"match": {
"attributes.id": "foo"
}
},
{
"match": {
"attributes.zone": 10
}
}
]
}
},
)
print(resp3)
const response = await client.indices.create({
index: "my-index-000001",
mappings: {
properties: {
attributes: {
type: "passthrough",
priority: 10,
properties: {
id: {
type: "keyword",
},
},
},
},
},
});
console.log(response);
const response1 = await client.index({
index: "my-index-000001",
id: 1,
document: {
attributes: {
id: "foo",
zone: 10,
},
},
});
console.log(response1);
const response2 = await client.search({
index: "my-index-000001",
query: {
bool: {
must: [
{
match: {
id: "foo",
},
},
{
match: {
zone: 10,
},
},
],
},
},
});
console.log(response2);
const response3 = await client.search({
index: "my-index-000001",
query: {
bool: {
must: [
{
match: {
"attributes.id": "foo",
},
},
{
match: {
"attributes.zone": 10,
},
},
],
},
},
});
console.log(response3);
PUT my-index-000001
{
"mappings": {
"properties": {
"attributes": {
"type": "passthrough",
"priority": 10,
"properties": {
"id": {
"type": "keyword"
}
}
}
}
}
}
PUT my-index-000001/_doc/1
{
"attributes" : {
"id": "foo",
"zone": 10
}
}
GET my-index-000001/_search
{
"query": {
"bool": {
"must": [
{ "match": { "id": "foo" }},
{ "match": { "zone": 10 }}
]
}
}
}
GET my-index-000001/_search
{
"query": {
"bool": {
"must": [
{ "match": { "attributes.id": "foo" }},
{ "match": { "attributes.zone": 10 }}
]
}
}
}
|
一个对象被定义为透传对象。其优先级（必需）用于冲突解决。 |
|
|
对象内容像往常一样被索引，包括动态映射。 |
|
|
子字段可以在查询中被引用，就像它们被定义在根级别一样。 |
|
|
子字段也可以通过包含对象名称作为前缀来引用。 |
冲突解决
编辑在不同的作用域中定义的字段可能会出现冲突的名称，例如：
-
一个透传对象被定义在与透传对象子字段之一同名的字段旁边，例如：
resp = client.index( index="my-index-000001", id="1", document={ "attributes": { "id": "foo" }, "id": "bar" }, ) print(resp)const response = await client.index({ index: "my-index-000001", id: 1, document: { attributes: { id: "foo", }, id: "bar", }, }); console.log(response);PUT my-index-000001/_doc/1 { "attributes" : { "id": "foo" }, "id": "bar" }在这种情况下，对
id的引用指向根级别的字段，而字段attributes.id只能使用完整路径访问。 -
两个（或多个）透传对象在同一对象内定义，并且包含相同名称的字段，例如：
resp = client.indices.create( index="my-index-000002", mappings={ "properties": { "attributes": { "type": "passthrough", "priority": 10, "properties": { "id": { "type": "keyword" } } }, "resource.attributes": { "type": "passthrough", "priority": 20, "properties": { "id": { "type": "keyword" } } } } }, ) print(resp)const response = await client.indices.create({ index: "my-index-000002", mappings: { properties: { attributes: { type: "passthrough", priority: 10, properties: { id: { type: "keyword", }, }, }, "resource.attributes": { type: "passthrough", priority: 20, properties: { id: { type: "keyword", }, }, }, }, }, }); console.log(response);PUT my-index-000002 { "mappings": { "properties": { "attributes": { "type": "passthrough", "priority": 10, "properties": { "id": { "type": "keyword" } } }, "resource.attributes": { "type": "passthrough", "priority": 20, "properties": { "id": { "type": "keyword" } } } } } }在这种情况下，参数
priority用于冲突解决，较高的值具有优先权。在上面的示例中，resource.attributes的优先级高于attributes，因此对id的引用指向resource.attributes中的字段。attributes.id仍然可以使用其完整路径访问。
将子字段定义为时间序列维度
编辑可以将透传字段配置为 时间序列维度 的容器。在这种情况下，所有子字段都会在底层使用相同的参数进行注释，并且它们也会被包含在路由路径和 tsid 计算中，从而简化了 TSDS 的设置。
resp = client.indices.put_index_template(
name="my-metrics",
index_patterns=[
"metrics-mymetrics-*"
],
priority=200,
data_stream={},
template={
"settings": {
"index.mode": "time_series"
},
"mappings": {
"properties": {
"attributes": {
"type": "passthrough",
"priority": 10,
"time_series_dimension": True,
"properties": {
"host.name": {
"type": "keyword"
}
}
},
"cpu": {
"type": "integer",
"time_series_metric": "counter"
}
}
}
},
)
print(resp)
resp1 = client.index(
index="metrics-mymetrics-test",
document={
"@timestamp": "2020-01-01T00:00:00.000Z",
"attributes": {
"host.name": "foo",
"zone": "bar"
},
"cpu": 10
},
)
print(resp1)
const response = await client.indices.putIndexTemplate({
name: "my-metrics",
index_patterns: ["metrics-mymetrics-*"],
priority: 200,
data_stream: {},
template: {
settings: {
"index.mode": "time_series",
},
mappings: {
properties: {
attributes: {
type: "passthrough",
priority: 10,
time_series_dimension: true,
properties: {
"host.name": {
type: "keyword",
},
},
},
cpu: {
type: "integer",
time_series_metric: "counter",
},
},
},
},
});
console.log(response);
const response1 = await client.index({
index: "metrics-mymetrics-test",
document: {
"@timestamp": "2020-01-01T00:00:00.000Z",
attributes: {
"host.name": "foo",
zone: "bar",
},
cpu: 10,
},
});
console.log(response1);
PUT _index_template/my-metrics
{
"index_patterns": ["metrics-mymetrics-*"],
"priority": 200,
"data_stream": { },
"template": {
"settings": {
"index.mode": "time_series"
},
"mappings": {
"properties": {
"attributes": {
"type": "passthrough",
"priority": 10,
"time_series_dimension": true,
"properties": {
"host.name": {
"type": "keyword"
}
}
},
"cpu": {
"type": "integer",
"time_series_metric": "counter"
}
}
}
}
}
POST metrics-mymetrics-test/_doc
{
"@timestamp": "2020-01-01T00:00:00.000Z",
"attributes" : {
"host.name": "foo",
"zone": "bar"
},
"cpu": 10
}
在上面的示例中，attributes 被定义为维度容器。其子字段 host.name (静态) 和 zone (动态) 被包含在路由路径和 tsid 中，并且可以在查询中引用，而无需 attributes. 前缀。