Lightdb 22.4 ltuldr工具使用介绍（兼容sqluldr2)

背景

lightdb支持数据备份的方式比较多，常见的方式为逻辑备份和物理备份。
物理备份：
冷备份及恢复(文件级别的复制恢复)：
热备份及恢复(基于时间点的备份恢复)
逻辑备份：
pg_dump:可以选择一个数据库或部分表备份
pg_dumpall:备份整个 cluster
copy \copy:导入导出数据
ltuldr跟copy功能类似，也属于逻辑备份。区别在于ltuldr是相当于客户端是外部工具，而copy属于ltsql内部命令行工具。性能方面：是oracle sqluldr2的1.3倍。

使用

ltuldr --help

连接参数

连接参数包括user、dbname、host、port、password。
user:指定数据库用户名；
dbname：指定数据库名；
host:指定数据库主机名；
port:指定数据库端口名；
password:指定数据库密码。

sql 和 query

两个参数皆可用于指定导出表的相关信息，但两者不可同时和连接信息一起使用。两者一起使用时会报错。
其中query可以直接指定表名，也可以使用sql语句。sql指定的文件中只能是sql 语句。sql语句最大长度为32767.

field 和 record

field：指定字段间的分隔符；
record:指定行之间的分隔符。
字段分隔符虽然通常是一个字符，但实际上不一定是只有一个字符，可以用多个字符；并且也不是只能使用可见的或可以打印的字符或字符串来作分隔符，不可见的字符也可以。有些字符虽然是可见或可以打印的，但在操作系统中有特殊的用处，如管道符（ |）或与符号（ &）， 想用它们来作分隔符时，直接传入字符当参数时，命令行就要特定处理，在这些字符前面加转义字符。为了可以使用不可见的字符及方便命令行参数传入，在指定分隔符时，可以用字符的 ASCII 代码（ 0xXX，大写的 XX 为 16 进制的 ASCII 码值）来指定一个字符，常用的字符的 ASCII 代码如下：

file 、 log和batch

file:指定读出数据存储的文件；
log:指定日志存储的文件。包括：（1）每50万条记录输出一个记录;(2)错误信息的输出;
batch:指定每个文件导出的批数，一批数据大小是500000.
file 选项指定导出的文件名，如果文件面的第一个字符为加号（ +）， 则表示在现有的文件后面添加，否则会生成新文件，如果已经有同名文件则覆盖现有文件，如果没有指定“ FILE”选项则默认为小写的“ uldrdata.txt”，存放路径为运行ltuldr的当前目录 。
“ FILE”选项中还有几个很特别的格式码，可以用来指定动态文件名（使生成的文件名中带日期信息），合理使用这些格式码，可以满足一些特定的需求，减少脚本编写的工作量。

log文件不支持%B、%b命名。

head

head:指定文件中是否需要添加导出表的字段。

应用

./ltuldr user=lightdb dbname=lt_test password=1 host=192.168.105.153 port=5432 query=test file=test.txt log=%Y_%M_%D.log head=yes batch=2