数据导出工具
- JSON
- CSV
- 分隔符
- 选项
  - 通用选项
  - 单集合选项
  - 多集合选项
  - JSON 选项
  - CSV 选项
  - 配置文件选项
- 返回值
- 示例

数据导出工具

sdbexprt 是一个实用的工具。它可以将集合从 SequoiaDB 数据库导出到 JSON 格式或者 CSV 格式的数据存储文件。sdbexprt 支持将一个集合导出到一个文件中，同时也支持将多个集合批量导出到指定目录下。

JSON

JSON 导出格式中的 JSON 记录符合 JSON 的定义，以左右花括号作为 JSON 记录的分界符，并且字符串类型的数据必须包含在两个双引号之间，转义字符为反斜杠“\”。默认情况下（SequoiaDB的）记录以换行符分隔。用户能够指定记录分隔符。

CSV

CSV（Comma Separated Value）导出格式以逗号分隔数值。默认情况下记录以换行符分隔，字段以逗号分隔。用户能够指定字符串分隔符、字段分隔符以及记录分隔符。

分隔符

类型	默认值
字符串分隔符	"（双引号）
字段分隔符	,（逗号）
记录分隔符	'\n'（换行符）

Note:
分隔符可以使用 ASCII 码中的不可见字符，通过转义字符“\”输入 ASCII 码的十进制数值（0 ~ 127），例如“\30”。回车符、换行符、制表符、转义字符“\”可以直接使用“\r”，“\n”，“\t”，“\”。
可以使用 UTF-8 字符作为分隔符。
可以使用多个字符作为分隔符。

选项

通用选项

选项	缩写	说明
—help	-h	显示帮助信息
—version		显示版本信息
—hostname	-s	主机名，默认为 localhost
—svcname	-p	端口号，默认为 11810
—user	-u	数据库用户名
—password	-w	数据库密码，指定值则使用明文输入，不指定值则命令行提示输入
—cipher		是否使用加密文件输入密码，默认为 false
—token		加密口令
—cipherfile		加密文件，默认为 ./passwd
—delrecord	-r	记录分隔符。默认是'\n'
—type		导出数据格式，为 csv 或 json，默认为 csv
—filelimit		指定单个导出文件的大小上限，单位可以为 k、K、M、m、G、g、T 或 t，默认值为 16G。当导出文件将超过限制时，会切分为多个文件，具有编号后缀，如 file.csv，file.csv.1，file.csv.2
—fields		导出集合的字段。该选项可以指定多次以指定多个导出集合的字段。格式为 `[csName.clName:][field1[,…]]` ，当确定只导出一个集合时，可以仅指定字段列表 `[field1[,…]]`
—withid		强制导出或者在配置文件中生成字段时，是否包含 _id 字段，默认为false
—floatfmt		指定浮点数格式，默认是 '%.16g'，输入 'db2' 表示 '%+.14E'，其他格式 %[+].precision
—ssl		使用 SSL 连接，默认 false
—replace		覆盖导出数据文件

单集合选项

选项	缩写	说明
—csname	-c	导出数据的集合空间名
—clname	-l	导出数据的集合名
—file		导出的文件名
—select		选择规则，例如：`—select '{ age:"", address:{$trim:1} }'`不能和选项 —fields 同时使用
—filter		导出过滤条件，例如：—filter '{ age: 18 }'
—sort		导出数据排序条件，例如：`—sort '{ name: 1 }'`
—skip		指定从第几条记录开始导出，默认是 0
—limit		指定导出的记录数，默认是 -1 （导出所有记录）

多集合选项

选项	缩写	说明
—cscl		导出的若干个导出集合或集合空间，多个名称使用逗号分隔，如 `—cscl cs1,cs2.cla`
—excludecscl		不包含的集合或集合空间，类似 —cscl
—dir		导出的目录。导出的每一个集合对应目录中的同名文件，如 foo.bar.csv

JSON 选项

选项	缩写	说明
—strict		是否严格按照数据类型导出，默认值为 false

CSV 选项

选项	缩写	说明
—delchar	-a	字符分隔符，默认值为双引号'"'
—delfield	-e	字段分隔符，默认值为逗号','
—included		是否导出字段名到文件首行，默认值为 true
—includebinary		是否导出完整二进制数据，默认值为 false
—includeregex		是否导出完整的正则表达式，默认值为 false
—force		对于导出 csv 格式，每个集合必须指定对应的字段，否则不允许导出；—force 选项可以强制导出，未指定字段的集合默认为第一行记录中除了 _id 以外的字段
—kicknull		是否踢掉 null 值，true 输出空字符，false 输出 null，默认为 false
—checkdelimeter		是否严格校验分隔符，默认为 true。true：禁止字符分隔符、字段分隔符、记录分隔符互相包含；false：允许字符分隔符、字段分隔符、记录分隔符互相包含。

配置文件选项

选项	缩写	说明
—genconf		指定一个配置文件名，将当前命令行中所指定的选项和值按照“键=值”的方式写入到配置文件，不执行导出工作
—genfields		生成配置文件时，是否对每一个集合生成对应的 —fields 选项，默认值为 true
—conf		指定一个配置文件作为输入，如果命令中和配置文件中存在相同的选项，优先选择命令行中的值

Note:
导出工具支持单集合导出和多集合批量导出， 单集合选项 只能用于导出一个集合，但具有更灵活的导出条件选项，如过滤、排序。
导出多集合到 csv 格式时，必须使用 —fields 选项对每一个集合指定字段，工具提供的 —genconf 选项将每一个集合的第一行记录的字段导出到配置文件中的 —fields 选项，可以比较方便地编辑每一个集合的字段。
—genconf 选项将当前命令行的选项写入到配置文件中，下次使用 —conf 选项指定配置文件执行即可，这提供一种多次执行相似命令的便捷方式，另外这种方式主要用于在多集合导出 csv 情况下，对每一个集合生成对应的 —fields 选项。
导出单集合时，—select 具有和 —fields 选项一样的作用，但 —select 选项更加灵活。
当不指定导出任何集合或者集合空间，即 -c、-l、—cscl 都不指定，则导出数据库中所有的集合。
当使用配置文件的选项和命令行选项一样时，优先选择命令行值。

返回值

0: 执行成功
非0: 执行失败

示例

导出集合“foo.bar”，导出格式为 csv，导出文件为“foo.bar.csv”，指定字段“field1”、“fieldNotExist”、“field3”，其中字段“fieldNotExist”在集合中不存在

$ sdbexprt -s localhost -p 11810 --type csv --file foo.bar.csv --fields field1,fieldNotExist,field3 -c foo -l bar

导出的foo.bar.csv的内容可能如下：

field1, fieldNotExist, field3
"Jack",,"China"
"Mike",,"USA"

导出数据库中所有的集合，排除集合空间“cs1”和集合“cs2.cla”以外，导出文件到目录“exportpath”下

$ sdbexprt --type json --dir exportpath --excludecscl cs1,cs2.cla

导出一个集合空间中所有的集合和另外一个集合，排除一个集合，导出 csv 格式，由于必须指定每一个集合的 —fields，使用 —force 选项强制导出

$ sdbexprt --dir exportpath --cscl cs1.cla,cs2 --excludecscl cs2.cla --force true

同上例，生成配置文件模板，其中配置文件中包含每一个所对应的 —fields 选项；根据需求修改配置文件之后，再执行导出

生成配置文件：

$ sdbexprt --dir exportpath --cscl cs1.cla,cs2 --excludecscl cs2.cla --genconf export.conf

配置文件文件内容可能如下：

hostname = localhost
...
dir = exportpath/
cscl = cs1.cla,cs2
excludecscl = cs2.cla
fields = cs1.cla: a1, a2, a3
fields = cs2.clb: b1, b2, b3
fields = cs2.clc: c1, c2
fields = cs2.cld: d1, d2, d3, d4

执行导出：

$ sdbexprt --conf export.conf