IoTDB数据导入

操作场景

该任务指导用户使用“import-csv.sh”将CSV格式的数据导入到IoTDB。

前提条件

已安装客户端，请参见。例如安装目录为“/opt/client”，以下操作的客户端目录只是举例，请根据实际安装目录修改。
各组件业务用户由MRS集群管理员根据业务需要创建，具体操作请参见。安全模式下，“机机”用户需要下载keytab文件，具体操作请参见。“人机”用户第一次登录时需修改密码。
服务端默认开启了SSL，需参考使用IoTDB客户端章节生成“truststore.jks”证书，并复制到“客户端安装目录/IoTDB/iotdb/conf”目录下。

操作步骤

在本地准备CSV文件，文件名为：example-filename.csv，内容如下：
```
Time,root.fit.d1.s1,root.fit.d1.s2,root.fit.d2.s1,root.fit.d2.s3,root.fit.p.s1
1,100,hello,200,300,400
2,500,world,600,700,800
3,900,"hello, \"world\"",1000,1100,1200
```
在导入数据前，需要注意：
- MRS 3.3.0之前版本，导入的数据不能包含空格，否则此行数据导入失败并跳过导入，后续操作不受影响。
- MRS 3.3.0及之后版本，导入的数据不能包含空格，否则此次数据导入操作会失败，需要对导入数据类型进行自检。
- 包含,的字段需要使用反引号括起来，例如：hello,world修改为`hello,world`。
- 字段中的"需要被替换成转义字符\"，例如："world"修改为\"world\"。
- 字段中的'需要被替换成转义字符\'，例如：'world' 修改为\'world\'。
- 如果输入的值为时间，格式为“yyyy-MM-dd'T'HH:mm:ss, yyy-MM-dd HH:mm:ss”或者“yyyy-MM-dd'T'HH:mm:ss.SSSZ”，例如：2022-02-28T11:07:00、2022-02-28 11:07:00或者2022-02-28T11:07:00.000Z。
使用WinSCP工具将CSV文件导入客户端节点，例如“/opt/client/IoTDB/iotdb/tools”目录下。
以客户端安装用户，登录安装客户端的节点。
执行以下命令，切换到客户端安装目录。
cd /opt/client
执行以下命令配置环境变量。
source bigdata_env
首次登录IoTDB客户端前需执行以下步骤生成SSL客户端证书：
1. 执行以下命令生成客户端SSL证书：
  keytool -noprompt -import -alias myservercert -file ca.crt -keystore truststore.jks
  
  执行该命令后需输入一个自定义密码。
2. 将生成的“truststore.jks”文件复制到“客户端安装目录/IoTDB/iotdb/conf”目录下：
  cp truststore.jks 客户端安装目录/IoTDB/iotdb/conf
如果当前集群开启了Kerberos认证，执行以下命令认证当前用户，如果集群未开启Kerberos认证请跳过该步骤。
kinit 组件业务用户
执行以下命令，切换到IoTDB客户端运行脚本所在目录。
cd /opt/client/IoTDB/iotdb/sbin
集群未启用Kerberos认证（普通模式）需先调用“alter-cli-password.sh”脚本修改默认用户root的默认密码：
sh alter-cli-password.sh IoTDBServer实例节点IP RPC端口
- IoTDBServer实例节点IP地址可在Manager界面，选择“集群 > 服务 > IoTDB > 实例”查看。
- IoTDBServer RPC端口可在参数“IOTDB_SERVER_RPC_PORT”中自行配置。默认端口如下：
  - 开源端口默认值为：6667
  - 定制端口默认值为：22260
  端口定制/开源区分：创建LTS版本类型集群时，可以选择“组件端口”为“开源”或是“定制”，选择“开源”使用开源端口，选择“定制”使用定制端口。
- root用户初始密码MRS 3.3.0之前版本为“root”，MRS 3.3.0及之后版本为“Iotdb@123”。
- 修改的用户密码字符长度MRS 3.3.0之前版本至少为4位，MRS 3.3.0及之后版本至少为8位，且不能包含空格。
执行以下命令登录客户端
 ./start-cli.sh -h IoTDBServer实例节点的业务ip -p IoTDBServer RPC端口
- IoTDBServer实例节点的业务IP地址可登录FusionInsight Manager后选择“集群 > 服务 > IoTDB > 实例”查看。
- RPC端口可通过“集群 > 服务 > IoTDB > 配置 > 全部配置”，搜索参数“IOTDB_SERVER_RPC_PORT”获得。
- 集群未启用Kerberos认证（普通模式）使用root用户登录。
运行该命令后，根据实际需求指定业务用户名：
- 指定业务用户名，则输入“yes”，并根据提示输入业务用户名和对应的业务用户密码：
- 不指定业务用户名，则输入“no”；此时，则使用7中的用户执行后续操作：
- 输入其它，则退出登录：

（可选）创建元数据。

IoTDB具有类型推断的能力，因此在数据导入前创建元数据不是必须的。但仍然推荐在使用CSV导入工具导入数据前创建元数据，因为这可以避免不必要的类型转换错误。命令如下：

SET STORAGE GROUP TO root.fit.d1;
SET STORAGE GROUP TO root.fit.d2;
SET STORAGE GROUP TO root.fit.p;
CREATE TIMESERIES root.fit.d1.s1 WITH DATATYPE=INT32,ENCODING=RLE;
CREATE TIMESERIES root.fit.d1.s2 WITH DATATYPE=TEXT,ENCODING=PLAIN;
CREATE TIMESERIES root.fit.d2.s1 WITH DATATYPE=INT32,ENCODING=RLE;
CREATE TIMESERIES root.fit.d2.s3 WITH DATATYPE=INT32,ENCODING=RLE;
CREATE TIMESERIES root.fit.p.s1 WITH DATATYPE=INT32,ENCODING=RLE;

执行以下命令，退出客户端。
quit;
执行以下命令，切换到“import-csv.sh”运行脚本所在目录。
cd /opt/client/IoTDB/iotdb/tools
执行以下命令运行import-csv.sh，导入“example-filename.csv”文件。
./import-csv.sh -h IoTDBServer实例节点的业务ip -p IoTDBServer RPC端口 -f example-filename.csv

需根据提示交互式输入业务用户名和对应密码，如下显示表示CSV文件导入成功：
验证数据一致性。
1. 执行以下命令，切换到IoTDB客户端运行脚本所在目录。
  cd /opt/client/IoTDB/iotdb/sbin
2. 参考10登录IoTDB客户端。执行SQL查询数据并与1中数据进行对比。
3. 查看导入的数据与1中的数据是否一致，如果一致则表示导入成功。
  例如，执行以下命令查看导入的数据：
  
  SELECT * FROM root.fit.**;
  为避免安全风险，推荐使用交互式方式导入CSV文件。
  
  CSV文件导入也可使用“./import-csv.sh -h IoTDBServer实例节点的业务ip -p IoTDBServer RPC端口 -u 业务用户名 -pw 业务用户密码 -f example-filename.csv”命令。
  如下显示表示CSV文件导入成功：
  
  如果服务端IoTDB开启了纳秒（ns）时间精度，客户端导入纳秒时间戳数据时，需要加上-tp ns参数。集群是否开启纳秒时间精度可登录FusionInsight Manager，选择“集群 > 配置 > 所有非默认值”，搜索“timestamp_precision”查看。