Querio

ClickHouse

This is a step by step guide to integrate ClickHouse and Querio.

1) Create a dedicated ClickHouse user

What: A non-human account used only by Querio, with least-privilege access.

How (run as a user with admin privileges):

Execute the following SQL against the DB

-- Replace 'querio_user' and 'STRONG_PASSWORD' as needed
CREATE USER querio_user IDENTIFIED BY 'STRONG_PASSWORD';

Tip: Use a long, random password (at least 16 characters) — a password manager can generate one.

2) Grant read-only access to the required database

What: Limit Querio's access to only the data it needs.

How (example for my_database):

Execute the following SQL against the DB

-- Database access
GRANT SELECT ON my_database.* TO querio_user;

Repeat grants for each database Querio needs to query. For specific table access, use: GRANT SELECT ON database.table_name TO querio_user;

3) Collect and share the connection details

What: These are the connection parameters Querio will use to connect to your ClickHouse database.

Required values:

  • Host: The address of your ClickHouse database (hostname or IP address)
  • Port: The port used for secure native connections to your ClickHouse database. This is usually 9440 (see ClickHouse documentation)
  • Username: querio_user (or whatever you created)
  • Password: The one you set in CREATE USER
  • Database: The database Querio should query

Note: Port 9440 is the default for secure native protocol connections. If your ClickHouse instance uses a different port, check your server configuration.