본문 바로가기
WIKI 기술 지식 베이스

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."
  }
}

더 알아보기 (Learn more)