跳到主要内容
版本：nightly

GreptimeDB 导出和导入工具

本指南描述了如何使用 GreptimeDB 的导出和导入工具进行数据库备份和恢复。

导出和导入工具提供了备份和恢复 GreptimeDB 数据库的功能。这些工具可以处理 schema（表结构等）和数据，支持完整或选择性的备份和恢复操作。

导出工具​

命令语法​

greptime cli export [OPTIONS]

选项​

选项是否必需默认值描述
--addr是-要连接的 GreptimeDB 数据库地址
--output-dir是-存储导出数据的目录
--database否所有数据库要导出的数据库名称
--export-jobs, -j否1并行导出任务数量（多个数据库可以并行导出）
--max-retry否3每个任务的最大重试次数
--target, -t否all导出目标（schema/data/all）
--start-time否-数据导出的开始时间范围
--end-time否-数据导出的结束时间范围
--auth-basic否-使用 <username>:<password> 格式
--timeout否0对 DB 进行一次调用的超时时间，默认为 0 代表永不超时 （例如 30s, 10min 20s）

导出目标​

  • schema: 仅导出表结构（SHOW CREATE TABLE）
  • data: 仅导出表数据（COPY DATABASE TO）
  • all: 导出表结构和数据（默认）

输出目录结构​

<output-dir>/
└── greptime/
    └── <database>/
        ├── create_database.sql
        ├── create_tables.sql
        ├── copy_from.sql
        └── <数据文件>

导入工具​

命令语法​

greptime cli import [OPTIONS]

选项​

选项是否必需默认值描述
--addr是-要连接的 GreptimeDB 数据库地址
--input-dir是-包含备份数据的目录
--database否所有数据库要导入的数据库名称
--import-jobs, -j否1并行导入任务数量（多个数据库可以并行导入）
--max-retry否3每个任务的最大重试次数
--target, -t否all导入目标（schema/data/all）
--auth-basic否-使用 <username>:<password> 格式

导入目标​

  • schema: 仅导入表结构
  • data: 仅导入表数据
  • all: 导入表结构和数据（默认）

常见使用场景​

完整数据库备份​

# 导出所有数据库备份
greptime cli export --addr localhost:4000 --output-dir /tmp/backup/greptimedb

# 导入所有数据库
greptime cli import --addr localhost:4000 --input-dir /tmp/backup/greptimedb

仅表结构操作​

# 仅导出表结构
greptime cli export --addr localhost:4000 --output-dir /tmp/backup/schemas --target schema

# 仅导入表结构
greptime cli import --addr localhost:4000 --input-dir /tmp/backup/schemas --target schema

基于时间范围的备份​

# 导出特定时间范围内的数据
greptime cli export --addr localhost:4000 \
    --output-dir /tmp/backup/timerange \
    --start-time "2024-01-01 00:00:00" \
    --end-time "2024-01-31 23:59:59"

指定数据库备份​

# 导出指定数据库
greptime cli export --addr localhost:4000 --output-dir /tmp/backup/greptimedb --database '{my_database_name}'

# 导入工具也同样适用
greptime cli import --addr localhost:4000 --input-dir /tmp/backup/greptimedb --database '{my_database_name}'

最佳实践​

  1. 并行度配置

    • 根据可用系统资源调整 --export-jobs/--import-jobs
    • 从较低的值开始，逐步增加
    • 在操作期间监控系统性能

  2. 备份策略

    • 使用时间范围进行增量数据备份
    • 定期备份用于灾难恢复

  3. 错误处理

    • 使用 --max-retry 处理临时异常
    • 保留日志以便故障排除

故障排除​

常见问题​

  1. 连接错误

    • 验证服务器地址和端口
    • 检查网络连接
    • 确保身份验证凭据正确

  2. 权限问题

    • 验证输出/输入目录的读写权限

  3. 资源限制

    • 减少并行任务数
    • 确保足够的磁盘空间
    • 在操作期间监控系统资源

性能提示​

  1. 导出性能

    • 对大型数据集使用时间范围
    • 根据 CPU/内存调整并行任务数量
    • 考虑网络带宽限制

  2. 导入性能

    • 注意监控数据库资源

  3. 导出性能

    • 对大型数据集使用时间范围
    • 根据 CPU/内存调整并行任务
    • 考虑网络带宽限制

  4. 导入性能

    • 监控数据库资源