跳到主要内容
版本：1.2

GreptimeDB 导出和导入工具

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

如需使用基于快照、支持断点续传的 Export/Import V2 工作流，请参阅使用 Export/Import V2 导出和导入数据。

有关详细的命令行选项和高级配置，请参阅 数据导出和导入。

导出操作​

完整数据库备份​

将每个数据库分别导出到各自的目录中，包括所有表及其数据。

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

输出目录结构：

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

导出到 S3​

导出所有数据库备份到 S3:

greptime cli data export \
    --addr localhost:4000 \
    --s3 \
    --s3-bucket <YOUR_S3_BUCKET> \
    --s3-access-key-id <YOUR_S3_ACCESS_KEY_ID> \
    --s3-secret-access-key <YOUR_S3_SECRET_ACCESS_KEY> \
    --s3-region <YOUR_S3_REGION> \
    --s3-root <YOUR_S3_ROOT> \
    --s3-endpoint <YOUR_S3_ENDPOINT>

使用 Basic Authentication 导出​

如果 GreptimeDB 实例启用了身份认证，请使用 --auth-basic 传入凭据：

greptime cli data export \
    --addr localhost:4000 \
    --output-dir /tmp/backup/greptimedb \
    --auth-basic <username>:<password>

仅导出表结构​

仅导出表结构而不包含数据。此操作将 CREATE TABLE 语句导出到 SQL 文件中，允许您备份表结构而不包含实际数据。

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

基于时间范围备份​

# 导出指定时间范围内的数据
greptime cli data 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 data export \
    --addr localhost:4000 \
    --output-dir /tmp/backup/greptimedb \
    --database '{my_database_name}'

导入操作​

完整数据库导入​

从 greptime cli data export 生成的备份目录导入所有数据库。

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

使用 Basic Authentication 导入​

如果 GreptimeDB 实例启用了身份认证，请使用 --auth-basic 传入凭据：

greptime cli data import \
    --addr localhost:4000 \
    --input-dir /tmp/backup/greptimedb \
    --auth-basic <username>:<password>

仅导入表结构​

仅导入表结构而不包含数据。此操作将 CREATE TABLE 语句从 SQL 文件中导入，允许您恢复表结构而不包含实际数据。

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

指定数据库导入​

# 导入指定数据库
greptime cli data import \
    --addr localhost:4000 \
    --input-dir /tmp/backup/greptimedb \
    --database '{my_database_name}'

最佳实践​

  1. 并行度配置

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

  2. 备份策略

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

  3. 错误处理

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

性能提示​

  1. 导出性能

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

  2. 导入性能

    • 注意监控数据库资源

  3. 导出性能

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

  4. 导入性能

    • 监控数据库资源

故障排除​

常见问题​

  1. 连接错误

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

  2. 权限问题

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

  3. 资源限制

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