Migrasi Pangkalan Data dan Pengurusan Skema

Apakah yang berlaku apabila aplikasi anda berubah? Ciri baharu selalunya memerlukan tempat baharu untuk menyimpan data atau perubahan pada struktur data sedia ada. Di sinilah pengurusan skema pangkalan data diperlukan.

Skema pangkalan data adalah seperti pelan tindakan bagi pangkalan data anda. Skema mentakrifkan jadual, lajur, hubungan dan kekangan yang menstrukturkan data anda.

Apabila aplikasi anda berkembang, skemanya juga perlu berkembang. Perubahan manual boleh berisiko dan tidak konsisten merentas persekitaran.

Migrasi pangkalan data ialah kawalan versi untuk skema pangkalan data anda. Anggaplah ia seperti komit kod, tetapi untuk struktur pangkalan data.

Setiap migrasi ialah sekumpulan arahan (biasanya SQL) yang menerangkan cara mengubah pangkalan data daripada satu versi kepada versi seterusnya. Migrasi biasanya mempunyai cap masa dan digunakan mengikut turutan.

• `up` script: Menggunakan perubahan (contohnya, menambah jadual).
• `down` script: Membuat asal perubahan (contohnya, menggugurkan jadual).

Penggunaan migrasi pangkalan data menawarkan beberapa kelebihan utama untuk pasukan pembangunan:

• Konsistensi: Memastikan semua pembangun dan persekitaran penggunaan mempunyai skema pangkalan data yang sama.
• Kerjasama: Memudahkan beberapa pembangun menyumbang perubahan skema tanpa konflik.
• Keupayaan Membuat Asal: Membolehkan anda kembali dengan mudah kepada keadaan skema sebelumnya jika berlaku masalah.
• Automasi: Berintegrasi dengan lancar ke dalam saluran paip CI/CD anda untuk penggunaan automatik.

Dalam ekosistem Clojure, pustaka yang popular dan kukuh untuk mengurus migrasi pangkalan data ialah Migratus.

Migratus bersifat fleksibel, menyokong migrasi SQL dan juga migrasi berasaskan Clojure. Pustaka ini menjejaki migrasi yang telah digunakan dalam pangkalan data anda, bagi memastikan migrasi hanya dijalankan sekali dan mengikut turutan yang betul.

Pustaka ini direka bentuk supaya mudah dikonfigurasi dan digunakan, serta sesuai dengan pendekatan berfungsi Clojure.

Untuk menggunakan Migratus, anda perlu menambahkannya sebagai kebergantungan dan mengkonfigurasikannya terlebih dahulu. Berikut ialah persediaan biasa menggunakan deps.edn dan peta konfigurasi:

Mula-mula, tambahkan kebergantungan tersebut pada deps.edn anda:

{:deps {org.clojure/clojure {:mvn/version "1.11.1"}
        migratus/migratus {:mvn/version "1.0.10"}
        org.postgresql/postgresql {:mvn/version "42.6.0"}}}

Kemudian, cipta fail migratus-config.edn (atau fail yang serupa) untuk mentakrifkan sambungan pangkalan data anda:

{:store :database
 :migration-dir "resources/migrations"
 :db {:classname   "org.postgresql.Driver"
      :subprotocol "postgresql"
      :subname     "//localhost:5432/myapp_db"
      :user        "dbuser"
      :password    "dbpass"}}

Migrasi biasanya ialah fail SQL yang diletakkan dalam direktori yang ditetapkan (contohnya, resources/migrations seperti yang dikonfigurasikan sebelum ini). Setiap migrasi terdiri daripada skrip "up" dan "down".

Migratus menjangkakan fail yang dinamakan seperti YYYYMMDDHHMMSS-migration-name.up.sql dan YYYYMMDDHHMMSS-migration-name.down.sql.

Cap masa tersebut memastikan susunan yang unik. Anda boleh menjana nama ini menggunakan alat baris perintah, biasanya migratus create <name>.

Fail .up.sql mengandungi perintah SQL untuk menggunakan perubahan skema. Contoh ini mencipta jadual users baharu.

-- resources/migrations/20231027100000-create-users-table.up.sql

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  username VARCHAR(255) NOT NULL UNIQUE,
  email VARCHAR(255) NOT NULL,
  created_at TIMESTAMP WITHOUT TIME ZONE DEFAULT CURRENT_TIMESTAMP
);

Skrip ini mentakrifkan struktur awal untuk pengguna kita.

Fail .down.sql mengandungi perintah SQL untuk mengembalikan perubahan skema yang dibuat oleh .up.sql yang sepadan dengannya. Contoh ini membuang jadual users.

-- resources/migrations/20231027100000-create-users-table.down.sql

DROP TABLE IF EXISTS users;

Amat penting untuk memastikan skrip `down` membatalkan skrip `up` dengan tepat, supaya pengembalian dapat dilakukan dengan selamat.

Setelah fail migrasi anda siap dan `migratus` dikonfigurasikan, anda boleh menggunakan migrasi tersebut.

Biasanya, anda akan menggunakan alat baris perintah seperti Leiningen atau clj dengan alias yang dikonfigurasikan untuk `migratus`.

Untuk menggunakan semua migrasi yang belum selesai:

lein migratus migrate

atau jika menggunakan clj dengan alias migratus:

clj -M:migratus migrate

Migratus akan menjalankan semua skrip `up` yang belum digunakan, mengikut susunan.

Adakalanya anda perlu membatalkan migrasi, mungkin disebabkan oleh ralat atau perubahan dalam keperluan. Migratus memudahkan proses ini.

Untuk mengembalikan migrasi terakhir yang digunakan:

lein migratus rollback

Perintah ini akan melaksanakan skrip `down` bagi migrasi yang paling baru digunakan. Anda boleh memanggilnya beberapa kali untuk mengembalikan migrasi yang lebih lama.

Pastikan skrip `down` anda sentiasa selamat dan idempoten!

Kita telah meneroka peranan penting migrasi pangkalan data dalam mengurus perubahan skema dalam projek Clojure. Anda telah mempelajari:

• Apakah skema dan migrasi pangkalan data.
• Manfaat perubahan skema yang dikawal versinya.
• Cara menggunakan `Migratus` untuk mentakrifkan dan menggunakan migrasi melalui skrip SQL `up` dan `down`.
• Perintah untuk menggunakan dan mengembalikan migrasi.

Dengan migrasi, skema pangkalan data anda boleh berkembang seiring dengan kod aplikasi secara terkawal dan boleh dipercayai!