도큐먼트 저장, 조회, 수정, 삭제하기

JSCODE 박재성

2026. 04. 04.

✅ 도큐먼트 저장

1. id를 자동으로 생성해서 저장

# 도큐먼트 저장 (id 자동 생성)
# POST /{인덱스명}/_doc
POST /users/_doc
{
  "name": "Jaeseong",
  "age": 20,
  "is_active": true
}

# 잘 저장됐는 지 확인하기
GET /users/_search 

2. id를 직접 지정해서 저장

# 도큐먼트 저장 (id 직접 지정)
# POST /{인덱스명}/_create/{id}
POST /users/_create/1
{
  "name": "jscode",
  "age": 30,
  "is_active": true
}

# 잘 저장됐는 지 확인하기
GET /users/_search 

# 이미 존재하는 id로 데이터 저장하면 어떻게 되는 지 확인하기
POST /users/_create/1
{
  "name": "jscode",
  "age": 30,
  "is_active": true
}

 

2. id를 직접 지정해서 저장 (이미 id가 존재한다면 데이터 덮어씌움) = UPSERT

# 도큐먼트 저장 및 업데이트
# PUT /{인덱스명}/_doc/{id}
PUT /users/_doc/2
{
  "name": "jason",
  "age": 30,
  "is_active": true
}

# 잘 저장됐는 지 확인하기
GET /users/_search 

# 이미 존재하는 id로 데이터 저장하면 어떻게 되는 지 확인하기
POST /users/_doc/2
{
  "name": "jason2", 
  "age": 30,
  "is_active": true
}

# 어떻게 됐는 지 확인하기
GET /users/_search 

 
 

✅ 도큐먼트 조회

1. (특정 인덱스의) 모든 도큐먼트 조회

# GET /{인덱스명}/_search
GET /users/_search

 

2. id로 특정 도큐먼트 조회

# 특정 도큐먼트 조회
# GET /{index}/_doc/{id}
GET /users/_doc/1
GET /users/_doc/2

✅ 도큐먼트 수정

1. 도큐먼트를 통째로 덮어씌우기

# 기존 도큐먼트 확인
GET /users/_doc/1

# 특정 도큐먼트 수정
# 이 API는 데이터 저장 시에도 사용하는 API이다. (바로 위에서 언급했었음)
# PUT /{인덱스명}/_doc/{id}
PUT /users/_doc/1
{
  "name": "new"
}

# 수정됐는 지 확인하기
GET /users/_doc/1

 

2. 일부 필드만 수정

# 기존 도큐먼트 확인
GET /users/_doc/2

# 특정 도큐먼트 수정
# POST /{인덱스명}/_update/{id}
POST /users/_update/2
{
  "doc": {
	  "age": 10,
	  "is_active": false
  }
}

# 수정됐는 지 확인하기
GET /users/_doc/2

 

✅ 도큐먼트 삭제하기

# 기존 도큐먼트 확인
GET /users/_doc/2

# id로 도큐먼트 삭제하기
# DELETE /{인덱스명}/_doc/{id} 
DELETE /users/_doc/2

# 삭제됐는 지 확인하기
GET /users/_doc/2