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

Lowercase processor

원문 보기 위키 갱신

출처: 문서

본문

이 문서는 OpenSearch 인제스트 파이프라인에서 lowercase 프로세서를 사용하는 방법을 설명합니다. 대규모 또는 복잡한 데이터 세트를 다루는 경우 OpenSearch 클러스터에서 실행되는 Data Prepper lowercase_string 프로세서를 사용하는 것을 고려하세요. {: .note}

소문자 프로세서

lowercase 프로세서는 특정 필드의 모든 텍스트를 소문자로 변환합니다.

구문

다음은 lowercase 프로세서의 구문입니다:

{
  "lowercase": {
    "field": "field_name"
  }
}

{% include copy.html %}

구성 매개변수

다음 표는 lowercase 프로세서의 필수 및 선택적 매개변수를 보여줍니다.

매개변수 필수 여부 설명
field 필수 변환할 데이터가 포함된 필드의 이름입니다. 템플릿 스니펫을 지원합니다.
description 선택적 프로세서에 대한 간단한 설명입니다.
if 선택적 프로세서 실행 조건입니다.
ignore_failure 선택적 프로세서가 오류를 만나도 계속 실행할지 여부를 지정합니다. true로 설정하면 실패를 무시합니다. 기본값은 false입니다.
on_failure 선택적 프로세서가 실패할 경우 실행할 프로세서 목록입니다.
ignore_missing 선택적 프로세서가 지정된 필드가 없는 문서를 무시할지 여부를 지정합니다. true로 설정하면 필드가 없거나 null인 경우 문서를 수정하지 않습니다. 기본값은 false입니다.
tag 선택적 프로세서의 식별 태그입니다. 동일한 유형의 프로세서를 구분하기 위해 디버깅에 유용합니다.
target_field 선택적 구문 분석된 데이터를 저장할 필드의 이름입니다. 기본값은 field입니다. 기본적으로 field가 제자리에서 업데이트됩니다.

프로세서 사용

파이프라인에서 프로세서를 사용하려면 다음 단계를 따르세요.

1단계: 파이프라인 생성

다음 쿼리는 lowercase 프로세서를 사용하여 문서의 title 필드를 소문자로 변환하는 lowercase-title이라는 파이프라인을 생성합니다:

PUT _ingest/pipeline/lowercase-title
{
  "description" : "Pipeline that lowercases the title field",
  "processors" : [
    {
      "lowercase" : {
        "field" : "title"
      }
    }
  ]
}

{% include copy-curl.html %}

2단계(선택 사항): 파이프라인 테스트

문서를 인제스트하기 전에 파이프라인을 테스트하는 것이 좋습니다. {: .tip}

파이프라인을 테스트하려면 다음 쿼리를 실행하세요:

POST _ingest/pipeline/lowercase-title/_simulate
{
  "docs": [
    {
      "_index": "testindex1",
      "_id": "1",
      "_source": {
        "title": "WAR AND PEACE"
      }
    }
  ]
}

{% include copy-curl.html %}

응답

다음 예시 응답은 파이프라인이 예상대로 작동하고 있음을 확인합니다:

{
  "docs": [
    {
      "doc": {
        "_index": "testindex1",
        "_id": "1",
        "_source": {
          "title": "war and peace"
        },
        "_ingest": {
          "timestamp": "2023-08-22T17:39:39.872671834Z"
        }
      }
    }
  ]
}

3단계: 문서 인제스트

다음 쿼리는 testindex1이라는 인덱스에 문서를 인제스트합니다:

PUT testindex1/_doc/1?pipeline=lowercase-title
{
  "title": "WAR AND PEACE"
}

{% include copy-curl.html %}

4단계(선택 사항): 문서 검색

문서를 검색하려면 다음 쿼리를 실행하세요:

GET testindex1/_doc/1

{% include copy-curl.html %}

더 알아보기 (Learn more)