MarkLogic 9 Product Documentation

xdmp.databaseRestore

xdmp.databaseRestore(
   forestIDs as (Number|String)[],
   pathname as String,
   [restoreToTime as Date?],
   [journal-archiving as Boolean?],
   [journal-archive-path as String?],
   [incremental-backup as Boolean?],
   [incremental-backup-path as String?],
   [backup-passphrase as String?],
   [forest-map as Object?]
) as (Number|String)

Summary

Starts an asynchronous restore of the specified list of destination forests from the backup data directory. Returns a job ID that uniquely identifies the restore task.

Required Privileges

http://marklogic.com/xdmp/privileges/xdmp-database-restore

http://marklogic.com/xdmp/privileges/xdmp-database-restore/database/{id}

Usage Notes

Reindexing will stop while a backup or restore is in progress.

All forests in forestIDs must exist in the current configuration.

$forest-map is a map from the names of destination forests to be restored to the names of backup forests (fd1<-fb1, fd2<-fb2, ...). Please note that there are several constraints on the map:

• There should be exactly one forest in the key of each map entry.
• Keys of the map must be a subset of $forestIDs, otherwise XDMP-FORESTMAPNOTSUBSET will be thrown.
• If some forests in forestIDs are not provided in the keys of the map, they will be self-mapped. Self-mapping means mapping destination forests to backup forests that have the same names.
• There should be zero or more forests in the value of each map entry. When there are zero forests in the value, it means clearing the destination forest, instead of detaching or deleting it.
• There shouldn't be duplicated values in the map (after supplement of self-mapping). Otherwise, XDMP-FORESTMAPDUPVALUE will be thrown.
• If $forest-map is not provided, all forests will by default be self-mapped.
• All backup forests in the value of a map entry must be accessible to the host where the destination forest is located.

Example

xdmp.databaseRestore([11183608861595735720,898513504988507762],
    "/backups/Data")
=> 33030877979801813489

Example

const map = {
    fd1: xdmp.arrayValues(["fb1"]),
    fd2: xdmp.arrayValues(["fb2"]),
    fd3: xdmp.arrayValues(["fb3"])
};
xdmp.databaseRestore(
  xdmp.databaseForests(xdmp.database("db")), "/backups/Data", null, false, "",
    false, "", "", map);
=> 33030877979801813489

Example

const map = {
    fd1: xdmp.arrayValues(["fb1","fb2"]),
    fd2: xdmp.arrayValues(["fb3"]),
    fd3: xdmp.arrayValues([]),
    fd4: xdmp.arrayValues([])
};
xdmp.databaseRestore(
  xdmp.databaseForests(xdmp.database("db")), "/backups/Data", null, false, "",
    false, "", "", map);
=> 33030877979801813489