如何实现Loopback4与Timescale DB数据库的连接配置

1. 选用的连接器 #

TimescaleDB 是 PostgreSQL 的时序扩展，完全兼容 PostgreSQL 协议，因此直接使用 Loopback4 官方的 PostgreSQL 连接器 即可，不需要额外的专用连接器。

2. 连接操作步骤 #

• 第一步：安装 PostgreSQL 连接器
  执行命令：
  npm install @loopback/connector-postgresql --save
• 第二步：创建数据源
  执行 Loopback4 CLI 命令 lb4 datasource，按照交互提示选择 PostgreSQL 作为连接器，输入对应的数据库连接信息，即可自动生成数据源配置文件。
• 第三步：开启 TimescaleDB 扩展
  连接到目标 PostgreSQL 数据库，执行 SQL 开启扩展（该操作仅需执行一次）：
  CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;

3. 数据源配置参数说明 #

自动生成的数据源配置文件默认存放在 src/datasources/ 目录下，核心配置字段要求如下：

• name：自定义的数据源名称，用于项目内识别，无强制格式要求
• connector：固定值为 postgresql，指定使用 PostgreSQL 连接器
• host：TimescaleDB 服务的主机地址，本地部署默认值为 localhost
• port：TimescaleDB 服务的端口，默认值为 5432
• user：数据库登录用户名
• password：数据库登录密码
• database：要连接的目标数据库名称
• schema：可选参数，指定使用的数据库 schema，默认值为 public
• ssl：可选布尔值，是否启用 SSL 连接，公网部署的云服务 TimescaleDB 实例通常需要设置为 true
• url：可选参数，可直接传入完整的数据库连接串，格式为 postgres://<user>:<password>@<host>:<port>/<database>，如果配置了 url 则不需要单独配置 host、port 等单独连接字段

4. 时序功能使用说明 #

基础的 CRUD 操作和普通 PostgreSQL 用法完全一致，如果需要创建超表、执行时序专属函数，直接调用 Loopback4 Repository 的 execute 方法执行原生 SQL 即可，示例：
await yourRepository.execute(SELECT create_hypertable('your_table_name', 'your_time_column_name');)

内容的提问来源于stack exchange，提问作者Utkarsh Mankad