多维表格
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.

90 lines
5.2 KiB

---
title: 'Connect to a Data source'
description: 'Learn how to connect to an external data-source (PG/MySQL) in NocoDB.'
tags: ['Data Sources', 'Connect', 'External', 'PG', 'MySQL', 'mtls', 'tls', 'ssl']
keywords: ['NocoDB data source', 'connect data source', 'external data source', 'PG data source', 'MySQL data source']
---
To connect to an external data source, follow the steps below:
1. Access the Base context menu by clicking on the `...` in the left sidebar against the base name
6 months ago
2. Click on `Settings` tab
3. In the popup modal, click on `Data Sources` tab
4. Click on `+ New Data Source` button
5. On the input modal, provide the following details:
| Field Name | Description |
|---------------|--------------------------------------------------------------------------------------|
| Source Name | Name for this data source for display on NocoDB UI |
| Database Type | Type of the data source. Currently, NocoDB supports PostgreSQL & MySQL data sources. |
| Host Address | Hostname of the data source |
| Port Number | Port number of the data source |
| Username | Username to connect to the database |
| Password | Password to connect to the database |
| Database | Name of the database to connect to |
| Schema name | Name of the schema to connect to |
6 months ago
5a. Optionally, if the connection required is TLS/MTLS for MITM protection, follow these additional steps below:
- Click on `SSL & Advanced Parameters`
- Select `SSL Mode` and upload the client certificate, client key, and Root CA files by clicking on the file.
\
Note: The entire connection parameters can be viewed in json form by clicking on the "Edit connection JSON" and edited as required by database server type.\
\
Example: In PostgreSQL when SSL mode set to "Required-Identity," if the server certificate's common name (cname) differs from the actual DNS/IP used for connection, the connection will fail.\
To resolve, add "servername" property with same cname value under the SSL section. Additional details are available at [knex configuration options](https://knexjs.org/guide/#configuration-options).
6. Click on the `Test Database Connection` button to verify the connection
6 months ago
7. Wait for the connection to be verified.
- After test is successful, `Counnect to Data Source` button will be enabled.
- Click on `Connect to Data Source` button to save the data source.
6 months ago
![data source-1](/img/v2/data-source/ds-connect-1.png)
6 months ago
![data source-2](/img/v2/data-source/ds-connect-2.png)
![data source-3](/img/v2/data-source/ds-connect-3.png)
![data source-4](/img/v2/data-source/ds-connect-4.png)
## Configuring Permissions
This section covers the settings available when configuring data source permissions. These settings determine the level of access and modifications allowed on the connected database.
![data source-1](/img/v2/data-source/data-source-permissions.png)
NocoDB provides the following options for schema and data permissions:
### Allow Data Edit
This option when enabled, users can insert, update, and delete records from the tables. This provides the flexibility to manage the data directly from the NocoDB UI but should be used with caution to avoid unintentional changes to the records in the external data source. This level of access is ideal for administrative users who need to modify data directly.
By default, data editing is enabled
When data editing is disabled, users can still view the data and perform read-only operations such as filtering, sorting, and grouping. This ensures that users can access the data for analysis and reporting purposes without the risk of modifying the records.
:::note
Data editing can only be disabled when schema editing is also disabled
:::
### Allow Schema Edit
This option enables users to modify the structure of the database schema. When enabled, users can create, modify, and delete tables, fields and relationships (links) within the connected datasource from NocoDB UI. This provides flexibility to adjust the database schema design as needed from UI.
:::warning
NocoDB strongly advises against enabling the schema editing option unless absolutely necessary. Use with extreme caution, as improper changes can severely impact the data integrity and functionality of the connected data source.
:::
By default, schema editing is disabled.
Even when schema editing is disabled, users can still
- add (augment) virtual columns such as Lookup, Rollup and Formula. These virtual columns do not alter the underlying schema of the connected data source.
- create views to customize the data presentation without modifying the original tables.
- create webhooks to trigger external actions based on specific events within the connected datasource.
- collaborate with other users by explicitly inviting them to the base or by sharing views.