Updated on 2024-08-12 GMT+08:00

Preparing a ClickHouse Application Development Environment

Table 1 describes the environment required for application development.

Table 1 Development environment

Item

Description

Operating System (OS)

  • Development environment: Windows 7 or later.
  • Operating environment: Linux

If the program needs to be commissioned locally, the operating environment must be able to communicate with network on the cluster service plane.

JDK installation

Basic configurations of the development and operating environments. The version requirements are as follows:

The server and client support only built-in OpenJDK 1.8.0_272.

Customers' applications that need to reference the JAR files of SDK to run in the application processes support Oracle JDK, IBM JDK, and OpenJDK.

  • x86 client: Oracle JDK 1.8; IBM JDK 1.8.5.11
  • TaiShan client: OpenJDK 1.8.0_272
NOTE:

For security purposes, the server supports only TLS V1.2 or later.

By default, the IBM JDK supports only TLS V1.0. If the IBM JDK is used, set the startup parameter com.ibm.jsse2.overrideDefaultTLS to true. After the setting, the IBM JDK supports TLS V1.0, TLS V1.1, and TLS V1.2. For details, see https://www.ibm.com/docs/en/sdk-java-technology/8?topic=customization-matching-behavior-sslcontextgetinstancetls-oracle#matchsslcontext_tls.

Installing and configuring IntelliJ IDEA

Basic configuration of the development environment. You are advised to use version 2019.1 or other compatible versions.

NOTE:
  • If you use IBM JDK, ensure that the JDK configured in IntelliJ IDEA is IBM JDK.
  • If you use Oracle JDK, ensure that the JDK configured in IntelliJ IDEA is Oracle JDK.
  • If you use Open JDK, ensure that the JDK configured in IntelliJ IDEA is Open JDK.
  • Do not use the same workspace and the sample project in the same path for different IntelliJ IDEA programs.

Apache Maven installation

Basic configuration of the development environment. This operation is used for project management throughout the lifecycle of software development.

7-zip

This tool is used to decompress *.zip and *.rar files. 7-Zip 16.04 is supported.