https://github.com/hyrise/sql-parser

SQL Parser for C++. Building C++ object structure from SQL statements.
https://github.com/hyrise/sql-parser

c-plus-plus hyrise sql sql-parser

Last synced: about 17 hours ago
JSON representation

SQL Parser for C++. Building C++ object structure from SQL statements.

• Host: GitHub
• URL: https://github.com/hyrise/sql-parser
• Owner: hyrise
• License: mit
• Created: 2014-10-08T23:27:56.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2024-09-17T12:41:15.000Z (about 2 months ago)
• Last Synced: 2024-09-17T15:50:58.321Z (about 2 months ago)
• Topics: c-plus-plus, hyrise, sql, sql-parser
• Language: C++
• Homepage:
• Size: 2.8 MB
• Stars: 733
• Watchers: 48
• Forks: 243
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
C++ SQL Parser

=========================

[![Build Status](https://github.com/hyrise/sql-parser/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/hyrise/sql-parser/actions?query=branch%3Amaster)

This is a SQL Parser for C++. It parses the given SQL query into C++ objects.

It has been developed for integration in [Hyrise](https://github.com/hyrise/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](docs/technical_documentation.pdf).

## Usage

**Note:** You can also find a detailed usage description [here](docs/basic-usage.md).

To use the SQL parser in your own projects you simply have to follow these few steps.

 1. Download the [latest release here](https://github.com/hyrise/sql-parser/releases)

 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](https://github.com/hyrise/sql-parser/tree/master/example)

```cpp

#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::kStmtSelect)) {

            const auto* select = static_cast(statement);

            /* ... */

        }

    }

}

```

Quick Links:

 * [SQLParser.h](src/SQLParser.h)

 * [SQLParserResult.h](src/SQLParserResult.h)

 * [SelectStatement.h](src/sql/SelectStatement.h)

## How to Contribute

**[Developer Documentation](docs/)**

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](https://github.com/hyrise/sql-parser/issues). 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 MIT License which is declared in the LICENSE file of this project.