MarkLogic Server 11.0 Product Documentationadmin:database-delete
admin:database-delete( $config as element(configuration), $database-ids as xs:unsignedLong* ) as element(configuration)
Summary
This function deletes the configuration from the specified database(s). It does not delete the configuration or data for any forests attached to the deleted database(s).
| Parameters | |
|---|---|
| config | A configuration specification, typically as returned from one of the Admin module functions. |
| database-ids |
The id(s) for the specified database(s) (for example,
xdmp:database("myDatabase")
).
|
Required Privileges
This operation requires at least one of the following privileges:http://marklogic.com/xdmp/privileges/admin/database
http://marklogic.com/xdmp/privileges/admin/database/{id}
Usage Notes
Any database whose ID you pass into this function must not have any appservers targeting it when the transaction begins, otherwise an exception is thrown. If you need to delete the database, make sure no appserver targets the database in a separate transaction before calling this function.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-delete($config, admin:database-get-id($config, "foo"))
=> The new configuration with the specified databases is removed.
Use admin:save-configuration to save these changes.