
MarkLogic 10 Product Documentation
admin.databaseForeignReplicaadmin.databaseForeignReplica(
   foreign-cluster-id as (Number|String),
   foreign-database-id as (Number|String),
   connect-forests-by-name as Boolean,
   lag-limit as Number,
   [replication-enabled as Boolean],
   [queue-size as Number]
) as element(db.foreignReplica)
Summary
  This function returns a replica database configuration.  Use the output of
  this function in the 
  admin.databaseSetForeignReplicas
  function to place the replica database configuration into the cluster
  configuration.
  
	  
	  
	
	  
	    | Parameters | 
	  
	
	  
	    | foreign-cluster-id | 
	    
    The ID of the foreign cluster containing the replica database.
     | 
	  
	  
	    | foreign-database-id | 
	    
    The ID of the replica database.
     | 
	  
	  
	    | connect-forests-by-name | 
	    
    Boolean that indicates whether to connect to forests by name.  If
    fn:true, forests will automatically connect to/from foreign
    forests of the same name. If false, forests must be
    individually
    configured to replicate to/from foreign forests. Individual forest settings
    override the database level setting.
     | 
	  
	  
	    | lag-limit | 
	    
    This parameter controls how far (in seconds) the replica may fall
    behind before the master stops accepting updates.
    If contact with the foreign cluster is lost, a warning will be logged and
    master forests will permit updates to proceed with no enforcement of the
    lag limit.
     | 
	  
	  
	    | replication-enabled | 
	    
    This parameter controls if replication is enabled. Set to true
    to enable, false to disable.
     | 
	  
	  
	    | queue-size | 
	    
	This parameter specifies the number of frames in the queue for foreign
	replication, or the number of fragments if you are doing bulk replication.
	The default is 10.
	 | 
	  
	
Example
  
  const admin = require('/MarkLogic/admin.xqy');
  const fdb = 7746794057802787479
  const cfg = admin.getConfiguration()
  const fcl = admin.clusterGetForeignClusterId(cfg, "ClusterA")
  admin.databaseForeignReplica(fcl, fdb, fn.true(), 300)
   //Returns the replica database configuration. Use the
//admin.databaseSetForeignReplicas function to set the confirguration. 
    
  
    Copyright © 2025 MarkLogic Corporation. MARKLOGIC is a
    registered trademark of MarkLogic Corporation.