亲测有效！如何快速实现 PostgreSQL 数据迁移到 时序数据库 TDengine

小 T 导读：本篇文章是“2024，我想和 TDengine 谈谈”征文活动的优秀投稿之一，作者从数据库运维的角度出发，分享了利用 TDengine Cloud 提供的迁移工具，从 PostgreSQL 数据库到 TDengine 进行数据迁移的完整实践过程。文章详细记录了从创建数据库实例、配置代理，到添加数据源、同步数据的每一个步骤，并结合实际操作中遇到的问题与解决经验，展现了 TDengine Cloud 的便利性和研发团队的高效响应能力。对于关注数据库迁移的技术人员来说，这篇文章是一个宝贵的经验分享。

从数据库管理员（DBA）或运维人员的角度来看，判断数据库是否易用，最直观且通常最先面临的问题便是存量数据库的迁移。如果数据库厂商能够提供一款高效便捷的迁移工具，使用户能够快速将源数据库的数据迁移至目标数据库，不仅能为用户留下良好的第一印象，也将大大促进后续工作的顺利开展。由于线下缺乏合适的迁移工具，因此本文将利用 TDengine Cloud 提供的迁移工具，对从 PostgreSQL 数据库迁移至 TDengine 的过程进行初步体验和探索。

创建数据库实例

首先，我们需要在官方 TDengine Cloud 平台（https://cloud.taosdata.com/auth）上完成注册并创建数据库实例。该过程操作简便，此处不再赘述。

创建新的代理

由于我的源数据库位于本地虚拟机，而目标数据库托管于 TDengine Cloud，因此需要在本地虚拟机上安装代理，以确保 TDengine Cloud 能够访问本地虚拟机中的 PostgreSQL 数据库。

1. 点击左侧数据写入菜单，在该界面中，再次点击创建新的代理。

1. 根据实际环境选择适配的代理软件版本进行下载。以官网提供的 Linux 版本为例，本文下载的是 x86 架构的代理程序。下载并安装完成后，通过命令 taosx-agent -V 验证安装是否成功，然后点击“下一步”继续操作。

1. 在该界面输入代理名称，系统将为它生成一个连接令牌。

1. 在已安装代理程序的服务器上，进入 /etc/taos 目录，找到 agent.toml 文件，将系统生成的端点地址和令牌复制到该文件中进行配置。

endpoint="https://39.97.158.21"token="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOjEzNywiaWF0IjoxNzI2MTk2NDY3fQ.YmxGvRzlXdOgpXEKiUv-x68TFRzkYhXIRcJgRiWY0xk"

1. 启动代理服务并查看服务器的状态。

添加数据源

1. 在数据写入的页面中，点击添加数据源。

1. 在数据源配置界面中，选择数据源类型为 PostgreSQL，代理选择之前创建的代理，目标数据库选择已创建的 demo 数据库（本文直接使用此前创建的数据库）。如果需要，也可参考下一步自行创建新数据库。

1. 创建 demo 数据库。

1. 填写 PostgreSQL 数据库 IP、端口、数据库名、用户名、密码等信息。

1. 检查连通性，如果界面提示“您的数据源可以连通”，就表示配置没什么问题。

1. 配置采集数据的 SQL，在 SQL 中必须包括开始时间与结束时间。

1. 点击从服务器检索，观察是否可以成功获取到数据。如果报错，则根据报错提示，修改 SQL 配置。

1. 点击创建超级表，会自动关联刚才识别到的字段信息，根据需要修改字段类型、填写表名称，最后点击确定按钮。

1. 点击确认按钮后，超级表就创建成功了。接下来，我们需要在当前界面填写子表和 tag 列对应数据。

1. 点击新增按钮，数据源添加成功，并可在数据源列表中查看相关信息。

查看数据同步情况

点击刚刚接入数据源的“查看”按钮，即可查看同步信息，包括同步时长、写入速度以及已处理的行数等详细数据。

核对同步数据

点击数据浏览器，选择对应的数据并查看业务表，就可以看到同步的数据。

你也可以自行写 SQL 来核对已经同步的数据量。

结语

本次从 PostgreSQL 数据库迁移至 TDengine 的体验整体非常流畅。即使在迁移过程中遇到问题，也能够借助官方提供的支持快速定位并解决，充分展现了 TDengine 工具的便捷性和研发团队的高效响应能力。如果你也对 TDengine 的迁移工具感兴趣，不妨亲自尝试操作，体验其强大的功能。

TDengine 有话说

作为一款专注于时序数据的高效数据库，我们始终致力于简化用户的迁移过程。在 TDengine 3.3.0.0 和 3.3.2.0 版本中，我们进一步增强了数据接入功能，实现了传统关系型数据库向 TDengine 的平滑迁移。这两次重要更新成功打通了 MySQL、PostgreSQL、Oracle 和 SQL Server 到 TDengine 的迁移路径，大幅提升了迁移效率和用户体验。

不仅如此，TDengine 在数据接入方面还支持与多种数据源的无缝对接，包括 AVEVA Historian、OPC、Kafka、MQTT、InfluxDB 和 PI System 等，充分满足用户在多样化场景中的数据管理需求。

未来，我们将继续优化数据接入能力，为用户提供更加便捷、高效的工具，助力大家轻松应对数据管理的各种挑战。如果在迁移过程中遇到任何问题或有其他需求，欢迎添加小 T vx（tdengine）寻求帮助，我们的研发团队将第一时间为您提供支持。期待与您共同探索更多数据管理的可能性！