Docs

RDS for PostgreSQL

V2（2022-01-01）

Using Java SDK

This topic describes the download, installation, and client initialization of the PostgreSQL Java SDK for RDS for PostgreSQL.

Download and install

Prerequisites

Prerequisites For more details, see Java Downloads.

tip

You can run the java -version command to check the version of the current Java.

SDL download URL

Java SDK source code address for RDS for PostgreSQL, see SDK list.

Install SDK

Configure Maven project dependencies. Create a new Maven project and add the following settings in pom.xml in the project directory to introduce service dependencies. When a dependency is introduced, the Maven project management tool automatically downloads the relevant JAR package.

tip

If your Java JDK version is JDK 9 or later and you need to add additional javax.annotation-api dependencies, add the following in pom.xml.

Initialize client side

Prerequisites

A Volcano Engine account has been created and the real-name authentication has been completed. For account registration and real name authentication, refer to How to Register an Account and Real-name authentication.

The Access Key ID (AK) and Secret Access Key (SK) information of the account have been obtained. For specific operations, refer to Access Key management.

For Regions supported by RDS for PostgreSQL, see service address.

The RDS for PostgreSQL Java SDK has been downloaded and installed. For specific steps, see Download and Install.

Initialize client

Initialize the client with the following code.

Sample

Request timed out time settings

When calling the PostgreSQL interface with the SDK, there is no timeout limit by default. You can specify a timeout (in seconds) for the request by adding a _request_timeout parameter at the end of the code when initiating an interface call request. If the request is not completed within this time, the request will terminate with a timeout error. For example, you can set the timeout to 10 seconds with the following code when calling the DescribeDBInstances interface.

Creating PostgreSQL instance

For information about the definition, range, and other parameters used in the following SDK code, see CreateDBInstances.

The parameters in this example are described in the following table.

Configuration item	Note	Value
DBEngineVersion	Compatible version.	PostgreSQL_12
NodeInfo	Instance specification configuration.	[ { "NodeType": "Primary", "ZoneId": "cn-beijing-c", "NodeSpec": "rds.postgres.1c2g" }, { "NodeType": "Secondary", "ZoneId": "cn-beijing-c", "NodeSpec": "rds.postgres.1c2g" } ]
StorageType	Storage type.	LocalSSD
StorageSpace	Instance storage space.	30
VpcId	A proprietary network (VPC) ID.	vpc-2bzo8w6m87v282dx0eemg****
SubnetId	Subnet ID.	subnet-2d6b6byrhtts058ozfenq****
InstanceName	Storage type.	pg-test-sdk-java
ChargeInfo	Billing method.	{ "ChargeType": "PostPaid" }

Query PostgreSQL instance information

For information about the definition, range, and other parameters used in the following SDK requests, see DescribeDBInstanceDetail.

Last updated: 2025.11.17 20:31:12