import

입력되는 모든 레코드를 지정된 테이블에 기록합니다. 클러스터 관리자 권한이 필요합니다.

명령어 속성

항목설명
명령어 유형가공 쿼리
필요 권한클러스터 관리자
라이선스 사용량해당 없음
병렬 실행지원
분산 실행분석 노드에서 실행 (reducer)

문법

import [create=BOOL] [_sk=STR] TABLE

옵션

create=BOOL
t로 설정하면 대상 테이블이 존재하지 않을 때 자동으로 테이블을 생성합니다. 이 옵션은 시스템 속성 araqne.logdb.import_create_option이 활성화된 환경에서만 사용할 수 있습니다. (기본값: f)
_sk=STR
파티션 서브키 필드 이름. 레코드를 저장할 때 파티션을 결정하는 서브키 값을 읽어올 필드를 지정합니다. (기본값: _sk)

대상

TABLE
레코드를 기록할 대상 테이블 이름

입력 필드

필드타입필수 여부설명
_time날짜선택레코드의 시각. 값이 null이거나 날짜 타입이 아니면 현재 시각을 사용합니다.

출력 필드

입력 레코드의 필드를 그대로 전달합니다.

오류 코드

파싱 오류
오류 코드메시지설명
30100권한이 없습니다. 클러스터 관리자 권한이 필요합니다.클러스터 관리자 권한 없이 실행한 경우
30101[table]은 존재하지 않는 테이블입니다.지정한 테이블이 존재하지 않고 create 옵션도 사용하지 않은 경우
30102[table]은 잘못된 형식의 테이블 이름입니다.테이블 이름이 올바르지 않은 경우
30103import 명령어에서 create 옵션은 더 이상 지원되지 않습니다.create=t를 지정했으나 시스템 속성이 비활성화된 경우
런타임 오류

해당 사항 없음

설명

import 명령어는 입력되는 모든 레코드를 지정된 테이블에 기록하고, 입력 레코드를 그대로 다음 명령어로 전달합니다. 각 레코드의 _time 필드 값을 저장 시각으로 사용하며, _time 필드가 없거나 날짜 타입이 아닌 경우 현재 시각을 사용합니다.

스토리지가 읽기 전용 상태이거나 쓰기 중 오류가 발생하면 쿼리가 취소됩니다.

분산 환경에서는 분석 노드에서 실행됩니다.

사용 예

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

  1. 테이블에 레코드 기록

    table WEB_APACHE_SAMPLE | import WEB_APACHE_BACKUP
    

    WEB_APACHE_SAMPLE 테이블의 전체 데이터를 WEB_APACHE_BACKUP 테이블에 기록합니다.

  2. 집계 결과를 테이블에 저장

    table WEB_APACHE_SAMPLE
    | stats count by method
    | import WEB_METHOD_STATS
    

    WEB_APACHE_SAMPLE 테이블의 데이터를 HTTP 메서드별로 집계하여 WEB_METHOD_STATS 테이블에 저장합니다.

  3. 파티션 서브키 필드 지정

    table WEB_APACHE_SAMPLE
    | import _sk=src_ip WEB_APACHE_BY_IP
    

    src_ip 필드의 값을 파티션 서브키로 사용하여 WEB_APACHE_BY_IP 테이블에 기록합니다.

호환성

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