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 %}