kvjoin()

kvjoin() 함수는 현재 레코드의 키-값 쌍을 지정한 구분자로 이어 붙여 하나의 문자열로 반환합니다.

문법

매개변수

KV_DELIM

각 키와 값 사이에 삽입할 구분자 문자열입니다.

PAIR_DELIM

키-값 쌍들 사이에 삽입할 구분자 문자열입니다.

REGEX

포함할 키를 정규표현식으로 지정합니다. 지정하지 않으면 레코드의 모든 키-값 쌍을 포함합니다.

설명

kvjoin() 함수는 현재 레코드의 각 필드를 순회하며 키 + KV_DELIM + 값 형태로 이어 붙이고, 각 쌍 사이에 PAIR_DELIM을 삽입하여 하나의 문자열로 반환합니다.

REGEX를 지정하면 키가 정규표현식과 일치하는 경우에만 해당 키-값 쌍을 포함합니다.

결합 결과에 포함할 키가 없는 경우 빈 문자열("")을 반환합니다.

오류 코드

해당 사항 없음

사용 예

이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.

1. 레코드의 모든 키-값 쌍 이어 붙이기

   table limit=1 WEB_APACHE_SAMPLE | eval result = kvjoin("=", "&")
   | # result: "method=GET&uri=/feed&status=200&..." 형태의 문자열
   

2. 정규표현식으로 특정 키만 선택하여 이어 붙이기

   table limit=5 WEB_APACHE_SAMPLE | eval result = kvjoin("=", "&", "status|bytes") | fields status, bytes, result
   | # result: "status=200&bytes=2780" 등
   

3. 일치하는 키가 없는 경우

   json "{'name': 'Kim'}"
   | eval result = kvjoin(":", ",", "src_.*")
   | # result: ""
   

호환성

kvjoin() 함수는 소나 4.0 이전 버전부터 제공되었습니다.