MarkLogic 12 EA 1 Product Documentation

admin:database-set-large-size-threshold

admin:database-set-large-size-threshold(
   $config as element(configuration),
   $database-id as xs:unsignedLong,
   $value as xs:unsignedInt
) as element(configuration)

Summary

This function sets the threshold at which binary documents in the specified database should be handled as binary large objects (BLOBs). Binary documents less than or equal to the threshold are treated as small binary objects, stored in stands. Binary documents larger than the threshold are stored in the Large Data Directory for more efficient memory consumption.

Required Privileges

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

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

http://marklogic.com/xdmp/privileges/admin/database/index

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

Usage Notes

The threshold value is in kilobytes and must be in the range:

• 32 KB <= threshold <= 512 MB on 64-bit systems
• 32 KB <= threshold <= 128 MB on 32-bit systems

The location of the Large Data Directory may be configured during forest creation by setting the "large data directory" property on the Forest configuration page of the Admin Interface, or by passing a large-data-directory parameter to admin:forest-create.

Example

  xquery version "1.0-ml";

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

  let $config := admin:get-configuration()
  return
  admin:database-set-large-size-threshold($config, xdmp:database("myDatabase"),
      2048)

  (: 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.  :)