Connecting to a ClickHouse Data Source

Preparations

Before connecting to a data source, verify that a VPC endpoint security group is added. Check procedure:

1. Log in to the management console.
2. In the service list, choose > MapReduce Service to access the MRS console.
3. Select a region in the upper left corner.
4. In the navigation pane on the left, choose Clusters.
5. Click the name of the cluster you want to connect to. The cluster overview page is displayed.
6. Locate the Network Information area. Click Add Security Group Rule next to EIP. In the Add Security Group Rule dialog box, click Manage Security Group Rule. Click the Inbound Rules tab and check whether a VPC endpoint security group is added.
   • If yes, return to the DataArts Insight data source editing page to connect to the data source.
   • If no, perform the following steps to add a security group:
     1. Click Add Rule. In the displayed Add Inbound Rule dialog box, set the protocol, port, and source IP address. To add multiple rules, click Fast-Add Rule.
     2. Confirm the parameter settings and click OK to return to the DataArts Insight page and connect to the data source.
     Note

     If no EIP is bound, locate the Network Information area and click Bind next to EIP. Click Manage Security Group Rule and then the Inbound Rules tab to check or add a security group.

     If the data source connection test fails after the security group is added, the possible cause is that SASL_SSL is not enabled for that data source.

Accessing a ClickHouse Data Source Through a Public Network

1. Click in the upper left corner of the management console to select a region and select an enterprise project from Enterprise Project in the upper right corner of the Workspace page.
2. Click the name of the desired project in the My Projects area in the right pane.
3. In the navigation pane on the left, choose Data Management > Data Sources. On the displayed page, click Create Data Source. In the slide-out panel, set Source Database Type to ClickHouse and Access Network Type to Public network.
4. Set other parameters based on Table 1.

   Figure 1 Parameters for connecting to a ClickHouse data source

   
   

   Table 1 Parameters

   Parameter	Mandatory	Description
   Source Database Type	Yes	Type of the accessed data source. In this example, ClickHouse is selected.
   Access Network Type	Yes	In this example, Public network is selected.
   Name	Yes	Name of the data source displayed in the list.
   Domain Name	Yes	IP address of the data source.
   Port	Yes	Port number for logging in to the database.
   Database	Yes	Name of the database to be logged in to.
   SASL_SSL	-	It is used for trusted identity authentication and secure data transmission when DataArts Insight retrieves data from the data source. This function is enabled by default.
   Username	Yes	Username for logging in to the database.
   Authentication Mode	Yes	The options are Password authentication and Certificate authentication.
   Password	Yes	Password for logging in to the database.

5. Click Test Connection to test the data source connectivity.
6. Once the test is successful, click OK.

Accessing a ClickHouse Data Source Through a VPC Network

1. Click in the upper left corner of the management console to select a region and select an enterprise project from Enterprise Project in the upper right corner of the Workspace page.
2. Click the name of the desired project in the My Projects area in the right pane.
3. In the navigation pane on the left, choose Data Management > Data Sources. On the displayed page, click Create Data Source. In the slide-out panel, set Source Database Type to ClickHouse and Access Network Type to MRS ClickHouse.
4. Set other parameters based on Table 2.
   Note

   • The selection of MRS instances only determines the VPC and subnet to be connected, and does not have any corresponding relationship with the server list.
   • Only the ClickHouse built in MRS is supported.

   Figure 2 Parameters for connecting to a ClickHouse data source

   
   

   Table 2 Parameters

   Parameter	Mandatory	Description
   Source Database Type	Yes	Type of the accessed data source. In this example, ClickHouse is selected.
   Access Network Type	Yes	In this example, MRS ClickHouse is selected.
   Region	Yes	Region where the ClickHouse service host is located.
   Name	Yes	Name of the data source displayed in the list.
   Description	No	Description of the data source.
   Instance	Yes	Role instance corresponding to the ClickHouse service.
   Servers	Yes	List of servers where ClickHouse is located.
   Database	Yes	Name of the database to be logged in to.
   SASL_SSL	-	It is used for trusted identity authentication and secure data transmission when DataArts Insight retrieves data from the data source. This function is enabled by default.
   Username	Yes	Username for logging in to the database.
   Authentication Mode	Yes	The options are Password authentication and Certificate authentication.
   Password	Yes	Password for logging in to the database.

5. Click Test Connection to test the data source connectivity.
6. Once the test is successful, click OK.