https://github.com/scottlepp/sql-proxy
A container to connect to any SQL database and execute SQL statements.
https://github.com/scottlepp/sql-proxy
Last synced: 3 months ago
JSON representation
A container to connect to any SQL database and execute SQL statements.
- Host: GitHub
- URL: https://github.com/scottlepp/sql-proxy
- Owner: scottlepp
- Created: 2020-02-18T15:50:22.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-10-10T11:20:11.000Z (over 4 years ago)
- Last Synced: 2025-03-25T19:15:22.384Z (3 months ago)
- Language: Java
- Homepage:
- Size: 26.9 MB
- Stars: 3
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SQL Proxy
Allows connecting to any SQL database/datasource over HTTP without the need of drivers.
## Getting Started
Clone the repo.
### Prerequisites
Install Java, Gradle, and Docker
### Installing
Step 1: Build with build script:
```
./build.sh
```
Step 2: Run the container
```
docker run -p 8081:8081 -t gs-springboot-sql-proxy
```
## Development
Using IntelliJ with Gradle just run the application.
### Using the Proxy
Step 1: Connect
* using POSTMAN or CURL (or whatever http client you want)
POST to localhost:8081/connect
```
{
"username": "[database user]",
"password": "[database password]",
"type": "[database type (sqlserver, oracle, mysql, postgres, snowflake, etc)]",
"host": "[database host]",
"port": "[database port]",
"database": "[defaut database]",
"params": {"[custom]": "[value]", "[custom2]": "[value]", ...}
}
```
Sql Server Example
```
{
"username": "sa",
"password": "abcd123",
"type": "sqlserver",
"host": "localhost",
"port": "1433",
"database": "",
}
```
Snowflake example:
```
curl -XPOST localhost:8081/connect -H 'Content-type: application/json' -d '{"username": "user","password": "password","type": "snowflake","host": "my.db.host","port": "1234","database": "MY_DB"}'
```
Step 2: Query
http://localhost:8081/query?sql=[sql statement]
Example (sql server):
http://localhost:8081/query?sql=select * from spt_monitor
Example (Snowflake):
```
curl -XGET "http://localhost:8081/query?sql=SELECT%20*%20FROM%20mytable;"
```
## Deployment
Deploy the container with Docker, Kubernetes, Portainer, etc
## Built With
* Gradle
* Docker
* Spring Boot
## Contributing
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/your/project/tags).
## Authors
* **Scott Lepper**
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Acknowledgments
https://spring.io/guides/gs/spring-boot-docker/