Database Connection Retry Settings
This page describes the key settings you can configure for DataSync in the shareappsettings.json file.
Locate the shared settings file
All properties are configured in the shared app settings file, usually named shareappsettings.json. This file is typically located at the root of your DataSync deployment and applies globally to all APIs in DataSync.
Handle failed database connections
A key section in these settings is DbRetrySettings, which controls how the system handles failed database connection attempts— for example, when the DataSync service starts and tries to connect to the required databases.
This retry logic applies only to the initial connection attempts during startup.
You can customize the following properties:
Property | Description |
---|---|
RetryCounts |
The number of times DataSync will try to connect if the initial attempt fails. |
RetryDelay | The amount of time to wait between retries, in hh:mm:ss format. |
There are no strict limits for these values. Adjust them based on your environment.
Example
If you want DataSync to attempt connecting to your databases up to 10 times, with a 10-second delay between each try, configure as follows:
“DbRetrySettings”: {
“RetryCounts”: 10,
“RetryDelay”: "00:00:10"
}
The DataSync APIs are resilient. If a dependency is temporarily unavailable (for example, authentication services), DataSync will handle it automatically and start working as soon as the dependency is available—no manual action or configuration is required.