Skip to content

Commit 5009967

Browse files
committed
feat(dwh): update
1 parent b481651 commit 5009967

File tree

1 file changed

+40
-12
lines changed

1 file changed

+40
-12
lines changed

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

Lines changed: 40 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,8 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po
165165

166166
## Toucan
167167

168+
### Creating a new ClickHouse® connector for your deployment
169+
168170
[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.
169171

170172
1. Log in to your Toucan account.
@@ -177,15 +179,41 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/po
177179

178180
| Field | Description |
179181
| ---------------------------------------------- | --------------------------------------------------------------------------- |
180-
| Name (mandatory) | The name you want to give to your new connection |
181-
| Host (mandatory) | Data Warehouse deployment host (available from the [Scaleway Console](https://console.scaleway.com/data-warehouse)) |
182-
| Port (mandatory) | `8443` |
183-
| User (mandatory) | A [user](/data-warehouse/how-to/manage-users/) with the appropriate permissions. |
184-
| Password (mandatory) | The user's password |
185-
| SSL_connection (optional) | Allows enabling SSL-wrapped TCP connection |
186-
| Retry Policy (optional) | Enables a retry policy if the connection is unstable |
187-
| Slow Queries Cache Expiration Time (optional) | Slow queries cache expiration time in seconds |
188-
189-
5. Click **Test connection** to make sure Toucan can communicate with your deployment, then click **Save**.
190-
191-
Your Data Warehouse for ClickHouse® is now connected to your Toucan app, and can be used as a data source.
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)