Changes

Database nodes are XML nodes which are either stored in a persistent database , or part of which contained in a so-called ''database fragment''. All XML fragments can be converted to database fragments by e. g. applying the [[XQuery_Update#transform|transform]] expression on an XML fragment:

|Returns a string sequence with The result of this function is dependent on the number of arguments:* Without arguments, the names of all databases:are returned that are accessible to the current user.

* The list of returned resources can be further restricted by the {{Code|$path}} argument.

* {{Code|db:list("docs")}} returns the names of all documents from the of a database named {{Code|docs}}.

|Without arguments, an element is returned for each database that is accessible to the current user:* If no argument is specifiedAn element has a value, a sequence of elements which is returned. A single element contains the name of a the database, and several attributes, which contain the number of stored resources, the modification date of modification, the database size on disk (measured in bytes), and a path to the original database pathinput.* If a database {{Code|$db}} is specified, a sequence an element for each documents and raw file of elements the specified database is returned, comprising information on all resources of the addressed database. :* An element contains has a value, which is the name of the resource, and several attributes, which contain the content type, the modified modification date, the raw flag (which indicates if the resource is binary or XML), and the size of a resource.* For binary resources, The value of the size is attribute depends on the resource type: for documents, it represents the number of bytesnodes; for document resourcesbinary data, it represents the file size is the number of nodes(measured in bytes).

* {{Code|db:list-details("docsshop")}} returns the names plus additional data info on all resources of all documents from the a database named {{Code|docsshop}}.

** strings may can be a URI pointing to a file/directory references, or an XML strings string (which are is detected by the leading <code>&lt;</code> character)

* The parsing and indexing behavior can be controlled via {{Code|$options}} argument can be used to change the indexing behavior:** the allowed options are {{Option|ADDCACHE}} and the [[Options#Indexing|indexing]], [[Options#Full-TextIndexing|full-textindexing]], [[Options#Parsing|parsing]] and [[Options#XML Parsing|XML parsing]] options, all in lower case.** the parsing options are will only applied to impact string input (URIs, XML strings or file/directory references), because nodes have already been parsed.* An existing database will be overwritten. Next, {{Code|db:create}} will be placed last on the * Database creation takes place after most other update operations (see [[XQuery Update#Pending Update List|Pending Update List]]). As a consequence, a newly created database cannot be addressed in the same query.

* For more information on the arguments, see See [[#db:create|db:create]] (note that for more details on the specified input argument.* The parsing behavior can be controlled via {{Code|$options}}:** allowed options cannot be are {{Option|ADDCACHE}} and the [[Options#IndexingParsing|indexingparsing]] and [[Options#Full-TextXML Parsing|full-textXML parsing]] options, all in lower case** parsing options will only impact string input (URIs, XML strings)., because nodes have already been parsed

* {{Code|<code>db:add("DB", "/home/dir/doc.xml")}} </code> adds the file {{Code|/home/dir/doc.xml}} to the database {{Code|DB}}.* {{Code|<code>db:add("DB", <a/>, "doc.xml")}} </code> adds a document node to the database {{Code|DB}} under the name {{Code|doc.xml}}.* {{Code|<code>db:add("DB", "/home/dir", "docs/dir", map { 'addcache': true()}} )</code> adds all documents in {{Code|/home/dir}} to the database {{Code|DB}} under the path {{Code|docs/dir}}. In order to reduce memory consumption, the files will be cached before being added to the database.

|{{Func|db:copy|$db as xs:string, $newname name as xs:string|empty-sequence()}}

|Creates a copy of the database specified by {{Code|$db}} to , which will be called {{Code|$newnamename}}.

|{{Func|db:alter|$db as xs:string, $newname name as xs:string|empty-sequence()}}

|Renames the database specified by {{Code|$db}} to {{Code|$newnamename}}.

* See [[#db:addcreate|db:addcreate]] for more details on the arguments input argument.* The parsing behavior can be controlled via {{Code|$options}}:** allowed options are {{Option|ADDCACHE}} and the [[Options#Parsing|parsing]] and [[Options#XML Parsing|XML parsing]] options, all in lower case** parsing options will only impact string input (for URIs, XML strings), because nodes have already been parsed* For historical reasons, the order of the 2nd and 3rd argument differs!).is different to [[#db:add|db:add]] and [[#db:create|db:create]]

|Stores Replaces a binary resource specified by {{Code|$input}} in the database {{Code|$db}} and the location specified by {{Code|$path}}, or adds it as new resource.