跳到主要内容
版本:nightly

INSERT

INSERT 用于将一条或多条记录插入到 GreptimeDB 中的表中。

INSERT INTO Statement

Syntax

INSERT INTO 语法如下:

INSERT INTO table_name (column1, column2, column3, ...)
VALUES (value1, value2, value3, ...);

在上述语法中,table_name 是要插入数据的表名,column1column2column3 等是表中的列名。 如果你想要插入数据到指定的列中,可以在 INSERT INTO 语句中指定列名。 如果你不指定列名,数据将会插入到表中的所有列中。

VALUES 关键字后面跟着的是一个值列表,这个值列表的顺序必须和 INSERT INTO 语句中的列顺序一致。

VALUES 值支持以下数据类型:

  • DEFAULT 关键字指定该列的默认值。 这在你不想在插入记录时显式指定某些列的值时非常有用。 它允许使用表 schema 中定义的列默认值来替代需要显示指定的值。 如果该列没有定义默认值,将会使用数据库的默认值(通常是 NULL)。
  • 使用十六进制字面值插入二进制字面值。
  • 使用 {Value}::{Type} 语法将特殊的数值 Infinity-InfinityNaN 转换为指定的数值类型。

示例

插入数据

使用 INSERT INTO 语句将一条记录插入到名为 system_metrics 的表中:

INSERT INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts)
VALUES
("host1", "idc_b", 50.0, 66.7, 40.6, 1667446797462);

上述语句将一条记录插入到 system_metrics 表中,该记录的 host 为 "host1",idc 为 "idc_b",cpu_util 为 50.0,memory_util 为 66.7,

你还可以使用 INSERT INTO 语句一次向表中插入多条记录,例如向 system_metrics 表中插入多条记录:

INSERT INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts)
VALUES
("host1", "idc_a", 11.8, 10.3, 10.3, 1667446797460),
("host2", "idc_a", 80.1, 70.3, 90.0, 1667446797461),
("host1", "idc_c", 50.1, 66.8, 40.8, 1667446797463);

此语句将三条记录插入到 system_metrics 表中,每列都有指定的值。

使用默认值插入数据

下面的 SQL 语句使用 DEFAULT 关键字为 cpu_util 列插入默认值:

INSERT INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts)
VALUES ("host1", "idc_a", DEFAULT, 10.3, 10.3, 1667446797460);

插入二进制数据

当我们想要插入二进制数据时,其列的数据类型为 blobbytea

CREATE TABLE test(b BLOB, ts TIMESTAMP TIME INDEX);

推荐使用预编译语句,例如 JDBC:

  PreparedStatement pstmt = conn.prepareStatement("insert into test values(?,?)");
pstmt.setBytes(1, "hello".getBytes());
pstmt.setInt(2, 1687867163);
pstmt.addBatch();
......
pstmt.executeBatch();

如果我们想要插入字面值的二进制数据,可以使用十六进制字面值:

INSERT INTO test VALUES(X'9fad5e9eefdfb449', 1687867163);
-- or --
INSERT INTO test VALUES(0x9fad5e9eefdfb449', 1687867163);

插入特殊数字值

使用 {Value}::{Type} 将特殊的数值 Infinity-InfinityNaN 转换为指定的数值类型:

INSERT INTO system_metrics (host, idc, cpu_util, memory_util, disk_util, ts)
VALUES ("host1", "idc_a", 66.6, 'NaN'::double, 'Infinity'::double, 1667446797460);

INSERT INTO SELECT Statement

INSERT INTO SELECT 语句用于将一张表中的数据复制到另一张表中。

Syntax

INSERT INTO SELECT 的语法如下:

INSERT INTO table2 (column1, column2, ...)
SELECT column1, column2, ...
FROM table1;

在上述语法中,table1 是你想要从中复制数据的源表,table2 是你想要将数据插入的目标表。 table1table2 需要有用于复制数据的拥有同样名称和数据类型的列。 SELECT 语句从源表中选择要插入的列。 如果在INSERT INTO语句中没有指定列名,那么数据将被插入到目标表的所有列中。

当你想要从一个表中复制数据到另一个表时,INSERT INTO SELECT 语句非常有用。例如归档或备份数据时,比起备份整个数据库并恢复,这种方式更加高效。

示例

INSERT INTO system_metrics2 (host, idc, cpu_util, memory_util, disk_util, ts)
SELECT host, idc, cpu_util, memory_util, disk_util, ts
FROM system_metrics;