工具介绍
Batch Tool工具是PolarDB-X团队开发的专为PolarDB-X数据库提供数据导入导出服务的工具。
Batch Tool工具采用JAVA语句实现，核心是生产者消费者模型，支持多线程操作，提供批量导出、批量导入、批量删除、批量更新等功能。数据以csv文件格式传输，方便用户进行数据交互。
Batch Tool工具的命令用法和参数如下：
usage: BatchTool [-?] [-batchsize ] [-con ] [-cs ] -D [-dir ] [-f ] [-F ] [-func] -h [-header] [-i] [-in] [-L ] [-lastSep] [-lb] [-local] [-maxConn ] [-minConn ] [-noesc] [-np] [-O ] -o [-OC column>] -p [-P ] [-para] [-pre ] [-pro ] [-quote ] [-readsize ] [-rfonly] [-ringsize ] -s [-t] -?,--help Help message. -batchsize,--batchSize Batch size of emitted tuples. -con,--consumer Configure number of consumer threads. -cs,--charset Define charset of files. -D,--database Database to use. -dir,--dir Directory path including files to import. -f,--from Source file(s), separated by ; . -F,--filenum Fixed number of exported files. -func,--sqlfunc Use sql function to update. -h,--host Connect to host. -header,--header Whether the header line is column names. -H,--historyFile history file name for resuming from breakpoint -i,--ignoreandresume Flag of insert ignore & resume from breakpoint -in,--wherein Using where ... in (...) -L,--line Max line limit of exported files. -lastSep,--withLastSep Whether line ends with separator. -lb,--loadbalance If using load balance. -local,--localmerge o local merge sort. -maxConn,--maxConnection Max connection number limit. -minConn,--minConnection Mim connection number limit. -noesc,--noescape Don't escape values. -np,--noparttion No use of parttion. -O,--orderby asc or desc. -o,--operation Batch operation type: export / import / delete / update. -OC,--orderCol col1;col2;col3. -p,--password Password to use when connecting to server. -P,--port Port number to use for connection. -para,--paraMerge Using parallel merge when doing order by export. -pre,--prefix Export file name prefix. -pro,--producer Configure number of producer threads. -quote,--quoteMode The mode of how field values are enclosed by double-quotes when exporting table. Default value is auto. -readsize,--readSize Read block size in MB. -rfonly,--rfonly Only read and process file, no sql execution. -ringsize,--ringBufferSize Ring buffer size. -s,--sep Separator between fields (delimiter). -t,--table -tps,--tpsLimit Tps limit -u,--user User for login. -w,--where Where condition: col1>99 AND col2<100 ...
参数说明
常用参数说明如下：
- -o：批处理操作，包括export、import、delete、update四个选项。
- -t：指定目标表名，只能为单个表。
- -s：指定分隔符，可以为字符或字符串。
- -f：指定源文件，多个文件名之间使用分号“;”分隔。
- -OC：指定导出时排序使用的列名，多个列之间使用分号“;”分隔。
- -cs：指定文本文件的字符集，默认为utf-8。
- -lastSep：文件每行是否以分隔符结尾。
- -quote：指定导出或导入时引号包围模式，包括以下三个可选值：
-
- auto：默认模式，将根据字段值是否包含特殊字符（如分隔符、换行符等）来添加双引号；
- force：强制每个字段值都添加双引号；
- none：强制不添加双引号（适用于已知表字段类型都是数值型、或字符串型字段中不包含特殊字符的情况）。
- -header：首行是否为字段名。
- -i：是否开启insert ignore与断点续传。
- -pre：指定导出文件名的前缀。
- -F：指定导出文件数量。
工具获取
Batch Tool工具的jar包，单击下载：target="_blank" rel="noopener noreferrer">Batch_tool工具。
使用示例
以编译生成的batch-tool.jar为例，查看参数说明：
java -jar batch-tool.jar -?
- 批量导出数据
## 1.默认导出（文件数等于表的分片数）
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o export -t table_name -s ,## 2.导出文件数=3 （-F:指定文件数）
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o export -t table_name -s , -F 3
## 3.指定单个文件最大行数=10000 (-L:指定单文件行数)
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o export -t table_name -s , -L 10000
## 4.带where条件 若条件带有空格，需要使用引号 (-w:where条件语句)
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o export -t table_name -s , -w "id < 150 and id > 120"
- 批量导入数据（需手动创建目标表，Batch Tool只包含数据传输）
## 1.多个文件用分号 (;) 分隔
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o import -t table_name -s , -f "table_name_0;table_name_1;table_name_2;table_name_3"
## 2.默认根据拆分键进行sharding插入, 如不采用，打开-np开关即可
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o import -t table_name -s , -f "file0;file2" -np
## 3.指定生产者、消费者线程（-pro:生产者线程，读取文件线程; -con:消费者线程，导入数据线程）
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o import -t table_name -s , -f "table_name_0;table_name_1" -np -pro 16 -con 16
## 4.打开insert ignore和断点续传
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o import -t table_name -s , -f "table_name_0;table_name_1" -i
- 批量删除数据（删除数据库中包含文件中的数据，原理：构建DELETE语句，根据表结构填充文件中的数据）
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o delete -t table_name -s , -f "file0"
- 批量更新数据（更新数据库中包含文件中的数据，原理：构建UPDTATE语句，根据表结构填充文件中的数据）
java -jar batch-tool.jar -h 127.0.0.1 -u testUser -p testPasswd -P 3306 -D db_name -o update -t table_name -s ,
