> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gidr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors

> Sync data from external storage providers.

# Connectors

Connectors allow you to sync data directly from external cloud storage providers. GIDR supports multiple connectors to integrate with your existing data infrastructure.

## Supported Connectors

* **File Storage**: AWS S3.
* **Database**: PostgreSQL, Microsoft SQL Server.

## Connect Data source

1. Select **Data Sources** > **+ Add**.
2. Choose **Connectors** as the source type.
3. Select your provider from the dropdown (e.g., **AWS**).

<img src="https://mintcdn.com/gidrai/tGsSOYP36yYHS_h9/docs/images/gidr/connectors_aws_modal.png?fit=max&auto=format&n=tGsSOYP36yYHS_h9&q=85&s=61acebf5a228ac2c863fdca3ea3b8c39" style={{ width: 'auto', maxWidth: '100%' }} alt="Connect AWS S3 Modal" width="563" height="533" data-path="docs/images/gidr/connectors_aws_modal.png" />

### AWS S3 Configuration

To connect an S3 bucket, you will need to provide the following credentials and settings:

#### General

* **Connector name**: A friendly name for this connection (e.g., "Marketing Assets").
* **Optional description**: Extra details about the data source.

#### Connector Settings

* **Access Key ID** (Required): Your AWS IAM Access Key ID.
  * *Example*: `AKIAIOSFODNN7EXAMPLE`
* **Secret Access key** (Required): Your AWS IAM Secret Access Key.
  * *Example*: `wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY`
* **Bucket Name** (Required): The name of the S3 bucket to sync.
  * *Example*: `project-data-backup`
* **Folder Prefix**: (Optional) Specify a subfolder path to limit the sync to a specific directory.
  * *Example*: `images/uploads/`
* **Language**: Select the primary language of the documents (e.g., **en**).

#### Sync Frequency

Choose how often GIDR should check for new files:

* **Daily**: Auto-sync every 24 hours.
* **Weekly**: Auto-sync once a week (you can select the day).
* **Never**: Manual sync only.

## Database Connectors

GIDR supports direct connections to SQL databases to sync tables.

### PostgreSQL Configuration

To connect a PostgreSQL database, provide the following connection details:

#### General

* **Connector name**: A friendly name for this connection.
* **Optional description**: Extra context about this data source.

#### Connector Settings

* **Host** (Required): The database server address.
  * *Example*: `db.example.com`
* **Port** (Required): The port number.
  * *Default*: `5432`
* **Database Name** (Required): The specific database to connect to.
  * *Example*: `production_db`
* **SSL Mode**: Toggle to enable/disable SSL connections (e.g., `false`).
* **Username** (Required): Database user.
* **Password** (Required): Database password.
* **Database Schema Name** (Required): The schema to sync tables from.
  * *Default*: `public`

### Microsoft SQL Server Configuration

To connect a Microsoft SQL Server database, provide the following details:

#### General

* **Connector name**: A friendly name for this connection.
* **Optional description**: Extra context about this data source.

#### Connector Settings

* **Host** (Required): The database server address.
  * *Example*: `db.example.com`
* **Port** (Required): The port number.
  * *Default*: `1433`
* **Database Name** (Required): The specific database to connect to.
  * *Example*: `production_db`
* **SSL Mode**: Toggle to enable/disable SSL connections (e.g., `false`).
* **Username** (Required): Database user.
* **Password** (Required): Database password.
* **Database Schema Name** (Required): The schema to sync tables from.
  * *Default*: `dbo`