Options
Jump to navigation
Jump to search
This page is linked from the Getting Started Section.
The options listed on this page can be requested with the GET command and changed with the SET command. Three data types exist: strings, numbers, and booleans, which can be turned ON and OFF. If options are internally changed by the GUI of BaseX, they will be listed in the Info View.
A preview page contains all options offered by the latest stable snapshot.
Contents
Main Options
The main options are only available in the standalone and server instance of BaseX; they cannot be changed by database clients:
LANG
Signature | LANG [language]
|
Summary | Set the interface language. Currently, seven languages are available: 'English', 'German', 'French', 'Dutch', 'Italian', 'Japanese', and 'Vietnamese' (default: English ). BaseX needs to be restarted in order to activate the new language.
|
LANGKEY
Signature | LANGKEY
|
Summary | Prefix all texts with the internal language keys. This option is helpful for creating new translations. BaseX needs to be restarted in order to activate this option. |
DBPATH
Signature | DBPATH [path]
|
Summary | Set a new database path (default: {home}/BaseXData ). Note: if the database path is changed, existing databases have to be manually moved to the new location.
|
REPOPATH
Signature | REPOPATH [path]
|
Summary | this path points to the XQuery package repository (default: {home}/BaseXRepo ).
|
PARALLEL
Signature | PARALLEL [number]
|
Summary | Set the maximum number of parallel readers (default: 8 ).
|
DEBUG
Signature | DEBUG
|
Summary | Show internal debug info, usually used for development of new features (default: false ).
|
Client/Server Architecture
HOST
Signature | HOST [host]
|
Summary | Used by the client to connect the server (default: localhost ).
|
PORT
Signature | PORT [port]
|
Summary | Used by the client to connect the server (default: 1984 ).
|
SERVERPORT
Signature | SERVERPORT [port]
|
Summary | Port of the database server (default: 1984 ).
|
EVENTPORT
Signature | EVENTPORT [port]
|
Summary | Port of the client, listening for server events. This port is only used if a client attaches itself to a database event (default: 1985 ).
|
JAXRXPORT
Signature | JAXRXPORT [port]
|
Summary | Port of the JAX-RX web server, usually Jetty (default: 8984 ).
|
JAXRXPATH
Signature | JAXRXPATH [path]
|
Summary | This local path points to the JAX-RX web directory (default: {home}/BaseXWeb ).
|
TIMEOUT
Signature | TIMEOUT [time]
|
Summary | Server timeout in seconds. The timeout describes the maximum execution time of a client query. The timeout is deactivated if time is set to 0 (default: no timeout (0 )).
|
Database Options
CHOP
Signature | CHOP
|
Summary | Chop all leading and trailing whitespaces from text nodes while building a database, and discard empty text nodes. This option often reduces the database size by up to 50% (default: true ).
|
INTPARSE
Signature | INTPARSE
|
Summary | Use internal XML parser instead of the standard Java XML parser. The internal parser is faster, more fault tolerant and supports common HTML entities out-of-the-box, but it does not support all features needed for parsing DTDs. (default: false ).
|
DTD
Signature | DTD
|
Summary | Parse referenced DTDs and resolve XML entities (default: false ).
|
CATFILE
Signature | CATFILE [path]
|
Summary | Specify a catalog file to locally resolve DTDs; see the Wikipedia entry on XML Catalogs for more details (default: empty). |
CREATEFILTER
Signature | CREATEFILTER [filter]
|
Summary | Globbing syntax for filtering input documents (default: *.xml ).
|
ADDARCHIVES
Signature | ADDARCHIVES
|
Summary | Parse files within archives (ZIP, DOCX, GZIP, etc.) while creating a database or adding new documents (default: true ).
|
SKIPCORRUPT
Signature | SKIPCORRUPT
|
Summary | Skip corrupt (i.e., non-well-formed) files while creating a database or adding new documents. If this option is used, database creation is slowed down, as all files will be parsed twice. Next, main memory consumption will be higher as parsed files will be cached in main memory (default: false ).
|
PARSER
Signature | PARSER [type]
|
Summary | Define import parser. As TYPE are available 'XML', 'CSV' or 'TEXT'. If Tagsoup is found in the classpath, 'HTML' is also available (default: XML ).
|
PARSEROPT
Signature | PARSEROPT [options]
|
Summary | Define parser-specific options (default: empty). See parsers page for more information. |
PATHINDEX
Signature | PATHINDEX
|
Summary | Create index for paths and speedup path based queries (default: true ).
|
TEXTINDEX
Signature | TEXTINDEX
|
Summary | Create index for text nodes and speedup queries querying the entire text of a node (default: true ).
|
ATTRINDEX
Signature | ATTRINDEX
|
Summary | Create index for attribute values and speedup queries querying attribute values (default: true ).
|
FTINDEX
Signature | FTINDEX
|
Summary | Create index for fulltext and speedup queries querying full text (default: false ).
|
WRITEBACK
Signature | WRITEBACK
|
Summary | Write original files back after updates. As this will alter your input file make sure you have a backup before you use this option (default: false ).
|
MAINMEM
Signature | MAINMEM
|
Summary | Use main-memory mode. Now all data is exclusively stored in main memory. Some queries will be evaluated even faster, but the data is lost if BaseX is shut down (default: false ).
|
FORCECREATE
Signature | FORCECREATE
|
Summary | Force database creation for unknown documents specified in XQuery expressions (default: false ).
|
Full-Text Options
WILDCARDS
Signature | WILDCARDS
|
Summary | Create wildcard optimized full text index that is especially tuned for querying full text using wildcards expressions (default: false ).
|
STEMMING
Signature | STEMMING
|
Summary | Stemm full text tokens before indexing and decrease index size. Should only be assigned for full text queries using stemming, otherwise the full text index could not be assigned for query speedups (default: false ).
|
CASESENS
Signature | CASESENS
|
Summary | Case sensitive full text indexing, i.e. full text tokens are stored case sensitive and enables the assignment of the full text index for case sensitive queries (default: false ).
|
DIACRITICS
Signature | DIACRITICS
|
Summary | Diacritic sensitive full text indexing, i.e. full text tokens are stored with diacritics and enables the assignment of the full text index for diacritic queries (default: false ).
|
LANGUAGE
Signature | LANGUAGE [lang]
|
Summary | Language for full-text search index, e.g. LANG can be set to English or German (default: empty).
|
SCORING
Signature | SCORING [mode]
|
Summary | Precalculation of full text scores and storage within the full text index structure. Enables TF/IDF based scores in full text queries and increases memory consumption while indexing. MODE can be set to 1 for document based scoring, 2 for text node based scoring and 0 for non scoring (default: 0 ).
|
STOPWORDS
Signature | STOPWORDS [path]
|
Summary | Specify stop word list at PATH , that could be used e.g. to decrease the full text index size. The standard stopword list (english) is provided at 'etc/xml/stopWords' (default: empty).
|
LSERROR
Signature | LSERROR [error]
|
Summary | Levenshtein default error used for fuzzy search with BaseX specialized own FTMatchOption, e.g. error could be 2 (default: 0 ).
|
Query Options
QUERYINFO
Signature | QUERYINFO
|
Summary | Show (all) process info (default: false ).
|
QUERY3
Signature | QUERY3
|
Summary | Enable/disable XQuery 3.0 functions (default: true ).
|
SERIALIZE
Signature | SERIALIZE
|
Summary | Flag for serialization of query results. I.e. there are any results printed if serialization is turned off (default: true ).
|
BINDINGS
Signature | BINDINGS [vars]
|
Summary | Contains external variables to be bound to the query. Keys and values are separated by equality signs, multiple variables are separated by commas (default: empty). |
SERIALIZER
Signature | SERIALIZER [params]
|
Summary | Parameters for serializing queries; see Serialization for more details. Keys and values are separated by equality signs, multiple parameters are separated by commas (default: empty). |
EXPORTER
Signature | EXPORTER [params]
|
Summary | Parameters for exporting the documents; see Serialization for more details. Keys and values are separated by equality signs, multiple parameters are separated by commas (default: empty). |
RUNS
Signature | RUNS [num]
|
Summary | Specify number of runs a query is executed. Results are printed a single time and evaluation times are averages of all runs (default: 1 ).
|
Serialization Options
DOTPLAN
Signature | DOTPLAN
|
Summary | Create query plans visualized with dotty, see 'plan.dot' file in your project folder (default: false ).
|
DOTCOMPACT
Signature | DOTCOMPACT
|
Summary | Compact dot representation (default: false ).
|
DOTDISPLAY
Signature | DOTDISPLAY
|
Summary | Display dot representation after query execution (default: true ).
|
DOTTY
Signature | DOTTY [path]
|
Summary | Program PATH of dotty executable (default: dotty ).
|
XMLPLAN
Signature | XMLPLAN
|
Summary | Print query plan as xml document (default: false ).
|
COMPPLAN
Signature | COMPPLAN
|
Summary | Create query plan before or after compilation - query plan might change due to optimizations (default: true ).
|
CACHEQUERY
Signature | CACHEQUERY
|
Summary | Cache the query results (default: false ).
|
MAXSTAT
Signature | MAXSTAT [num]
|
Summary | Set maximum number of index occurrences to print through the command info index (default: 15 ).
|