Skip to content

Commit 198ff21

Browse files
committed
docs(dwh): add data warehouse powerBI connection info MTA-6169
1 parent 48c0770 commit 198ff21

File tree

1 file changed

+44
-3
lines changed

1 file changed

+44
-3
lines changed

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

Lines changed: 44 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -110,14 +110,34 @@ Refer to the official [ClickHouse®](https://clickhouse.com/docs/integrations/me
110110

111111
## PowerBI Desktop
112112

113-
Power BI Desktop is a robust data visualization tool that allows users to create dynamic reports and dashboards from various data sources.
113+
Power BI Desktop is a robust data visualization tool that allows users to create dynamic reports and dashboards from various data sources. To connect to your Data Warehouse for ClickHouse® deployment, PowerBI requires a MySQL connection using a dedicated user with a **plain text password**.
114114

115115
<Message type="note">
116116
ODBC connection between PowerBI and Data Warehouse for ClickHouse® is currently not supported.
117117
</Message>
118118

119+
### Creating a dedicated MySQL user
119120

120-
0. Make sure you installed [PowerBI Desktop]https://www.microsoft.com/en-us/download/details.aspx?id=58494/), and [MySQL Connector/NET](https://dev.mysql.com/downloads/connector/net/).
121+
1. [Connect to your deployment](/data-warehouse/how-to/connect-applications/).
122+
123+
2. Run the SQL query below to create a user with a plain text password. Replace the placeholders with the appropriate values:
124+
```sql
125+
CREATE USER mysql_user IDENTIFIED WITH plaintext_password BY 'mysql_user_password';
126+
```
127+
128+
3. Run the SQL query below to grant the user access to the database:
129+
130+
```sql
131+
GRANT SELECT(id) ON my_database.my_table TO mysql_user WITH GRANT OPTION;
132+
```
133+
134+
Your user can now access the specified database using the credentials you just defined.
135+
136+
### Connecting PowerBI to your deployment
137+
138+
<Tabs id="power-bi-connection">
139+
<TabsTab label="PowerBI Desktop">
140+
0. Make sure you installed [PowerBI Desktop](https://www.microsoft.com/en-us/download/details.aspx?id=58494/), and [MySQL Connector/NET](https://dev.mysql.com/downloads/connector/net/).
121141

122142
1. Open PowerBI Desktop.
123143

@@ -132,12 +152,33 @@ ODBC connection between PowerBI and Data Warehouse for ClickHouse® is currently
132152
A credentials pop-up displays.
133153

134154
5. Select **Database** from the left menu, enter the values below, then click **Connect**.
135-
- **User name**: your deployment admin user (`scwadmin` by default)
155+
- **User name**: your dedicated MySQL user [previously created](#creating-a-dedicated-mysql-user)
136156
- **Password**: the password you set at deployment creation
137157

138158
The **Navigator** pop-up displays, showing the different schemas and tables contained in your Data Warehouse for ClickHouse® deployment.
139159

140160
6. Select the desired tables, then **Load** to import data, or **Transform Data** to start working with your dataset.
161+
</TabsTab>
162+
<TabsTab label="PowerBI Service (Online)">
163+
164+
0. Access [PowerBI Service](https://app.powerbi.com).
165+
166+
1. From the PowerBI Service interface, click the **+ New** button from the toolbar. A list of data sources displays.
167+
168+
2. Select **MySQL Database** from the list. A connection wizard displays.
169+
170+
3. Enter the following values.
171+
- **Server**: `<YOUR_DEPLOYMENT_ID>.dtwh.<REGION>.scw.cloud`
172+
- **Database**: the name of the database to import (`default` if you did not create additional databases in your deployment)
173+
- **Connection**: `<YOUR_DEPLOYMENT_ID>.dtwh.<REGION>.scw.cloud`
174+
- **Connection name**: `<YOUR_DEPLOYMENT_ID>.dtwh.<REGION>.scw.cloud`
175+
- Authentication type: `Basic`
176+
- Username: your dedicated MySQL user [previously created](#creating-a-dedicated-mysql-user))
177+
- Password: The plain text password assigned to your MySQL user
178+
- Privacy level: `None`
179+
4. Click **Next**. The **Power Query** interface displays, allowing you to use the `MySQL.Database` function from this interface.
180+
</TabsTab>
181+
</Tabs>
141182

142183
Your Data Warehouse for ClickHouse® is now integrated into your PowerBI platform.
143184

0 commit comments

Comments
 (0)