跳到主要内容
版本:0.15

数据导出和导入

数据导出和导入工具提供了备份和恢复 GreptimeDB 数据库的功能。这些工具可以处理表结构和数据,允许进行完整的备份或选择性的备份和恢复操作。

导出工具

命令语法

greptime cli data export [OPTIONS]

选项

选项是否必需默认值描述
--addr-要连接的 GreptimeDB 数据库地址
--output-dir-存储导出数据的目录
--database所有数据库要导出的数据库名称
--export-jobs, -j1并行导出任务数量(多个数据库可以并行导出)
--max-retry3每个任务的最大重试次数
--target, -tall导出目标(schema/data/all)
--start-time-数据导出的开始时间范围
--end-time-数据导出的结束时间范围
--auth-basic-使用 <username>:<password> 格式
--timeout0对 DB 进行一次调用的超时时间,默认为 0 代表永不超时(例如 30s, 10min 20s
--proxy-代理服务器地址,如设置该参数,将覆盖系统代理。如果未设置 --proxy--no-proxy,则默认使用系统代理
--no-proxy-禁用代理服务器,如设置该参数,将完全不使用代理
--s3-是否导出数据到 Amazon S3
--ddl-local-dir-当同时设置了 ddl_local_dir 和远程存储(如 S3/OSS)时,SQL 文件将导出至本地目录,而数据将导出到远程存储。注意:ddl_local_dir 只导出 SQL 文件至本地文件系统,适用于导出客户端无法直接访问远程存储的情况。如果未设置 ddl_local_dir,则 SQL 和数据都将导出至远程存储
--s3-bucket是*-当设置了 --s3 时,必须指定 S3 的 bucket 名称
--s3-root是*-当设置了 --s3 时,必须指定导出在 bucket 中的根路径
--s3-endpoint否*-当设置了 --s3 时,需指定 S3 的 endpoint
--s3-access-key是*-当设置了 --s3 时,需指定 S3 的 Access Key
--s3-secret-key是*-当设置了 --s3 时,需指定 S3 的 Secret Key
--s3-region是*-当设置了 --s3 时,需指定 S3 的区域(Region)
--oss-是否导出数据到阿里云 OSS
--oss-bucket是*-当设置了 --oss 时,需指定 OSS 的 bucket 名称
--oss-endpoint否*-当设置了 --oss 时,需指定 OSS 的 endpoint
--oss-access-key-id是*-当设置了 --oss 时,需指定 OSS 的 Access Key ID
--oss-access-key-secret是*-当设置了 --oss 时,需指定 OSS 的 Access Key Secret

导出目标

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

导入工具

命令语法

greptime cli data import [OPTIONS]

选项

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

导入目标

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