文档

关于 SequoiaDB

快速入门

快速入门之一键清理

安装

基本操作

数据模型

SQL引擎

FileSystem引擎

S3引擎

系统架构

数据库管理

数据库服务

数据库配置

特殊配置项修改

引擎调度工具

数据库工具

集群启停

集群扩容

备份恢复

日志归档重放

监控

安全

查询访问计划

统计信息

连接器

驱动

参考手册

故障排除

SAC 管控中心

Web服务

版本信息

大对象工具

sdblobtool 是一款用于管理 SequoiaDB 集合大对象的工具。

功能列表

设置 sdblobtool 的 --operation 选项可以使用不同功能:

设置 功能 描述
export 导出 将集合中的大对象导出至本地文件
import 导入 将本地文件中的大对象导入至集合
migration 迁移 将一个集合中的大对象复制到另一个集合中

选项

导出选项

名称 描述 默认值 是否必填
--hostname 协调节点(Coord) 地址 localhost
--svcname 协调节点(Coord) 服务名 11810
--usrname 用户名
--passwd 密码,指定值则使用明文输入,不指定值则命令行提示输入
--cipher 使用加密文件输入密码 false
--token 加密口令
--cipherfile 加密文件 ./passwd
--operation 操作类型 是,设置为 export
--file 本地文件全路径
--collection 需要导出的集合全名
--prefer 优先选择的实例 M
--ssl 使用 SSL 连接 false

Note:

  • --prefer 的取值 m 或 M 指 master,s 或 S 表示 slave,a 或 A 表示 anyone,1 - 7 表示 node1 - node7,默认值为 M。

导入选项

名称 描述 默认值 是否必填
--hostname 协调节点(Coord) 地址 localhost
--svcname 协调节点(Coord) 服务名 11810
--usrname 用户名
--passwd 密码,指定值则使用明文输入,不指定值则命令行提示输入
--cipher 使用加密文件输入密码 false
--token 加密口令
--cipherfile 加密文件 ./passwd
--operation 操作类型 是,设置为 import
--file 本地文件全路径
--collection 需要导入的集合全名
--ignorefe 当前大对象如果已经存在于集合中,忽略这个错误并开始导入下一条记录 false
--ssl 使用 SSL 连接 false

Note:

  • 当需要开启 --ignorefe 时只需要添加 --ignorefe 即可,不需要为其制定具体值。下同。
  • 本地文件必须为导出生成的文件。

迁移选项

名称 描述 默认值 是否必填
--hostname 协调节点(Coord) 地址 localhost
--svcname 协调节点(Coord) 服务名 11810
--usrname 用户名
--passwd 密码,指定值则使用明文输入,不指定值则命令行提示输入
--cipher 使用加密文件输入密码 false
--token 加密口令
--cipherfile 加密文件 ./passwd
--operation 操作类型 是,设置为 migration
--file 本地文件全路径
--collection 需要导出的集合全名
--dsthost 目标协调节点(Coord) 地址 localhost
--dstservice 目标协调节点(Coord) 服务名 11810
--dstusrname 目标用户名
--dstpasswd 目标密码
--dstcollection 需要导入的目标集合全名
--ignorefe 当前大对象如果已经存在于集合中,忽略这个错误并开始导入下一条记录 false
--ssl 使用 SSL 连接 false

日志

使用 sdblobtool 时会在用户的当前运行目录产生日志文件“sdblobtool.log”,当发生错误时可以在日志中查看详细信息。

常见错误

错误码(rc) 描述 应对措施
-5 本地文件已存在或者集合中存在相同 OID 的大对象 - 如果是导出操作,检查本地文件是否已经存在
- 如果是导入或者迁移操作,检查目标集合中是否已存在相同 OID 的大对象
-6 参数不合法 检查参数是否输入错误
-10 系统错误 需要根据日志进行错误排查
-15 无法连接到指定地址 - 检查地址相关参数是否填写正确
- 检查数据库是否正常启动
- 如果使用主机名作为参数,检查本地主机名列表是否配置正确
- 检查防火墙是否开启
-23 集合不存在 - 检查集合相关参数是否填写正确
- 检查相关集合是否存在

示例

  1. 将集合 foo.bar 中的大对象导出至本地文件 mylob 中。

    $ ./sdblobtool --operation export --hostname hostname1 --svcname 11810 --collection foo.bar --file /opt/mylob
  2. 将本地文件 mylob 中的大对象导入至集合 foo.bar 中,当遇到已存在的大对象时直接跳过。

    $ ./sdblobtool --operation import --hostname hostname1 --svcname 11810 --collection foo.bar --file /opt/mylob --ignorefe
  3. 将集合中的大对象复制到另一个集合中。

    $ ./sdblobtool --operation migration --hostname hostname1 --svcname 11810 --collection foo.bar --dsthost hostname2 --dstservice 11810 --dstcollection foo.bar
回到顶部