Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/QuesmaOrg/quesma
Programmable database gateway
https://github.com/QuesmaOrg/quesma
clickhouse database elasticsearch gateway kibana opensearch opensearch-dashboards
Last synced: 14 days ago
JSON representation
Programmable database gateway
- Host: GitHub
- URL: https://github.com/QuesmaOrg/quesma
- Owner: QuesmaOrg
- License: other
- Created: 2024-05-02T07:04:50.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-10-17T08:55:53.000Z (19 days ago)
- Last Synced: 2024-10-19T11:21:12.419Z (17 days ago)
- Topics: clickhouse, database, elasticsearch, gateway, kibana, opensearch, opensearch-dashboards
- Language: Go
- Homepage: https://quesma.com/
- Size: 6.06 MB
- Stars: 94
- Watchers: 6
- Forks: 3
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.MD
- License: LICENSE.MD
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-clickhouse - QuesmaOrg/quesma - Quesma is a programmable database gateway that facilitates smooth migrations between different database platforms. (Integrations / Data Transfer and Synchronization)
README
Website |
LinkedIn |
Twitter |
YouTube |
Docs
Quesma is an actively developed database gateway currently in pre-alpha Early Access. Route your queries through a translation layer that seamlessly connects your apps with the modern database platforms of your choice. No more query refactoring during migrations.
How? Isn't migrating to a new database hard? Quesma does it without touching your application/client stack - keeping backward compatibility and moving safely, step-by-step. We translate your queries so you don’t have to rewrite your database query code during migrations.
Currently supported: Quesma makes it possible to connect seamlessly [**Kibana/OpenSearch Dashboards to Clickhouse**](https://quesma.com/quesma-for-elk)
## Getting Started
The easiest way to get started is to try out the example `docker-compose` setup, which can be found in `/examples/kibana-sample-data.` It features Kibana connecting to Elasticsearch and Clickhouse through Quesma:
```mermaid
flowchart LR;
kibana<-->quesma;
log-generator-->quesma(Quesma);
quesma<-->clickhouse[(clickhouse)];
quesma<-->elasticsearch[(elasticsearch)];
```
The setup contains following demo datasets:
- `logs-generic-default` - generated by `log-generator` application
- Logs Explorer: [link](http://localhost:5601/app/observability-log-explorer)
- `kibana_sample_data_ecommerce` - an official Kibana sample data set
- Logs Explorer: [link]()
- Dashboard: [link]()
- `kibana_sample_data_flights` - an official Kibana sample data set
- Logs Explorer: [link]()
- Dashboard: [link]()
### Running the example
In order to run it, you need to:
- clone this repository: `git clone https://github.com/QuesmaOrg/quesma.git`
- run `docker-compose up` directly from `examples/kibana-sample-data` directory
Handy one-liner for above commands:
```bash
git clone https://github.com/QuesmaOrg/quesma.git && docker compose -f quesma/examples/kibana-sample-data/docker-compose.yml up
```
The example above uses the latest Quesma Docker image published in DockerHub. In case you want to build Quesma Docker image from the sources, run `./bin/build-image.sh` from the root directory
Once it's running, you can access:
- Kibana at [localhost:5601](http://localhost:5601/)
- Quesma at [localhost:9999](http://localhost:9999/)
- Clickhouse at [localhost:8123/play](http://localhost:8123/play)
### Development
Developer documentation is available in the [docs](docs/DEVELOPMENT.MD) directory.
### License
[Elastic License 2.0](https://github.com/QuesmaOrg/quesma/blob/main/LICENSE.MD)