Migracje bazy danych

Nigdy nie importujesz SQL ręcznie. bs_core tworzy i aktualizuje schemat sam przy starcie.

Jak to działa

• Pliki migracji są w bs_core/sql/, numerowane (obecnie od 001_core_schema.sql do 035_faction_jobs.sql).
• Przy starcie bs_core uruchamia po kolei każdy plik ze swojej listy, który nie jest jeszcze zapisany, i zapisuje go w tabeli bs_migrations razem z sumą kontrolną. Plik nigdy nie leci dwa razy.
• Konsola wypisuje, co zostało zastosowane przy tym starcie.
• Kilka resource’ów tworzy własne małe tabele przez CREATE TABLE IF NOT EXISTS przy starcie (na przykład bs_tester i bs_config). Przy nich też nic nie robisz.

Ostatnie

Plik	Dodaje
029_vehicle_world.sql	Pojazdy świata, brakujące części
030_user_language.sql	bs_users.language
031_building.sql	bs_build_pieces, bs_build_bases, przenosi stare konstrukcje do frakcji
032_crafting.sql	Kolejki stacji, pułapki, zwroty offline, punkty recyclera
033_medical.sql	bs_character_medical: rany, infekcja, choroba, krew
034_base_flags.sql	Flagi safezone i placówek, ogłoszone raidy
035_faction_jobs.sql	Członkowie prac, tablica, wyniki, wybory prac, praca w garażu
045_darkzone.sql	Dark Zone (1.1.0)
046_building_v2.sql	Budowanie v2: prąd, generatory, flagi (1.1.0)
047_faction_emblems.sql	Emblematy frakcji (1.1.0)
048_backpack_refresh.sql	Przedmioty plecaków przemianowane, zawartość zostaje (1.1.0)

Dodawanie własnej

1. Weź kolejny numer: bs_core/sql/036_my_change.sql.
2. Napisz ją tak, żeby była bezpieczna na bazie, która już ma dane. Dodawaj kolumny z wartościami domyślnymi, nie usuwaj rzeczy, których ludzie jeszcze używają.
3. Dodaj nazwę pliku do listy w bs_core/server/sv_migrations.lua (M.files). Lista jest zakodowana na sztywno. Plik, którego w niej nie ma, po cichu nigdy się nie uruchomi.
4. Zrestartuj serwer (restart samego bs_core wyrzuca wszystkich).

Uwaga

Nigdy nie edytuj migracji, która już przeszła na działającym serwerze. Zrób nową. Stara nie uruchomi się ponownie, więc twoja zmiana nigdy nie trafi do tej bazy.

Backupy

Przed aktualizacją z migracjami zrób backup. W Windowsie:

powershell -ExecutionPolicy Bypass -File .\tools\Backup-Database.ps1

Zobacz Aktualizacja i baza danych, żeby przywrócić dane i przenosić postacie między serwerami.