feat(dwh): add toucan connection procedure MTA-6557

pages/data-warehouse/how-to/connect-bi-tools.mdx

@@ -161,4 +161,59 @@ 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.
+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
+
+### 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.
+
+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 in the fields with the following information:
+
+    | Field                                          | Description                                                                 |
+    | ---------------------------------------------- | --------------------------------------------------------------------------- |
+    | 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.
+
+    <Message type="note">
+    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.
+    </Message>
+
+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.