ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / Managing databases / HFSQL / Managing HFSQL Client/Server
  • Overview
  • Restoring a backup in the HFSQL Control Center
  • Restoring a backup programmatically
  • To restore a database backup
  • Tip: Use a backup to copy and rename a database
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Restoring an HFSQL Client/Server database
HFSQL Client/ServerAvailable only with this kind of connection
Overview
A backup of an HFSQL Client/Server database can be restored at any time:
  • if the backup performed is a full backup, all you have to do is restore this backup.
  • if the backup performed is a differential backup, all you have to do is restore the full backup and the associated differential backup.
Reminder A differential backup contains all changes made since the previous full backup.
The restore operation can be triggered:
Caution: Restoring a backup should be carried out with care.
  • To perform this operation, you must have the rights to perform a backup (hRightsBackup constant) as well as the rights to lock the database (hRightsLock constant).
  • To restore the entire server (or the __jnl and __trs databases), no other application must be connected to the server. The connection used must not be attached to a database.
  • To restore databases only, there must be no connection on the database to restore.
Remarque: Making a backup and restoring it under another name is a simple way of duplicating a database.
Restoring a backup in the HFSQL Control Center
To restore a backup:
  1. Select the HFSQL Client/Server server in the tree structure on the left of the screen.
  2. Select the "Backups" tab.
  3. In the table of existing backups, select the backup to restore.
  4. In the backup context menu, select "Restore". The restoration wizard starts.
  5. Validate the restore operation.
Remarks:
  • It is also possible to restore a backup present in a specific directory on the server: in the ribbon, in the "Backups" group, pull down "Restore" and select "Restore a backup from a directory".
  • It is also possible to restore a backup present in a zip file: in the ribbon, in the "Backups" group, pull down "Restore" and select "Restore a backup from a zip file".
  • Warning If the backup is restored to a network drive (UNC or network drive letter), the user must have the necessary rights.
    In this case, to perform the restore operation:
    • specify a UNC path for the backup location,
    • modify the properties of the HFSQL Client/Server server via the Windows service manager by specifying a user who has the necessary rights in order to access the UNC location containing the backup.
Restoring a backup programmatically

To restore a database backup

Use the HRestoreBackup function.

Tip: Use a backup to copy and rename a database

To copy and rename a database, you have the ability to use the following tip:
  1. Perform the backup the database.
  2. Restore the database backup under a different name.
This operation can be performed with HRestoreBackup.
Minimum version required
  • Version 15
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help