Usage instructions

Single-threaded vs multi-threaded operation

Users may start PiCO_QL in the same thread as the application (single-threaded) or in a separate thread. In the former case, PiCO_QL has to be compiled with PICO_QL_SINGLE_THREADED flag enabled. In the latter, it has to be compiled with PICO_QL_JOIN_THREADS compile flag enabled. In a happy day scenario pico_ql_serve() returns 101 (SQLITE_DONE).

Using PiCO QL

In production mode (PICO_QL_TEST not defined) PICO QL opens a port at localhost where the SWILL web interface is listening for query requests. Opening a browser at this address reveals the query interface. The port number is provided as an argument to pico_ql_serve(). A usual port number is 8080.

Updating virtual table definitions

Users may update table definitions in the DSL, execute the generator, re-compile and execute the application.