Deploy healthcare data solutions in Microsoft Fabric (preview)
[This article is prerelease documentation and is subject to change.]
This article shows you how to deploy and start using healthcare data solutions in Microsoft Fabric (preview). The deployment includes the following steps:
- Review prerequisites
- Set up data connection
- Set up Azure Language service
- Deploy Azure Marketplace offer
- Deploy healthcare data solutions in Microsoft Fabric
- Deploy sample data
- Deploy capabilities
Before you begin, make sure you meet the licensing requirements in Licensing prerequisites.
Review prerequisites
To deploy healthcare data solutions (preview) in a workspace with Fabric capacity, you need permission from your tenant administrator. To grant the appropriate permissions, your tenant admin can follow these steps:
Go to the Microsoft Fabric admin portal.
On the Admin portal page, select Tenant settings, and then select Healthcare data solutions (preview).
Slide the toggle to Enabled. In the Apply to section, you can either keep the default selection of The entire organization, or you can choose specific security groups by selecting the Specific security groups option.
Then, select Apply.
Set up data connection
To use healthcare data solutions (preview), you must connect at least one data source or sample data to your Fabric workspace. You can use a Fast Healthcare Interoperability Resources (FHIR) service such as Azure Health Data Services to ingest data. Or, you can use the sample data that comes with the preview release to set up and test the solutions.
Use FHIR service
The following steps show you how to set up Azure Health Data Services (FHIR service) for data ingestion:
To set up your Azure Health Data Services (FHIR service), follow the instructions in Deploy a FHIR service within Azure Health Data Services using Azure portal.
After setting up the FHIR service, continue with Set up Azure Language service and Deploy Azure Marketplace offer.
Use sample data
If you want to use the provided sample data instead of a FHIR service, follow the steps in Deploy sample data after deploying healthcare data solutions (preview) to your Fabric workspace.
Set up Azure Language service
Go to the Azure portal.
On the home page, select Create a resource, search for Resource group, and create a new Azure resource group.
Make sure you have the Azure role-based access control (RBAC) Owner or User Access Administrator role on the resource group. To assign the permissions, follow the steps in Grant access.
After creating the resource group, go back to the home page, select Create a resource, search for Language service, and deploy a new Azure Language service to your resource group. Use the default setup settings.
Important
Deploying the language service requires you to accept the Responsible Use of AI documentation terms on the Azure portal. Make sure you review these terms when adding the language service to your resource group. For more information, see the following transparency notes:
Deploy Azure Marketplace offer
Follow these steps to deploy the Healthcare data solutions in Microsoft Fabric Azure Marketplace offer:
On the Azure portal home page, select Create a resource, or search for Marketplace in the top search box.
In the Marketplace search bar, search for Healthcare data solutions in Microsoft Fabric.
Select Create, and follow the on-screen guidance to deploy the solution. Make sure you update the following parameters:
- Resource group: Select your resource group.
- Language service: Select the language service previously created in your resource group.
- Fhir Server Uri: Optional parameter to be provided only if you're ingesting data from the Azure FHIR service. Enter your FHIR server's URI value here.
- Export Start Time: Specify your preferred start time to initiate bulk data ingestion from your FHIR service to the lake.
After the deployment is completed, the following highlighted resources should be provisioned in your environment:
Note
- The following image is for representational purposes only.
- Resource names are indicative.
If you're using the Azure FHIR service as a data source, complete the following post-deployment steps:
After the Healthcare data solutions in Microsoft Fabric Azure function app is successfully deployed, update the following FHIR server configuration:
Update the FHIR service to have a system assigned managed identity.
Update the FHIR service's export Azure storage account name to point to the healthcare data solution's storage account (select from the list of options).
In the healthcare data solution's storage account, assign the Azure RBAC role Storage blob data contributor to the FHIR service. This role enables the FHIR service to read and write to the storage account.
In the FHIR service, assign the Azure RBAC role FHIR Data Exporter to the function app. This role enables the function app to execute the FHIR $export API.
Update the FHIR Service Uri and Export Start Time app settings on the export function app.
This function app initiates the $export FHIR operation to the FHIR server, when the FHIR ingestion notebook invokes it.
Deploy healthcare data solutions in Microsoft Fabric
You can use Microsoft Fabric to guide you through a simplified deployment process for healthcare data solutions (preview). The estimated completion time is approximately 30 minutes.
Sign in to Microsoft Power BI with your administrator credentials.
On the home page, select Workspaces and create a new Fabric workspace for deploying healthcare data solutions (preview).
Go to the newly created workspace. In the left navigation menu, select the Power BI icon and switch to the Microsoft Fabric experience.
On the Fabric page, select Industry Solutions.
Important
The Industry Solutions tile won't be visible in your Fabric environment unless you've purchased Fabric capacity (or the trial capacity). For more information, see Licensing and prerequisites.
Note
You can also directly navigate to Industry Solutions (powerbi.com) to deploy healthcare data solutions (preview).
On the Industry Solutions page, select the Healthcare solutions (Preview) tile to deploy healthcare data solutions (preview). Ensure you select your newly created workspace by checking the Current workspace value.
There might be a brief delay before the deployment begins. So, only select the tile once and wait for the operation to succeed. Refrain from closing the browser during the deployment process.
Note
If the workspace doesn't have Fabric capacity enabled, the Upgrade to a free Microsoft Fabric trial window appears. Select Upgrade to start the Fabric trial for the workspace.
Important
By design, Fabric allows you to deploy Healthcare solutions (preview) more than once in your workspace. As the default setting, the first installation is titled healthcare1 and the deployment items follow the labeling format
healthcare1_item-name
.For any subsequent deployments beyond first-time installation, the deployment follows the labeling format
healthcare#
and the artifacts/items follow the labeling formathealthcare#_item-name
. Here,#
starts at1
and the labeling increments by1
for every new solution deployment in your workspace.After the solution deployment is completed, you should be directed to the healthcare data solutions home page.
Deploy sample data
To use healthcare data solutions (preview) capabilities, you must connect at least one data source or sample data to your Fabric workspace. The preview release includes a sample data package that you can deploy to your workspace. You can use this sample data to test the capabilities instead of relying on your own data. After you deploy the sample data, the files are stored in your OneLake.
The sample data package includes the following data:
Name | Size | Purpose |
---|---|---|
FHIR sample data | 32.1 GB | Use this data to test the transformation pipelines |
OMOP vocabulary data | 5.36 GB | Use this reference dataset for OMOP analytics |
DICOM imaging sample data | 40 MB | Use this sample dataset for DICOM imaging |
To deploy the sample data to your workspace:
Select the Sample data tile on the healthcare data solutions home page.
On the sample data page, select Deploy to workplace.
After the sample data is deployed to your workspace, use OneLake file explorer to view the deployed sample data files stored in OneLake. To learn more, see Use OneLake file explorer to access Fabric data.
Deploy capabilities
After setting up the data connection using your FHIR service or the shipped sample data, you can now deploy and explore the healthcare data solutions (preview) capabilities. Since the other capabilities rely on the Healthcare data foundations functionality, we recommend that you deploy the capabilities in the following order:
- Deploy and configure Healthcare data foundations
- Deploy and configure FHIR data ingestion
- Deploy and configure Unstructured clinical notes enrichment
- Deploy and configure OMOP analytics
- Deploy and configure Dynamics 365 Customer Insights - Data preparation
- Deploy and configure DICOM data ingestion
Important
Deploying Healthcare data foundations and FHIR data ingestion is mandatory, as you need them to deploy and run other capabilities.
However, Unstructured clinical notes enrichment, OMOP analytics, Dynamics 365 Customer Insights - Data preparation, and DICOM data ingestion are optional capabilities. They aren't required to run other capabilities. So, you may choose whether to deploy them based on your requirement.