插入数据#

在创建完一个表的时候，用户可以插入数据。用户可以每次插入一行或多行。使用INSERT命令创建一个新行。这条命令要求提供表名字以及列值。比如，考虑来自表的基本概念的产品表：

CREATE TABLE products (
    product_no integer,
    name text,
    price numeric
);

下面是一个向表中插入一行的例子：

INSERT INTO products VALUES (1, 'Cheese', 9.99);

数据值是按照这些列在表中出现的顺序列出的，并且用逗号分隔。通常，数据值是常量，但也允许使用标量表达式。上述语法的缺点是你必须知道表中列的顺序。你也可以明确地列出列名以避免这个问题。比如，下面的两条命令都和上面的那条命令效果相同：

INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', 9.99);
INSERT INTO products (name, price, product_no) VALUES ('Cheese', 9.99, 1);

许多用户认为明确列出列名是个好习惯。如果你不知道所有列的数值，那么可以省略其中的一些。这时候,这些未知列将被填充为它们的缺省值。比如

INSERT INTO products (product_no, name) VALUES (1, 'Cheese');
INSERT INTO products VALUES (1, 'Cheese');

第二种形式从左向右用给定的值尽可能多的填充列，剩余的填充缺省值。为了保持清晰，你也可以对独立的列或者整个行明确使用缺省值：

INSERT INTO products (product_no, name, price) VALUES (1, 'Cheese', DEFAULT);
INSERT INTO products DEFAULT VALUES;

备注

HORC和MAGMA格式的表均支持设置缺省值。

你可以在一条命令中插入多行：

INSERT INTO products (product_no, name, price) VALUES
    (1, 'Cheese', 9.99),
    (2, 'Bread', 1.99),
    (3, 'Milk', 2.99);

当插入分区表的时候，用户可以直接插入父表。也可以直接插入特定的子表（注意，该子表必须是叶子表，也就是它没有再次分区）。当数据不符合要插入的分区的条件时，会报错。

小技巧

要一次插入大量数据，可以看看COPY命令，外部表导入等，详情请参考数据导入导出章节。这些方法性能要优于INSERT语句。 INSERT只适用于插入少量的数据。

MAGMA表upsert优化#

OushuDB 可以通过设置 magma_conflict_mode 这个 guc 值来控制唯一性约束的键插入重复值时的错误处理过程，有三种模式

do_conflict: 事务终止，并报告出现的duplicate key错误（这也是默认模式下magma_conflict_mode的值）
do_nothing: 不写入该行，也不报错，事务中其余语句仍然正常继续执行
do_replace: 插入的这行将覆盖原先的那行

下面举例说明：

-- 创建一个拥有唯一索引的主键表
CREATE TABLE test(a int UNIQUE, b int);
INSERT INTO test VALUES (1, 10);

测试do_conflict模式

-- 设置成do_conflict模式，遇到违反唯一性约束的错误会报错，并且事务终止
SET magma_conflict_mode = 'do_conflict';

-- 插入一个违反唯一性约束的数值
INSERT INTO test VALUES (1, 100);
ERROR:  duplicate key value violates unique constraint

-- test表中数据仍不变
SELECT * FROM test;
 a | b
---+----
1 | 10
(1 row)

-- 设置成do_nothing模式，遇到违反唯一性约束的错误不报错，只不过不插入
SET magma_conflict_mode = 'do_nothing';

-- 插入一个违反唯一性约束的数值
INSERT INTO test VALUES (1, 100);
INSERT 0 0

-- test表中数据仍不变
SELECT * FROM test;
 a | b
---+----
1 | 10
(1 row)

-- 设置成do_replace模式，遇到违反唯一性约束的错误的数值，就覆写
SET magma_conflict_mode = 'do_replace';

-- 插入一个违反唯一性约束的数值
INSERT INTO test VALUES (1, 100);
INSERT 0 1

-- test表中对应行的数据已覆写
SELECT * FROM test;
 a | b
---+----
1 | 100
(1 row)

OushuDB 产品文档

插入数据

本页目录

插入数据#

MAGMA表upsert优化#