# ElasticsearchのREST API一覧と実用サンプル

## 目次
1. Elasticsearchとは
2. REST APIの基本
3. 代表的なAPI一覧
   - 3.1 インデックスAPI
   - 3.2 ドキュメントAPI
   - 3.3 検索API
   - 3.4 集約API
   - 3.5 マッピングAPI
   - 3.6 設定API
   - 3.7 クラスターAPI
4. 実用サンプル
   - 4.1 ドキュメントのインデックス化
   - 4.2 基本的な検索の実行
   - 4.3 集約クエリの例
   - 4.4 インデックス設定の更新
5. APIリクエスト時の注意点
6. まとめ

## 1. Elasticsearchとは
Elasticsearchは、分散型の検索エンジンであり、特にフルテキスト検索に最適化されています。オープンソースとして提供されており、その高性能な検索機能により、多くの企業や開発者に利用されています。

## 2. REST APIの基本
ElasticsearchはRESTful APIを介して操作され、HTTPプロトコルを使用してクライアントと通信します。通常のHTTPメソッド（GET、POST、PUT、DELETE）を利用して、データや設定を作成・取得・更新・削除が可能です。

## 3. 代表的なAPI一覧

### 3.1 インデックスAPI
インデックスAPIは、Elasticsearchのデータ検索を効率的に行うための構造を定義します。

- `PUT /{index}`: 新しいインデックスを作成
- `DELETE /{index}`: 既存のインデックスを削除

### 3.2 ドキュメントAPI
ドキュメントAPIは、データの作成、更新、削除を容易にします。

- `POST /{index}/_doc/{id}`: ドキュメントの追加または更新
- `GET /{index}/_doc/{id}`: ドキュメントの取得
- `DELETE /{index}/_doc/{id}`: ドキュメントの削除

### 3.3 検索API
検索APIは、高度な検索クエリを提供します。

- `GET /{index}/_search`: クエリを使用した検索の実行
- サンプルクエリ:
  ```json
  {
    "query": {
      "match": {
        "field": "value"
      }
    }
  }
  ```

### 3.4 集約API
集約APIにより、複雑なデータ分析が可能です。

- `GET /{index}/_search`: 集約クエリの実行
- 集約クエリ例:
  ```json
  {
    "aggs": {
      "genres": {
        "terms": {
          "field": "genre.keyword"
        }
      }
    }
  }
  ```

### 3.5 マッピングAPI
マッピングAPIは、インデックス内のフィールドのデータ型とその動作を指定します。

- `PUT /{index}/_mapping`: マッピングの設定
- `GET /{index}/_mapping`: マッピング情報の取得

### 3.6 設定API
設定APIは、インデックスの動作を調整します。

- `PUT /{index}/_settings`: 設定の更新
- サンプル設定:
  ```json
  {
    "index": {
      "number_of_replicas": 2
    }
  }
  ```

### 3.7 クラスターAPI
クラスターAPIにより、クラスターの状態やノードの情報を管理・取得できます。

- `GET /_cluster/health`: クラスターの健康状態
- `GET /_nodes`: クラスター内のノード情報

## 4. 実用サンプル

### 4.1 ドキュメントのインデックス化
```bash
curl -X POST "localhost:9200/library/_doc/1" -H 'Content-Type: application/json' -d'
{
  "title": "Elasticsearch Essentials",
  "author": "Jane Doe",
  "year": 2023
}
'
```

### 4.2 基本的な検索の実行
```bash
curl -X GET "localhost:9200/library/_search" -H 'Content-Type: application/json' -d'
{
  "query": {
    "match": {
      "title": "Elasticsearch"
    }
  }
}
'
```

### 4.3 集約クエリの例
```bash
curl -X GET "localhost:9200/library/_search" -H 'Content-Type: application/json' -d'
{
  "aggs": {
    "authors": {
      "terms": {
        "field": "author.keyword"
      }
    }
  }
}
'
```

### 4.4 インデックス設定の更新
```bash
curl -X PUT "localhost:9200/library/_settings" -H 'Content-Type: application/json' -d'
{
  "index": {
    "number_of_replicas": 1
  }
}
'
```

## 5. APIリクエスト時の注意点
- インデックス名やフィールド名は小文字である必要があります。
- ドキュメントIDは一意でなければならず、更新時にも同じIDを用いて操作を行います。
- 大規模なデータ操作はリアルタイム性が犠牲になることがありますので、バルクAPIを活用するとよいでしょう。

## 6. まとめ
ElasticsearchのREST APIは、単にデータを検索するだけでなく、分析やインデックスの管理など、さまざまな用途に使えます。特に検索機能や集約機能はデータ分析に強力な手段となるため、正しく理解して利用することで、ビジネスインテリジェンスや意思決定の支援に貢献します。

この記事では、Elasticsearchを効果的に利用するためのAPIについて詳しく説明しました。REST APIについての理解が進むことで、検索や分析機能を最大限に活用した、より効率的でパフォーマントなアプリケーション開発が可能になります。 [cv:issue_marketplace_engineer]

ElasticsearchのREST API一覧と実用サンプル

目次

続きを読むには単価診断を受けてください（30秒）