diff --git a/pages/data-warehouse/how-to/connect-bi-tools.mdx b/pages/data-warehouse/how-to/connect-bi-tools.mdx index add828fb25..e276f2f592 100644 --- a/pages/data-warehouse/how-to/connect-bi-tools.mdx +++ b/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. \ 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 + +### 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. + + + 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