SQL

你可以使用 MySQL 或 PostgreSQL 客户端执行 SQL 语句， 使用任何你喜欢的编程语言（如Java JDBC）通过 MySQL 或 PostgreSQL 协议访问 GreptimeDB。

我们将使用 monitor 表作为示例来展示如何写入数据。有关如何创建 monitor 表的 SQL 示例，请参见表管理。

创建表

在插入数据之前，你需要创建一个表。例如，创建一个名为 monitor 的表：

  1. CREATE TABLE monitor (
  2.     host STRING,
  3.     ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP() TIME INDEX,
  4.     cpu FLOAT64 DEFAULT 0,
  5.     memory FLOAT64,
  6.     PRIMARY KEY(host));

上述语句将创建一个具有以下 schema 的表：

  1. +--------+----------------------+------+------+---------------------+---------------+
  2. | Column | Type                 | Key  | Null | Default             | Semantic Type |
  3. +--------+----------------------+------+------+---------------------+---------------+
  4. | host   | String               | PRI  | YES  |                     | TAG           |
  5. | ts     | TimestampMillisecond | PRI  | NO   | current_timestamp() | TIMESTAMP     |
  6. | cpu    | Float64              |      | YES  | 0                   | FIELD         |
  7. | memory | Float64              |      | YES  |                     | FIELD         |
  8. +--------+----------------------+------+------+---------------------+---------------+
  9. 4 rows in set (0.01 sec)

有关 CREATE TABLE 语句的更多信息，请参阅表管理。

插入数据

让我们向 monitor 表中插入一些测试数据。你可以使用 INSERT INTO 语句：

  1. INSERT INTO monitor
  2. VALUES
  3.     ("127.0.0.1", 1702433141000, 0.5, 0.2),
  4.     ("127.0.0.2", 1702433141000, 0.3, 0.1),
  5.     ("127.0.0.1", 1702433146000, 0.3, 0.2),
  6.     ("127.0.0.2", 1702433146000, 0.2, 0.4),
  7.     ("127.0.0.1", 1702433151000, 0.4, 0.3),
  8.     ("127.0.0.2", 1702433151000, 0.2, 0.4);
  1. Query OK, 6 rows affected (0.01 sec)

你还可以插入数据时指定列名：

  1. INSERT INTO monitor (host, ts, cpu, memory)
  2. VALUES
  3.     ("127.0.0.1", 1702433141000, 0.5, 0.2),
  4.     ("127.0.0.2", 1702433141000, 0.3, 0.1),
  5.     ("127.0.0.1", 1702433146000, 0.3, 0.2),
  6.     ("127.0.0.2", 1702433146000, 0.2, 0.4),
  7.     ("127.0.0.1", 1702433151000, 0.4, 0.3),
  8.     ("127.0.0.2", 1702433151000, 0.2, 0.4);

通过上面的语句，我们成功的向 monitor 表中插入了六条数据。请参考 INSERT 获得更多写入数据的相关信息。

时区

SQL 客户端中指定的时区将影响没有时区信息的字符串格式的时间戳。 该时间戳值将会自动添加客户端的时区信息。

例如，下面的 SQL 将时区设置为 +8:00：

  1. SET time_zone = '+8:00';

然后向 monitor 表中插入值：

  1. INSERT INTO monitor (host, ts, cpu, memory)
  2. VALUES
  3.     ("127.0.0.1", "2024-01-01 00:00:00", 0.4, 0.1),
  4.     ("127.0.0.2", "2024-01-01 00:00:00+08:00", 0.5, 0.1);

第一个时间戳值 2024-01-01 00:00:00 没有时区信息，因此它将自动添加客户端的时区信息。 在插入数据后，它将等同于第二个值 2024-01-01 00:00:00+08:00。

+8:00 时区下的结果如下：

  1. +-----------+---------------------+------+--------+
  2. | host      | ts                  | cpu  | memory |
  3. +-----------+---------------------+------+--------+
  4. | 127.0.0.1 | 2024-01-01 00:00:00 |  0.4 |    0.1 |
  5. | 127.0.0.2 | 2024-01-01 00:00:00 |  0.5 |    0.1 |
  6. +-----------+---------------------+------+--------+

UTC 时区下的结果如下：

  1. +-----------+---------------------+------+--------+
  2. | host      | ts                  | cpu  | memory |
  3. +-----------+---------------------+------+--------+
  4. | 127.0.0.1 | 2023-12-31 16:00:00 |  0.4 |    0.1 |
  5. | 127.0.0.2 | 2023-12-31 16:00:00 |  0.5 |    0.1 |
  6. +-----------+---------------------+------+--------+