Manage your Azure Synapse Link during environment lifecycle events
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.