Database Module - Revision history

CG: /* db:export */

2023-12-01T21:07:51Z

db:export

CG at 21:07, 1 December 2023

2023-12-01T21:07:32Z

CG: /* Database Nodes */

2023-12-01T16:58:48Z

Database Nodes

CG: /* Errors */

2023-12-01T16:41:16Z

Errors

CG: /* Errors */

2023-12-01T16:40:57Z

Errors

CG: Text replacement - "" to "

2023-12-01T16:36:58Z

Text replacement - "<syntaxhighlight lang="xquery">" to "<pre lang='xquery'>"

CG: Text replacement - "" to ""

2023-12-01T16:32:51Z

Text replacement - "</syntaxhighlight>" to "</pre>"

CG at 16:28, 1 December 2023

2023-12-01T16:28:03Z

CG at 10:23, 26 October 2023

2023-10-26T10:23:06Z

CG at 10:13, 26 October 2023

2023-10-26T10:13:48Z

@@ Line 325: / Line 325: @@
 |- valign="top"
 | '''Summary'''
-|Exports the specified {{Code|$database}} to the specified file {{Code|$path}}. Existing files will be overwritten.<br/>The {{Code|$options}} argument contains [[Serialization|serialization parameters]] (see [https://www.w3.org/TR/xpath-functions-31/#func-serialize fn:serialize()]).
+|Exports the specified {{Code|$database}} to the specified file {{Code|$path}}. Existing files will be overwritten.<br/>The {{Code|$options}} argument contains [[Serialization|serialization parameters]] (see [https://www.w3.org/TR/xpath-functions-31/#func-serialize fn:serialize]).
 |- valign="top"
 | '''Errors'''

@@ Line 729: / Line 729: @@
+|
 * {{Code|db:rename("DB", "docs/dir/doc.xml", "docs/dir/newdoc.xml")}} renames the resource {{Code|docs/dir/doc.xml}} to {{Code|docs/dir/newdoc.xml}} in the database {{Code|DB}}.
-* {{Code|db:rename("DB", "docs/dir", "docs/newdir")}} moves all resources in the database {{Code|DB}} from {{Code|docs/dir}} to {Code|docs/newdir}}.
+* {{Code|db:rename("DB", "docs/dir", "docs/newdir")}} moves all resources in the database {{Code|DB}} from {{Code|docs/dir}} to {{Code|docs/newdir}}.
 |}

@@ Line 9: / Line 9: @@
 In BaseX, two internal representations exist for XML nodes:
-* Database nodes are:
+. Database nodes are:
-** stored in a persistent database on disk;
+* stored in a persistent database on disk;
-** nodes of a document that has been generated temporarily with {{Code|fn:doc}}, {{Code|fn:parse-xml}} and other functions; or
+* nodes of a document that has been generated temporarily with {{Code|fn:doc}}, {{Code|fn:parse-xml}} and other functions; or
-** the result of a [[XQuery Update#Main-Memory Updates|main-memory update]].
+* the result of a [[XQuery Update#Main-Memory Updates|main-memory update]].
-* Fragments are similar to DOM structures. They are created when XQuery node constructors are used (<code><a/></code>, <code>element a { }</code>, etc.).
+. Fragments are similar to DOM structures. They are created when XQuery node constructors are used (<code><a/></code>, <code>element a { }</code>, etc.).
 Fragments require less memory for small XML structures, but database nodes are more efficient for larger amounts of data. Fragments nodes can be converted to database nodes by applying a [[XQuery_Update#Main-Memory Updates|main-memory update]] with an empty body to a node:

@@ Line 976: / Line 976: @@
 {| class="wikitable" width="100%"
 ! width="110"|Code
-! Description
+| Description
 |- valign="top"
 |{{Code|args}}

@@ Line 976: / Line 976: @@
 {| class="wikitable" width="100%"
 ! width="110"|Code
-|Description
+! Description
 |- valign="top"
 |{{Code|args}}

@@ Line 17: / Line 17: @@
 Fragments require less memory for small XML structures, but database nodes are more efficient for larger amounts of data. Fragments nodes can be converted to database nodes by applying a [[XQuery_Update#Main-Memory Updates|main-memory update]] with an empty body to a node:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 <xml>hello world</xml> update { }
 </pre>
@@ Line 332: / Line 332: @@
 | '''Examples'''
 | Export all files as text:<br/>
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 db:export("DB", "/home/john/xml/texts", map { 'method': 'text' })
 </pre>
 The following code can be used to export parts of the database:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 let $target := '/home/john/xml/target'
 for $doc in db:get('DB', 'collection')
@@ Line 557: / Line 557: @@
 * {{Code|db:put("DB", document { <a/> }, "docs/dir/doc.xml")}} replaces the content of the document {{Code|docs/dir/doc.xml}} in the database {{Code|DB}} with the specified document node.
 The following query can be used to import files from a directory to a database:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 let $source := '/home/john/xml/source'
 for $file in file:list($source, true())
@@ Line 587: / Line 587: @@
 * {{Code|db:put-binary('DB', file:read-binary('video.mov'), 'video/sample.mov')}} stores the addressed video file at the specified location.
 * With the following query, you can copy the binary resources of one database into another:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 let $db := 'db'
 let $src-path := 'src/'
@@ Line 619: / Line 619: @@
 * {{Code|db:put-value('DB', 1 to 10000, 'sequence')}} stores a numeric range in the database.
 * With the following query, a map with countries and associated cities is stored in a database. The value resource can e.g. be used as index in future queries:
-<syntaxhighlight lang="xquery">
+<pre lang='xquery'>
 db:put-value(
    'factbook',

@@ Line 19: / Line 19: @@
 <syntaxhighlight lang="xquery">
 <xml>hello world</xml> update { }
-</syntaxhighlight>
+</pre>
 ==Updating Functions==
@@ Line 334: / Line 334: @@
 <syntaxhighlight lang="xquery">
 db:export("DB", "/home/john/xml/texts", map { 'method': 'text' })
-</syntaxhighlight>
+</pre>
 The following code can be used to export parts of the database:
 <syntaxhighlight lang="xquery">
@@ Line 344: / Line 344: @@
    file:write($path, $doc)
+)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 563: / Line 563: @@
 where not(file:is-dir($path))
 return db:put('db', doc($path), $file)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 595: / Line 595: @@
 let $trg := $trg-path || substring-after($src, $src-path)
 return db:put-binary($db, db:get-binary($db, $src), $trg)
-</syntaxhighlight>
+</pre>
 |}
@@ Line 627: / Line 627: @@
    ),
    'cities'
-)</syntaxhighlight>
+)</pre>
 |}

@@ Line 173: / Line 173: @@
 ==db:get==
 {| width='100%'
@@ Line 198: / Line 196: @@
 ==db:get-pre==
 {| width='100%'
@@ Line 221: / Line 217: @@
 ==db:get-id==
 {| width='100%'
@@ Line 240: / Line 234: @@
 ==db:get-binary==
 {| width='100%'
@@ Line 265: / Line 257: @@
 ==db:get-value==
 {| width='100%'
@@ Line 540: / Line 530: @@
 ==db:put==
 {| width='100%'
@@ Line 579: / Line 567: @@
 ==db:put-binary==
 {| width='100%'
@@ Line 613: / Line 599: @@
 ==db:put-value==
 {| width='100%'
@@ Line 785: / Line 769: @@
 =Backups=
 All functions in this section except for {{Function||db:backups}} are {{Function|Database|Updating Functions}}.
 ==db:create-backup==
 {| width='100%'

← Older revision		Revision as of 10:13, 26 October 2023
Line 949:		Line 949:

	==db:type==		==db:type==
−
−	~~{{Announce\|Introduced with BaseX 10:}} Replaces {{Code\|db:is-raw}} and {{Code\|db:is-xml}}.~~

	{\| width='100%'		{\| width='100%'