cloudbeaver icon indicating copy to clipboard operation
cloudbeaver copied to clipboard

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

Open ewh0 opened this issue 7 months ago • 1 comments

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

  • https://dbeaver.com/docs/cloudbeaver/Server-configuration/
  • https://dbeaver.com/docs/cloudbeaver/Configuring-server-datasources/
  • https://dbeaver.com/docs/dbeaver/Configuration-files-in-DBeaver/
  • https://github.com/dbeaver/cloudbeaver/blob/devel/config/sample-databases/DefaultConfiguration/GlobalConfiguration/.dbeaver/data-sources.json
  • https://dbeaver.com/docs/dbeaver/Admin-Manage-Connections/
  • etc.

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

ewh0 avatar Jul 16 '24 08:07 ewh0