16.1.6 ROWID

Machbase 8.7.0부터 지원되는 기능

ROWID는 테이블 안의 한 행을 다시 찾기 위한 64비트 식별자입니다. 이 페이지는 SQL에서의 의미, 테이블별 조회 조건, INSERT 실행 결과와 유효 기간을 정의합니다. SDK별 접근 API와 코드는 SDK 기능 지원 범위와 각 언어 페이지를 참고하십시오.

이 기능은 Standard Edition에서 지원합니다. 서버와 SDK를 ROWID를 지원하는 버전으로 함께 업데이트해야 합니다. Cluster Edition에서는 사용할 수 없습니다.

ROWID와 업무 키 구분

ROWID는 현재 테이블의 저장 행 위치를 가리키는 식별자이며, 주문 번호나 장비 ID 같은 영구 업무 키가 아닙니다.

• 일반 컬럼이 아니므로 SELECT *에는 포함되지 않습니다. 필요한 경우 명시적으로 조회합니다.
• 다른 테이블의 ROWID와 비교하거나 다른 테이블 조회에 사용하지 않습니다.
• ROWID 값을 분해하거나 산술 연산에 사용하지 않습니다.
• 숫자의 크기가 전체 테이블의 입력 순서를 의미하지는 않습니다.
• 신규 테이블에는 ROWID라는 실제 컬럼을 정의할 수 없습니다.
• 이전 버전에서 실제 ROWID 컬럼을 만든 테이블은 그 컬럼을 우선합니다. ROWID 의사 컬럼을 사용하려면 기존 컬럼의 이름을 변경합니다.

SELECT ROWID, name, time, value
  FROM sensor_tag
 WHERE name = 'TAG-01';

테이블별 지원 범위

TRANSACTION, LOOKUP, VOLATILE 테이블에서는 AUTO_INCREMENT 사용 여부와 관계없이 값이 0 이상인 단일 LONG/INT64 PRIMARY KEY를 ROWID로 사용합니다. 애플리케이션이 PK 값을 지정한 경우에는 그 값이 반환되고, AUTO_INCREMENT PK를 생략하거나 NULL로 지정한 경우에는 서버가 생성한 값이 반환됩니다. 음수 PK는 ROWID로 사용할 수 없습니다.

LOG와 TAG ROWID는 0..UINT64_MAX-1, 세 PRIMARY KEY 기반 테이블은 0..INT64_MAX 범위입니다. 0은 유효한 값이며 UINT64_MAX는 ROWID로 사용할 수 없습니다.

LOG 조회

LOG ROWID는 범위 조회와 정렬에 사용할 수 있습니다. _ARRIVAL_TIME은 여러 행에서 같을 수 있으므로 특정 행을 다시 찾는 용도로는 ROWID를 사용합니다.

SELECT ROWID, message
  FROM app_log
 WHERE ROWID >= ?
   AND ROWID < ?
 ORDER BY ROWID;

ROWID IN (...)은 지원하지 않습니다.

TAG 조회

TAG는 단일 ROWID 일치 조회만 지원합니다. 태그 이름, 시간, 값 조건을 AND로 함께 지정할 수 있으며 모든 조건을 만족해야 행을 반환합니다.

SELECT ROWID, name, time, value
  FROM sensor_tag
 WHERE ROWID = ?
   AND name = 'TAG-01'
   AND time >= TO_DATE('2026-08-10 00:00:00', 'YYYY-MM-DD HH24:MI:SS');

TAG ROWID에는 다음 조건을 사용할 수 없습니다.

TRANSACTION, LOOKUP, VOLATILE 비교

다음 세 테이블은 같은 AUTO_INCREMENT 선언을 사용할 수 있지만 재시작과 입력 기능이 다릅니다.

CREATE TRANSACTION TABLE orders (
    id   LONG PRIMARY KEY AUTO_INCREMENT,
    item VARCHAR(100)
);

CREATE LOOKUP TABLE lookup_orders (
    id   LONG PRIMARY KEY AUTO_INCREMENT,
    item VARCHAR(100)
);

CREATE VOLATILE TABLE volatile_orders (
    id   LONG PRIMARY KEY AUTO_INCREMENT,
    item VARCHAR(100)
);

LOOKUP의 PROPERTY(SEQUENCE)와 NEXTVAL()은 AUTO_INCREMENT와 별개의 기능입니다. 두 방식을 같은 컬럼에 함께 지정하지 않습니다.

명시적 트랜잭션이 진행 중일 때는 TRANSACTION 테이블 DDL을 실행할 수 없습니다. CREATE TRANSACTION TABLE이 ERR-02362로 실패하면 먼저 COMMIT 또는 ROLLBACK한 뒤 다시 실행합니다.

JOIN, 집계와 View

JOIN 결과에는 전체 결과를 대표하는 ROWID가 없습니다. 필요한 원본 테이블 별칭의 ROWID를 각각 조회합니다.

SELECT a.ROWID AS order_rowid,
       b.ROWID AS item_rowid,
       a.customer, b.item
  FROM orders a JOIN order_items b ON a.id = b.order_id;

INSERT 결과로 ROWID를 받는 조건

INSERT ... RETURNING ROWID 문법은 사용하지 않습니다. 지원되는 SDK는 성공한 단일 INSERT ... VALUES의 실행 결과에 ROWID를 함께 제공합니다.

generated ROWID는 statement별 결과입니다. 연결 전체에서 최근 값을 조회하는 SQL 함수는 제공하지 않습니다.

조회 결과와 오류 구분

형식이 올바른 ROWID가 현재 테이블에 없으면 오류가 아니라 0행을 반환합니다. 삭제된 행, 추가 조건과 일치하지 않는 행도 같습니다. 반면 NULL, 음수 PK, UINT64_MAX, 숫자로 변환할 수 없는 값, TAG에서 지원하지 않는 범위·IN·OR·정렬 조건은 오류입니다.

유효 기간과 재시도

ROWID를 장기간 보관하는 업무 키로 사용하지 않습니다.

INSERT는 성공했지만 네트워크 응답이 끊기면 애플리케이션이 ROWID를 받지 못할 수 있습니다. 이때 같은 INSERT를 자동 재시도하면 중복 행이 생길 수 있으므로 업무 키나 별도의 idempotency 정책으로 실제 반영 여부를 먼저 확인합니다.

관련 문서

• SDK 기능 지원 범위
• AUTO_INCREMENT
• LOG 데이터 입력
• TAG 데이터 입력