Data Connectors
Ingest documents from external data sources into your RAG pipeline.
Data Connectors allow AgentOven to ingest documents from external data sources — data warehouses, object stores, and data lakes — into your RAG pipeline. This is an enterprise feature available in AgentOven Pro.
Architecture
Data connectors use a pluggable driver architecture. Each connector implements the DataConnectorDriver interface, which provides connect, read, and health check operations.
go
type DataConnectorDriver interface {
Kind() string
Connect(ctx context.Context, config map[string]interface{}) error
ReadDocuments(ctx context.Context, query string, limit int) ([]models.RawDocument, error)
HealthCheck(ctx context.Context) error
}Supported Connectors (Pro)
Snowflake
Connect to Snowflake data warehouses to pull structured and unstructured data for RAG ingestion. Supports SQL queries against your Snowflake tables.
Config: account · warehouse · database · schema · role
Databricks
Read from Databricks Delta Lake tables and Unity Catalog. Supports SQL queries and direct table reads for large-scale data ingestion.
Config: host · token · warehouse_id · catalog · schema
S3 / ADLS / GCS
Read documents directly from cloud object stores. Supports multiple file formats (text, JSON, CSV, PDF) with configurable prefix filtering.
Config: provider (s3|adls|gcs) · bucket · prefix · credentials
Ingestion Flow
Data connectors feed into the existing RAG ingestion pipeline:
- Configure a data connector with credentials
- Connector reads raw documents from the data source
- Documents are passed to the ingestion engine
- Text is chunked, embedded, and stored in the vector store
- Data is available for RAG queries
API Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/connectors | List configured data connectors |
POST | /api/v1/connectors | Register a new data connector |
POST | /api/v1/connectors/{id}/test | Test connector connection |
POST | /api/v1/connectors/{id}/ingest | Trigger document ingestion |
DELETE | /api/v1/connectors/{id} | Remove a data connector |
OSS vs Pro
The data connector framework (registry, driver interface, API endpoints) ships with OSS. The actual connector drivers (Snowflake, Databricks, S3/ADLS/GCS) are Pro-only and require an AgentOven Pro license.