1-07-1. Empty Search

Let’s start with the simplest form of the search API, the empty search, which returns all documents in all indices:

search API의 가장 간단한 형태인, empty search로 시작해 보자. 모든 indices의 모든 document를 반환한다.

GET /_search
{} 

COPY AS CURLVIEW IN SENSE 

이것이 empty request body이다.

Just as with a query-string search, you can search on one, many, or _all indices, and one, many, or all types:

query-string 검색과 마찬가지로, 하나 이상 또는 모든(_all) indices에서, 하나 이상 또는 모든 type을 검색할 수 있다.

GET /index_2014*/type1,type2/_search
{}

And you can use the from and size parameters for pagination:

또한, page를 계산하기 위해 from, size 매개변수를 사용할 수 있다.

GET /_search
{
  "from": 30,
  "size": 10
}

body를 가지는 GET request?

The HTTP libraries of certain languages (notably JavaScript) don’t allow GET requests to have a request body. In fact, some users are suprised that GET requests are ever allowed to have a body.

특정 language(특히 javascript)의 HTTP library는 request body를 가지는 GET request를 사용할 수 없다. 사실, 어떤 사용자는 GET request가 body를 가질 수 있다는 사실에 놀라기도 한다.

The truth is that RFC 7231—the RFC that deals with HTTP semantics and content—does not define what should happen to a GET request with a body! As a result, some HTTP servers allow it, and some—especially caching proxies—don’t.

진실은, RFC 7231(HTTP의 의미와 내용을 다루고 있는 RFC)이 GET request가 body를 가지면 어떤 일이 일어나는지를 정의하지 않았다는 것이다. 결론적으로, 어떤 HTTP 서버는 이를 받아들인다. 그리고 어떤 서버(특히 caching proxies)는 그렇지 않다.

The authors of Elasticsearch prefer using GET for a search request because they feel that it describes the action—retrieving information—better than the POST verb. However, because GET with a request body is not universally supported, the search API also accepts POST requests:

Elasticsearch을 만든 사람은 검색 request에, GET 을 사용하는 것을 더 좋아한다. "정보를 가져온다" 라는 동작을 묘사하는데 있어, POST 보다 낫다고 느끼기 때문이다. 그러나, request body를 가지는 GET 은 일반적으로 지원되지 않기 때문에, search API 또한 POST request도 사용할 수 있다.

POST /_search
{
  "from": 30,
  "size": 10
}

The same rule applies to any other GET API that requires a request body.

request body를 요구하는 다른 GET API와, 동일한 규칙이 적용된다.

We present aggregations in depth in Aggregations, but for now, we’re going to focus just on the query.

Aggregations에서, aggregation에 대해 자세히 이야기할 것이다. 지금은 query에만 집중하자.

Instead of the cryptic query-string approach, a request body search allows us to write queries by using the query domain-specific language, or query DSL.

아리송한 query-string 방식 대신, request body 검색은 query DSL(Domain Specific Language) 을 사용하여 query를 작성할 수 있다.