Deploy healthcare data solutions in Microsoft Fabric (preview)

[This article is prerelease documentation and is subject to change.]

This article outlines the prerequisites and steps to successfully deploy and start using healthcare data solutions in Microsoft Fabric (preview). The deployment includes the following steps:

1. Review prerequisites
   
2. Set up data connection
3. Set up Azure Language service
4. Deploy Azure Marketplace offer
5. Deploy healthcare data solutions in Microsoft Fabric
6. Deploy sample data
7. Deploy capabilities

Before you begin deploying healthcare data solutions (preview), review the licensing requirements in Licensing prerequisites.

Review prerequisites

To deploy healthcare data solutions (preview) in a workspace with Fabric capacity, ensure that your tenant administrator provides you with the permission to deploy healthcare data solutions (preview) and the associated capabilities.

To provide the appropriate permissions, your tenant admin can follow these steps:

1. Navigate to the Microsoft Fabric admin portal.

2. On the Admin portal page, select Tenant settings, and then select Healthcare data solutions (preview).

3. Slide the toggle to Enabled. In the Apply to section, you can either keep the default selection of The entire organization, or you can provide this permission selectively to specific security groups by selecting the Specific security groups option.

   Then, select the Apply button.

   

Set up data connection

To begin using healthcare data solutions (preview), you must connect at least one data source or sample data to your Fabric workspace. To facilitate the same, the preview release includes sample data that you can deploy and set up for testing the solutions. Alternatively, you can also ingest data using a Fast Healthcare Interoperability Resources (FHIR) service such as Azure Health Data Services.

Use FHIR service

The following section outlines the steps for setting up Azure Health Data Services (FHIR service) for data ingestion:

1. 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.

2. After setting up the FHIR service, proceed with Set up Azure Language service and Deploy Azure Marketplace offer.

Use sample data

If you wish 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

1. Navigate to the Azure portal.

2. On the home page, select Create a resource, search for Resource group, and create a new Azure resource group.

3. Ensure 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.

4. 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. Ensure you review these terms when adding the language service to your resource group. For more information, review the following transparency notes:

• Responsible Use of AI documentation for Text Analytics for health.
• Responsible Use of AI documentation for Personally Identifiable Information (PII).
• Responsible Use of AI documentation for Azure AI Language.

Deploy Azure Marketplace offer

Follow these steps to deploy the Healthcare data solutions in Microsoft Fabric Azure Marketplace offer:

1. On the Azure portal home page, select Create a resource, or search for Marketplace in the top search box.

2. In the Marketplace search bar, search for Healthcare data solutions in Microsoft Fabric.

   

3. Select Create, and follow the on-screen guidance to deploy the solution. Ensure 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.

4. 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.

   

5. Complete the following post-deployment steps if you're using the Azure FHIR service as a data source.

   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).

   • On the Healthcare data solution's storage account, assign the Azure RBAC role Storage blob data contributor to the FHIR service. This assignment enables the FHIR service to read and write to the storage account.

   • On the FHIR service, assign the Azure RBAC role FHIR Data Exporter to the function app. This assignment 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 is responsible for initiating 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.

1. Sign in to Microsoft Power BI with your administrator credentials.

2. On the home page, select Workspaces and create a new Fabric workspace for deploying healthcare data solutions (preview).

3. Navigate to the newly created workspace. In the left navigation menu, select the Power BI icon and switch to the Microsoft Fabric experience.

   

4. 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, go to Licensing and prerequisites.

   

   Note

   Alternatively, you can also directly navigate to Industry Solutions (powerbi.com) to deploy healthcare data solutions (preview).

5. 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 format healthcare#_item-name. Here, # starts at 1 and the labeling increments by 1 for every new solution deployment in your workspace.

6. After the solution deployment is completed, you should be directed to the healthcare data solutions home page.

   

Deploy sample data

To begin using healthcare data solutions (preview) capabilities, you must connect at least one data source or sample data to your Fabric workspace. To facilitate the same, the preview release ships a sample data package that you can deploy to your workspace. You can utilize the sample data to test the capabilities instead of relying on your own data. Post deploying 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

To deploy the sample data to your workspace:

1. Select the Sample data tile on the healthcare data solutions home page.

   

2. On the sample data page, select Deploy to workplace.

   

3. 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, go to 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 proceed to deploy and explore the healthcare data solutions (preview) capabilities. Since the other capabilities rely on the Healthcare data foundations functionality, we recommend following this sequence when you deploy the capabilities:

1. Deploy and configure Healthcare data foundations
2. Deploy and configure FHIR data ingestion
3. Deploy and configure Unstructured clinical notes enrichment
4. Deploy and configure OMOP analytics
5. Deploy and configure Dynamics 365 Customer Insights - Data preparation

Important

Deploying Healthcare data foundations and FHIR data ingestion is mandatory, as they are required to deploy and run other capabilities.

However, Unstructured clinical notes enrichment, OMOP analytics, and Dynamics 365 Customer Insights - Data preparation are optional capabilities. They aren't required to run other capabilities. So, you may choose whether to deploy them based on your requirement.

See also

• Overview of healthcare data solutions in Microsoft Fabric (preview)
• How to get healthcare data solutions in Microsoft Fabric (preview)
• Region and language availability for healthcare data solutions in Microsoft Fabric (preview)