Create a connection to ClickHouse®

    Follow these steps to create a connection to ClickHouse®:

    1. Select Visualization from the list of services on the left.

    2. Select your workbook or click Create workbook to make a new one.

    3. Click CreateConnection in the upper-right corner of your workbook page.

    4. Select ClickHouse®.

    5. Specify the connection parameters:

      • Hostname. Copy the host's name from the Hosts tab on the information page of your cluster.

      • HTTP Interface Port (by default, 8443).

      • Username and Password for your cluster. You can find them in the Overview tab on your cluster's information page.

      • Cache TTL. Specifies how long to store cache (in seconds). You can keep the Default value or select Customized to set this value manually.

      • Raw SQL level:

        • Forbid is the default setting. It handles all SQL queries automatically.

        • Allow subselects in datasets gives access to manual operations with SQL queries and subqueries. Use with caution and only if necessary.

        • Allow subselects in datasets and queries from charts allows you to use your connection to create a QL chart.

      • HTTPS if you need this security layer (enabled by default).

    6. Click Check connection:

      • If your connection is operational, you'll see a green icon.

      • If there is a problem, a red icon will appear. You'll also see a popup message with a Details button to check service information about the error.

    7. Click Create connection.

    8. Name your connection and click Create.