diff --git a/docs/integrations/sql-clients/datagrip.md b/docs/integrations/sql-clients/datagrip.md index f09b5b2f5d1..4418a9bb6d5 100644 --- a/docs/integrations/sql-clients/datagrip.md +++ b/docs/integrations/sql-clients/datagrip.md @@ -53,17 +53,22 @@ DataGrip is available at https://www.jetbrains.com/datagrip/ ## 3. Connect to ClickHouse {#3-connect-to-clickhouse} -- Specify your database connection details, and click **Test Connection**: +- Specify your database connection details, and click **Test Connection**. +In step one you gathered your connection details - fill in the host URL, port, username, password, and database name, then test the connection. - In step one you gathered your connection details, fill in the host URL, port, username, password, and database name, then test the connection. +:::tip +Enter only the hostname in the **Host** field (e.g., `your-host.clickhouse.cloud`) without any protocol prefix like `https://`. - :::tip - The **HOST** entry in the DataGrip dialog is actually a URL, see the image below. +For ClickHouse Cloud connections, you must add `?ssl=true` to the **URL** field below the host. The complete JDBC URL should look like: - For more details on JDBC URL settings, please refer to the [ClickHouse JDBC driver](https://github.com/ClickHouse/clickhouse-java) repository. - ::: +`jdbc:clickhouse://your-host.clickhouse.cloud:8443/default?ssl=true` + +ClickHouse Cloud requires SSL encryption for all connections. Without the `?ssl=true` parameter, you'll see "Connection reset" errors even with correct credentials. + +For more details on JDBC URL settings, please refer to the [ClickHouse JDBC driver](https://github.com/ClickHouse/clickhouse-java) repository. +::: -DataGrip connection details form with ClickHouse settings +DataGrip connection details form with ClickHouse settings ## Learn more {#learn-more} diff --git a/static/images/integrations/sql-clients/datagrip-7.png b/static/images/integrations/sql-clients/datagrip-7.png index f30d7414d08..294e7c89477 100644 Binary files a/static/images/integrations/sql-clients/datagrip-7.png and b/static/images/integrations/sql-clients/datagrip-7.png differ