Skip to main content

Limitations

ClickHouse native TCP protocol is not supported. Formal only supports ClickHouse over HTTP.

Create a Clickhouse Resource

To create a Clickhouse Resource, follow these steps:
  1. Navigate to Resources.
  2. Click Create Resource.
  3. Set Technology to Clickhouse.
  4. Fill in Resource Friendly Name, Hostname, and Port.
    • The hostname and port: typically, the port is 8443 when using TLS or 8123 when not using TLS.
  5. Click Create.
  6. In the Add Native User wizard (or later on the Authentication tab → Add User), create a password native user.
    • The username and password: out of the box, the username is default. Use the username appropriate for your use case.

Connect to a Clickhouse Resource

Here is an example of how to connect to a Clickhouse Resource using Clickhouse Connect:

Smart Routing

The Connector supports smart routing through the ClickHouse HTTP interface. Configure a technology listener to route one port to multiple ClickHouse resources. Set the client host to <resource-name>.<connector-hostname>. For example, use resource-clickhouse.connector.example.com to select the resource-clickhouse resource.

Policy Evaluation

Formal supports the following policy evaluation stages for ClickHouse:
  • Session: Evaluate and enforce policies at connection time
  • Response: Evaluate and enforce policies after data retrieval