mirror of
https://github.com/pocoproject/poco.git
synced 2025-05-25 14:34:04 +02:00
ef688babc2
* fix(SQLParser): move to Data dir; add extradirs, remove vs 140,150 build scripts generation * fix(ActiveRecord): Makefile #4453 * fix(Data): Make SQLParser internal * fix(build): ODBC Makefile and Data libs CmakeLists #4453 * fix(build): Data libs CMakeLists #4453 * fix(build): regenerate VS projects #4453 * fix(CppUnit): remove Foundation dependency * fix(SQLParser): remove leftover unnecessary includes * fix(SQLParser): remove fwd header #4453 * fix(PocoDoc): remove SQLParser from include list * fix(mkrelease): remove 140,150 vs projects * fix(SQLParser): Disable SQL parsing by default #4462 * fix(test): Disable SQL parsing by default #4462 * Fix detection of odbc and apache2 for Fedora (#4461) * Fixed transaction handling in MySQL test when SQL parser is switched off * chore(ParallelSocketAcceptor): remove unnecessary include and using from header --------- Co-authored-by: Matej Kenda <matejken@gmail.com> Co-authored-by: topazus <77263945+topazus@users.noreply.github.com> Co-authored-by: Friedrich Wilckens <frwilckens@gmail.com>
64 lines
2.7 KiB
Markdown
64 lines
2.7 KiB
Markdown
C++ SQL Parser
|
|
=========================
|
|
[](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<const hsql::SelectStatement*>(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.
|