Schema Import

1. Overview

The schema import tool import-schema.sh/bat is located in tools directory.

2. Detailed Functionality

2.1 Parameter

Short ParamFull ParamDescriptionRequiredDefault
-h-- hostHostnameNo127.0.0.1
-p--portPort numberNo6667
-u--usernameUsernameNoroot
-pw--passwordPasswordNoroot
-sql_dialect--sql_dialectSpecifies whether the server usestree model ortable modelNotree
-db--databaseTarget database for importYes-
-table--tableTarget table for import (only applies when-sql_dialect=table)No-
-s--sourceLocal directory path containing script file(s) to importYes
-fd--fail_dirDirectory to save failed import filesNo
-lpf--lines_per_failed_fileMaximum lines per failed file (only applies when-sql_dialect=table)No100000Range:0 to Integer.Max=2147483647
-help--helpDisplay help informationNo

2.2 Command

# Unix/OS X
tools/import-schema.sh [-sql_dialect<sql_dialect>] -db<database> -table<table> 
     [-h <host>] [-p <port>] [-u <username>] [-pw <password>]
       -s <source> [-fd <fail_dir>] [-lpf <lines_per_failed_file>]
      
# Windows
# Before version V2.0.4.x  
tools\import-schema.bat [-sql_dialect<sql_dialect>] -db<database> -table<table>  
      [-h <host>] [-p <port>] [-u <username>] [-pw <password>]
       -s <source> [-fd <fail_dir>] [-lpf <lines_per_failed_file>] 
       
# V2.0.4.x and later versions       
tools\windows\schema\import-schema.bat [-sql_dialect<sql_dialect>] -db<database> -table<table>  
      [-h <host>] [-p <port>] [-u <username>] [-pw <password>]
       -s <source> [-fd <fail_dir>] [-lpf <lines_per_failed_file>] 

2.3 Examples

# Before import
IoTDB> show timeseries root.treedb.**
+----------+-----+--------+--------+--------+-----------+----+----------+--------+------------------+--------+
|Timeseries|Alias|Database|DataType|Encoding|Compression|Tags|Attributes|Deadband|DeadbandParameters|ViewType|
+----------+-----+--------+--------+--------+-----------+----+----------+--------+------------------+--------+
+----------+-----+--------+--------+--------+-----------+----+----------+--------+------------------+--------+

# Execution
./import-schema.sh -sql_dialect tree -s /home/dump0_0.csv -db root.treedb

# Verification
IoTDB> show timeseries root.treedb.**
+------------------------------+-----+-----------+--------+--------+-----------+----+----------+--------+------------------+--------+
|                    Timeseries|Alias|   Database|DataType|Encoding|Compression|Tags|Attributes|Deadband|DeadbandParameters|ViewType|
+------------------------------+-----+-----------+--------+--------+-----------+----+----------+--------+------------------+--------+
|root.treedb.device.temperature| null|root.treedb|  DOUBLE| GORILLA|        LZ4|null|      null|    null|              null|    BASE|
|   root.treedb.device.humidity| null|root.treedb|  DOUBLE| GORILLA|        LZ4|null|      null|    null|              null|    BASE|
+------------------------------+-----+-----------+--------+--------+-----------+----+----------+--------+------------------+--------+