文档首页/ MapReduce服务 MRS/ 开发指南（LTS版）/ IoTDB开发指南（安全模式）/ 准备IoTDB应用开发环境/ 导入并配置IoTDB样例工程
更新时间：2024-12-06 GMT+08:00
查看PDF
分享

导入并配置IoTDB样例工程

背景信息

获取IoTDB开发样例工程，将工程导入到IntelliJ IDEA开始样例学习。

操作步骤

  1. 参考获取MRS应用开发样例工程，获取样例代码解压目录中“src/iotdb-examples”目录下的样例工程，可根据实际业务场景选择对应的样例，相关样例介绍请参见IoTDB样例工程介绍。
  2. 若需要在本地Windows调测iotdb-flink-example、iotdb-jdbc-example、iotdb-kafka-example或iotdb-session-example样例代码，需进行以下操作：

    • 需放置准备集群认证用户信息获取到的认证文件“user.keytab”和“krb5.conf”及SSL证书文件“truststore.jks”到各样例工程的“..\src\main\resources”目录下。
    • 配置各样例工程的“..\src\main\resources”目录下“com.huawei.bigdata.iotdb.IoTDBProperties”类，修改该类的IoTDBProperties()方法的proPath的值为“iotdb-example.properties”文件所在的绝对路径。
      图1 配置proPath参数值

  3. 修改各样例工程“..\src\main\resources”目录下的“iotdb-example.properties”文件： 

    iotdb_ssl_enable=true
jdbc_url=jdbc:iotdb://IoTDBServer实例IP地址:IoTDBServer RPC端口
# 进行认证的用户名
username=developuser
# 进行认证的用户密码，该密码建议密文存放，使用时解密，确保安全。
password=xxx
# 下载的认证凭据中“krb5.conf”文件的位置，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的krb5.conf文件，Windows环境下使用“\\”，填写文件绝对路径。
krb5_conf_dest=IoTDB客户端安装目录/IoTDB/iotdb/conf/krb5.conf
# 下载的认证凭据中“user.keytab”文件的位置，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的user.keytab文件，Windows环境下使用“\\”，填写文件绝对路径。
key_tab_dest=IoTDB客户端安装目录/IoTDB/iotdb/conf/user.keytab
# 对应user.keytab的用户名@HADOOP.COM
client_principal=developuser@HADOOP.COM
# truststore文件路径，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的truststore.jks文件，Windows环境下使用“\\”，填写文件绝对路径。
iotdb_ssl_truststore=IoTDB客户端安装目录/IoTDB/iotdb/conf/truststore.jks

  4. 安装IntelliJ IDEA和JDK工具后，需要在IntelliJ IDEA配置JDK。

    1. 打开IntelliJ IDEA，选择“Configure”。
      图2 Quick Start
    2. 在下拉框中选择“Structure for New Projects”。
      图3 Configure
    3. 在弹出的“Project Structure for New Projects”页面中，选择“SDKs”，单击加号添加JDK。
      图4 Project Structure for New Projects
    4. 在弹出的“Select Home Directory for JDK”窗口，选择对应的JDK目录，然后单击“OK”。
      图5 Select Home Directory for JDK
    5. 完成JDK选择后，单击“OK”完成配置。
      图6 完成JDK配置

      不同的IDEA版本的操作步骤可能存在差异，以实际版本的界面操作为准。

  5. 导入样例工程到IntelliJ IDEA开发环境。

    1. 打开IntelliJ IDEA，在“Quick Start”页面选择“Open or Import”。

      另外，针对已使用过的IDEA工具，可以从主界面选择“File > Import project...”导入样例工程。

      图7 Open or Import（Quick Start页面）
    2. 选择样例工程文件夹“iotdb-examples”下的“iotdb-jdbc-example”的pom.xml文件，然后单击“OK”。

      选择“Open as Project”

    3. 导入结束，IDEA主页显示导入的样例工程。
      图8 导入样例工程成功

  6. 设置项目使用的Maven版本。

    1. 在IntelliJ IDEA的菜单栏中，选择“File > Settings...”
      图9 Settings
    2. 选择“Build,Execution,Deployment > Maven”，选择Maven home directory为本地安装的Maven版本。
      然后根据实际情况设置好“User settings file”和“Local repository”参数。
      图10 选择本地Maven安装目录
    3. 然后单击“Apply”和“OK”，完成配置。