timescaledb

Linux/macOS	Linux i386	Windows	Coverity	代码覆盖率	OpenSSF

TimescaleDB是一个开源数据库，旨在为时间序列数据提供可扩展的SQL解决方案。它基于PostgreSQL开发，并作为PostgreSQL扩展包提供，实现了跨时间和空间（分区键）的自动分区，同时提供完整的SQL支持。

如果您不想安装或管理自己的TimescaleDB实例，可以尝试Timescale提供的30天免费试用，这是我们的全托管云服务。Timescale采用按需付费模式。我们不会对您未使用的存储、备份、快照、入站或出站流量收费。

要确定哪个选项最适合您，请查看Timescale产品，了解更多关于我们的Apache-2版本、TimescaleDB社区版（自托管）和Timescale云（托管）的信息，包括：功能比较、常见问题、文档和支持。

以下是TimescaleDB的介绍。欲了解更多信息，请查看以下资源：

为了参考和清晰起见，本仓库中的所有代码文件在其头部都注明了许可证（Apache-2开源许可证或Timescale许可证(TSL)）。通过在bootstrap时传递-DAPACHE_ONLY=1参数，可以构建Apache-2许可的二进制文件。

欢迎贡献者。

（要从源代码构建TimescaleDB，请参阅从源代码构建中的说明。）

使用TimescaleDB

TimescaleDB通过跨时间和空间（分区键）的自动分区，实现了PostgreSQL对时间序列数据的扩展，同时保留了标准PostgreSQL接口。

换句话说，TimescaleDB呈现的是看似常规的表，但实际上只是一个抽象（或虚拟视图），由许多包含实际数据的独立表组成。这种单表视图，我们称之为超表，由许多数据块组成，这些数据块通过在一个或两个维度上对超表数据进行分区而创建：按时间间隔，以及可选的"分区键"，如设备ID、位置、用户ID等。几乎所有用户与TimescaleDB的交互都是通过超表进行的。创建表和索引、修改表、插入数据、选择数据等操作都可以（而且应该）在超表上执行。

从使用和管理的角度来看，TimescaleDB的外观和感觉就像PostgreSQL一样，可以按照相同的方式进行管理和查询。

开始之前

PostgreSQL的默认设置通常对现代服务器和TimescaleDB来说过于保守。您应该确保调整了postgresql.conf设置，可以使用timescaledb-tune或手动进行调整。

创建超表

-- 不要忘记创建timescaledb扩展
CREATE EXTENSION timescaledb;

-- 首先创建一个普通的SQL表
CREATE TABLE conditions (
  time        TIMESTAMPTZ       NOT NULL,
  location    TEXT              NOT NULL,
  temperature DOUBLE PRECISION  NULL,
  humidity    DOUBLE PRECISION  NULL
);

-- 然后将其转换为按时间分区的超表
SELECT create_hypertable('conditions', 'time');

插入和查询数据

通过普通的SQL命令向超表插入数据：

INSERT INTO conditions(time, location, temperature, humidity)
  VALUES (NOW(), 'office', 70.0, 50.0);

SELECT * FROM conditions ORDER BY time DESC LIMIT 100;

SELECT time_bucket('15 minutes', time) AS fifteen_min,
    location, COUNT(*),
    MAX(temperature) AS max_temp,
    MAX(humidity) AS max_hum
  FROM conditions
  WHERE time > NOW() - interval '3 hours'
  GROUP BY fifteen_min, location
  ORDER BY fifteen_min DESC, max_temp DESC;