Trim processor
출처: 문서
본문
Trim processor
trim 프로세서는 지정된 필드에서 앞뒤 공백 문자를 제거하는 데 사용해요.
다음은 trim 프로세서의 구문이에요:
{
"trim": {
"field": "field_to_trim",
"target_field": "trimmed_field"
}
}
{% include copy.html %}
구성 매개변수
다음 표는 trim 프로세서의 필수 및 선택 매개변수를 나열해요.
| 매개변수 | 필수/선택 | 설명 |
|---|---|---|
field |
필수 | 트리밍할 텍스트가 포함된 필드예요. |
target_field |
필수 | 트리밍된 텍스트가 저장되는 필드예요. 지정되지 않으면 필드가 제자리에서 업데이트돼요. |
ignore_missing |
선택 | 프로세서가 지정된 필드를 포함하지 않는 문서를 무시할지 여부를 지정해요. true로 설정하면 필드에서 누락된 값을 무시하고 target_field를 변경하지 않아요. 기본값은 false예요. |
description |
선택 | 프로세서에 대한 간단한 설명이에요. |
if |
선택 | 프로세서 실행 조건이에요. |
ignore_failure |
선택 | 프로세서가 오류가 발생해도 계속 실행할지 여부를 지정해요. true로 설정하면 실패를 무시해요. 기본값은 false예요. |
on_failure |
선택 | 프로세서가 실패할 경우 실행할 프로세서 목록이에요. |
tag |
선택 | 프로세서의 식별 태그예요. 동일한 유형의 프로세서를 구분하는 데 유용해요. |
프로세서 사용하기
파이프라인에서 프로세서를 사용하려면 다음 단계를 따라요.
1단계: 파이프라인 생성
다음 쿼리는 trim 프로세서를 사용하여 raw_text 필드에서 앞뒤 공백을 제거하고 트리밍된 텍스트를 trimmed_text 필드에 저장하는 trim_pipeline이라는 파이프라인을 생성해요.
PUT _ingest/pipeline/trim_pipeline
{
"description": "Trim leading and trailing white space",
"processors": [
{
"trim": {
"field": "raw_text",
"target_field": "trimmed_text"
}
}
]
}
{% include copy-curl.html %}
2단계(선택 사항): 파이프라인 테스트
문서를 수집하기 전에 파이프라인을 테스트하는 것이 좋아요. {: .tip}
파이프라인을 테스트하려면 다음 쿼리를 실행해요.
POST _ingest/pipeline/trim_pipeline/_simulate
{
"docs": [
{
"_source": {
"raw_text": " Hello, world! "
}
}
]
}
{% include copy-curl.html %}
응답
다음 예제 응답은 파이프라인이 예상대로 작동하고 있음을 확인해요.
{
"docs": [
{
"doc": {
"_index": "_index",
"_id": "_id",
"_source": {
"raw_text": " Hello, world! ",
"trimmed_text": "Hello, world!"
},
"_ingest": {
"timestamp": "2024-04-26T20:58:17.418006805Z"
}
}
}
]
}
3단계: 문서 수집
다음 쿼리는 testindex1이라는 인덱스에 문서를 수집해요.
PUT testindex1/_doc/1?pipeline=trim_pipeline
{
"message": " This is a test document. "
}
{% include copy-curl.html %}
응답
요청은 문서를 testindex1 인덱스에 인덱싱하고, trim_pipeline에 의해 처리되는 raw_text 필드가 있는 모든 문서를 인덱싱하여 trimmed_text 필드를 채워요. 다음 응답에 나와 있어요.
"_index": "testindex1",
"_id": "1",
"_version": 68,
"result": "updated",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
},
"_seq_no": 70,
"_primary_term": 47
}
{% include copy-curl.html %}
4단계(선택 사항): 문서 검색
문서를 검색하려면 다음 쿼리를 실행해요.
GET testindex1/_doc/1
{% include copy-curl.html %}
응답에는 앞뒤 공백이 제거된 trimmed_text 필드가 포함되어 있어요.
{
"_index": "testindex1",
"_id": "1",
"_version": 69,
"_seq_no": 71,
"_primary_term": 47,
"found": true,
"_source": {
"raw_text": " This is a test document. ",
"trimmed_text": "This is a test document."
}
}