
MarkLogic 10 Product Documentation
admin:database-one-time-incremental-backupadmin:database-one-time-incremental-backup(
   $backup-dir as xs:string,
   $start as xs:dateTime,
   $backup-security-db as xs:boolean,
   $backup-schemas-db as xs:boolean,
   $backup-triggers-db as xs:boolean,
   [$include-replicas as xs:boolean],
   [$incremental-dir as xs:string?],
   [$purge-journal-archive as xs:boolean?],
   [$journal-archiving as xs:boolean?],
   [$journal-archive-path as xs:string?],
   [$lag-limit as xs:unsignedLong?]
) as element(db:database-backup)
Summary
This function constructs a one-time incremental backup specification.
	  
	  
	
	  
	    | Parameters | 
	  
	
	  
	    | backup-dir | 
	    
	The directory where the full backup is located. | 
	  
	  
	    | start | 
	    
	The starting dateTime of the scheduled incremental backup. | 
	  
	  
	    | backup-security-db | 
	    
	Whether to backup the security database alongside the current incremental backup. | 
	  
	  
	    | backup-schemas-db | 
	    
	Whether to backup the schemas database alongside the current incremental backup. | 
	  
	  
	    | backup-triggers-db | 
	    
	Whether to backup the triggers database alongside the current incremental backup. | 
	  
	  
	    | include-replicas | 
	    
    If set to false, do not include the replicas in
	      the incremental backup.  The default is true, which means to
	      include all replicas in the incremental backup. | 
	  
	  
	    | incremental-dir | 
	    
    The directory in which to save the incremental backup. | 
	  
	  
	    | purge-journal-archive | 
	    
     Whether or not to purge journal archive after incremental backup is performed.
     Defaults to false  | 
	  
	  
	    | journal-archiving | 
	    
     Whether or not to enable journal archiving. Defaults to false. | 
	  
	  
	    | journal-archive-path | 
	    
    Path for where archived journals are stored. Defaults to the backup data directory. | 
	  
	  
	    | lag-limit | 
	    
    Maximum difference in seconds that the archived journal can lag behind its forest's active journal. Defaults to 900. | 
	  
	
Example
xquery version "1.0-ml";
import module namespace admin = "http://marklogic.com/xdmp/admin"
      at "/MarkLogic/admin.xqy";
admin:database-one-time-incremental-backup("/backup-dir",
        xs:dateTime("2014-07-14T09:45:00"),true(),true(),true())
  (: returns the one-time incremental backup :)
    
  
    Copyright © 2025 MarkLogic Corporation. MARKLOGIC is a
    registered trademark of MarkLogic Corporation.