16.1.6 ROWID

Machbase 8.7.0以降でサポート

ROWIDはテーブル内の1行を再検索するための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、3つの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の比較

次の3つのテーブルは同じ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も含めて返します。

生成されたROWIDはステートメントごとの結果です。接続全体の最新値を参照するSQL関数は提供しません。

参照結果とエラーの区別

形式が正しいROWIDが現在のテーブルになければ、エラーではなく0行を返します。削除済みの行や追加条件を 満たさない行も同様です。一方、NULL、負数のPK、UINT64_MAX、数値へ変換できない値、TAGで非対応の 範囲・IN・OR・ソート条件はエラーです。

有効期間と再試行

ROWIDを長期保存する業務キーとして使用しないでください。

INSERTが成功してもネットワーク応答が失われると、アプリケーションがROWIDを受け取れない場合があります。 同じINSERTを自動再試行すると重複行が生じる可能性があるため、業務キーや別途の冪等性ポリシーで 実際の反映状態を先に確認してください。

関連ドキュメント

• SDK機能のサポート範囲
• AUTO_INCREMENT
• LOGデータの取り込み
• TAGデータの取り込み