Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
Various optimizations can * {{Version|9.0}}: Temporarily disable node copying in node constructors (see {{Option|COPYNODE}} for more details). The following query will be disabled by marking an expression as non-deterministicevaluated faster, and take much less memory, than without pragma, because the database nodes will not be fully copied, but only attached to the new {{Code|xml}} parent element:
countfile:write( 'wrapped-db-nodes.xml', (# basexdb:non-deterministic copynode false #) { 1 to 10 <xml>{ db:open('huge') }</xml> })
→Database Pragmas
=Pragmas=
==BaseX Pragmas== Many optimizations in BaseX will only be performed if an expression is ''deterministic'' (i. e., if it always yields the same output and does not have side effects). By flagging an expression as non-deterministic, optimizations and query rewritings can be suppressed: <pre class="brush:xquery">sum( (# basex:non-deterministic #) { 1 to 100000000})</pre> This pragma can be helpful when debugging your code. ==Database Pragmas== All [[Options|Local local database options]] can be assigned locally via pragmas. Some examples: * {{Version|9.0}}: Enforce query to be rewritten for index access. This can e. g. be helpful if the name of a database is not static (see [[Indexes#Enforce Rewritings|Enforce Rewritings]] for more examples):
<pre class="brush:xquery">
(# db:chop false enforceindex #) { doc for $db in ('doc.xmlpersons1', 'persons2', 'persons3') return db:open($db) //name[text() = 'John']}
</pre>
<pre class="brush:xquery">
</pre>
</pre>
By default, XQuery functions will be ''inlined'' if the query body is not too large and does not exceed the value assigned to a fixed number of expressions, which can be adjusted via the {{Option|INLINELIMIT}} option.
The annotation can be used to overwrite this global limit: Function inlining can be enforced if no argument is specified. Inlining will be disabled if {{Code|0}} is specified.
