TDengine TSDB（数据备份与恢复）

一、描述

针对TDengine的数据导入导出，日常最常用的方式是使用CSV文件和官方备份工具taosdump。你可以根据需求选择。

二、核心方法操作

1. 使用taosdump(备份与迁移)

这是最专业的迁移工具（注3.3.8版本自带），建议用于重要数据的备份和恢复。

• 备份数据 (导出)：

  # 备份指定数据库到指定目录
  taosdump -h <服务器地址> -D <数据库名> -o <备份输出目录路径>
  # 备份指定数据库到指定目录（举例~如下是具体参数~参考）
  taosdump -h 127.0.0.1 -u root -D mydb -o C:/backups
  
  # 备份全部数据库
  taosdump -h <服务器地址> -A -o <备份输出目录路径>
  # 备份某数据库中指定的表
  taosdump -h <服务器地址> <数据库名> <表名1> <表名2> -o <备份输出目录路径>
  # 备份某个时间段的数据
  taosdump -h <服务器地址> -D <数据库名> -S "2026-01-21 00:00:00" -E "2026-12-31 23:59:59" -o <备份输出目录路径>

• 备份数据 (导出注意事项和报错)：

 第一点：taosdump 是一个需要在操作系统的命令行终端中运行的工具，而不是在 TDengine 的 SQL 窗口里执行的 SQL 命令。

别拿导出命令行去sql窗口去执行（ 如：taosdump -h <127.0.0.1> -u root -D <mydb> -o <C:\backups>   ）

第二点：以下步骤在 Windows 命令提示符 (CMD) 或 PowerShell 中执行备份

第三点：命令行环境对比：别跑错地方了

环境	是什么？	用来做什么？	能执行 taosdump 吗？
PowerShell / CMD	操作系统的命令行外壳	执行系统命令、运行程序、管理文件、编写脚本。	✅ 可以！这是正确的地方。
TDengine SQL 客户端 (taos)	数据库的专用客户端	连接数据库服务，执行 SQL 语句，如 SELECT, CREATE。	❌ 不可以！这里只能识别 SQL 语法。

第四点：直接进入 taosdump 所在目录执行（推荐，最直接）这是最快的方法，不需要修改系统设置配置path环境变量。

1. 找到 taosdump.exe 的位置。

   • 它通常位于你的 TDengine 安装目录下的目录里。例如，常见的默认路径是（不不同版本存在差异）：

     • C:\TDengine\

     • C:\TDengine\tools\或者 C:\Program Files\TDengine\tools\

   • 你可以打开文件资源管理器，进入上述路径确认 taosdump.exe 文件是否存在。

2. 在 CMD/PowerShell 中切换到该目录。

   • 假设你的 taosdump.exe 在 C:\TDengine\。

   • 在当前的 CMD 窗口中，输入以下命令并按回车：

     cd C:\TDengine

   • 命令提示符会变成 C:\TDengine>，表示你已进入该目录。

3. 在当前目录下执行备份命令。

   • 现在，你只需要直接输入 taosdump 的命令即可，因为系统会在当前目录下寻找可执行文件。

     taosdump -h 127.0.0.1 -u root -D mydb -o C:/backups

• ⚠️ 恢复前的关键注意事项与参数

• 恢复数据 (导入)：

  # 从指定目录恢复备份数据
  taosdump -h <目标服务器地址> -i <备份文件所在目录路径>
  # 具体执行参数如下
  taosdump -h 127.0.0.1 -u root -i C:/backups

  重要提示：taosdump默认不覆盖已有数据目录。如果导出中断，需要删除已生成的文件重来。恢复时若出现“表已存在”的提示可忽略。

 2. 使用CSV文件 (通用交换)

这是最灵活、与外部系统交互最方便的方式。

• 导出数据到CSV：
  在 taos shell 中执行：

  SELECT * FROM <数据库名>.<表名> >> '/路径/导出文件.csv';

• 从CSV导入数据：
  确保CSV文件列的顺序和数据类型与目标表严格一致，且不含表头。在 taos shell 中执行：

  INSERT INTO <数据库名>.<表名> FILE '/路径/数据文件.csv';

 3. 关键注意事项与建议

• 版本兼容：不同版本的taosdump可能存在差异，建议在相同版本间进行备份恢复。

• 大文件操作：处理超大CSV或使用taosdump恢复时，可调整 -B 参数（默认16384）来优化性能，避免内存或WAL错误。

• 字符编码：处理包含中文等非ASCII字符的CSV时，请使用 UTF-8编码（无BOM）。

• 操作原则：在生产环境执行重要操作前，务必在测试环境验证。

 3. 完整操作流程与建议

为确保恢复顺利进行，请遵循以下步骤：

1. 前置检查：

   • 确认服务运行：确保目标 taosd 服务正在运行。

   • 备份文件检查：确认 C:/backups 目录下存在有效的备份文件（应有 .avro 等数据文件）。

   • 数据库存在性：如果备份文件包含数据库架构（默认包含），且你未使用 -D 重命名，请确保目标服务器上不存在同名数据库，或你已决定使用 -R 参数覆盖。

2. 执行恢复：

   • 打开 CMD/PowerShell，进入 taosdump 所在目录（例如 cd C:\TDengine）。

   • 输入完整的恢复命令，例如：

     taosdump -h 127.0.0.1 -u root -i C:/backups

   • 输入密码后等待完成，观察输出信息是否有错误。

3. 恢复后验证：

   • 使用 TDengine 客户端连接数据库：taos -h 127.0.0.1

   • 执行 SHOW DATABASES; 查看数据库是否已恢复。

   • 切换到该数据库：USE mydb; （或你恢复后的库名）

   • 执行 SELECT COUNT(*) FROM your_table; 查询主要表的行数，与备份前对比，确保数据量基本一致。

 重要提醒：

• 版本兼容：尽量在相同版本的 TDengine 之间进行恢复，跨大版本恢复务必在测试环境验证可行性。

• -R 参数风险：-R 会先删除目标库中的同名表，属于高危操作。生产环境中使用前，必须确认当前数据已无用或另有备份。

• 权限问题：恢复操作需要相应的数据库权限。以 root 用户操作通常没有大问题。

• 空间充足：确保目标服务器的磁盘空间足够容纳恢复的数据。

三、taosd启动异常处理