import
입력되는 모든 레코드를 지정된 테이블에 기록합니다. 클러스터 관리자 권한이 필요합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 가공 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 해당 없음 |
| 병렬 실행 | 지원 |
| 분산 실행 | 분석 노드에서 실행 (reducer) |
문법
import [create=BOOL] [_sk=STR] TABLE
옵션
create=BOOLt로 설정하면 대상 테이블이 존재하지 않을 때 자동으로 테이블을 생성합니다. 이 옵션은 시스템 속성araqne.logdb.import_create_option이 활성화된 환경에서만 사용할 수 있습니다. (기본값:f)_sk=STR- 파티션 서브키 필드 이름. 레코드를 저장할 때 파티션을 결정하는 서브키 값을 읽어올 필드를 지정합니다. (기본값:
_sk)
대상
TABLE- 레코드를 기록할 대상 테이블 이름
입력 필드
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
_time | 날짜 | 선택 | 레코드의 시각. 값이 null이거나 날짜 타입이 아니면 현재 시각을 사용합니다. |
출력 필드
입력 레코드의 필드를 그대로 전달합니다.
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 30100 | 권한이 없습니다. 클러스터 관리자 권한이 필요합니다. | 클러스터 관리자 권한 없이 실행한 경우 |
| 30101 | [table]은 존재하지 않는 테이블입니다. | 지정한 테이블이 존재하지 않고 create 옵션도 사용하지 않은 경우 |
| 30102 | [table]은 잘못된 형식의 테이블 이름입니다. | 테이블 이름이 올바르지 않은 경우 |
| 30103 | import 명령어에서 create 옵션은 더 이상 지원되지 않습니다. | create=t를 지정했으나 시스템 속성이 비활성화된 경우 |
런타임 오류
해당 사항 없음
설명
import 명령어는 입력되는 모든 레코드를 지정된 테이블에 기록하고, 입력 레코드를 그대로 다음 명령어로 전달합니다. 각 레코드의 _time 필드 값을 저장 시각으로 사용하며, _time 필드가 없거나 날짜 타입이 아닌 경우 현재 시각을 사용합니다.
스토리지가 읽기 전용 상태이거나 쓰기 중 오류가 발생하면 쿼리가 취소됩니다.
분산 환경에서는 분석 노드에서 실행됩니다.
사용 예
이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.
-
테이블에 레코드 기록
table WEB_APACHE_SAMPLE | import WEB_APACHE_BACKUPWEB_APACHE_SAMPLE테이블의 전체 데이터를WEB_APACHE_BACKUP테이블에 기록합니다. -
집계 결과를 테이블에 저장
table WEB_APACHE_SAMPLE | stats count by method | import WEB_METHOD_STATSWEB_APACHE_SAMPLE테이블의 데이터를 HTTP 메서드별로 집계하여WEB_METHOD_STATS테이블에 저장합니다. -
파티션 서브키 필드 지정
table WEB_APACHE_SAMPLE | import _sk=src_ip WEB_APACHE_BY_IPsrc_ip필드의 값을 파티션 서브키로 사용하여WEB_APACHE_BY_IP테이블에 기록합니다.
호환성
import 명령어는 소나 4.0 이전 버전부터 제공되었습니다.