TAG data UPDATE WHERE/SET constraints

TAG data UPDATE는 대상 범위가 명확해야 합니다. WHERE 절에는 태그 선택 조건과 BASETIME 조건이 모두 필요하고, SET 절은 실제 데이터 컬럼만 대상으로 합니다.

Machbase 8.7.0부터 지원되는 기능

SET 절 제약

SET 표현식에는 상수, bind 변수, 기존 행 컬럼을 참조하지 않는 산술식·문자열식·CASE, 허용된 형변환 함수와 NULL을 사용할 수 있습니다. 기존 행 컬럼을 참조하는 식, 서브쿼리와 집계식은 SET RHS로 사용할 수 없습니다.

WHERE 절 제약

UPDATE table_name
   SET col = expr
 WHERE name = 'tag-name'
   AND time >= TO_DATE('2026-07-01', 'YYYY-MM-DD');

Bind parameter는 조건의 값 위치에만 사용합니다. 태그 이름과 BASETIME 컬럼을 marker로 대체할 수 없으며, bind를 사용해도 태그 선택 조건과 시간 조건은 모두 필요합니다. 같은 prepared statement를 다시 실행하면 새로 바인딩한 값으로 대상을 선택하고, 일치하는 행이 없으면 affected rows 0으로 성공합니다.

NAME과 TIME parameter의 타입 정보와 SDK별 API는 TAG data UPDATE의 bind parameter 및 Named Bind Parameter를 참고하십시오.

메타데이터 UPDATE

UPDATE table_name METADATA
   SET meta_col = value
 WHERE condition;

메타데이터 UPDATE는 태그 속성 영역을 수정합니다. 실제 시계열 row의 데이터 컬럼을 수정하는 TAG data UPDATE와 구문과 대상이 다릅니다.

컬럼 역할 확인 방법

DESC 명령으로 컬럼 속성을 확인합니다.

DESC sensor_tag;

또는 시스템 테이블에서 컬럼 FLAG를 조회합니다.

SELECT NAME, TYPE, FLAG
  FROM M$SYS_COLUMNS
 WHERE TABLE_ID = (
     SELECT ID FROM M$SYS_TABLES WHERE NAME = 'SENSOR_TAG'
 );

오류 사례

-- 오류: BASETIME 컬럼을 SET 대상으로 지정
UPDATE sensor_tag
   SET time = TO_DATE('2026-07-01', 'YYYY-MM-DD')
 WHERE name = 'TEMP-01'
   AND time >= TO_DATE('2026-07-01', 'YYYY-MM-DD');

-- 오류: 시간 조건이 없음
UPDATE sensor_tag
   SET value = 0.0
 WHERE name = 'TEMP-01';

-- 오류: OR 조건 사용
UPDATE sensor_tag
   SET value = 0.0
 WHERE name = 'TEMP-01'
    OR name = 'TEMP-02';

관련 문서

• TAG data UPDATE syntax
• Named Bind Parameter
• ROLLUP_REBUILD syntax