schema

로그 스키마를 적용하여 필드 이름을 표시 이름으로 변환하고, 스키마에 정의된 필드만 선택하거나 필드 순서를 재정렬합니다.

명령어 속성

항목설명
명령어 유형가공 쿼리
필요 권한없음
라이선스 사용량해당 없음
병렬 실행미지원
분산 실행수집 노드에서 실행 (mapper)

문법

schema [overlay={t|f}] [locale=STR] CODE

옵션

overlay={t|f}
오버레이 모드 활성화 여부 (기본값: f)
  • t: 스키마에 정의된 필드의 순서만 재정렬하고, 스키마에 정의되지 않은 필드도 함께 출력합니다.
  • f: 스키마에 정의된 필드만 선택하여 출력합니다.
locale=STR
필드 표시 이름의 언어를 지정합니다. 지정하지 않으면 세션의 로케일을 사용합니다.

대상

CODE
적용할 로그 스키마의 코드

입력 필드

없음

출력 필드

없음 (스키마에 따라 필드 이름 변환 및 순서 재정렬하여 전달)

오류 코드

파싱 오류
오류 코드메시지설명
23600schema 파라미터가 없습니다.스키마 코드가 지정되지 않은 경우
23601[code] 에 해당되는 schema를 찾을 수 없습니다.지정한 코드에 해당하는 스키마가 없는 경우
런타임 오류

해당 사항 없음

설명

schema 명령어는 실행 시 쿼리 플래너에 의해 renamefields(또는 order) 명령어로 변환됩니다. 스키마에 정의된 각 필드의 이름을 표시 이름으로 변환합니다.

overlay=f(기본값)이면 스키마에 정의된 필드만 선택하여 출력합니다. overlay=t이면 스키마에 정의된 필드를 앞쪽에 정렬하되, 스키마에 정의되지 않은 필드도 함께 출력합니다.

locale 옵션을 지정하면 해당 언어의 표시 이름을 사용합니다. 지정하지 않으면 현재 세션의 로케일 설정을 따릅니다. 해당 언어의 표시 이름이 없으면 기본 표시 이름을 사용합니다.

사용 예

  1. 스키마 적용

    table duration=1h WEB_APACHE | schema web_apache
    

    WEB_APACHE 테이블의 데이터에 web_apache 스키마를 적용하여 필드 이름을 표시 이름으로 변환하고, 스키마에 정의된 필드만 출력합니다.

  2. 오버레이 모드로 스키마 적용

    table duration=1h WEB_APACHE | schema overlay=t web_apache
    

    web_apache 스키마에 정의된 필드를 앞쪽에 정렬하고, 스키마에 정의되지 않은 필드도 함께 출력합니다.

  3. 언어를 지정하여 스키마 적용

    table duration=1h WEB_APACHE | schema locale=en web_apache
    

    web_apache 스키마를 적용하되 필드 표시 이름을 영어로 출력합니다.

호환성

schema 명령어는 소나 4.0 이전 버전부터 제공되었습니다.