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