大对象工具

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

功能列表

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

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

选项

导出选项

名称	描述	默认值	是否必填
--hostname	协调节点（Coord）地址	localhost	否
--svcname	协调节点（Coord）服务名	11810	否
--usrname	用户名		否
--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	密码		否
--operation	操作类型		是，设置为 import
--file	本地文件全路径		是
--collection	需要导入的集合全名		是
--ignorefe	当前大对象如果已经存在于集合中，忽略这个错误并开始导入下一条记录	false	否
--ssl	使用 SSL 连接	false	否

Note:

当需要开启 --ignorefe 时只需要添加 --ignorefe 即可，不需要为其制定具体值。下同。

本地文件必须为导出生成的文件。

迁移选项

名称	描述	默认值	是否必填
--hostname	协调节点（Coord）地址	localhost	否
--svcname	协调节点（Coord）服务名	11810	否
--usrname	用户名		否
--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	集合不存在	- 检查集合相关参数是否填写正确 - 检查相关集合是否存在

示例

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

$ ./sdblobtool --operation export --hostname hostname1 --svcname 11810 --collection foo.bar --file /opt/mylob

将本地文件 mylob 中的大对象导入至集合 foo.bar 中，当遇到已存在的大对象时直接跳过。

$ ./sdblobtool --operation import --hostname hostname1 --svcname 11810 --collection foo.bar --file /opt/mylob --ignorefe

将集合中的大对象复制到另一个集合中。

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

收起

建议反馈

本页导航