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

Uppercase processor

원문 보기 위키 갱신

출처: 문서

본문

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

대문자 프로세서

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

구문

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

{
  "uppercase": {
    "field": "field_name"
  }
}

{% include copy.html %}

구성 매개변수

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

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

프로세서 사용

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

1단계: 파이프라인 생성

다음 쿼리는 uppercase라는 파이프라인을 생성하며, field 필드의 텍스트를 대문자로 변환합니다:

PUT _ingest/pipeline/uppercase
{
  "processors": [
    {
      "uppercase": {
        "field": "name"
      }
    }
  ]
}

{% include copy-curl.html %}

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

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

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

POST _ingest/pipeline/uppercase/_simulate
{
  "docs": [
    {
      "_index": "testindex1",
      "_id": "1",
      "_source": {
        "name": "John"
      }
    }
  ]
}

{% include copy-curl.html %}

응답

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

{
  "docs": [
    {
      "doc": {
        "_index": "testindex1",
        "_id": "1",
        "_source": {
          "name": "JOHN"
        },
        "_ingest": {
          "timestamp": "2023-08-28T19:54:42.289624792Z"
        }
      }
    }
  ]
}

3단계: 문서 인제스트

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

PUT testindex1/_doc/1?pipeline=uppercase
{
  "name": "John"
}

{% include copy-curl.html %}

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

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

GET testindex1/_doc/1

{% include copy-curl.html %}

더 알아보기 (Learn more)