Document API에서는 다양한 문서 파라미터를 제공한다. 이 파라미터는 Document API 에서 공통적으로 사용할수 있다.

문서 ID 자동생성

문서를 생성할때 _id 를 지정하지 않으면 엘라스틱서치가 자동으로 ID를 부여하게 된다.

그러나 자동으로 생성될 경우 id에 의한 문서 조회가 어렵게 된다. 특정 문서의 id 조회가 중요한 경우라면 _id를 지정하는 것을 권장한다

• Get API를 통해 특정 id로 해당 문서를 조회할수 있다.

버전 관리

색인된 모든 문서는 버전을 가지고 있다. 버전 정보를 최초 1을 갖게 되고, 문서 변경이 생길 때마다 +1 증가한다.

Update API를 사용하여 문서가 변경되면 내부적으로 스냅샷을 생성한뒤 문서를 수정하고 인덱스에 재색인하게 된다.

• 버전은 동시성 제어를 위해서만 사용된다. History 관리용이 아니다.
• 스냅샷이 생성된 사이 버전값이 더 증가하였다면, 실패로 처리한다 (왜냐하면 동시에 처리를 시도하였고 순서가 뒤바뀌었으니 PHANTOM 현상등이 나타날수 있음)

버전은 _version 메타 필드로 확인이 가능하며 ?version= 파라미터로 명시적으로 특정 버전일 경우에만 작업을 수행하도록 할수 있음

• History 별로 작업을 하겠다는 것이 아니라 해당 version이 아닐 경우 version_conflict_engine_exception 오류가 발생

오퍼레이션 타입

Update API 사용시 이미 id가 존재하는 경우 update 작업을 수행하고, 없을 경우 craete 작업을 한다.

만약 이미 문서가 존재할 경우 update 하지 않고 색인이 실패하길 원하는 경우 op_type 파라미터를 사용하면 된다.

• ?op_type=create: 해당 문서가 없을 경우 신규 문서가 생성됨. 만약 문서가 존재한다면 오류를 일으킴

타임아웃

?timeout 을 지정하면 작업 타임아웃을 지정할 수 있음. ?timeout=1m, ?timeout=5s 등과 같이 지정가능

인덱스 매핑 정보 자동생성

Index API로 문서를 색인 할때 기존에 정의되지 않은 신규 필드가 있을 경우 기본동작은 동적 매핑에 의해 새로운 필드가 추가되게 된다.