索引的別名（index alias）

2014-09-02 本文已影响262人朱小虎XiaohuZhu

Neil Zhu，简书ID Not_GOD，University AI 创始人 & Chief Scientist，致力于推进世界人工智能化进程。制定并实施 UAI 中长期增长战略和目标，带领团队快速成长为人工智能领域最专业的力量。
作为行业领导者，他和UAI一起在2014年创建了TASA（中国最早的人工智能社团）, DL Center（深度学习知识中心全球价值网络），AI growth（行业智库培训）等，为中国的人工智能人才建设输送了大量的血液和养分。此外，他还参与或者举办过各类国际性的人工智能峰会和活动，产生了巨大的影响力，书写了60万字的人工智能精品技术内容，生产翻译了全球第一本深度学习入门书《神经网络与深度学习》，生产的内容被大量的专业垂直公众号和媒体转载与连载。曾经受邀为国内顶尖大学制定人工智能学习规划和教授人工智能前沿课程，均受学生和老师好评。

索引的別名

索引别名API允许为一个索引添加别名，所有API自动地把别名转化为实际上的索引名称。一个别名可以被映射到多个索引上，在指定时，别名将会自动地扩展别名索引上。一个别名还可以关联上一个可以在搜索时自动应用的过滤器和路由值。

下面是例子：

curl -XPOST localhost:9200/_aliases -d'
{
    "actions" : [
        { "add" : { "index" : "test1", "alias" : "alias1" } } 
    ]
}'

别名同样可以删除，例如：

curl -XPOST localhost:9200/_aliases -d'
{
    "actions" : [
        { "remove" : { "index" : "test1", "alias" : "alias1" } }
    ]
}'

重命名一个别名就是在相同的API下简单地先删除然后添加的过程。这个操作是原子的。不需要担心别名在一小段时间内不会指向一个索引：

curl -XPOST localhost:9200/_aliases -d '
{
    "actions" : [
        { "remove" : { "index" : "test1", "alias" : "alias1" } },
        { "add" : { "index" : "test1", "alias" : "alias2" } }
    ]
}'

将一个别名关联上超过一个索引同样就是简单地add操作：

curl -XPOST 'http://localhost:9200/_aliases' -d '
{
    "actions" : [
        { "add" : { "index" : "test1", "alias" : "alias1" } },
        { "add" : { "index" : "test2", "alias" : "alias1" } }
    ]
}'

过滤的别名（filtered aliases）

过滤的别名提供了一个方便的方式来创建一个索引的不同视图（view）。过滤器可以使用一个查询DSL来定义，然后被应用到所有使用这个别名的搜索，计数，查询删除，MLT操作。这里是个例子：

curl -XPOST 'http://localhost:9200/_aliases' -d '
{
    "actions" : [
        {
            "add" : {
                 "index" : "test1",
                 "alias" : "alias2",
                 "filter" : { "term" : { "user" : "kimchy" } }
            }
        }
    ]
}'

路由

可以和路由值进行关联。这个特性可以和过滤的别名整合使用来避免不必要的shard操作。下面的命令会创建一个新的别名alias1，它指向了索引test。在alias1创建之后，所有使用这个别名的操作，都会采用路由值为1进行寻路：

curl -XPOST localhost:9200/_aliases -d '
{
    "actions" : [
        {
            "add" : {
                 "index" : "test",
                 "alias" : "alias1",
                 "routing" : "1"
            }
        }
    ]
}'

同样也可以指定不同的用来供搜索和索引操作的路由值：

curl -XPOST 'http://localhost:9200/_aliases' -d '
{
    "actions" : [
        {
            "add" : {
                 "index" : "test",
                 "alias" : "alias2",
                 "search_routing" : "1,2",
                 "index_routing" : "2"
            }
        }
    ]
}'

正如上例所示，搜索路由可能包含几个由逗号分割的值。索引路由只可以包含一个单一的值。如果一个操作使用路由别名同样包含一个路由参数，那么这两个参数之间的交集会作为最终使用的结果。例如下面的命令会使用2作为路由值：

curl -XGET localhost:9200/alias2/_search?q=user:kimchy&routing=2,3

增加一个单一的别名

还有一种方式可以增加别名：PUT /{index}/_alias/{name}
其中

index : 可以blank | * | _all | glob | pattern | name1, name2, ...
name : 必须选项
routing : 可选择的路由选项
filter : 可选择的过滤器

当然也可以使用复数_aliases

例子：
增加基于时间的别名：

curl -XPUT localhost:9200/logs_201305/_alias/2013

增加用户别名：

curl -XPUT 'localhost:9200/users/_alias/user_12' -d '{
    "routing" : "12",
    "filter" : {
        "term" : {
            "user_id" : 12
        }
    }
}'

在索引时进行别名指定

别名同样可以在索引创建时进行指定：

curl -XPUT localhost:9200/logs_20142801 -d '{
    "aliases" : {
        "current_day" : {},
        "2014" : {
            "filter" : {
                "term" : {"year" : 2014 }
            }
        }
    }
}'

删除别名

The rest endpoint is: /{index}/_alias/{name}

where

index : * | _all | glob pattern | name1, name2, …

name : * | _all | glob pattern | name1, name2, …

Alternatively you can use the plural _aliases. Example:

curl -XDELETE 'localhost:9200/users/_alias/user_12'

检索存在的别名

get index alias api允许通过别名的名称和索引的名称进行过滤。这个API重定向至主人处，然后获得请求的索引别名，如果有的话。这个API仅仅会序列化找到的索引别名。

可能的选项：

index : 索引名称用来获得别名。部分名字则通过wildcard进行支持，同样多索引名称可以使用逗号进行指定分割。另外别名名称可以使用。
alias : 别名名称在响应中返回。正如索引选项，这个选项支持wildcard和选项特定的多个别名名称通过逗号进行分割。
ignore_unavailable : 当一个指定的索引名称不存在时候的反应。如果设置为true，那么这些索引会被忽略。

The rest endpoint is: /{index}/_alias/{alias}.

例子：

对索引users的别名：

curl -XGET localhost:9200/users/_alias/*

响应：

{
  "users" : {
    "aliases" : {
      "user_13" : {
        "filter" : {
          "term" : {
            "user_id" : 13
          }
        },
        "index_routing" : "13",
        "search_routing" : "13"
      },
      "user_14" : {
        "filter" : {
          "term" : {
            "user_id" : 14
          }
        },
        "index_routing" : "14",
        "search_routing" : "14"
      },
      "user_12" : {
        "filter" : {
          "term" : {
            "user_id" : 12
          }
        },
        "index_routing" : "12",
        "search_routing" : "12"
      }
    }
  }
}

所有名称中有2013的任何索引的别名：

curl -XGET localhost:9200/_alias/2013

响应：

{
  "logs_201304" : {
    "aliases" : {
      "2013" : { }
    }
  },
  "logs_201305" : {
    "aliases" : {
      "2013" : { }
    }
  }
}

所有以2013_01开头的别名：

curl -XGET localhost:9200/_alias/2013_01*

响应：

{
  "logs_20130101" : {
    "aliases" : {
      "2013_01" : { }
    }
  }
}

这个get index aliases api同样有一个HEAD变量来检查这个索引别名是否存在。索引别名存在api支持和get index aliases api同样的选项。例子：

curl -XHEAD 'localhost:9200/_alias/2013'
curl -XHEAD 'localhost:9200/_alias/2013_01*'
curl -XHEAD 'localhost:9200/users/_alias/*'