عمليات الترحيل#

عمليات الترحيل أشبه بنظام للتحكم بالإصدارات لقاعدة بياناتك. يعرّف كل ترحيل تغييرًا في قاعدة البيانات وكيفية التراجع عنه. من خلال تعديل قاعدة بياناتك عبر عمليات الترحيل، تنشئ طريقة متسقة وقابلة للاختبار وقابلة للمشاركة لتطوير قواعد بياناتك بمرور الوقت.

// An example migration.
struct MyMigration: Migration {
    func prepare(on database: any Database) -> EventLoopFuture<Void> {
        // Make a change to the database.
    }

    func revert(on database: any Database) -> EventLoopFuture<Void> {
        // Undo the change made in `prepare`, if possible.
    }
}

إذا كنت تستخدم async/await فينبغي أن تنفّذ بروتوكول AsyncMigration:

struct MyMigration: AsyncMigration {
    func prepare(on database: any Database) async throws {
        // Make a change to the database.
    }

    func revert(on database: any Database) async throws {
        // Undo the change made in `prepare`, if possible.
    }
}

دالة prepare هي المكان الذي تُجري فيه التغييرات على Database المُمرّرة. قد تكون هذه تغييرات على مخطط قاعدة البيانات مثل إضافة أو إزالة جدول أو مجموعة أو حقل أو قيد. قد تعدّل أيضًا محتوى قاعدة البيانات، مثل إنشاء نسخ نماذج جديدة أو تحديث قيم الحقول أو إجراء عمليات تنظيف.

دالة revert هي المكان الذي تتراجع فيه عن هذه التغييرات، إن أمكن. إن القدرة على التراجع عن عمليات الترحيل يمكن أن تجعل النمذجة الأولية والاختبار أسهل. كما تمنحك خطة احتياطية إذا لم تسر عملية النشر إلى بيئة الإنتاج كما هو مخطط لها.

التسجيل#

تُسجَّل عمليات الترحيل في تطبيقك باستخدام app.migrations.

import Fluent
import Vapor

app.migrations.add(MyMigration())

يمكنك إضافة ترحيل إلى قاعدة بيانات محددة باستخدام المعامل to، وإلا فستُستخدم قاعدة البيانات الافتراضية.

app.migrations.add(MyMigration(), to: .myDatabase)

ينبغي إدراج عمليات الترحيل بترتيب الاعتمادية. على سبيل المثال، إذا كان MigrationB يعتمد على MigrationA، فينبغي إضافته إلى app.migrations ثانيًا.

الترحيل#

لترحيل قاعدة بياناتك، شغّل أمر migrate.

swift run App migrate

يمكنك أيضًا تشغيل هذا الأمر عبر Xcode. سيتحقق أمر migrate من قاعدة البيانات لمعرفة ما إذا كانت هناك أي عمليات ترحيل جديدة قد سُجّلت منذ آخر تشغيل له. إذا كانت هناك عمليات ترحيل جديدة، فسيطلب تأكيدًا قبل تشغيلها.

التراجع#

للتراجع عن ترحيل في قاعدة بياناتك، شغّل migrate مع الراية --revert.

swift run App migrate --revert

سيتحقق الأمر من قاعدة البيانات لمعرفة أي دفعة من عمليات الترحيل جرى تشغيلها آخر مرة ويطلب تأكيدًا قبل التراجع عنها.

الترحيل التلقائي#

إذا كنت ترغب في تشغيل عمليات الترحيل تلقائيًا قبل تشغيل أوامر أخرى، فيمكنك تمرير الراية --auto-migrate.

swift run App serve --auto-migrate

يمكنك أيضًا القيام بذلك برمجيًا.

try app.autoMigrate().wait()

// or
try await app.autoMigrate()

يتوفر كلا هذين الخيارين للتراجع أيضًا: --auto-revert وapp.autoRevert().

الخطوات التالية#

ألقِ نظرة على دليلَي باني المخطط وباني الاستعلام لمزيد من المعلومات حول ما تضعه داخل عمليات الترحيل.