Skip to content

Latest commit

 

History

History
76 lines (45 loc) · 3.07 KB

README.md

File metadata and controls

76 lines (45 loc) · 3.07 KB
Raw

Tests

squel

A useless row-oriented SQL query engine written to understand something about query processing.

With it, you can:

  1. Run SQL-queries on CSV-files
  2. Store and query TDB-files (see below)

Design

The system is implemented using the iterator / volcano processing model where each relational operator implements a getTuple function. Each operator in the query plan calls getTuple of it's children and after processing it, passes the tuple to it's parent (if any).

There are three subsystems:

  • The parser which is responsible for parsing the raw sql-query into a parse tree describing the query
  • The planner which is responsible for composing a query plan of the parse tree consisting of relational operators and binding identifiers to data
  • The executor which is responsible for executing the query described by the query plan. Execution means iterating over the operators.

SQL-support

The query engine has support for some basic SQL-features like:

  • Aggregation (COUNT,AVG,SUM)
  • Joins (atm only inner join between two tables)
  • Subqueries
  • Filtering (WHERE-clauses)
  • CREATE TABLE and INSERT INTO statements

This is about as complicated as it can get.

SELECT COUNT(unemployed)
FROM (
    SELECT lt.long_term_unemployed,lt.time,u.unemployed
    FROM
    './test/data/lt_unemployed.csv' AS lt 
    JOIN
    './test/data/unemployed.csv' AS u
        ON u.time=lt.time
)
WHERE long_term_unemployed > 10000 OR unemployed > 50000

See ./test/ for further examples.

Memory management & storage

A table can be persisted in the custom tdb-file format. It consists of a header (describing the table: column types, names, etc.) and the actual data. The data is stored in a contiguous block where each record is of fixed size.

During query execution, a tuple is represented in memory in the same format. A column can be extracted from the block using an offset and datatype information. Queries on plaintext files are converted to the same format (and thus are slower than queries on .tdb-files).

Thanks to the iterator model, the system needs to maintain only a ~single tuple in memory at a time during execution. This means that querying a 1KB table consumes as much memory as querying 1GB table (assuming the same table definition).

An exception to this is joins (and other blocking operators). Atm the inner table of the join is stored in memory in it's entirety. So one must be careful when crafting the query (choose the smaller table as the inner table).

See test/test_tdb.bats for an example of how to create and insert into a tdb-table and src/include/io/tdb.h for a brief description of the file layout.

Building

Simply run make to build under ./build:

make

This should able you to run the following query:

./build/squel "SELECT * FROM './test/data/small.csv'"

For running tests / cleaning up, you can do:

make tests
make clean