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）。