Elasticsearch基础语法 #

API特点
├── RESTful风格
│   ├── 使用HTTP方法表示操作
│   └── URL表示资源
├── JSON格式
│   ├── 请求体使用JSON
│   └── 响应体使用JSON
└── 统一端点
    └── 默认端口9200

http://host:port/<index>/<type>/<id>

简化格式（推荐）
http://host:port/<index>/_doc/<id>

常用参数
├── pretty
│   └── 格式化JSON输出
├── format
│   └── 指定输出格式(json/yaml/smile/cbor)
├── filter_path
│   └── 过滤响应字段
├── human
│   └── 人类可读格式
└── refresh
    └── 立即刷新索引

GET /products/_search?pretty
GET /products/_search?filter_path=hits.hits._source
GET /products/_search?human=true

curl -X <METHOD> "http://localhost:9200/<endpoint>" \
  -H "Content-Type: application/json" \
  -d '{
    <request_body>
  }'

PUT /products
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 1
  },
  "mappings": {
    "properties": {
      "name": { "type": "text" },
      "price": { "type": "float" }
    }
  }
}

DELETE /products

PUT /products/_doc/1
{
  "name": "iPhone 15",
  "price": 999,
  "brand": "Apple"
}

POST /products/_doc
{
  "name": "iPhone 15",
  "price": 999
}

POST /products/_update/1
{
  "doc": {
    "price": 899
  }
}

DELETE /products/_doc/1

GET /products/_search
{
  "query": {
    "match": {
      "name": "iPhone"
    }
  },
  "size": 10,
  "from": 0,
  "_source": ["name", "price"]
}

{
  "_index": "products",
  "_id": "1",
  "_version": 1,
  "_seq_no": 0,
  "_primary_term": 1,
  "found": true,
  "_source": {
    "name": "iPhone 15",
    "price": 999
  }
}

{
  "took": 5,
  "timed_out": false,
  "_shards": {
    "total": 3,
    "successful": 3,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 100,
      "relation": "eq"
    },
    "max_score": 1.0,
    "hits": [
      {
        "_index": "products",
        "_id": "1",
        "_score": 1.0,
        "_source": {
          "name": "iPhone 15",
          "price": 999
        }
      }
    ]
  }
}

{
  "error": {
    "root_cause": [
      {
        "type": "index_not_found_exception",
        "reason": "no such index [products]",
        "index": "products"
      }
    ],
    "type": "index_not_found_exception",
    "reason": "no such index [products]",
    "index": "products"
  },
  "status": 404
}

GET /products/_search
{
  "query": {
    <query_type>: {
      <field>: <value>
    }
  }
}

{
  "query": {
    "match": {
      "name": "iPhone"
    }
  }
}

{
  "query": {
    "term": {
      "brand": "Apple"
    }
  }
}

{
  "query": {
    "range": {
      "price": {
        "gte": 500,
        "lte": 1000
      }
    }
  }
}

{
  "query": {
    "bool": {
      "must": [
        { "match": { "name": "iPhone" } }
      ],
      "filter": [
        { "range": { "price": { "lte": 1000 } } }
      ],
      "must_not": [
        { "term": { "status": "deleted" } }
      ],
      "should": [
        { "term": { "brand": "Apple" } }
      ]
    }
  }
}

action_and_meta_data\n
optional_source\n
action_and_meta_data\n
optional_source\n

POST /_bulk
{"index": {"_index": "products", "_id": "1"}}
{"name": "iPhone 15", "price": 999}
{"index": {"_index": "products", "_id": "2"}}
{"name": "MacBook Pro", "price": 1999}
{"update": {"_index": "products", "_id": "1"}}
{"doc": {"price": 899}}
{"delete": {"_index": "products", "_id": "2"}}

{
  "took": 30,
  "errors": false,
  "items": [
    {
      "index": {
        "_index": "products",
        "_id": "1",
        "status": 201
      }
    },
    {
      "index": {
        "_index": "products",
        "_id": "2",
        "status": 201
      }
    }
  ]
}

GET /_mget
{
  "docs": [
    { "_index": "products", "_id": "1" },
    { "_index": "products", "_id": "2" }
  ]
}

GET /products/_mget
{
  "ids": ["1", "2", "3"]
}

GET /_msearch
{}
{"query": {"match_all": {}}}
{"index": "products"}
{"query": {"match": {"name": "iPhone"}}}

PUT /_index_template/logs_template
{
  "index_patterns": ["logs-*"],
  "template": {
    "settings": {
      "number_of_shards": 3,
      "number_of_replicas": 1
    },
    "mappings": {
      "properties": {
        "@timestamp": { "type": "date" },
        "message": { "type": "text" },
        "level": { "type": "keyword" }
      }
    }
  }
}

GET /_index_template/logs_template

POST /_aliases
{
  "actions": [
    {
      "add": {
        "index": "products_v1",
        "alias": "products"
      }
    }
  ]
}

POST /_aliases
{
  "actions": [
    {
      "remove": {
        "index": "products_v1",
        "alias": "products"
      }
    },
    {
      "add": {
        "index": "products_v2",
        "alias": "products"
      }
    }
  ]
}

GET /_cluster/health
GET /_cluster/state
GET /_cluster/stats
GET /_cluster/pending_tasks

GET /_nodes
GET /_nodes/stats
GET /_nodes/hot_threads
GET /_cat/nodes?v

GET /_cat/indices?v
GET /products/_settings
GET /products/_mapping
GET /products/_stats
POST /products/_close
POST /products/_open

GET /products/_doc/1
HEAD /products/_doc/1
GET /products/_source/1
GET /products/_count

GET /products/_search
GET /products/_validate/query
GET /products/_explain/1