dbeaver / cloudbeaver

Cloud Database Manager
https://dbeaver.com/
Apache License 2.0
3.39k stars 370 forks source link

[Documentation] Where I can find the specification of data-sources.json #2780

Open ewh0 opened 2 months ago

ewh0 commented 2 months ago

As a new user to cloudbeaver (and dbeaver in general), I need to pre-configure the database connection and personally I find it's difficult to look up the specification of data-sources.json

I've navigated back and force between a lot of links, such as

but none of these links fully cover the exact semantics of data-sources.json. For example, what will happen exactly if I turn save-password to true or false?

I'm looking for a specification where it lists every parameter we can put on this json file, and overall schema and the semantic of each parameter.

Using docker as example, the specification of docker compose (https://docs.docker.com/compose/compose-file/build/) basically list and explains each and every possible parameter.

IMHO, having such a document as a reference will help people quickly onboard cloudbeaver (prehaps also dbeaver) in general.

Thanks

LonwoLonwo commented 2 months ago

Hello @ewh0

Thanks for the report. We will look at it and try to reconfigure our documentation. We can probably update this article https://dbeaver.com/docs/dbeaver/Admin-Manage-Connections/