Skip to main content

ClickHouse (Custom Connector)

Custom connector for ClickHouse utilizes an ODBC connection for executing custom queries and retrieves metadata using specific queries tailored to this data source.

ODBC Driver

Before importing, using the custom connector requires the installation and configuration of the ODBC driver.

We have tested the import using the ClickHouse Official ODBC Driver 64bit

ODBC Driver configuration

First Download ODBC driver.

Image title

Extract files and double click on clickhouse-odbc-<version>-win64 and follow the instructions to install the driver.

Image title

After that hit the windows key, search for ODBC DataSources 64 bit and open this app. In the System DSN tab you should be able to see ClickHouse DSN (Unicode).

Image title

Go to the User DSN tab and click on the Add button. Double click on ClickHouse DSN (Unicode) to configure it.

Image title

Provide all the connection details as follows:

  • Name - Some convenient name for the connection.
  • Host - Host of your ClickHouse instance (without https://).
  • Port - Set it to HTTP SSL/TLS port. Default port: 8443.
  • User - ClickHouse database user.
  • Password - ClickHouse database password.
  • Timeout - You can set it to 200 and adjust if needed.
Image title
Image title

Connector features

Data Catalog

Dataedo will document the following objects from ClickHouse:

  • Tables,
  • Views,
  • Procedures,
  • Functions

How to connect

To connect to ClickHouse create new documentation by clicking Add and choosing New connection.

Image title

On the connection screen choose ClickHouse (Local Custom Connector) or ClickHouse (Shared Custom Connector).

Image title

Choose the ODBC driver configured earlier.

Image title

Click Connect.

Connector specification

Imported objects

ObjectImported as
TableTable
ViewView

Tables metadata

MetadataImported as
NameName
CommentDescription
ColumnsTable columns
   NameName
   Data typeData type

Views metadata

MetadataImported as
NameName
CommentDescription
ColumnsView columns
   NameName
   Data typeData type