mirror of https://github.com/nocodb/nocodb
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4.1 KiB
4.1 KiB
title | description |
---|---|
Data Sources overview | NocoDB Data-Source sync, access control & re-config |
Overview
NocoDB allows you to connect to external data sources and get a unified spreadsheet view of your data. Activities related to external data sources can be managed from Data Sources
tab in Base dashboard
.
Data Sources
tab includes following functionalities
- Connect/manage external data source
- UI Access Control
- Relations
:::info Currently only one external data source can be added per project. :::
Accessing Data Sources
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab
Sync Metadata
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Click on
Sync Metadata
button listed underActions
column for the data source that you wish to sync metadata for - [Optional] Click on
Reload
button to refresh Sync state. - Any changes to the metadata identified will be listed in the
Sync State
column - Click on
Sync Now
button to sync the metadata changes
After the sync is complete, you can see the updated state in the Sync State
column. Sync modal also marks Tables metadata is in Sync
in the header.
UI Access Control
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Click on
UI ACL
button listed underActions
column for the data source that you wish to manage UI access control for - On the UI ACL modal, you can see the list of tables available in the data source as rows & roles available as columns. Toggle checkboxes to enable/disable access to tables for specific roles.
- Click on
Save
button to save the changes
Relations
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Click on
Relations
button listed underActions
column for the data source that you wish to access ERD (Relations view) for
Junction table names within Relations
- Enable
Show M2M Tables
withinProject Settings
menu - Double-click on
Show Columns
to see additional checkboxes get enabled.- Enabling which you should be able to see junction tables and their table names.
Edit external database configuration parameters
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Click on
Edit
icon listed underActions
column for the data source that you wish to access ERD (Relations view) for Go toData Sources
, clickEdit
icon, you can re-configure database credentials.
Please make sure database configuration parameters are valid. Any incorrect parameters could lead to schema loss!
Unlink data source
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Click on
Delete
icon listed underActions
column for the data source that you wish to Unlink
Data source visibility
- Access Base context menu by clicking on the
Base
name in the left sidebar - Click on
Data Sources
tab - Toggle radio button listed under
Visibility
column for the data source that you wish to hide/un-hide