Parser used for BeeDB, mainly forked from Hyrise SQL Parser (https://github.com/hyrise/sql-parser).
Go to file
Nan Xiao 165583a60b Print exprList in printOperatorExpression 2017-08-03 14:55:44 +08:00
benchmark Add tokenize method to SQLParser to output the list of tokens (#54) 2017-07-21 02:47:45 +02:00
docs Documentation & Result Move Constructor (#39) 2017-04-21 16:15:07 +02:00
example Add tokenize method to SQLParser to output the list of tokens (#54) 2017-07-21 02:47:45 +02:00
hyrise cleaned up documentation 2016-02-27 16:58:51 +01:00
src Print exprList in printOperatorExpression 2017-08-03 14:55:44 +08:00
test Add tokenize method to SQLParser to output the list of tokens (#54) 2017-07-21 02:47:45 +02:00
.gitignore Many updates to grammar including support for arrays, ilike, natural joins with no predicates... (#49) 2017-07-26 19:09:02 +02:00
.travis.yml Add tokenize method to SQLParser to output the list of tokens (#54) 2017-07-21 02:47:45 +02:00
LICENSE Switch to MIT License (#52) 2017-07-07 17:43:44 +02:00
Makefile Support build static library in Makefile. 2017-07-28 15:49:38 +08:00
README.md Add tokenize method to SQLParser to output the list of tokens (#54) 2017-07-21 02:47:45 +02:00
astyle.options change indent to spaces=2 and indent access modifiers. minor style changes 2017-02-08 02:16:52 +01:00

README.md

C++ SQL Parser

GitHub release Build Status

This is a SQL Parser for C++. It parses the given SQL query into C++ objects. It has been developed for integration in Hyrise, but can be used perfectly well in other environments as well.

In March 2015 we've also written a short paper outlining discussing some development details and the integration into our database Hyrise. You can find the paper here.

Usage

Note: You can also find a detailed usage description at this blog post.

Requirements:

  • gcc 4.8+ (or clang 3.4+)

To use the SQL parser in your own projects you simply have to follow these few steps. The only requirement for is gcc 4.8+. Older versions of gcc/clang might also work, but are untested.

  1. Download the latest release here
  2. Compile the library make to create libsqlparser.so
  3. (Optional, Recommended) Run make install to copy the library to /usr/local/lib/
  4. Run the tests make test to make sure everything worked
  5. Include the SQLParser.h from src/ (or from /usr/local/lib/hsql/ if you installed it) and link the library in your project
  6. Take a look at the example project here
#include "hsql/SQLParser.h"

/* ... */

{
    // Basic Usage Example

    const std::string query = "...";
    hsql::SQLParserResult result;
    hsql::SQLParser::parse(query, &result);

    if (result.isValid() && result.size() > 0) {
        const hsql::SQLStatement* statement = result.getStatement(0);

        if (statement.isType(hsql::SelectStatement)) {
            const hsql::SelectStatement* select = (const hsql::SelectStatement*) statement;
            /* ... */
        }
    }
}

Quick Links:

How to Contribute

Developer Documentation

We strongly encourage you to contribute to this project! If you want to contribute to this project there are several options. If you've noticed a bug or would like an improvement let us know by creating a new issue. If you want to develop a new feature yourself or just improve the quality of the system, feel free to fork the reposistory and implement your changes. Open a pull request as soon as your done and we will look over it. If we think it's good then your pull request will be merged into this repository.

License

HYRISE sql-parser is licensed as open source after the OpenSource "Licence of the Hasso-Plattner Institute" declared in the LICENSE file of this project.

Contributers

The following people contributed to HYRISE sql-parser in various forms.