MarkLogic Server 11.0 Product Documentation

admin:group-set-expanded-tree-cache-partitions

admin:group-set-expanded-tree-cache-partitions(
   $config as element(configuration),
   $group-id as xs:unsignedLong,
   $value as xs:unsignedInt
) as element(configuration)

Summary

This function changes the expanded tree cache partitions setting of the group with the specified ID to the specified value. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. This is a "cold" operation; when you use admin:save-configuration to save the configuration, it will automatically restart MarkLogic Server.

If the Cache Sizing method is set to automatic, enode, or dnode (by means of the admin:group-set-cache-sizing function or the Admin UI), this function sets the expanded tree cache partitions for the group configuration, but it is not used until the Cache Sizing method is set to manual. When the Cache Sizing method is automatic, enode or dnode, MarkLogic will set the cache partitions and ignore any manual settings.

Required Privileges

http://marklogic.com/xdmp/privileges/admin/group

http://marklogic.com/xdmp/privileges/admin/group/{id}

Usage Notes

Example

  xquery version "1.0-ml";

  import module namespace admin = "http://marklogic.com/xdmp/admin"
		  at "/MarkLogic/admin.xqy";

  let $config := admin:get-configuration()
  let $groupid := admin:group-get-id($config, "Default")
  return
  admin:group-set-expanded-tree-cache-partitions($config, $groupid, 2)

  (: returns the new configuration element -- use admin:save-configuration
     to save the changes to the configuration or pass the configuration
     to other Admin API functions to make other changes.  :)