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)
MySQL Connect to self-hosted or cloud MySQL 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:
Cloudflare Vectorize Store vector embeddings for semantic search and AI/RAG applications
| 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
MySQL Setup Binlog configuration, user permissions, and network access
Salesforce Setup Connected App, OAuth settings, and security token
Cloudflare Vectorize Setup Vector index creation, API tokens, and embedding configuration
Next Steps
Section titled “Next Steps”- Getting Started - Set up your first adapter
- Field Mapping - Configure how data maps between adapters