Convert type processor
출처: 문서
본문
타입 변환 프로세서
convert_type 프로세서는 이벤트에서 지정된 키에 연결된 값의 타입을 지정된 타입으로 변환해요. 이벤트에 있는 일부 필드의 타입을 바꾸는 캐스팅 프로세서예요. 이벤트가 조건 기반 프로세서를 통과하게 하거나 조건부 라우팅을 수행하려면, 정수를 double로 바꾸거나 문자열을 정수로 바꾸는 것처럼 일부 데이터를 다른 타입으로 변환해야 할 때가 있어요.
OpenSearch Data Prepper 버전 2.10.0부터 convert_entry_type 프로세서는 convert_type으로 이름이 바뀌었어요. convert_entry_type을 사용하는 설정은 deprecation 경고를 발생시키니 업데이트해야 해요.
{: .important }
설정
다음 옵션들을 사용해 convert_type 프로세서를 설정할 수 있어요.
| 옵션 | 필수 여부 | 설명 |
|---|---|---|
key |
예 | 값을 다른 타입으로 변환해야 하는 키예요. |
keys |
예 | 값을 다른 타입으로 변환해야 하는 키들이에요. |
type |
아니요 | 키-값 쌍의 대상 타입이에요. 가능한 값은 integer, long, double, big_decimal, string, boolean이고, 기본값은 integer예요. |
null_values |
아니요 | null 값으로 간주할 대상의 문자열 표현이에요. 필드 값이 이 문자열 중 하나와 같으면 그 값은 null로 간주되어 null로 변환돼요. |
scale |
아니요 | big_decimal로 변환할 때 big_decimal의 scale을 조정해요. 기본값은 0이에요. |
tags_on_failure |
아니요 | 이벤트 변환에 실패했을 때 이벤트 메타데이터에 추가할 태그 목록이에요. |
convert_when |
아니요 | convert_type 작업을 수행하기 위한 조건을 Data Prepper 표현식으로 지정해요. 지정하면 표현식이 true로 평가될 때만 convert_type 작업이 실행돼요. |
사용법
시작하려면 다음과 같은 pipeline.yaml 파일을 만들어 보세요:
type-conv-pipeline:
source:
...
....
processor:
- convert_type:
key: "response_status"
type: "integer"
{% include copy.html %}
다음으로 logs_json.log라는 이름의 로그 파일을 만들고, pipeline.yaml 파일의 file source에 있는 path를 해당 파일 경로로 바꾸세요. 자세한 내용은 OpenSearch Data Prepper 구성하기를 참고하세요.
예를 들어, convert_type 프로세서를 실행하기 전에 logs_json.log 파일에 다음과 같은 이벤트 레코드가 들어 있다면:
{"message": "value", "response_status":"200"}
convert_type 프로세서는 수신한 출력을 다음과 같은 출력으로 변환하는데, 이때 response_status 값의 타입이 문자열에서 정수로 바뀌어요:
{"message":"value","response_status":200}