Skip to content

Commit b639032

Browse files
committed
update datagrip guide
1 parent 1604463 commit b639032

File tree

2 files changed

+15
-8
lines changed

2 files changed

+15
-8
lines changed

docs/integrations/sql-clients/datagrip.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,19 +51,26 @@ DataGrip is available at https://www.jetbrains.com/datagrip/
5151

5252
<Image img={datagrip_1} size="lg" border alt="DataGrip Drivers tab showing ClickHouse driver installation" />
5353

54-
## 3. Connect to ClickHouse {#3-connect-to-clickhouse}
54+
## 3. Connect to ClickHouse {#connect-to-clickhouse}
5555

56-
- Specify your database connection details, and click **Test Connection**:
56+
- Specify your database connection details, and click **Test Connection**.
57+
In step one you gathered your connection details - fill in the host URL, port, username, password, and database name, then test the connection.
5758

58-
In step one you gathered your connection details, fill in the host URL, port, username, password, and database name, then test the connection.
59+
:::tip
60+
Enter only the hostname in the **Host** field (e.g., `your-host.clickhouse.cloud`) without any protocol prefix like `https://`.
5961

60-
:::tip
61-
The **HOST** entry in the DataGrip dialog is actually a URL, see the image below.
62+
For ClickHouse Cloud connections, you must add `?ssl=true` to the **URL** field below the host. The complete JDBC URL should look like:
63+
```
64+
jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true
65+
```
66+
67+
ClickHouse Cloud requires SSL encryption for all connections. Without the `?ssl=true` parameter, you'll see "Connection reset" errors even with correct credentials.
68+
69+
For more details on JDBC URL settings, please refer to the [ClickHouse JDBC driver](https://github.com/ClickHouse/clickhouse-java) repository.
70+
:::
6271

63-
For more details on JDBC URL settings, please refer to the [ClickHouse JDBC driver](https://github.com/ClickHouse/clickhouse-java) repository.
64-
:::
6572

66-
<Image img={datagrip_7} size="md" border alt="DataGrip connection details form with ClickHouse settings" />
73+
<Image img={datagrip_7} border alt="DataGrip connection details form with ClickHouse settings" />
6774

6875
## Learn more {#learn-more}
6976

357 KB
Loading

0 commit comments

Comments
 (0)