为RDS PostgreSQL实例添加TimescaleDB插件 - 云数据库 RDS

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

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

前提条件

实例大版本为PostgreSQL 10或以上版本。
说明
暂不支持RDS PostgreSQL 17。
实例内核小版本至少升级到20230330。查看和升级内核小版本，请参见升级内核小版本。
重要
20230330内核小版本之前已支持此插件，但RDS PostgreSQL支持插件策略已于2023年4月17日调整，部分插件在20230330或以上内核小版本才能创建，更多信息，请参见【通知】2023年4月17日起RDS PostgreSQL部分插件在低内核版本限制创建。
- 如果您的实例大版本为PostgreSQL 14，在20230330内核小版本前已使用了TimescaleDB插件（插件版本小于等于2.5.0），在不升级内核小版本时，不影响使用，在升级内核小版本到20230330或以上版本后，必须手动执行ALTER EXTENSION timescaledb UPDATE;命令进行手动升级插件后，才能继续使用。
- 如果您的实例大版本为PostgreSQL 15、13、12、11或10，在20230330内核小版本前已使用了TimescaleDB插件，不影响使用。
- 如果您首次创建或重新创建此插件，请升级内核小版本到20230330或以上版本。
使用该插件前，需要将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;

创建时序表

创建标准表conditions，示例如下：

CREATE TABLE conditions (
  time        TIMESTAMPTZ       NOT NULL,
  location    TEXT              NOT NULL,
  temperature DOUBLE PRECISION  NULL,
  humidity    DOUBLE PRECISION  NULL
);

创建时序表，示例如下：

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官方协议要求，不允许使用TLS协议的功能提供database-as-a-service和software-as-a-service。更多信息，请参见TimescaleDB官方协议的2.2章节。