From 25a47a29f788dec6f0a8f5d7129789c941d44961 Mon Sep 17 00:00:00 2001 From: Samy OUBOUAZIZ Date: Mon, 20 Oct 2025 18:06:46 +0200 Subject: [PATCH 1/6] feat(dwh): add toucan connection procedure MTA-6557 --- .../how-to/connect-bi-tools.mdx | 29 ++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index add828fb25..58da97d410 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -161,4 +161,31 @@ Your user can now access the specified database using the credentials you just d Your Data Warehouse for ClickHouse® is now integrated into your PowerBI platform. -Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/powerbi) and [PowerBI](https://learn.microsoft.com/en-us/power-query/connectors/clickhouse) documentation portals for more information. \ No newline at end of file +Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/powerbi) and [PowerBI](https://learn.microsoft.com/en-us/power-query/connectors/clickhouse) documentation portals for more information. + +## Toucan Toco + +Toucan Toco is a business intelligence platform that transforms raw data into actionable insights through customizable visualizations and dashboards. Toucan's ClickHouse® connector allows you to use your Data Warehouse for ClickHouse® deployment as a data source. + +1. Log in to your Toucan account. + +2. From the Toucan user interface, create a new app, or select the one you want to connect to Data Warehouse for ClickHouse®. + +3. From the **My datasources** tab of your **Datahub**, click **Add a connector**. A pop-up displays. + +4. Select the ClickHouse® from the list, then fill the fields with the following information: + + | Field | Value | Description | + | ---------------------------------------------- | ------------- | --------------------------------------------------------------------------- | + | Name (mandatory) | | Use it to identify your connection | + | Host (mandatory) | | Could be an IP address or a hostname (e.g., localhost) | + | Port (mandatory) | | An integer; by default, ClickHouse runs on port 9000 | + | User (mandatory) | | Your login user | + | Password (mandatory) | | Your login password (this value will be stored as a secret) | + | SSL_connection (optional) | | Allows enabling SSL-wrapped TCP connection | + | Retry Policy (optional) | | Enables configuring a retry policy if the connection is flaky | + | Slow Queries' Cache Expiration Time (optional) | | Slow queries' cache expiration time in seconds | + +5. Click **Test connection** to make sure Toucan can communicate with your deployment, then click **Save**. + +Your Data Warehouse for ClickHouse® is now connected to your Toucan app, and can be used as a data source. \ No newline at end of file From 14ecd9de3119dbb0ccf84817aadfa480b6243fbc Mon Sep 17 00:00:00 2001 From: Samy OUBOUAZIZ Date: Tue, 21 Oct 2025 15:08:00 +0200 Subject: [PATCH 2/6] feat(dwh): update --- .../how-to/connect-bi-tools.mdx | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index 58da97d410..2af55315ae 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -163,28 +163,28 @@ Your Data Warehouse for ClickHouse® is now integrated into your PowerBI platfor Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/powerbi) and [PowerBI](https://learn.microsoft.com/en-us/power-query/connectors/clickhouse) documentation portals for more information. -## Toucan Toco +## Toucan -Toucan Toco is a business intelligence platform that transforms raw data into actionable insights through customizable visualizations and dashboards. Toucan's ClickHouse® connector allows you to use your Data Warehouse for ClickHouse® deployment as a data source. +[Toucan](https://www.toucantoco.com/en/) is a business intelligence platform that transforms raw data into actionable insights through customizable visualizations and dashboards. Toucan's ClickHouse® connector allows you to use your Data Warehouse for ClickHouse® deployment as a data source. 1. Log in to your Toucan account. -2. From the Toucan user interface, create a new app, or select the one you want to connect to Data Warehouse for ClickHouse®. +2. From your Toucan App Store, create a new app, or select the one you want to connect to Data Warehouse for ClickHouse®. 3. From the **My datasources** tab of your **Datahub**, click **Add a connector**. A pop-up displays. 4. Select the ClickHouse® from the list, then fill the fields with the following information: - | Field | Value | Description | - | ---------------------------------------------- | ------------- | --------------------------------------------------------------------------- | - | Name (mandatory) | | Use it to identify your connection | - | Host (mandatory) | | Could be an IP address or a hostname (e.g., localhost) | - | Port (mandatory) | | An integer; by default, ClickHouse runs on port 9000 | - | User (mandatory) | | Your login user | - | Password (mandatory) | | Your login password (this value will be stored as a secret) | - | SSL_connection (optional) | | Allows enabling SSL-wrapped TCP connection | - | Retry Policy (optional) | | Enables configuring a retry policy if the connection is flaky | - | Slow Queries' Cache Expiration Time (optional) | | Slow queries' cache expiration time in seconds | + | Field | Description | + | ---------------------------------------------- | --------------------------------------------------------------------------- | + | Name (mandatory) | The name you want to give to your new connection | + | Host (mandatory) | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) | + | Port (mandatory) | `8443` | + | User (mandatory) | A [user](/data-warehouse/how-to/manage-users/) with the appropriate permissions. | + | Password (mandatory) | The user's password | + | SSL_connection (optional) | Allows enabling SSL-wrapped TCP connection | + | Retry Policy (optional) | Enables a retry policy if the connection is unstable | + | Slow Queries Cache Expiration Time (optional) | Slow queries cache expiration time in seconds | 5. Click **Test connection** to make sure Toucan can communicate with your deployment, then click **Save**. From b48165183e01332ab5e9d7f8a598cfa186abbfbf Mon Sep 17 00:00:00 2001 From: SamyOubouaziz Date: Tue, 21 Oct 2025 15:12:13 +0200 Subject: [PATCH 3/6] Update pages/data-warehouse/how-to/connect-bi-tools.mdx Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> --- pages/data-warehouse/how-to/connect-bi-tools.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index 2af55315ae..74dd7d90e7 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -173,7 +173,7 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po 3. From the **My datasources** tab of your **Datahub**, click **Add a connector**. A pop-up displays. -4. Select the ClickHouse® from the list, then fill the fields with the following information: +4. Select the ClickHouse® from the list, then fill in the fields with the following information: | Field | Description | | ---------------------------------------------- | --------------------------------------------------------------------------- | From 50099674a069b2225024a4feb5bd7723e767962b Mon Sep 17 00:00:00 2001 From: Samy OUBOUAZIZ Date: Wed, 22 Oct 2025 15:15:13 +0200 Subject: [PATCH 4/6] feat(dwh): update --- .../how-to/connect-bi-tools.mdx | 52 ++++++++++++++----- 1 file changed, 40 insertions(+), 12 deletions(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index 74dd7d90e7..67d968ed43 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -165,6 +165,8 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po ## Toucan +### Creating a new ClickHouse® connector for your deployment + [Toucan](https://www.toucantoco.com/en/) is a business intelligence platform that transforms raw data into actionable insights through customizable visualizations and dashboards. Toucan's ClickHouse® connector allows you to use your Data Warehouse for ClickHouse® deployment as a data source. 1. Log in to your Toucan account. @@ -177,15 +179,41 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po | Field | Description | | ---------------------------------------------- | --------------------------------------------------------------------------- | - | Name (mandatory) | The name you want to give to your new connection | - | Host (mandatory) | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) | - | Port (mandatory) | `8443` | - | User (mandatory) | A [user](/data-warehouse/how-to/manage-users/) with the appropriate permissions. | - | Password (mandatory) | The user's password | - | SSL_connection (optional) | Allows enabling SSL-wrapped TCP connection | - | Retry Policy (optional) | Enables a retry policy if the connection is unstable | - | Slow Queries Cache Expiration Time (optional) | Slow queries cache expiration time in seconds | - -5. Click **Test connection** to make sure Toucan can communicate with your deployment, then click **Save**. - -Your Data Warehouse for ClickHouse® is now connected to your Toucan app, and can be used as a data source. \ No newline at end of file + | Name | The name you want to give to your new connection | + | Host | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) | + | Port | `9440` | + | User | A [user](/data-warehouse/how-to/manage-users/) with read (`SELECT`) permissions. | + | Password | The user's password | + | SSL_connection | Must be enabled to connect to your deployment via SSL | + | Retry Policy (optional) | (Optional) enables a retry policy if the connection is unstable | + | Slow Queries Cache Expiration Time (optional) | (Optional) slow queries cache expiration time in seconds | + +5. Click **Save**. Your new ClickHouse® connector appears in the list. + +Your Data Warehouse for ClickHouse® is now connected to your Toucan app, and can be used as a data source. + +Refer to the [official Toucan documentation](https://docs-v3.toucantoco.com/data-management-in-datahub/datasources-in-toucan/managing-connectors/setting-up-a-connector/database-and-data-warehouse-connectors/setting-up-a-clickhouse-connector) for more information on the ClickHouse® connector. + +### Creating new datasets from your deployment + +1. Click the **+** icon in your new connector to create a new dataset. A form displays. + +2. Select the desired database from the **Database** drop-down menu. + +3. Select the desired table from the **Table or view** drop-down menu. + +4. Select the columns you want to import from the **Columns** drop-down menu. Tick/untick the checkboxes to filter data. + +5. Click **Next**. A preview of the data displays, showing the selected columns only. + +6. Click **Create** to proceed. + + + Use the available YouPrep™ pipeline tools to transform data before using it as a data set. Refer to the [official Toucan documentation](https://docs-v3.toucantoco.com/data-management-in-datahub/datasets-in-toucan/preparing-data/overview-of-youprep-tm) for more information on the YouPrep™ interface. + + +7. Enter a name for your data set, select **Data requested live**, then click **Save** to finish. + +Your data set now appears in the **DATASETS** tab of your **DATAHUB**, and is now ready to be used. + +Refer to the [official Toucan documentation](https://docs-v3.toucantoco.com/visualizations-and-layouts/creating-visualizations/viz-gallery) for more information on how to create visualizations using your new data set. \ No newline at end of file From a9b941fae0f15a207993a9065ee1f88dad620e53 Mon Sep 17 00:00:00 2001 From: Samy OUBOUAZIZ Date: Wed, 22 Oct 2025 15:53:17 +0200 Subject: [PATCH 5/6] feat(dwh): update --- pages/data-warehouse/how-to/connect-bi-tools.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index 67d968ed43..90a4756184 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -182,7 +182,7 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po | Name | The name you want to give to your new connection | | Host | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) | | Port | `9440` | - | User | A [user](/data-warehouse/how-to/manage-users/) with read (`SELECT`) permissions. | + | User | A [user](/data-warehouse/how-to/manage-users/) with read (`SELECT`) permissions | | Password | The user's password | | SSL_connection | Must be enabled to connect to your deployment via SSL | | Retry Policy (optional) | (Optional) enables a retry policy if the connection is unstable | From 112eeb3850eb0bbbd673a7bb6d579cd6dbe89712 Mon Sep 17 00:00:00 2001 From: Samy OUBOUAZIZ Date: Mon, 27 Oct 2025 13:07:37 +0100 Subject: [PATCH 6/6] feat(dwh): update --- pages/data-warehouse/how-to/connect-bi-tools.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index 90a4756184..e276f2f592 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/pages/data-warehouse/how-to/connect-bi-tools.mdx @@ -214,6 +214,6 @@ Refer to the [official Toucan documentation](https://docs-v3.toucantoco.com/data 7. Enter a name for your data set, select **Data requested live**, then click **Save** to finish. -Your data set now appears in the **DATASETS** tab of your **DATAHUB**, and is now ready to be used. +Your data set now appears in the **Datasets** tab of your **Datahub**, and is now ready to be used. Refer to the [official Toucan documentation](https://docs-v3.toucantoco.com/visualizations-and-layouts/creating-visualizations/viz-gallery) for more information on how to create visualizations using your new data set. \ No newline at end of file