16.4.5 tagmetaimport

tagmetaimport는 TAG 테이블의 메타데이터를 CSV 파일에서 일괄 가져오는 도구입니다. 대량의 TAG 이름과 메타데이터를 등록할 때 사용합니다. 기존 태그를 자동 갱신하거나 파일 전체를 하나의 트랜잭션으로 반영하는 도구는 아닙니다.

옵션 목록

tagmetaimport -h

입력 파일 형식

메타데이터 CSV 파일은 TAG 테이블의 메타 컬럼 순서에 맞게 작성합니다.

TAG 테이블 정의 예시:

CREATE TAG TABLE sensor_tag (
    name   VARCHAR(64) PRIMARY KEY,
    time   DATETIME    BASETIME,
    value  DOUBLE      SUMMARIZED
) METADATA (
    unit   VARCHAR(32),
    location VARCHAR(128)
);

이 테이블의 메타데이터 CSV 파일 (tag_meta.csv):

name,unit,location
sensor_001,celsius,Building-A Floor-1
sensor_002,celsius,Building-A Floor-2
sensor_003,bar,Boiler-Room
sensor_004,rpm,Motor-Section

헤더 없이 데이터만 있는 경우:

sensor_001,celsius,Building-A Floor-1
sensor_002,celsius,Building-A Floor-2

사용 예시

기본 가져오기

tagmetaimport -s 127.0.0.1 -P 5656 -u SYS -p MANAGER \
    -t _SENSOR_TAG_META -d tag_meta.csv -H

헤더가 있는 CSV 파일 가져오기

tagmetaimport -s 127.0.0.1 -P 5656 -u SYS -p MANAGER \
    -t _SENSOR_TAG_META -d tag_meta.csv -H

원격 서버에 가져오기

tagmetaimport -s 192.168.0.10 -P 5656 -u SYS -p MANAGER \
    -t _SENSOR_TAG_META -d tag_meta.csv -H

탭 구분자 파일

tagmetaimport -s 127.0.0.1 -P 5656 -u SYS -p MANAGER \
    -t _SENSOR_TAG_META -d tag_meta.tsv -D '\t' -H

EUC-KR 인코딩 파일

tagmetaimport -s 127.0.0.1 -P 5656 -u SYS -p MANAGER \
    -t _SENSOR_TAG_META -d tag_meta_kr.csv -E MS949 -H

동작 방식

• -t는 자동으로 논리 TAG를 METADATA 대상으로 바꾸지 않습니다. 논리 테이블 sensor_tag의 대상은 _SENSOR_TAG_META입니다. 이 이름은 도구의 입력 대상 지정에만 사용합니다.
• 이미 존재하는 태그 이름은 일반 METADATA INSERT에서 오류이며 실패 건수와 bad/log 파일로 확인합니다.
• 데이터가 입력된 이후에 메타데이터를 추가하려는 경우 이 도구를 사용하면 효율적입니다.
• 소량의 메타데이터는 SQL INSERT 또는 machsql에서 직접 입력할 수도 있습니다.

-- machsql에서 직접 메타데이터 삽입
INSERT INTO sensor_tag METADATA (name, unit, location)
VALUES ('sensor_005', 'volt', 'Panel-Room');

주의 사항

• TAG 테이블이 사전에 생성되어 있어야 합니다.
• CSV 파일의 컬럼 순서는 TAG 테이블의 메타 컬럼 순서와 일치해야 합니다.
• BASETIME 컬럼(time)과 SUMMARIZED 컬럼(value)은 메타데이터 파일에 포함하지 않습니다.

기존 값 변경은 UPDATE sensor_tag METADATA ... 또는 명시적인 SQL UPSERT로 수행합니다. 재현 가능한 신규 입력·재입력 실패 예제는 메타데이터 일괄 등록을 참고하십시오. _LAST_UPDATE_TIME은 새 메타데이터 입력과 실제 값 변경 시 서버가 관리합니다.