Help Center/ GaussDB(DWS)/ Management Guide/ Cluster Connection/ Using the JDBC and ODBC Drivers to Connect to a Cluster/ Configuring JDBC to Connect to a Cluster (Load Balancing Mode)
Updated on 2025-02-07 GMT+08:00
View PDF

Configuring JDBC to Connect to a Cluster (Load Balancing Mode)

Context

If you use JDBC to connect to only one CN in the cluster, this CN may be overloaded and other CN resources wasted. It also incurs single-node failure risks.

To avoid these problems, you can use JDBC to connect to multiple CNs. Two modes are available:

  • Connection using ELB: An ELB distributes access traffic to multiple ECSs for traffic control based on forwarding policies. It improves the fault tolerance capability of application programs.
  • Connection in multi-host mode: Use JDBC to configure multiple nodes, which is similar to ELB.

Method 1: Using ELB to Connect to a Cluster

  1. Obtain the Elastic Load Balance address. On the console, go to the details page of a cluster and obtain the ELB IP address.
  2. Configure the driver. For details, see Downloading the JDBC or ODBC Driver. 

    1
2
3
4
5
    		 
    <dependency> 
    <groupId>com.huaweicloud.dws</groupId>  
    <artifactId>huaweicloud-dws-jdbc</artifactId>   
    <version>8.1.1.1</version> 
</dependency>

  3. Obtain the database connection. 

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
    		 
    private static final String USER_NAME = "dbadmin";
private static final String PASSWORD = "password";
// jdbc:postgresql://ELB_IP:PORT/dbName"
private static final String URL = "jdbc:postgresql://100.95.153.169:8000/gaussdb";
private static Properties properties = new Properties();
static {
    properties.setProperty("user", USER_NAME);
    properties.setProperty("password", PASSWORD);
}
/**
 * Obtain the database connection.
 */
public static Connection getConnection() {
    Connection connection = null;
    try {
        connection = DriverManager.getConnection(URL, properties);
    } catch (SQLException e) {
        e.printStackTrace();
    }
    return connection;
}

Method 2: Connecting to the Cluster in Multi-host Mode

  1. Obtain the EIP. Go to the details page of a cluster on the console and obtain the EIP.
  2. Configure the driver. For details, see Downloading the JDBC or ODBC Driver. 

    1
2
3
4
5
    		 
    <dependency> 
    <groupId>com.huaweicloud.dws</groupId>  
    <artifactId>huaweicloud-dws-jdbc</artifactId>   
    <version>8.1.1.1</version> 
</dependency>

  3. Obtain the database connection. 

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
    		 
    private static final String USER_NAME = "dbadmin";
private static final String PASSWORD = "password";
// jdbc:postgresql://host1:port1,host2:port2/dbName"
private static final String URL = "jdbc:postgresql://100.95.146.194:8000,100.95.148.220:8000,100.93.0.221:8000/gaussdb?loadBalanceHosts=true";
private static Properties properties = new Properties();
static {
    properties.setProperty("user", USER_NAME);
    properties.setProperty("password", PASSWORD);
}
/**
 * Obtain the database connection.
 */
public static Connection getConnection() {
    Connection connection = null;
    try {
        connection = DriverManager.getConnection(URL, properties);
    } catch (SQLException e) {
        e.printStackTrace();
    }
    return connection;
}