Changes

Jump to navigation Jump to search
2,278 bytes added ,  13:40, 1 April 2019
m
This page is part of the [[Getting Started]] Section.
BaseX offers a standalone (embedded) console mode from in which all [[Commands|database commands]] can be executedfrom the command line or console.The article on the [[Database Server]] provides numerous examples for running commands in the console standalone mode.(note Note that the GUI standalone mode does ''not'' interact with the client/server architecture.).
==Startup==First of all, please launch a '''standalone''' version of BaseX: double click on the '''BaseX''' icon, or run the <code>basex</code> script. [[Startup#BaseX Standalone|Follow this link]] for more information (or check out the additional [[Startup Options#BaseX Standalone|command-line options]]).
==Working with the First of all, launch a '''standalone''' version of BaseX Console== After : double click on the '''BaseX Console has been started, ''' icon (Windows only) or run the <code>HELPbasex</code> command can be used script. Click on the following links toto list all find more information on [[Startup#Standalone_Mode|starting the standalone mode]], [[Start_Scripts#Standalone|the standalone mode's start script]] or [[CommandsCommand-Line_Options#Standalone|database commandsthe standalone mode's command-line options]]. Multiple commands can be separated by semicolons.
To evaluate commands without entering the console mode, you can use the<code>-c</code> option on the command line: <pre>basex -Vc "CREATE DB input <example/>; XQUERY /"=Create a Database=
Database 'input' created * To create a database you need an XML document, e.g. [http://files.basex.org/xml/factbook.xml factbook.xml].* Save this document to your working directory.* Type in 124.95 msthe following command to create and open the database:<code>> [[Commands#CREATE DB|CREATE DB]] factbook factbook.xml<example/code>
Query: '''factbook''' is the name of the database <br/>: '''factbook.xml''' is the initial input of the database<br/>
Compiling:; Where is the database stored?
Result: root()By default, databases are stored in the <code>basex/data</code> directory, which is located in your home folder.Depending on your [[Configuration]], the location of your home folder varies. For example, on a Mac it's <code>/Users/John</code>, if your name is John.
Parsing: 0.42 msCompiling: 9.3 msEvaluating: 0.35 msPrinting: 5.53 msTotal Time: 15.62 ms=Execute a Query=
Hit(s): 1 ItemThe [[Commands#XQUERY|XQUERY]] command lets you run a query.Updated: 0 Items* For example, the following query returns all country nodes in the currently opened factbook database.Printed: 10 Bytes<code>> [[Commands#XQUERY|XQUERY]] //country</code>
Query executed * You can also run queries in 15.62 msfiles:<code>> [[Commands#RUN|RUN]] /Users/John/query.xq</precode>
All available command-line options can be found [[Startup Options#BaseX Standalone|here]].=Database Commands=
* The following command lists all databases than can be opened by the currently logged in user:<code>> [[Commands#LIST|LIST]]</code> * To open an existing database, execute the following:<code>> [[Commands#OPEN|OPEN]] factbook</code> * To get information on the currently opened database, type:<code>> [[Commands#INFO|INFO]]</code> * You can also address a database within your query with the [[Database Module#db:open|db:open]] function:<code>> [[Commands#XQUERY|XQUERY]] db:open("factbook")//country</code> * To [[Commands|close]] the current database, please type: <code>> [[Commands#CLOSE|CLOSE]]</code> * Use the [[Commands#DROP DB|DROP DB]] command to delete a database:<code>> [[Commands#DROP DB|DROP DB]] factbook</code> =Multiple Resources=See  One database can contain not only a single, but millions of documents. All documents can have a different structure. With the following commands, you can create an empty database and add two documents. It is also ==possible to address resources via URLs: <code>> [[Commands#CREATE DB|CREATE DB]] store</code><br/><code>> [[Commands#ADD|ADD]] factbook.xml</code><br/><code>> [[GUICommands#ADD|ADD]]http://files.basex.org/xml/xmark.xml</code> * Deleting a document from a database is easy, but make sure that the database, which contains the addressed document, is currently opened:<code>> [[Database ServerCommands#DELETE|DELETE]]factbook.xml</code> =Backup and Restore= * To backup your database, type:<code>> [[Getting StartedCommands#CREATE BACKUP|CREATE BACKUP]]factbook</code> * To restore your database, type:<code>> [[CategoryCommands#RESTORE|RESTORE]] factbook</code> The backup file is stored in the database directory.It contains the name of the database and a timestamp:Beginner<code>[db-name]-[timestamp].zip</code>.If a database is to be restored, and if several backups exist, the backup with the newest timestamp is taken.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu