Turso Sync: همگامسازی local-first برای SQLite
خلاصهٔ کاملتر
Turso تو این مقاله Turso Sync رو معرفی کرده؛ راهی برای ساختن اپهای local-first (یعنی اپهایی که اول روی دیتابیس خود دستگاه کار میکنن و بعداً با سرور همگام میشن). این دومین تلاششون برای sync هست و روی Turso Database ساخته شده، که بازنویسی متنباز SQLite با Rust هست.
به گفتهٔ نویسنده، مشکل تلاش قبلی (Embedded Replicas) این بود که روی WAL خود SQLite ساخته شده بود. WAL یعنی لاگی که SQLite تغییرات رو توش مینویسه، ولی بهجای «یه ردیف به tasks اضافه شد» فقط ثبت میکنه که فلان صفحهٔ ثابت از فایل عوض شده. برای همین یه تغییر یهردیفه هم کل صفحه رو میفرستاد، ادغام تغییرات تقریباً غیرممکن بود و اگه دو طرف از هم جدا میشدن، باید کل دیتابیس دوباره دانلود میشد. نتیجه این بود که نوشتنها بهطور پیشفرض مستقیم میرفتن سمت سرور.
تو موتور جدید، هر تغییر ردیف با CDC (یعنی ثبت تغییرات داده در سطح ردیف) ردیابی میشه. موقع ارسال، بهجای صفحهها خود دستورهای منطقی فرستاده میشن؛ پس یه insert یهردیفه تقریباً به اندازهٔ همون ردیف حجم داره و دو تغییر نامرتبط روی دو جدول دیگه با هم تداخل پیدا نمیکنن. sync هم دو تا متد جدا داره: push() تغییرات محلی رو میفرسته و pull() تغییرات سرور رو میگیره و یه boolean برمیگردونه که بگه چیزی عوض شده یا نه.
const db = await connect({
path: "./my-app.db",
url: process.env.TURSO_DATABASE_URL!,
authToken: process.env.TURSO_AUTH_TOKEN!,
});
await db.push();
const changed = await db.pull();تو این کد، نوشتنها تا وقتی push() صدا زده نشه روی فایل محلی میمونن و اگه دستگاه آفلاین باشه هم امن روی دیسک هستن. با longPollTimeoutMs سرور میتونه pull رو نگه داره تا چیز جدیدی برسه. یه حالت آزمایشی به اسم partial sync هم هست که اپ قبل از دانلود کامل دیتابیس شروع به جواب دادن میکنه و صفحههای لازم رو در قالب بخشهای ۱۲۸ کیلوبایتی میگیره.
تو بنچمارکها، وقتی هر دو روش بعد از هر نوشتن داده رو میفرستن، Turso Sync هر چرخه رو تو ۳۰ میلیثانیه انجام داده در برابر ۲۱۸ میلیثانیه. insert و update پشتسرهم حدود ۹ تا ۱۰ برابر سریعتر بودن با ۱۵ برابر دادهٔ کمتر. عدد ۳۱۲ برابر هم هست، ولی خود نویسنده میگه مقایسهش منصفانه نیست چون ۲۰۰ رفتوبرگشت شبکه رو با یکی مقایسه کرده.
حل تداخل با قانون last push wins هست، یعنی آخرین ارسال برنده میشه. این برای تنظیمات کاربر، لیست کارهای شخصی و حافظهٔ ایجنتها که هر ردیف یه صاحب داره خوبه، ولی برای شمارندهها مثل موجودی انبار مشکلسازه. نویسنده پیشنهاد میده دادهها append-only باشن یا هر کاربر ردیفهای خودش رو داشته باشه. کسایی که از sync() تو libSQL استفاده میکنن هم بهتره سراغ Turso Sync برن.
نکات کلیدی:
- Turso Sync بهجای صفحههای WAL، تغییرات منطقی ردیفها رو با CDC میفرسته.
- خوندن و نوشتن همیشه محلیه و ارسال و دریافت با push() و pull() جدا انجام میشه.
- تو بنچمارک، هر چرخه ۳۰ میلیثانیه در برابر ۲۱۸ میلیثانیهٔ Embedded Replicas بوده.
- partial sync هنوز آزمایشیه و بهطور پیشفرض بخشهای ۱۲۸ کیلوبایتی میگیره.
- حل تداخل last push wins هست و برای شمارندههای مشترک مناسب نیست.
- برای شروع آفلاین باید bootstrapIfEmpty: false تنظیم بشه.
- پلن رایگان Turso Cloud ماهی ۳ گیگابایت sync داره و پلن Developer ده گیگابایت.




