mirror of
https://github.com/dbgate/dbgate
synced 2024-11-07 20:26:23 +00:00
101 lines
3.7 KiB
Markdown
101 lines
3.7 KiB
Markdown
[](https://github.com/prettier/prettier)
|
|
[](https://paypal.me/JanProchazkaCz/30eur)
|
|
|
|
# DbGate - database administration tool
|
|
|
|
DbGate is fast and efficient database administration tool. It is focused to work with data (filtering, editing, master/detail views etc.)
|
|
|
|
**Try it online** - https://dbgate.org
|
|
|
|
## Currently implemented features
|
|
* Support for Microsoft SQL Server, Postgre SQL, MySQL
|
|
* Table data browsing - filtering, sorting, adding related columns using foreign keys
|
|
* Master/detail views
|
|
* Browsing objects - tables, views, procedures, functions
|
|
* Table data editing, with SQL change script preview
|
|
* SQL editor, execute SQL script, SQL code formatter
|
|
* Runs as application for Windows, Linux and Mac. Or in Docker container on server and in web Browser on client.
|
|
* For detailed info, how to run DbGate in docker container, visit [docker hub](https://hub.docker.com/r/dbgate/dbgate)
|
|
|
|
## Current support for database engines
|
|
| Action | Microsoft SQL Server | Postgre SQL | MySQL |
|
|
|---|---|---|---|
|
|
| Tables | yes | yes | yes |
|
|
| Columns | yes | yes | yes |
|
|
| Primary keys | yes | yes | yes |
|
|
| Foreign keys | yes | yes | yes |
|
|
| Run query | yes | yes | yes |
|
|
| Data types | yes | no | no |
|
|
| Views | yes | no | no |
|
|
| Stored procedures | yes | no | no |
|
|
| Functions | yes | no | no |
|
|
|
|
|
|
|
|
## Design goals
|
|
* Application simplicity - DbGate takes the best and only the best from old [DbGate](http://www.jenasoft.com/dbgate), [DatAdmin](http://www.jenasoft.com/datadmin) and [DbMouse](http://www.jenasoft.com/dbmouse) . First will be implemented the most used features from this software.
|
|
* Minimal dependencies - so that the software can be developed in future without problems with obsolete libraries
|
|
* Frontend - React, styled-components, socket.io
|
|
* Backend - NodeJs, ExpressJs, socket.io, database connection drivers
|
|
* JavaScript + TypeScript
|
|
* App - electron
|
|
* There is plan to incorporate SQLite to support work with local datasets
|
|
* Platform independed - will run as web application in single docker container on server, or as application using Electron platform on Linux, Windows and Mac
|
|
|
|
## How Can I Contribute?
|
|
You're welcome to contribute to this project! Especially with these topics:
|
|
|
|
* Bug fixing
|
|
* Test Mac edition
|
|
* Styles, graphics
|
|
* Better MySQL, Postgre SQL support
|
|
|
|
Any help is appreciated!
|
|
|
|
Feel free to report issues and open merge requests.
|
|
|
|
## How to run development environment
|
|
|
|
```sh
|
|
yarn
|
|
yarn start
|
|
```
|
|
|
|
If you want to make modifications in TypeScript packages, run TypeScript compiler in watch mode in seconds terminal:
|
|
```sh
|
|
yarn lib
|
|
```
|
|
|
|
Open http://localhost:5000 in your browser
|
|
|
|
You could run electron app, using this server:
|
|
```sh
|
|
cd app
|
|
yarn
|
|
yarn start
|
|
```
|
|
|
|
## How to run built electron app locally
|
|
This mode is very similar to production run of electron app. Electron app forks process with API on dynamically allocated port, works with compiled javascript files.
|
|
|
|
```sh
|
|
cd app
|
|
yarn
|
|
```
|
|
|
|
```sh
|
|
yarn
|
|
yarn build:app:local
|
|
yarn start:app:local
|
|
```
|
|
|
|
## Packages
|
|
* api - backend, Javascript, ExpressJS
|
|
* datalib - TypeScript library for utility classes
|
|
* electron - application (JavaScript)
|
|
* engines - drivers for database engine (mssql, mysql, postgres), analysing database structure, creating specific queries (JavaScript)
|
|
* filterparser - TypeScript library for parsing data filter expressions using parsimmon
|
|
* sqltree - JSON representation of SQL query, functions converting to SQL (TypeScript)
|
|
* types - common TypeScript definitions
|
|
* web - frontend in React (JavaScript)
|