Elasticsearch Guide[7.15]翻译 Aliases

Alias types

有如下两种类型的 aliases：

data stream alias 代表一个或多个 data stream
index alias 代表一个或多个 indices

alias 不能同时代表 data streams 和 indices。You can also cannot add a data stream’s backing index to an index alias。

Add an alias

给一个已存在的 data stream 或 index 添加 alias，使用 aliases API 的 add action。如果 alias 不存在，这个请求将会创建它。

POST _aliases
{"actions": [{"add": {"index": "logs-nginx.access-prod","alias": "logs"}}]
}

这个 API 的 index 和 indices 参数支持通配符 (*)。通配符模式同时匹配到 data strams 和 indices 时会返回一个 error。

POST _aliases
{"actions": [{"add": {"index": "logs-*","alias": "logs"}}]
}

Remove an alias

移除一个 alias，使用 aliases API 的 remove action。

POST _aliases
{"actions": [{"remove": {"index": "logs-nginx.access-prod","alias": "logs"}}]
}

Multiple actions

你可以在单次操作中使用 aliases API 执行多个 actions。

例如，这个 logs alias 只想一个独立的 data stream。如下请求交换了 stream 的 alias。在交换期间，logs alias 没有停止工作并且也没有同时指向两个 streams。

POST _aliases
{"actions": [{"remove": {"index": "logs-nginx.access-prod","alias": "logs"}},{"add": {"index": "logs-my_app-default","alias": "logs"}}]
}

Add an alias at index creation

你也可以使用一个 component template 或 index template 在 index 创建时给 index 添加 aliases。但是，不能使用 component template 或 index template 给 data stream 添加 alias。

# Component template with index aliases
PUT _component_template/my-aliases
{"template": {"aliases": {"my-alias": {}}}
}# Index template with index aliases
PUT _index_template/my-index-template
{"index_patterns": ["my-index-*"],"composed_of": ["my-aliases","my-mappings","my-settings"],"template": {"aliases": {"yet-another-alias": {}}}
}

你也可以在 create index API 请求中指定 index 的 aliases。

# PUT <my-index-{now/d}-000001>
PUT %3Cmy-index-%7Bnow%2Fd%7D-000001%3E
{"aliases": {"my-alias": {}}
}

View aliases

使用无参数的 get alias API 请求，获取集群的 aliases 清单。

GET _alias

在 _alias 之前指定 data stream 或 index，查看它的所有 aliases。

GET erp_job/_alias

返回结果如下：

{"erp_job" : {"aliases" : {"erp_job_alias" : { },"erp_job_alias_2" : { }}}
}

在 _alias 后指定一个 alias 来查看 alias 下的 data streams 或 indices。

GET _alias/logs

Write index

你可以使用 is_write_index 给 write index 或 write data stream 设置 alias。Elasticsearch 路由任何有关该 alias 的写请求到这个 index 或 data stream。

POST _aliases
{"actions": [{"add": {"index": "logs-nginx.access-prod","alias": "logs"}},{"add": {"index": "logs-my_app-default","alias": "logs","is_write_index": true}}]
}

如果一个 alias 指向多个没有设置 is_write_index 的 indics 或 data streams。那么该 alias 会拒绝写请求。如果一个 index alias 指向一个没有设置 is_write_index 的 index，那么该 index 会自动的表现为一个 write index。Data stream aliases 不会自动的设置成为一个 write data stream，即便这个 alias 指向一个 data stream。

TIP！我们建议使用 data stream 存储 append-only 时间序列数据。如果你频繁的更新或删除已有的时间序列数据，那么使用带有 index alias 的 write index 替代它。查看 Manage time series data without data streams。

Filter an alias

filter 选项使用 Query DSL 来限制 alias 不能访问的 documents。Data stream aliases 不支持 filter。

POST _aliases
{"actions": [{"add": {"index": "my-index-2099.05.06-000001","alias": "my-alias","filter": {"bool": {"filter": [{"range": {"@timestamp": {"gte": "now-1d/d","lt": "now/d"}}},{"term": {"user.id": "kimchy"}}]}}}}]
}

Routing

使用 routing 选项路由 alias 请求到指定的 shard。这可以让你利用 shard caches 来提升搜索速度。Data stream aliases 不支持路由选项。

POST _aliases
{"actions": [{"add": {"index": "my-index-2099.05.06-000001","alias": "my-alias","routing": "1"}}]
}

使用 index_routing 和 search_routing 给“索引” 和 “搜索”指定不同的路由值。如果这么做，这些选项会覆盖各自操作的 routing 值。

POST _aliases
{"actions": [{"add": {"index": "my-index-2099.05.06-000001","alias": "my-alias","search_routing": "1","index_routing": "2"}}]
}