複数の Elasticsearch インデックスを横断して検索する

ワイルドカードパターンと明示的なカンマ区切りリストという 2 つの方法で、複数の Elasticsearch インデックスを一度にクエリします。

Takahiro Iwasa

2020-12-31

3 min read

Elasticsearch では、ワイルドカードパターンまたは明示的なカンマ区切りリストのいずれかを使って、複数のインデックスを一度にクエリできます。

Elasticsearch の起動

以下の docker-compose.yml で、シングルノードのクラスタを構成します。

1
version: '3'
2

3
services:
4
  elasticsearch:
5
    image: elasticsearch:7.10.1
6
    container_name: elasticsearch
7
    environment:
8
      - discovery.type=single-node
9
      - bootstrap.memory_lock=true
10
    ports:
11
      - 9200:9200

クラスタを起動します。

docker-compose up -d

データの準備

curl を使って、users-2020-11 と users-2020-12 の各インデックスにドキュメントを登録します。

curl -X POST -H 'Content-Type: application/json' -d '{"name": "hoge"}' localhost:9200/users-2020-11/_doc/
curl -X POST -H 'Content-Type: application/json' -d '{"name": "fuga"}' localhost:9200/users-2020-12/_doc/

データの検索

ワイルドカードによる検索

ワイルドカード式を使うと、1 回のリクエストで複数のインデックスを検索できます。

curl localhost:9200/users-2020-*/_search | jq .hits.hits

レスポンスには users-2020-11 と users-2020-12 両方のデータが含まれます。

1
[
2
  {
3
    "_index": "users-2020-11",
4
    "_type": "_doc",
5
    "_id": "PNQ3tXYBKT-fwQ71grcz",
6
    "_score": 1,
7
    "_source": {
8
      "name": "hoge"
9
    }
10
  },
11
  {
12
    "_index": "users-2020-12",
13
    "_type": "_doc",
14
    "_id": "PdQ3tXYBKT-fwQ71p7cy",
15
    "_score": 1,
16
    "_source": {
17
      "name": "fuga"
18
    }
19
  }
20
]

カンマ区切りリストによる検索

複数のインデックスをカンマ区切りのリストで明示することもできます。

🔥 Caution

この方法を使う場合は、URL の長さが上限を超えないように注意してください。

curl localhost:9200/users-2020-11,users-2020-12/_search | jq .hits.hits

レスポンスには users-2020-11 と users-2020-12 両方のデータが含まれます。

1
[
2
  {
3
    "_index": "users-2020-11",
4
    "_type": "_doc",
5
    "_id": "PNQ3tXYBKT-fwQ71grcz",
6
    "_score": 1,
7
    "_source": {
8
      "name": "hoge"
9
    }
10
  },
11
  {
12
    "_index": "users-2020-12",
13
    "_type": "_doc",
14
    "_id": "PdQ3tXYBKT-fwQ71p7cy",
15
    "_score": 1,
16
    "_source": {
17
      "name": "fuga"
18
    }
19
  }
20
]

まとめ

ワイルドカードパターンと明示的なカンマ区切りリストのどちらを使っても、users-2020-11 と users-2020-12 から同じ検索結果が返されます。実用上の主な違いは、対象インデックスの指定方法と管理方法です。

users-2020-* のようなワイルドカードパターンは、月次インデックスが増えても指定文字列が変わらないため、時系列のインデックスを扱いやすくなります。一方、対象が少数で事前に分かっている場合は、カンマ区切りリストのほうが明示的です。ただし、対象が増えると URL の長さ制限に注意が必要です。

記事一覧に戻る