Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 12 additions & 7 deletions docs/integrations/sql-clients/datagrip.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,17 +53,22 @@

## 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**.

Check warning on line 56 in docs/integrations/sql-clients/datagrip.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.EOLWhitespace

Remove whitespace characters from the end of the line.
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.
:::

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

## Learn more {#learn-more}

Expand Down
Binary file modified static/images/integrations/sql-clients/datagrip-7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.