安装和更新 TimescaleDB Toolkit

Timescale Cloud：性能、扩展、企业级

自托管产品

MST

某些超函数默认包含在 Timescale 中。对于其他超函数，您需要安装 TimescaleDB Toolkit PostgreSQL 扩展。

如果您正在使用 Timescale，Toolkit 已预装。

在 TimescaleDB 托管服务上安装和更新 Toolkit

在 TimescaleDB 托管服务上，在您希望使用 Toolkit 的每个数据库上运行此命令


CREATE EXTENSION timescaledb_toolkit;

使用此命令更新已安装的 Toolkit 版本


ALTER EXTENSION timescaledb_toolkit UPDATE;

如果您正在自行托管 TimescaleDB 数据库，您可以通过以下方式安装 Toolkit：

推荐的安装 Toolkit 的方法是使用 TimescaleDB Docker 镜像。要获取 Toolkit，请使用高可用性镜像 timescaledb-ha


docker pull timescale/timescaledb-ha:pg17

有关使用 Docker 运行 TimescaleDB 的更多信息，请参阅关于预构建容器的章节。

这些说明使用 yum 包管理器。它们已在 CentOS 7 上进行测试，也可能适用于其他基于 Red Hat 的系统，例如 Red Hat Enterprise Linux 和 Fedora。

确保您已安装 TimescaleDB 并在您的 yum repo.d 目录中创建了 TimescaleDB 存储库。有关更多信息，请参阅基于 Red Hat 的系统的说明。
更新本地存储库列表
```
yum update
```

安装 TimescaleDB Toolkit


yum install timescaledb-toolkit-postgresql-16

这些说明使用 apt 包管理器。它们已在 Ubuntu 20.04 上进行测试，也可能适用于其他基于 Debian 的系统。

安装 TimescaleDB Toolkit


apt install timescaledb-toolkit-postgresql-16

这些说明使用 brew 包管理器。有关安装或使用 Homebrew 的更多信息，请参阅 brew 主页。

启用 Timescale 公式库，其中还包含 TimescaleDB 和 timescaledb-tune 的公式。
```
brew tap timescale/tap
```
更新您的本地 brew 安装
```
brew update
```
安装 TimescaleDB Toolkit
```
brew install timescaledb-toolkit
```
连接到您希望使用 Toolkit 的数据库。
在数据库中创建 Toolkit 扩展
```
CREATE EXTENSION timescaledb_toolkit;
```

TimescaleDB Toolkit 目前不支持 Windows。作为一种变通方法，您可以在 Docker 容器中运行 PostgreSQL。

通过安装最新版本并运行 ALTER EXTENSION 来更新 Toolkit。

在数据库中更新 Toolkit 扩展


ALTER EXTENSION timescaledb_toolkit UPDATE;

对于某些 Toolkit 版本，您可能需要断开并重新连接活动会话。

您可以从源代码构建 Toolkit。有关更多信息，请参阅 Toolkit 开发者文档。