DML操作

單行插入

INSERT INTO user_table VALUES (1, 'value1', 100);

同一分區鍵下的多行批量插入

同一分區鍵下的多行可以原子批量插入，單次最多 200 行。以下樣本假設表結構為 user_table(pk1 BIGINT, pk2 VARCHAR(1024), value BIGINT)，其中 pk1 為分區鍵。兩行的分區鍵 pk1 均為 1，屬於同一分區，可原子批量插入。

INSERT INTO user_table VALUES (1, 'attr1', 100), (1, 'attr2', 200);

注意事項

• 主鍵衝突：插入已存在主鍵的行會返回錯誤，錯誤碼為 OTSParameterInvalid，錯誤資訊包含 Duplicate entry for key 'PRIMARY'，已有資料不會被覆蓋。

• 跨分區鍵批量插入：批量 INSERT 的所有行必須具有相同的分區鍵，跨分區鍵的批量插入會失敗。

• 單批超過 200 行：單次批量 INSERT 超過 200 行時將被拒絕。

• 受影響行數：單行 INSERT 成功返回 1，N 行批量插入成功返回 N。主鍵衝突時不返回受影響行數，直接報錯。

常量值更新

支援單列或多列同時更新。

-- 單列更新
UPDATE user_table SET attr_col = 999 WHERE pk_col = 1;

-- 多列更新
UPDATE user_table SET c1 = 10, c2 = 20, c3 = 'updated' WHERE id = 1;

-- 複合主鍵更新，WHERE 條件順序可與主鍵定義順序不同
UPDATE user_table SET value = 999 WHERE pk2 = 2 AND pk1 = 1;

自增列更新

對整數類型（BIGINT）的屬性列進行原子性的遞增或遞減操作，適用於計數器等情境。僅支援整數類型屬性列，不支援 DOUBLE、BOOL、VARCHAR 等其他類型。

-- 遞增 1
UPDATE user_table SET counter = counter + 1 WHERE id = 1;

-- 遞增指定值
UPDATE user_table SET counter = counter + 10 WHERE id = 1;

-- 遞減
UPDATE user_table SET counter = counter - 5 WHERE id = 1;

將屬性列設為 NULL

將屬性列設為 NULL 等同於刪除該屬性列。系統會將該屬性列從行中移除，而非儲存 NULL 值。

UPDATE user_table SET attr_col = NULL WHERE pk_col = 1;

注意事項

• WHERE 必須為完整主鍵等值條件：以下情況均不支援，會返回錯誤碼 OTSParameterInvalid 或 OTSUnsupportOperation：

  • WHERE 子句未包含完整主鍵。

  • WHERE 子句使用了非主鍵列條件。

  • WHERE 子句使用了範圍查詢（>、<、BETWEEN 等）。

  • WHERE 子句使用了 IN、LIKE、OR、!= 等非等值條件。

  • WHERE 子句在完整主鍵之外附加了屬性列條件。

• 不能修改主鍵列：UPDATE 不支援通過 SET 修改主鍵列的值。

• 目標行不存在：UPDATE 不存在的行時操作靜默成功，受影響行數為 0，不報錯。

注意事項

• WHERE 必須為完整主鍵等值條件：約束與 UPDATE 一致，缺 WHERE、部分主鍵、非主鍵列條件、範圍條件、IN、LIKE、OR、附加屬性列條件等均不支援。

• 目標行不存在：DELETE 不存在的行時操作靜默成功，受影響行數為 0，不報錯。

SQL 文法限制

以下 SQL 文法在非事務表 DML 操作中不支援：

資料類型限制

列選項和約束限制

CREATE TABLE 時僅支援以下列選項：PRIMARY KEY、NOT NULL、NULL、DEFAULT VALUE、ON UPDATE。不支援 AUTO_INCREMENT、UNIQUE、CHECK、COMMENT 等列選項。

約束方面，僅支援 PRIMARY KEY 約束，不支援 UNIQUE、FOREIGN KEY、CHECK 等約束。

特殊表類型限制

Search 綁定表和別名表不支援任何 DML 操作（INSERT、UPDATE、DELETE）。