Manage your Azure Synapse Link during environment lifecycle events

Article
02/15/2022

Azure Synapse Link for Dataverse provides a continuous pipeline of data from Dataverse to Azure Synapse Analytics and/or Azure Data Lake. Once the link is created it continuously writes all the initial data as well as any incremental data. When you make changes to your Power Platform environment, this can affect the state of your Azure Synapse Link for Dataverse. This article explains the behavior of the Azure Synapse Link for Dataverse and possible user action during environment lifecycle events.

Note

Azure Synapse Link for Microsoft Dataverse was formerly known as Export to data lake. The service was renamed effective May 2021 and will continue to export data to Azure Data Lake as well as Azure Synapse Analytics.

Environment lifecycle events overview

Environment operation	Synapse link	Data	User action
Backup and restore	Stops syncing	Maintained	Use solutions to transport the link across environments
Copy	Source continues syncing	Source is maintained	Use solutions to transport the link across environments
Delete	Stops syncing	Maintained	None
Edit the properties	Error	Maintained	Unlink and relink
Move	Source stops syncing	Source is maintained	Use solutions to transport the link across environments
Recover	Continue syncing	Maintained	None
Reset	Removed	Maintained	Delete data before recreating the link

Backup and restore an environment

Azure Synapse Link for Dataverse profiles are not part of an environment backup or the subsequent restore. Once an environment is restored, use solutions to export and import the configuration to preserve the configuration of the Azure Synapse Link across environments.

Copy an environment

Azure Synapse Link for Dataverse profiles are not copied as part of the copy an environment process. To preserve the configuration of the Azure Synapse Link across environments, use solutions to export and import the configuration.

Delete an environment

When an environment is deleted, all Azure Synapse Link profiles are deleted and the data sync is stopped. All data written at the time of deletion is still available in your Azure Synapse Analytics workspace and/or Azure Data Lake.

Edit the properties of an environment

Azure Synapse Link for Dataverse profiles will fail if the environment name or URL environment properties are changed. You will need to unlink the Azure Synapse Link, optionally deleting the file system, and create a new link.

Move an environment

If an environment is migrated from one tenant to another, all Azure Synapse Link profiles are deleted and the data sync is stopped. All data written at the time of deletion is still available in your Azure Synapse Analytics workspace and/or Azure Data Lake. To preserve the configuration of the Azure Synapse Link across environments, use solutions to export and import the configuration.

Recover an environment

When recovering a deleted environment within the grace period, all Azure Synapse Link for Dataverse will be available and will continue syncing data with no user action as long as the data in your Azure Synapse Analytics workspace and/or Azure Data Lake has not been modified.

Reset an environment

If an environment is reset, all Azure Synapse Link for Dataverse profiles will be removed from the environment. All the corresponding data in Azure Synapse Analytics workspace and/or Azure Data Lake will still be available but will not be synced. You may need to clean up the data in the Azure Synapse Analytics workspace and/or Azure Data Lake and you'll need to re-create the Azure Synapse Link for Dataverse.