Skip to content

Commit 00b0747

Browse files
SamyOubouazizRoRoJ
andauthored
feat(dwh): add toucan connection procedure MTA-6557 (#5687)
* feat(dwh): add toucan connection procedure MTA-6557 * feat(dwh): update * Update pages/data-warehouse/how-to/connect-bi-tools.mdx Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com> * feat(dwh): update * feat(dwh): update * feat(dwh): update --------- Co-authored-by: Rowena Jones <36301604+RoRoJ@users.noreply.github.com>
1 parent 6ec221f commit 00b0747

File tree

1 file changed

+56
-1
lines changed

1 file changed

+56
-1
lines changed

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

Lines changed: 56 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,4 +161,59 @@ Your user can now access the specified database using the credentials you just d
161161

162162
Your Data Warehouse for ClickHouse® is now integrated into your PowerBI platform.
163163

164-
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.
164+
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.
165+
166+
## Toucan
167+
168+
### Creating a new ClickHouse® connector for your deployment
169+
170+
[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.
171+
172+
1. Log in to your Toucan account.
173+
174+
2. From your Toucan App Store, create a new app, or select the one you want to connect to Data Warehouse for ClickHouse®.
175+
176+
3. From the **My datasources** tab of your **Datahub**, click **Add a connector**. A pop-up displays.
177+
178+
4. Select the ClickHouse® from the list, then fill in the fields with the following information:
179+
180+
| Field | Description |
181+
| ---------------------------------------------- | --------------------------------------------------------------------------- |
182+
| Name | The name you want to give to your new connection |
183+
| Host | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) |
184+
| Port | `9440` |
185+
| User | A [user](/data-warehouse/how-to/manage-users/) with read (`SELECT`) permissions |
186+
| Password | The user's password |
187+
| SSL_connection | Must be enabled to connect to your deployment via SSL |
188+
| Retry Policy (optional) | (Optional) enables a retry policy if the connection is unstable |
189+
| Slow Queries Cache Expiration Time (optional) | (Optional) slow queries cache expiration time in seconds |
190+
191+
5. Click **Save**. Your new ClickHouse® connector appears in the list.
192+
193+
Your Data Warehouse for ClickHouse® is now connected to your Toucan app, and can be used as a data source.
194+
195+
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.
196+
197+
### Creating new datasets from your deployment
198+
199+
1. Click the **+** icon in your new connector to create a new dataset. A form displays.
200+
201+
2. Select the desired database from the **Database** drop-down menu.
202+
203+
3. Select the desired table from the **Table or view** drop-down menu.
204+
205+
4. Select the columns you want to import from the **Columns** drop-down menu. Tick/untick the checkboxes to filter data.
206+
207+
5. Click **Next**. A preview of the data displays, showing the selected columns only.
208+
209+
6. Click **Create** to proceed.
210+
211+
<Message type="note">
212+
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.
213+
</Message>
214+
215+
7. Enter a name for your data set, select **Data requested live**, then click **Save** to finish.
216+
217+
Your data set now appears in the **Datasets** tab of your **Datahub**, and is now ready to be used.
218+
219+
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.

0 commit comments

Comments
 (0)