mirror of
https://github.com/dbgate/dbgate
synced 2024-11-07 20:26:23 +00:00
144 lines
6.4 KiB
Markdown
144 lines
6.4 KiB
Markdown
[](https://www.npmjs.com/package/dbgate)
|
|
|
|
[](https://snapcraft.io/dbgate)
|
|
[](https://snapcraft.io/dbgate)
|
|
[](https://github.com/prettier/prettier)
|
|
|
|
<img src="https://raw.githubusercontent.com/dbgate/dbgate/master/app/icon.png" width="64" align="right"/>
|
|
|
|
# DbGate - (no)SQL database client
|
|
|
|
DbGate is cross-platform database manager.
|
|
It's designed to be simple to use and effective, when working with more databases simultaneously.
|
|
But there are also many advanced features like schema compare, visual query designer, chart visualisation or batch export and import.
|
|
|
|
DbGate is licensed under MIT license and is completely free.
|
|
|
|
* Try it online - [demo.dbgate.org](https://demo.dbgate.org) - online demo application
|
|
* **Download** application for Windows, Linux or Mac from [dbgate.org](https://dbgate.org/download/)
|
|
* Run web version as [NPM package](https://www.npmjs.com/package/dbgate) or as [docker image](https://hub.docker.com/r/dbgate/dbgate)
|
|
|
|
## Supported databases
|
|
* MySQL
|
|
* PostgreSQL
|
|
* SQL Server
|
|
* MongoDB
|
|
* SQLite
|
|
* Amazon Redshift
|
|
* CockroachDB
|
|
* MariaDB
|
|
|
|
<!-- Learn more about DbGate features at the [DbGate website](https://dbgate.org/), or try our online [demo application](https://demo.dbgate.org) -->
|
|
|
|
|
|
<a href="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot1.png">
|
|
<img src="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot1.png" width="400"/>
|
|
</a>
|
|
<a href="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot2.png">
|
|
<img src="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot2.png" width="400"/>
|
|
</a>
|
|
<a href="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot4.png">
|
|
<img src="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot4.png" width="400"/>
|
|
</a>
|
|
<a href="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot3.png">
|
|
<img src="https://raw.githubusercontent.com/dbgate/dbgate/master/img/screenshot3.png" width="400"/>
|
|
</a>
|
|
|
|
<!--  -->
|
|
|
|
## Features
|
|
* Table data editing, with SQL change script preview
|
|
* Edit table schema, indexes, primary and foreign keys
|
|
* Compare and synchronize database structure
|
|
* Light and dark theme
|
|
* Master/detail views, foreign key lookups
|
|
* Query designer
|
|
* Form view for comfortable work with tables with many columns
|
|
* JSON view on MongoDB collections
|
|
* Explore tables, views, procedures, functions, MongoDB collections
|
|
* SQL editor
|
|
* execute SQL script
|
|
* SQL code formatter
|
|
* SQL code completion
|
|
* Add SQL LEFT/INNER/RIGHT join utility
|
|
* Mongo JavaScript editor, execute Mongo script (with NodeJs syntax)
|
|
* Runs as application for Windows, Linux and Mac. Or in Docker container on server and in web Browser on client.
|
|
* Import, export from/to CSV, Excel, JSON
|
|
* Free table editor - quick table data editing (cleanup data after import/before export, prototype tables etc.)
|
|
* Archives - backup your data in JSON files on local filesystem (or on DbGate server, when using web application)
|
|
* Charts, export chart to HTML page
|
|
* For detailed info, how to run DbGate in docker container, visit [docker hub](https://hub.docker.com/r/dbgate/dbgate)
|
|
* Extensible plugin architecture
|
|
|
|
## How to contribute
|
|
Any contributions are welcome. If you want to contribute without coding, consider following:
|
|
|
|
* Tell your friends about DbGate or share on social networks - when more people will use DbGate, it will grow to be better
|
|
* Write review on [Slant.co](https://www.slant.co/improve/options/41086/~dbgate-review) or [G2](https://www.g2.com/products/dbgate/reviews)
|
|
* Create issue, if you find problem in app, or you have idea to new feature. If issue already exists, you could leave comment on it, to prioritise most wanted issues.
|
|
* Become a backer on [Open collective](https://opencollective.com/dbgate)
|
|
|
|
Thank you!
|
|
|
|
## Why is DbGate different
|
|
There are many database managers now, so why DbGate?
|
|
* Works everywhere - Windows, Linux, Mac, Web browser (+mobile web is planned), without compromises in features
|
|
* Based on standalone NPM packages, scripts can be run without DbGate (example - [CSV export](https://www.npmjs.com/package/dbgate-plugin-csv) )
|
|
* Many data browsing functions based using foreign keys - master/detail, expand columns, expandable form view
|
|
|
|
## 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) .
|
|
* Minimal dependencies
|
|
* Frontend - Svelte, socket.io
|
|
* Backend - NodeJs, ExpressJs, socket.io, database connection drivers
|
|
* JavaScript + TypeScript
|
|
* App - electron
|
|
* Platform independent - runs as web application in single docker container on server, or as application using Electron platform on Linux, Windows and Mac
|
|
|
|
<!-- ## Plugins
|
|
Plugins are standard NPM packages published on [npmjs.com](https://www.npmjs.com).
|
|
See all [existing DbGate plugins](https://www.npmjs.com/search?q=keywords:dbgateplugin).
|
|
Visit [dbgate generator homepage](https://github.com/dbgate/generator-dbgate) to see, how to create your own plugin.
|
|
|
|
Currently following extensions can be implemented using plugins:
|
|
- File format parsers/writers
|
|
- Database engine connectors
|
|
|
|
Basic set of plugins is part of DbGate git repository and is installed with app. Additional plugins pust be downloaded from NPM (this task is handled by DbGate) -->
|
|
|
|
## How to run development environment
|
|
|
|
```sh
|
|
yarn
|
|
yarn start
|
|
```
|
|
|
|
If you want to make modifications in libraries or plugins, run library compiler in watch mode in the second terminal:
|
|
```sh
|
|
yarn lib
|
|
```
|
|
|
|
Open http://localhost:5000 in your browser
|
|
|
|
You could run electron app (requires running localhost:5000):
|
|
```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 and uses compiled version of plugins (doesn't use localhost:5000)
|
|
|
|
```sh
|
|
cd app
|
|
yarn
|
|
```
|
|
|
|
```sh
|
|
yarn
|
|
yarn build:app:local
|
|
yarn start:app:local
|
|
```
|
|
|