https://github.com/sealjay/powerbi-adt
Querying Azure Digital Twins with PowerBI.
https://github.com/sealjay/powerbi-adt
Last synced: about 1 month ago
JSON representation
Querying Azure Digital Twins with PowerBI.
- Host: GitHub
- URL: https://github.com/sealjay/powerbi-adt
- Owner: Sealjay
- License: mit
- Created: 2021-05-24T22:54:39.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-07-29T14:07:41.000Z (almost 4 years ago)
- Last Synced: 2025-04-30T05:46:23.526Z (about 1 month ago)
- Language: JavaScript
- Size: 51.8 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# powerbi-adt
[](http://commitizen.github.io/cz-cli/)   
## Overview
An example showing how to query [Azure Digital Twins](https://docs.microsoft.com/en-us/azure/digital-twins/how-to-manage-twin?WT.mc_id=AI-MVP-5004204#create-a-digital-twin) from within PowerBI. You could use this to query the current state of your IoT devices, for example, to use the [Anomaly Detector](https://docs.microsoft.com/en-gb/azure/cognitive-services/anomaly-detector/?WT.mc_id=AI-MVP-5004204) cognitive service to check the state of outliers.
powerbi-adt is available under the [MIT Licence](./LICENCE).
## Setting up
1. Create an Azure Digital Twin
2. Give yourself access to the data plane - add some example data - the [Azure Digital Twins explorer](https://github.com/Azure-Samples/digital-twins-explorer/) example data is a good start.
3. Create a virtual environment for your Python setup, e.g. `python3 -m venv .venv`
4. Install the requirements `pip install -r requirements-dev.txt`
5. Copy the path to your venv
6. [Enable python scripting](https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-python-scripts#enable-python-scripting) in PowerBI
7. Log in to Azure on the CLI with `az login`
8. Import the **powerbi-query.py** as a [PowerBI datasource](https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-python-scripts?WT.mc_id=AI-MVP-5004204#run-your-python-script-and-import-data)
### Editing the query
```
query_expression = "SELECT * FROM digitaltwins"
query_result = service_client.query_twins(query_expression)
twin_list = pd.DataFrame(query_result)
```
The example query I provide in the `query_expression` variable will allow you to [query the twin graph](https://docs.microsoft.com/en-us/azure/digital-twins/how-to-query-graph?WT.mc_id=AI-MVP-5004204#query-by-property) - and you can use the Azure Digital Twins query language to build on this. Each individual pandas dataframe will appear as a data set in PowerBI.
### Example
You should see something like this...
## Limitations
- Using Python as a data source is only refreshable on PowerBI Desktop, or by using [an on-premises data gateway in personal mode](https://docs.microsoft.com/en-us/power-bi/connect-data/service-gateway-power-bi-faq?WT.mc_id=AI-MVP-5004204).
## Contact
Feel free to contact me [on Twitter](https://twitter.com/sealjay_clj). For bugs, please [raise an issue on GitHub](https://github.com/Sealjay-clj/powerbi-adt/issues).
## Contributing
Contributions are more than welcome! This repository uses the [GitHub flow](https://guides.github.com/introduction/flow/) - and you can choose to use [Commitizen](https://github.com/commitizen/cz-cli#making-your-repo-commitizen-friendly) to support the use of [semantic commits](https://nitayneeman.com/posts/understanding-semantic-commit-messages-using-git-and-angular/#common-types). (`npm install -g commitizen cz-customizable`and then `git cz`- easy!)