Updated on 2026-03-20 GMT+08:00

PostgreSQL/SQLServer Link Parameters

Table 1 lists the parameters for creating a link to PostgreSQL/SQLServer. Greenplum, Kingbase, and GaussDB can be connected through the PostgreSQL connector. The source and destination data sources supported by migration jobs are the same as those for PostgreSQL.

Do not change the password or user when the job is running. If you do so, the password will not take effect immediately and the job will fail.

Table 1 PostgreSQL/SQLServer link parameters

Parameter

Description

Example Value

Name

Link name, which should be defined based on the data source type, so it is easier to remember what the link is for

sql_link

Database Server

IP address or domain name of the database to connect

Click Select next to the text box to obtain the list of instances.

192.168.0.1

Port

Port of the database to connect

  • MySQL: The default port is 3306.
  • Oracle: The default port is 1521.
  • PostgreSQL: The default port is 5432.
  • Microsoft SQL Server: The default port is 1433.
  • DWS: The default port is 8000.
  • Doris: The default port is 9030.
    • To query the MRS Doris MySQL port, log in to Manager, choose Cluster > Services > Doris, click Configurations, and search for query_port.
    • To query the open-source Doris MySQL port,

      go to the installation path and search for query_port in the conf/fe.conf file.

  • DB2: The default port is 50000.

The port number varies depending on the database. Examples:

Default port of SQL Server: 1433

Default port of PostgreSQL: 5432

Database Name

Name of the database to connect

dbname

Username

Username used for accessing the database

When you create a database shard link, this configuration is applied to all backend links in the data source list for which no username or password has been configured. When you edit a database shard link, if you want to modify an existing backend link, specify the username and password in the data source list.

cdm

Password

Password of the user

When you create a database shard link, this configuration is applied to all backend links in the data source list for which no username or password has been configured. When you edit a database shard link, if you want to modify an existing backend link, specify the username and password in the data source list.

-

Use Agent

The agent function will be unavailable soon and does not need to be configured.

-

Agent

The agent function will be unavailable soon and does not need to be configured.

-

Driver Class Name

Class name of the uploaded driver

Select org.postgresql.Driver or com.kingbase8.Driver.

-

Reference Sign

Database enclosure character. This parameter is optional. For some databases, the value is case sensitive. Leave this parameter blank if no enclosure character is required.

"

Driver Version

Different types of relational databases adapt to different drivers. For details, see How Do I Obtain a Driver?

-

Fetch Size

(Optional) Displayed when you click Show Advanced Attributes.

Number of rows obtained by each request. Set this parameter based on the data source and the job's data size. If the value is either too large or too small, the job may run for a long time.

1000

SSL Encryption

Whether to connect to the database in SSL mode

Yes

Link Attributes

(Optional) Click Add to add the JDBC connector attributes of multiple specified data sources. For details, see the JDBC connector document of the corresponding database.

The following are some examples:
  • connectTimeout=60 and socketTimeout=300: When a large amount of data needs to be migrated or the entire table is retrieved using query statements, the migration fails due to connection timeout. In this case, you can customize the connection timeout interval (ms) and socket timeout interval (ms) to prevent failures caused by timeout. In addition, some driver versions may not support the socketTimeout parameter. You are advised to use sqljdbc9.4.jar or a later driver version.
  • useCursorFetch=false: By default, useCursorFetch is true, indicating that the JDBC connector communicates with relational databases using a binary protocol. Some third-party systems may have compatibility issues, causing migration time conversion errors. In this case, you can disable this function.
  • trustServerCertificate=true: A PKIX error may be reported during the creation of a secure connection. You are advised to set this parameter to true.
  • sslmode=require: The link to PostgreSQL may fail when SSL authentication is enabled. Set this parameter to require.

sslmode=require

Link Secret Attributes

(Optional) Displayed when you click Show Advanced Attributes.

Custom secret attributes of the link

sk=09fUgD5WOF1L6f