[Index and Query a Document]

이제 customer index에 무엇인가를 집어 넣어 보자. 앞의 내용에 대한 기억을 되살려보면, document를 index하기 위하여 elasticsearch에 index의 어느 Type인지를 알려주어야 한다.

Customer index에 "external" type 다음과 같은 간단한 customer document를 index해 보자.

JSON Document는 {"name":"John Doe"}이다.

curl -XPUT 'localhost:9200/customer/external/1?pretty' -d '
{
  "name": "John Doe"
}'

응답 결과는 다음과 같다.

curl -XPUT 'localhost:9200/customer/external/1?pretty' -d '
{
  "name": "John Doe"
}'
{
  "_index" : "customer",
  "_type" : "external",
  "_id" : "1",
  "_version" : 1,
  "created" : true
}

위에서 살펴보면, 새로운 customer document가 customer index내에 성공적으로 생성되었음을 알 수 있다. 생성된 document는 내부적으로 특정 index time에 1이라는 ID를 갖는다. Elasticsearch가 document를 index하기 전에 명시적으로 customer index를 먼저 생성하도록 요구하지 않는다는 것에 주목하라. 이전 예제에서 살펴보면, elasticsearch는 이전에 customer index가 존재하지 않으면 자동으로 customer index를 생성한다. 이제 index된 document를 조회해 보자.

curl -XGET 'localhost:9200/customer/external/1?pretty'

응답 결과는 다음과 같다.

curl -XGET 'localhost:9200/customer/external/1?pretty'
{
  "_index" : "customer",
  "_type" : "external",
  "_id" : "1",
  "_version" : 1,
  "found" : true, "_source" : { "name": "John Doe" }
}

found 필드 외에는 모두 일반적으로 나타나는 필드이다. 이전 단계에서 index된 JSON document는 _source 필드에 있다.

[Create an Index]

자, 이제 "customer"라는 이름을 가지는 index를 생성해 보자. 그리고 그 후, 다시 모든 index list를 조회해 보자.

curl -XPUT 'localhost:9200/customer?pretty'
curl 'localhost:9200/_cat/indices?v'

첫 번째 command는 http PUT method로 "customer"라는 이름을 갖는 index를 생성한다. 간단히 pretty를 맨 끝에 호출하여 JSON 응답을 출력할 수 있다.

응답 결과는 다음과 같다.

curl -XPUT 'localhost:9200/customer?pretty'
{
  "acknowledged" : true
}

curl 'localhost:9200/_cat/indices?v'
health index    pri rep docs.count docs.deleted store.size pri.store.size
yellow customer   5   1          0            0       495b           495b

두 번째 command의 응답 결과를 통해서 customer 이름의 index 1개가 있고, 5개의 primary shard와 1개의 replica가 있음을 알 수 있다. 아직 document는 없다.

Customer index는 yellow health가 tag되어 있음을 알 수 있다. 이전에 논의했던 내용을 되새겨 보면, yellow는 아직 replica가 할당되어 있지 않았음을 의미함을 알 수 있다. 그 이유는 elasticsearch에서 index에 대해 하나의 replica를 default로 생성했기 때문이다. 이 순간, 하나의 node만을 가지고 있기 때문에 또 다른 node가 cluster에 join할 때까지 replica는 할당되지 않는다. Replica가 second node에 할당되면 health status는 green으로 바뀐다.

[List All Indexes]

이제 index에 대해서 가만히 들여다 보자.

curl 'localhost:9200/_cat/indices?v'

응답은 다음과 같다.

curl 'localhost:9200/_cat/indices?v'
health index pri rep docs.count docs.deleted store.size pri.store.size

아직 cluster에 index가 하나도 없다는 것을 의미한다.