RDS PostgreSQL实例新增TimescaleDB插件版本，支持时序数据的自动分片、高效写入、检索、准实时聚合等。

目前RDS PostgreSQL对外开放的是Open Source版本的TimescaleDB，由于License等问题，可能暂不支持一些高级特性，详情参见TimescaleDB。

前提条件

  • 实例版本为PostgreSQL 11、12、13。
    说明 如果实例版本为PostgreSQL 13，需要内核小版本大于等于20211130，如需升级内核小版本，请参见升级内核小版本。
  • 使用该插件前，需要将timescaledb加入到shared_preload_libraries参数中。

    您可以使用RDS PostgreSQL参数设置功能，为shared_preload_libraries参数添加timescaledb。具体操作，请参见设置实例参数。

说明 部分存量用户可能已经创建过TimescaleDB插件，如果升级内核小版本后，出现如下类似提示：
ERROR:  could not access file "$libdir/timescaledb-1.3.0": No such file or directory

请在对应数据库执行如下SQL更新插件：

alter extension timescaledb update;

添加TimescaleDB插件

使用pgAdmin客户端连接实例，添加TimescaleDB，命令如下： 

CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;

创建时序表

  1. 创建标准表conditions，示例如下： 
    CREATE TABLE conditions (
  time        TIMESTAMPTZ       NOT NULL,
  location    TEXT              NOT NULL,
  temperature DOUBLE PRECISION  NULL,
  humidity    DOUBLE PRECISION  NULL
);
  2. 创建时序表，示例如下： 
    SELECT create_hypertable('conditions', 'time');
说明 详细命令说明请参见Create a Hypertable。

高效写入

您可以使用标准SQL命令将数据插入超表（Hypertables），示例如下： 
INSERT INTO conditions(time, location, temperature, humidity)
  VALUES (NOW(), 'office', 70.0, 50.0);
您还可以一次将多行数据插入到超表中，示例如下： 
INSERT INTO conditions
  VALUES
    (NOW(), 'office', 70.0, 50.0),
    (NOW(), 'basement', 66.5, 60.0),
    (NOW(), 'garage', 77.0, 65.2);

检索

您可以使用高级SQL查询检索数据，示例如下： 
--过去3小时内，每15分钟采集一次数据，按时间和温度排序。
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;

您也可以使用固有的函数进行分析查询，示例如下：

--均值查询（Median）
SELECT percentile_cont(0.5)
  WITHIN GROUP (ORDER BY temperature)
  FROM conditions;
均值百分查询
--移动平均数（Moving Average）
SELECT time, AVG(temperature) OVER(ORDER BY time
      ROWS BETWEEN 9 PRECEDING AND CURRENT ROW)
    AS smooth_temp
  FROM conditions
  WHERE location = 'garage' and time > NOW() - interval '1 day'
  ORDER BY time DESC;
移动平均数

常见问题

Q：使用插件时遇到如下报错如何处理？
ERROR:  functionality not supported under the current license "ApacheOnly", license
HINT:  Upgrade to a Timescale-licensed binary to access this free community feature

A：TimescaleDB官方协议要求，不允许使用TSL协议的功能提供database-as-a-service和software-as-a-service。更多信息，请参见TimescaleDB官方协议的2.2章节。