Remove processor
출처: 문서
본문
Remove 프로세서
remove 프로세서는 문서에서 필드를 제거하는 데 사용해요.
구문
다음은 remove 프로세서의 구문이에요.
{
"remove": {
"field": "field_name"
}
}
{% include copy.html %}
구성 매개변수
다음 표는 remove 프로세서의 필수 및 선택적 매개변수를 보여줘요.
| 매개변수 | 필수/선택 | 설명 |
|---|---|---|
field |
선택 | 제거할 데이터가 포함된 필드 이름. 템플릿 스니펫을 지원해요. 메타데이터 필드 _index, _version, _version_type, _id는 제거할 수 없어요. version이 지정되면 수집된 문서에서 _id를 제거할 수 없어요. |
exclude_field |
선택 | 유지할 필드 이름. 메타데이터 필드를 제외한 모든 다른 필드가 제거돼요. exclude_field와 field 옵션은 상호 배타적이에요. 템플릿 스니펫을 지원해요. |
description |
선택 | 프로세서에 대한 간단한 설명. |
if |
선택 | 프로세서 실행 조건. |
ignore_failure |
선택 | 오류가 발생해도 프로세서가 계속 실행되는지 여부를 지정해요. true로 설정하면 실패를 무시해요. 기본값은 false예요. |
on_failure |
선택 | 프로세서가 실패할 경우 실행할 프로세서 목록. |
tag |
선택 | 프로세서의 식별 태그. 동일한 유형의 프로세서를 구분하기 위해 디버깅에 유용해요. |
프로세서 사용하기
파이프라인에서 프로세서를 사용하려면 다음 단계를 따라 해요.
1단계: 파이프라인 생성
다음 쿼리는 문서에서 ip_address 필드를 제거하는 remove_ip라는 파이프라인을 생성해요.
PUT /_ingest/pipeline/remove_ip
{
"description": "Pipeline that excludes the ip_address field.",
"processors": [
{
"remove": {
"field": "ip_address"
}
}
]
}
{% include copy-curl.html %}
2단계(선택 사항): 파이프라인 테스트
문서를 수집하기 전에 파이프라인을 테스트하는 것이 좋아요. {: .tip}
파이프라인을 테스트하려면 다음 쿼리를 실행해요.
POST _ingest/pipeline/remove_ip/_simulate
{
"docs": [
{
"_index": "testindex1",
"_id": "1",
"_source":{
"ip_address": "203.0.113.1",
"name": "John Doe"
}
}
]
}
{% include copy-curl.html %}
응답
다음 예시 응답은 파이프라인이 예상대로 작동하고 있음을 확인해줘요.
{
"docs": [
{
"doc": {
"_index": "testindex1",
"_id": "1",
"_source": {
"name": "John Doe"
},
"_ingest": {
"timestamp": "2023-08-24T18:02:13.218986756Z"
}
}
}
]
}
3단계: 문서 수집
다음 쿼리는 testindex1이라는 인덱스에 문서를 수집해요.
PUT testindex1/_doc/1?pipeline=remove_ip
{
"ip_address": "203.0.113.1",
"name": "John Doe"
}
{% include copy-curl.html %}
4단계(선택 사항): 문서 검색
문서를 검색하려면 다음 쿼리를 실행해요.
GET testindex1/_doc/1
{% include copy-curl.html %}