Adapters Overview
Adapters are how Sync or Swim connects to your data sources and destinations. Each adapter handles the specifics of connecting, reading, writing, and detecting changes for a particular system.
Available Adapters
Section titled “Available Adapters”Bidirectional Sync
Section titled “Bidirectional Sync”These adapters support full two-way synchronization:
PostgreSQL Connect to self-hosted or cloud PostgreSQL databases (RDS, Cloud SQL, Azure)
Salesforce Sync with Salesforce orgs using OAuth and Connected Apps
| Adapter | Sync Type | Change Detection | Status |
|---|---|---|---|
| PostgreSQL | ↔ Bidirectional | WAL (instant) | Available |
| Salesforce | ↔ Bidirectional | Polling | Available |
| MySQL | ↔ Bidirectional | Binlog | Available |
| Redis | ↔ Bidirectional | Keyspace notifications | Available |
One-Way Sync (Destinations)
Section titled “One-Way Sync (Destinations)”These adapters support one-way sync as destinations:
| Adapter | Sync Type | Use Case | Status |
|---|---|---|---|
| Cloudflare Vectorize | → One-way | Vector embeddings for AI/RAG | Available |
| BigQuery | → One-way | Analytics and data warehouse | Coming Soon |
| Snowflake | → One-way | Analytics and data warehouse | Coming Soon |
How Adapters Work
Section titled “How Adapters Work”Each adapter implements a standard interface for:
- Connection - Securely authenticate with the target system
- Schema Discovery - Automatically detect tables, objects, and fields
- Change Detection - Monitor for new, updated, or deleted records
- Read/Write - Efficiently batch data operations
- Error Handling - Graceful retry and recovery logic
Change Detection Methods
Section titled “Change Detection Methods”Different adapters use different methods to detect changes, optimized for each system:
| Method | Latency | Systems |
|---|---|---|
| Write-Ahead Log (WAL) | Instant | PostgreSQL |
| Binary Log (Binlog) | Instant | MySQL |
| Change Streams | Near-instant | MongoDB (coming soon) |
| Keyspace Notifications | Instant | Redis |
| Polling | Configurable (15s-5min) | Salesforce, APIs |
Adapter Configuration
Section titled “Adapter Configuration”Each adapter requires specific credentials and configuration. See the individual adapter documentation for detailed setup instructions:
PostgreSQL Setup Database user, permissions, network access, and SSL configuration
Salesforce Setup Connected App, OAuth settings, and security token
Next Steps
Section titled “Next Steps”- Getting Started - Set up your first adapter
- Field Mapping - Configure how data maps between adapters