التنفيذ: متاح عبر npm package | رمز المصدر: GitHub
ماذا يمكنك مزامنته؟
تدعم ميزة مزامنة قاعدة البيانات لدينا مزامنة الكيانات التالية من مدفوعات Dodo إلى قاعدة البيانات الخاصة بك:Payments
قم بمزامنة جميع معاملات الدفع، بما في ذلك الدفعات لمرة واحدة، والمبالغ المستردة، وتحديثات حالة الدفع.
Customers
حافظ على تزامن بيانات العملاء، بما في ذلك ملفات تعريف العملاء، ومعلومات الاتصال، والبيانات الوصفية.
Subscriptions
قم بمزامنة بيانات الاشتراكات، بما في ذلك الاشتراكات النشطة، ودورات الفوترة، وتغييرات حالة الاشتراك.
Licenses
قم بمزامنة معلومات الترخيص، بما في ذلك مفاتيح الترخيص، والتفعيلات، وتحديثات حالة الترخيص.
scopes. جميع عمليات المزامنة تدريجية وتنقل فقط السجلات الجديدة أو المحدثة لتحقيق أفضل أداء.
دعم قاعدة البيانات
ندعم حاليًا MongoDB وPostgreSQL وMySQL وClickHouse. نعمل بنشاط على توسيع الدعم لـ:- قواعد البيانات: Snowflake وغيرها.
- خطوط الأنابيب: خطوط أنابيب ETL، المزامنة في الوقت الحقيقي.
البدء
يمكنك استخدام ميزة مزامنة قاعدة البيانات لدينا عبر CLI أو برمجيًا في الكود الخاص بك. توفر كلا الطريقتين نفس الوظائف—اختر الطريقة التي تناسب سير العمل الخاص بك.استخدام CLI
يوفر أداة CLI طريقة سريعة لإعداد وتشغيل مزامنة قاعدة البيانات. قم بتثبيته عالميًا لاستخدامه من أي مكان في الطرفية الخاصة بك:تشغيل CLI
يدعم CLI وضعين: الوضع التفاعلي للإعداد الموجه، والوضع اليدوي للتكوين المباشر. الوضع التفاعلي: قم بتشغيل الأمر بدون معلمات لبدء معالج الإعداد التفاعلي.معلمات CLI
فاصل المزامنة بالثواني. يحدد عدد مرات تشغيل عملية المزامنة. إذا لم يتم توفيره، فسيتم تشغيل المزامنة مرة واحدة ثم التوقف.
نوع قاعدة البيانات المراد استخدامها. القيم المدعومة:
"mongodb"، "postgres"، "mysql"، أو "clickhouse".سلسلة اتصال لقاعدة البيانات الخاصة بك:
- MongoDB:
mongodb://localhost:27017أوmongodb+srv://user:pass@cluster.mongodb.net/ - PostgreSQL:
postgresql://user:password@localhost:5432/mydb - MySQL:
mysql://user:password@localhost:3306/mydb - ClickHouse:
http://localhost:8123
قائمة مفصولة بفواصل للكيانات المراد مزامنتها. النطاقات المتاحة:
licences، payments، customers، subscriptions. على سبيل المثال: "payments,customers".مفتاح واجهة برمجة تطبيقات Dodo Payments الخاص بك. يجب أن يبدأ بـ
dp_live_ في وضع الإنتاج أو dp_test_ في وضع الاختبار.البيئة المستهدفة. يجب أن تكون إما
"live_mode" أو "test_mode". هذا يحدد البيئة التي سيتم المزامنة منها في Dodo Payments.معدل الطلبات في الثانية. يتحكم في سرعة إرسال محرك المزامنة لطلبات واجهة برمجة التطبيقات لتجنب إثقال واجهة Dodo Payments.
الاستخدام في الكود الخاص بك
للحصول على تحكم برمجي، قم بدمج ميزة المزامنة مباشرة في تطبيقك. قم بتثبيتها كاعتماد في مشروعك:المزامنة التلقائية (استنادًا إلى الفترات)
استخدم المزامنة التلقائية عندما تريد أن تعمل المزامنة باستمرار على فترات منتظمة:المزامنة اليدوية
استخدم المزامنة اليدوية عندما تريد تشغيل عمليات المزامنة عند الطلب (على سبيل المثال، من مهمة cron أو نقطة نهاية API):مثال PostgreSQL
إليك كيفية استخدامdodo-sync مع PostgreSQL:
مثال MySQL
إليك كيفية استخدامdodo-sync مع MySQL:
مثال ClickHouse
إليك كيفية استخدامdodo-sync مع ClickHouse:
خيارات المُنشئ
اسم قاعدة البيانات المطلوب استخدامها. القيم المدعومة:
"mongodb"، "postgres"، "mysql"، أو "clickhouse".سلسلة الاتصال لقاعدة البيانات الخاصة بك:
- MongoDB:
mongodb://localhost:27017أوmongodb+srv://... - PostgreSQL:
postgresql://user:password@localhost:5432/mydb - MySQL:
mysql://user:password@localhost:3306/mydb - ClickHouse:
http://localhost:8123
مصفوفة الكيانات المراد مزامنتها. الخيارات المتاحة:
"licences"، "payments"، "customers"، "subscriptions". يمكنك تضمين أي توليفة منها.تكوين واجهة برمجة تطبيقات Dodo Payments للمصادقة وتحديد البيئة. راجع أنواع SDK لـ TypeScript للحصول على الخيارات الكاملة.الخصائص المطلوبة:
bearerToken: مفتاح واجهة برمجة تطبيقات Dodo Payments الخاص بكenvironment: إما"test_mode"أو"live_mode"
الوقت بالثواني بين المزامنات التلقائية. مطلوب عند استخدام
.start() للمزامنة التلقائية. اختياري عند استخدام .run() للمزامنة اليدوية.عدد الطلبات في الثانية. يتحكم في سرعة إرسال محرك المزامنة لطلبات واجهة برمجة التطبيقات لتجنب إثقال Dodo Payments.
معلومات هامة
يتتبع محرك المزامنة التغييرات ويزامن فقط السجلات الجديدة أو المحدثة، مما يجعل المزامنات اللاحقة فعالة حتى مع مجموعات البيانات الكبيرة.