TDengine產品提供一個數據庫(ku)數據的(de)導(dao)入導(dao)出DUMP工具，從而支持數據的(de)遷移。比如從某家公有云遷移到另外一家公有云。

DUMP工(gong)具導出(chu)數據(ju)時，以(yi)sql語句的(de)(de)形式導出(chu)內(nei)容，包(bao)括數據(ju)庫、超級表(biao)、普通表(biao)，以(yi)及(ji)表(biao)中的(de)(de)記錄數據(ju)，然后(hou)保存(cun)到指定的(de)(de)輸(shu)出(chu)文件(jian)中。

DUMP工具導入(ru)數據(ju)時(shi)，將導出的(de)文件(jian)作為輸入(ru)，順序(xu)讀入(ru)并執行文件(jian)中的(de)sql語句，完(wan)成(cheng)數據(ju)的(de)導入(ru)。

（工具的參數內容(rong)有可能因版本更新(xin)而改變，請以 help 實(shi)際輸出(chu)的聯機幫(bang)助(zhu)信息為(wei)準。）

DUMP命令幫助信息

root@taos-ec1:/dump# ./taosdump --help
Usage: taosdump [OPTION...] dbname [tbname ...]
  or:  taosdump [OPTION...] --databases dbname ...
  or:  taosdump [OPTION...] --all-databases
  or:  taosdump [OPTION...] -i inpath
  or:  taosdump [OPTION...] -o outpath

  -h, --host=HOST            Server host dumping data from. Default is
                             localhost.
  -p, --password=PASSWORD    User password to connect to server. Default is
                             taosdata.
  -P, --port=PORT            Port to connect
  -q, --mysqlFlag=MYSQLFLAG  mysqlFlag, Default is 0
  -u, --user=USER            User name used to connect to server. Default is
                             root.
  -v, --cversion=CVERION     client version
  -c, --config=CONFIG_DIR    Configure directory. Default is
                             /etc/taos/taos.cfg.
  -e, --encode=ENCODE        Input file encoding.
  -g, --debug                Print debug info.
  -i, --inpath=INPATH        Input file path.
  -o, --outpath=OUTPATH      Output file path.
  -r, --resultFile=RESULTFILE   DumpOut/In Result file path and name.
      --verbose              Print verbose debug info.
  -A, --all-databases        Dump all databases.
  -D, --databases            Dump assigned databases
  -a, --allow-sys            Allow to dump sys database
  -B, --data-batch=DATA_BATCH   Number of data point per insert statement.
                             Default is 1.
  -E, --end-time=END_TIME    End time to dump. Either Epoch or ISO8601/RFC3339
                             format is acceptable. Epoch precision millisecond.
                             ISO8601 format example:
                             2017-10-01T18:00:00.000+0800 or
                             2017-10-0100:00:00.000+0800 or '2017-10-01
                             00:00:00.000+0800'
  -L, --max-sql-len=SQL_LEN  Max length of one sql. Default is 65480.
  -N, --without-property     Dump schema without properties.
  -s, --schemaonly           Only dump schema.
  -S, --start-time=START_TIME   Start time to dump. Either Epoch or
                             ISO8601/RFC3339 format is acceptable. Epoch
                             precision millisecond. ISO8601 format example:
                             2017-10-01T18:00:00.000+0800 or
                             2017-10-0100:00:00.000+0800 or '2017-10-01
                             00:00:00.000+0800'
  -t, --table-batch=TABLE_BATCH   Number of table dumpout into one output file.
                             Default is 1.
  -T, --thread_num=THREAD_NUM   Number of thread for dump in file. Default is
                             5.
  -?, --help                 Give this help list
      --usage                Give a short usage message
  -V, --version              Print program version

Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.

Report bugs to <support@yakult-sh.com.cn>.

導出命令說明

導(dao)出數據(ju)時，可以(yi)使(shi)用(yong)不同的(de)方(fang)式(shi)，比如導(dao)出所(suo)有數據(ju)庫的(de)數據(ju)；導(dao)出指定一(yi)(yi)個(ge)(ge)或(huo)多個(ge)(ge)數據(ju)庫的(de)數據(ju)；導(dao)出指定一(yi)(yi)個(ge)(ge)數據(ju)庫中指定一(yi)(yi)個(ge)(ge)或(huo)多個(ge)(ge)表的(de)數據(ju)；僅僅導(dao)出schema。同時，以(yi)上(shang)方(fang)式(shi)時，還(huan)可以(yi)指定數據(ju)的(de)時間(jian)范圍。下面分別舉(ju)例描述。

1、導出所有數據庫(ku)的數據

root@taos-ec1:/dump# ./taosdump -c /dump/cfg -o /dump/data-data0601-0701 -u jason -p abcd -A -S 1559318400000 -E 1561910400000 -t 500 -B 80 -T 8

-c ： 指(zhi)定配(pei)置(zhi)文件(jian)所(suo)在的路徑。因為dump會啟動taos客戶端，去(qu)鏈接taosd服務，所(suo)以需要做好配(pei)置(zhi)文件(jian)。

-o：指定(ding)輸(shu)出文(wen)件(jian)(jian)的(de)路徑。文(wen)件(jian)(jian)會自動(dong)生成，一個dbs.sql文(wen)件(jian)(jian)，導出數(shu)據庫、超級(ji)表；若干個XXX_tables.N.sql文(wen)件(jian)(jian)，文(wen)件(jian)(jian)名(ming)的(de)規則：XXX是數(shu)據庫名(ming)稱，N是數(shu)字(zi)，從(cong)0開始遞(di)增(zeng)。

-u：用戶名。

-p：密碼。

-A：指示導(dao)出所有(you)數據(ju)庫的(de)數據(ju)。

-S：指(zhi)定導出記錄的開(kai)始時(shi)間。Unix時(shi)間戳，單(dan)位：毫秒。該示(shi)例中(zhong)時(shi)間是(shi)2019/6/1 0:0:0。

-E：指(zhi)定導出記錄的最后時間。Unix時間戳，單(dan)位：毫秒。該示例中(zhong)時間是2019/7/1 0:0:0

-t：指定導(dao)入到一(yi)個(ge)(ge)文(wen)件的(de)表的(de)個(ge)(ge)數。該參(can)數可以控制輸出文(wen)件的(de)大小。

-B：指定一條(tiao)import語句中(zhong)包含記(ji)錄的條(tiao)數。注意(yi)：不要讓sql語句超過64k，否則(ze)后(hou)(hou)續導(dao)入會出錯。該參數為了后(hou)(hou)續導(dao)入時，提高導(dao)入速率。

-T： 指定導出數據時，啟動的線程數。建議設置成機器上core的2倍。

2、導出(chu)指定數(shu)據庫的(de)數(shu)據

root@taos-ec1:/dump# ./taosdump -c /dump/cfg -o /dump/data-data0601-0701 -u jason -p abcd -D dbname1 dbname2 -S 1559318400000 -E 1561910400000 -t 500 -B 100 -T 8

-D：指定僅導出(chu)dbname1和dbname2的所有數據。

3、導出指定(ding)數(shu)據庫中指定(ding)表的(de)數(shu)據

root@taos-ec1:/dump# ./taosdump -c /dump/cfg -o /dump/data-data0601-0701 -u jason -p abcd  dbname1 tablename1 tablename2 -S 1559318400000 -E 1561910400000 -t 500 -B 100 -T 8

指定導出dbname1數據(ju)庫中tablename1和tablename2的數據(ju)。

4、僅(jin)僅(jin)導出(chu)schema

root@taos-ec1:/dump# ./taosdump -c /dump/cfg -o /dump/data-data0601-0701 -u jason -p abcd -A -S 1559318400000 -E 1561910400000 -t 500 -s -T 8

-s：僅(jin)僅(jin)導出所(suo)有數(shu)據(ju)庫(ku)(ku)的schema，即數(shu)據(ju)庫(ku)(ku)、超級表、普通表，但不導出表中的記錄。

導出完成后，在指定的(de)輸出目錄(lu)下生成若(ruo)干.sql的(de)文件。

導入命令說明

將(jiang)導(dao)出的所有文件（由于文件比(bi)(bi)較大，建議進行(xing)壓(ya)縮，傳輸到目(mu)的機器上后，再解壓(ya)），拷貝到一個路(lu)徑下，比(bi)(bi)如/tmp路(lu)徑。導(dao)入數(shu)據時，需要指定導(dao)入文件所在的目(mu)錄(lu)。

root@ecs-17fe:# ./taosdump -c /tmp/cfg -u jason -p abcd -i /tmp/data0601-0701 -T 8

-i：導入(ru)文件所在路徑。

-T：指定導入數(shu)據時(shi)，啟(qi)動的(de)線程(cheng)數(shu)。建議設置成機器上core的(de)2倍。

校驗

完成導入后(hou)(hou)，可以隨機執行一些查詢，在相同的(de)查詢條件下，導出前與(yu)導入后(hou)(hou)的(de)記錄條數是否相同。比如(ru)

taos> select count(*) from table_name;
taos> select count(*) from super_table where ts >= 1559318400000 and ts <= 1561910400000;