---
url: /v6.2/en-us/connecting-kingbasees.md
---
# Connecting to KingbaseES

### Connection Steps

Please follow the steps below to connect to the `KingbaseES` data source.

1. Click "New Data Connection" in the upper right corner of the data connection page.
   ![](/images/data-connection/connection-001.png)

2. Select the `KingbaseES` data source from the data source types.
   ![](/images/data-connection/connecting-kingbasees-001.png)

3. Fill in the required parameters for the data source connection as prompted.
   ![](/images/data-connection/connecting-kingbasees-002.png)

   **Connection Configuration Information**
   | Field                                 | Description                                                                                                    |
   | -------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
   | Name                                  | The name of the connection. Required and unique within the user.                                               |
   | Host Address                          | The address of the database. If the URL field is filled in, the value in the URL will take precedence.         |
   | Port                                  | The port of the database. If the URL field is filled in, the value in the URL will take precedence.            |
   | Username                              | The username for the database.                                                                                 |
   | Password                              | The password for the database.                                                                                 |
   | Database                              | The name of the database.                                                                                      |
   | Schema                                | The schema of the database.                                                                                    |
   | Max Connections                       | The maximum number of connections in the connection pool.                                                      |
   | Encoding                              | The encoding setting for the database connection.                                                              |
   | ssl                                   | Whether to use an SSL connection.                                                                              |
   | sslmode                               | Fill in according to the data source configuration, such as "disable", "allow", "prefer", "require", "verify-ca", "verify-full" |
   | Prefer using database comment as dataset title | Whether to display the table name or the table comment as the title. When enabled, the title is shown; when disabled, the table comment is shown. |
   | URL                                   | The JDBC URL of the database.                                                                                  |
   | Transaction Isolation Level for Read   | The transaction isolation level for read operations. This setting only affects reading data; writing data still uses the default isolation level. |
   | Hierarchical loading of schema and tables | Disabled by default. When enabled, schema and tables are loaded hierarchically. Only the schema is loaded during connection; you need to click the schema to load the tables under it. |
   | Query Timeout (seconds)                | Default is 600. When the data volume is large, you can appropriately increase the timeout.                     |
   | Show only tables under the specified database/schema | When this option is selected and the database field is not empty, only the tables under that database will be displayed. |

4. After filling in the parameters, click the `Validate` button to get the validation result (this checks the connectivity between HENGSHI SENSE and the configured data connection; you cannot add the connection if validation fails).

5. After validation passes, click `Execute Preset Code` to pop up the preset code for this data source, then click the execute button.

6. Click the `Add` button to add the `KingbaseES` connection.

> \[!CAUTION] Please note
>
> 1. Parameters marked with \* are required; other parameters are optional.
> 2. You must execute the preset code when connecting to the data source. Failure to do so may result in certain functions being unavailable during data analysis. In addition, when upgrading from a version prior to 4.4 to 4.4, you need to execute the preset code for existing data connections in the system.

***

### Supported `KingbaseES` Versions

`V8R6`, `V9R3`

### Data Connection Preview Support

Supports regular `table` and `view` types, as well as other tables that can be listed by `show tables`.

### SQL Dataset Support for SQL

All `SELECT`-related features are supported. The `SELECT SQL` statement must comply with the `KingbaseES` syntax specifications.