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

# Drive Connectors

# Drive Services

This is the supported list of connectors for Drive Services:

<CardGroup cols="2">
  <Card title="Custom Drive" icon="https://mintcdn.com/collatedocs/NU2cty4wnF-KyKEi/public/images/connectors/googledrive.webp?fit=max&auto=format&n=NU2cty4wnF-KyKEi&q=85&s=6b42b5ea604c0f0e9617b37be2a3060d" href="/ai-2-0/connectors/drive/custom-drive" horizontal width="4096" height="4096" data-path="public/images/connectors/googledrive.webp">
    <img src="https://mintcdn.com/collatedocs/qTqd1tlB8cqEVgXb/public/images/connectors/openmetadata-logo.png?fit=max&auto=format&n=qTqd1tlB8cqEVgXb&q=85&s=ad28bd1f2fd6ae2dd39f0703121c1653" style={{ position: 'absolute', top: '17px', right: '60px', width: 'auto', height: '16px', margin: '0' }} alt="OpenMetadata" width="69" height="83" data-path="public/images/connectors/openmetadata-logo.png" />

    <div className="prod-beta-chip prod">PROD</div>
  </Card>

  <Card title="Google Drive" icon="https://mintcdn.com/collatedocs/NU2cty4wnF-KyKEi/public/images/connectors/googledrive.webp?fit=max&auto=format&n=NU2cty4wnF-KyKEi&q=85&s=6b42b5ea604c0f0e9617b37be2a3060d" href="/ai-2-0/connectors/drive/googledrive" horizontal width="4096" height="4096" data-path="public/images/connectors/googledrive.webp">
    <div className="prod-beta-chip beta">BETA</div>
  </Card>

  <Card title="SFTP" icon="https://mintcdn.com/collatedocs/Mzs68wAOnz09Hwg3/public/images/connectors/sftp.webp?fit=max&auto=format&n=Mzs68wAOnz09Hwg3&q=85&s=641fa6903bb1d8dcbcb416ce59576854" href="/ai-2-0/connectors/drive/sftp" horizontal width="28" height="23" data-path="public/images/connectors/sftp.webp">
    <img src="https://mintcdn.com/collatedocs/qTqd1tlB8cqEVgXb/public/images/connectors/openmetadata-logo.png?fit=max&auto=format&n=qTqd1tlB8cqEVgXb&q=85&s=ad28bd1f2fd6ae2dd39f0703121c1653" style={{ position: 'absolute', top: '17px', right: '60px', width: 'auto', height: '16px', margin: '0' }} alt="OpenMetadata" width="69" height="83" data-path="public/images/connectors/openmetadata-logo.png" />

    <div className="prod-beta-chip beta">BETA</div>
  </Card>
</CardGroup>

If you have a request for a new connector, don't hesitate to reach out in [Slack](https://slack.open-metadata.org/) or
open a [feature request](https://github.com/open-metadata/OpenMetadata/issues/new/choose) in our GitHub repo.

## Configure Metadata Agent and Schedule Ingestion

The **Metadata Agent** extracts directories, files, spreadsheets, and other structural metadata from your source and keeps your Collate catalog in sync. It powers discovery, lineage, and governance across your data assets.

When you click **Create & Deploy**, Collate automatically deploys a Metadata Agent for this service and triggers the first ingestion run. View its status and run history from the **Agents** tab on the service detail page.

To configure the additional Metadata Agent and schedule ingestion, follow these steps:

1. In the left navigation, click **Connections** and select your service.

2. Click the **Agents** tab.

3. Click **Add Agent** and select **Metadata** from the dropdown.
   <img src="https://mintcdn.com/collatedocs/bv5oe4uRjuorTJO1/public/images/ai-2.0/connectors/metadata-ingestion/add-metadata-agent.png?fit=max&auto=format&n=bv5oe4uRjuorTJO1&q=85&s=accad7d1c4ddf209781bff851d51d464" alt="Add Metadata Agent" width="2398" height="1144" data-path="public/images/ai-2.0/connectors/metadata-ingestion/add-metadata-agent.png" />
   For some services, the dropdown is not available and clicking **Add Agent** takes you directly to the agent configuration page.

4. On the **Configure Ingestion** page, do the following and click **Next**.

   * **Name this Ingestion**: Enter a unique recognizable name for this ingestion pipeline.

     <img src="https://mintcdn.com/collatedocs/bv5oe4uRjuorTJO1/public/images/ai-2.0/connectors/metadata-ingestion/metadata-agent-name.png?fit=max&auto=format&n=bv5oe4uRjuorTJO1&q=85&s=d5ec1f0f3742cadab8cd54c602c97239" alt="Name this Ingestion" width="1578" height="644" data-path="public/images/ai-2.0/connectors/metadata-ingestion/metadata-agent-name.png" />

   * **Agent Setup**: Configure the core parameters for this agent. The following fields are available:

     | Field                     | Default | Description                                                                                                                                                       |
     | ------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
     | Number of Threads         | 1       | Number of threads to use for parallel drive ingestion.                                                                                                            |
     | Mark Deleted Directories  | On      | Soft-delete directories in Collate when they are removed from the source. Associated entities like files, spreadsheets, worksheets, and lineage are also deleted. |
     | Mark Deleted Files        | On      | Soft-delete files in Collate when they are removed from the source. Associated entities like lineage are also deleted.                                            |
     | Mark Deleted Spreadsheets | On      | Soft-delete spreadsheets in Collate when they are removed from the source. Associated entities like worksheets and lineage are also deleted.                      |
     | Mark Deleted Worksheets   | On      | Soft-delete worksheets in Collate when they are removed from the source. Associated entities like lineage are also deleted.                                       |
     | Include Directories       | On      | Fetch directory metadata. Turn off to skip directories entirely.                                                                                                  |
     | Include Files             | On      | Fetch file metadata. Turn off to skip files entirely.                                                                                                             |
     | Include Spreadsheets      | On      | Fetch spreadsheet metadata. Turn off to skip spreadsheets entirely.                                                                                               |
     | Include Worksheets        | On      | Fetch worksheet metadata. Turn off to skip worksheets entirely.                                                                                                   |

     <img src="https://mintcdn.com/collatedocs/tVR0kaoXvgs3p2Wx/public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-agent-setup.png?fit=max&auto=format&n=tVR0kaoXvgs3p2Wx&q=85&s=8a132a356d8ea3314299b648265a253c" alt="Agent Setup" width="1530" height="1558" data-path="public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-agent-setup.png" />

   * **Filter Patterns**: Apply include or exclude rules to scope which directories, files, spreadsheets, and worksheets this agent ingests. Use FQN for filtering to apply regex on fully qualified names (e.g. `service_name.directory_name.file_name`) instead of raw names. These follow the same filter options described in **Step 5**.

     <img src="https://mintcdn.com/collatedocs/tVR0kaoXvgs3p2Wx/public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-filter-pattern.png?fit=max&auto=format&n=tVR0kaoXvgs3p2Wx&q=85&s=1337b9f82862926e08662b4f1fb0013b" alt="Filter Patterns" width="1570" height="1040" data-path="public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-filter-pattern.png" />

   * **Scope & Behaviour**: Control what metadata to include and how to handle deletions. Toggle each option on or off based on your needs:

     | Toggle            | Default | Description                                                                                                                                                            |
     | ----------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
     | Enable Debug Log  | Off     | Sets the ingestion log level to DEBUG. Useful for troubleshooting.                                                                                                     |
     | Include Tags      | On      | Ingest tags from the source.                                                                                                                                           |
     | Include Owners    | Off     | Assign owners from the source when the owner email matches a Collate user. Does not overwrite an existing owner.                                                       |
     | Override Metadata | Off     | When on, source values overwrite existing descriptions, tags, owners, and display names in Collate. When off, Collate only updates fields that have no existing value. |

     <img src="https://mintcdn.com/collatedocs/tVR0kaoXvgs3p2Wx/public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-scope-behaviour.png?fit=max&auto=format&n=tVR0kaoXvgs3p2Wx&q=85&s=508c5978a32083dabbc5443f2a1ec4b4" alt="Scope & Behaviour" width="1562" height="894" data-path="public/images/ai-2.0/connectors/metadata-ingestion/Drive/drive-scope-behaviour.png" />

5. On the **Schedule Interval** page, set when the agent runs:

   * **Schedule**: Choose a preset interval (Hourly, Daily, Weekly, Monthly) or enter a custom cron expression.
   * **On-Demand**: No automatic schedule; trigger the agent manually when needed.

   <img src="https://mintcdn.com/collatedocs/bv5oe4uRjuorTJO1/public/images/ai-2.0/connectors/metadata-ingestion/schedule.png?fit=max&auto=format&n=bv5oe4uRjuorTJO1&q=85&s=25cc1d78f6f2a8bd115830d034d1d8d1" alt="Schedule Interval" width="1588" height="1044" data-path="public/images/ai-2.0/connectors/metadata-ingestion/schedule.png" />

6. Click **Add** to deploy the agent.
