Download to read offline
![[BDD] Introduction to Behat (PL)](https://cdn.slidesharecdn.com/ss_thumbnails/behat-141216193109-conversion-gate01-thumbnail.jpg?width=640&height=640&fit=bounds)
Liquibase - database structure versioning
- 1. Wersjonowanie baz danych podczasdevelopmentu Liquibase Piotr Pelczar me@athlan.pl
- 2. Piotr ’Athlan’ Pelczar Freelancer:vgroup.pl, athlan.pl goldenline.pl/piotr-pelczar me@athlan.pl
- 3. Agenda 1. 2. 3. 4. 5. 6. 7. 8. 9. Problem wersjonowania strukturbaz danych Przedstawienie narzędzia Liquibase Instalacja Pierwszy zrzut bazy, tworzenie tagów Database diff, tag Rollback Preconditions Dobre praktyki Integracja z Maven i Eclipse
- 4. Problem • Baza danychmusi być integralna podczas developmentu. • Jak utrzymać jej integralność? • Jak pozbyć się problemu supportowania developerów? • Problem branchowania i mergeowania zmian wprowadzanych podczas równoległego rozwoju aplikacji.
- 5. Czym jest Liquibase? • • • • Niezależnaod bazy danych biblioteka. OpenSource. Dostępna z linii poleceń. Do śledzenia i zarządzania zmianami w bazie danych. • Zmiany są zapisywane w plikach XML.
- 6. Wspierane bazy danych • • • • • • • • MySQL PostgreSQL Oracle MS-SQL SybaseEnterprise Sybase Anywhere DB2 Apache Derby http://www.liquibase.org/databases Warto się zapoznać z issues. • • • • • • • HSQL H2 Informix InterSystems Caché Firebird SAPDB SQLite
- 7. Format zmian • • • • Jako plikXML Obsługuje ponad 40 rodzajów zmian W tym raw SQL, co jest otwartą furktą Można uruchamiać komendy shell http://www.liquibase.org/manual/refactoring_commands
- 8.
- 9. Format zmian • Zmianysą również przechowywane lokalnie w bazie danych w tabeli databasechangelog
- 10. Współbieżność pracy • Współbieżnośćjest zagwarantowana poprzez wpisy w tabeli databasechangeloglock
- 11. Uruchamianie Liquibase Możliwość uruchomieniaLiquibase z poziomu: • • • • • • • Ant Maven Spring Framework (jako bean w kontekście) Grails Servlet Listener Command Line Integracja z Hibernate
- 12. Instalacja 1. http://www.liquibase.org/download 2. Rozpakowujemy 3.Pobieramy odpowiedni driver JDBC do bazy danych, np. postgresql-9.1-902.jdbc4.jar
- 13. Instalacja 4. W bieżącymkatalogu tworzymy pusty liquibase.properties z wpisem: classpath=D:ProgramsLiquibase postgresql-9.1-902.jdbc4.jar Nadpisuje on wartości z linii poleceń, można zmienić lokalizację za pomocą flagi -defaultsFile http://www.liquibase.org/manual/command_line#using_a_li quibaseproperties_file
- 14. Wymagania 1. Java 1.5lub nowsza 2. Poprawnie skonfigurowany classpath oraz JAVA_HOME 3. Tak, aby Java była dostępna z polecenia: java -version 4. Liquibase jest uruchamiane jako archiwum JAR: java -jar liquibase.jar
- 15.
- 16. Pierwszy zrzut bazydanych liquibase --url=jdbc:postgresql://localhost:5432/ handlowcy --username postgres --password root --changeLogFile="schema.xml" generateChangeLog http://www.liquibase.org/manual/generating_changelogs
- 18. Pierwszy zrzut bazydanych Ograniczenia, w sposób automatyczny nie są zrzucane: • Procedury składowane • Funkcje • Triggey • Jest możliwość wykonywania swoich zapytań SQL, ale nie będą przenośne. http://www.liquibase.org/manual/generating_changelogs
- 19. Załadowanie schematu bazy liquibase --url=jdbc:postgresql://localhost:5432/ handlowcy_dev --usernamepostgres --password root --changeLogFile="schema.xml" update
- 20. Wygenerowanie zapytań SQL liquibase --url=jdbc:postgresql://localhost:5432/ handlowcy_dev --usernamepostgres --password root --changeLogFile="schema.xml" updateSQL > changes.sql
- 21. Nadeszły zmiany, diff Sprawdzeniezmian, które nastąpiły: liquibase --url=jdbc:postgresql://… --username postgres --password root --referenceUrl=jdbc:postgresql://… --referenceUsername postgres --referencePassword root diff
- 22.
- 23. Generujemy zmiany, diffChangeLog liquibase --url=jdbc:postgresql://… --usernamepostgres --password root --referenceUrl=jdbc:postgresql://… --referenceUsername postgres --referencePassword root --changeLogFile=changelog-DATE-ath.xml diffChangeLog
- 24. Diff danych liquibase --url=jdbc:postgresql://… --username postgres --passwordroot --referenceUrl=jdbc:postgresql://… --referenceUsername postgres --referencePassword root --changeLogFile=changelog-DATE-ath.xml --diffTypes=data diffChangeLog
- 25. Diff uwagi Diff obsługuje: •Missing/unexpected tables, views, columns • Missing/unexpected primary keys, unique constraints • Missing/unexpected foreign Keys • Missing/unexpected sequences, indexes • Column definition differences (data type, autoincrement, etc.) • View definition differences • Data differences (limited), not checked by default
- 26. Nadeszły zmiany, diff Diffnie obsługuje: • Non-foreign key constraints (check, etc) • Stored Procedures • Data type length* * Testowano: Zmiany długości varchar w PostgreSQL są wykrywane.
- 27. Nadeszły zmiany, diff •Ważnym jest, żeby dobrze interpretować „reference”. Z naszej perspektywy baza produkcyjna jest główną, a rererence jest developerska. Jeżeli odwrócimy, naturalną konsekwencją jest wygenerowanie DROP’ów zamiast CREATE’ów. • Umieszczanie daty i nazwy dewelopera w nazwach plików changelogów to dobry nawyk: 2012-11-24-athlan.xml. • Przy zbiorczych change’ach pliki te jednoznacznie są identyfikowane nie tylko w Liquibase, ale na repozytorium git czy SVN, można je łatwiej mergeować.
- 28. Nadeszły zmiany, diff •Raz wykonany changeSet już nigdy nie zostanie powtórzony (identyfikowany po author oraz id). • Nie ma poprawiania XML na repo.
- 29. Tagowanie bazy danych 1.W pliku XML <tagDatabase tag="NAZWA"/> 2. Z poziomu linii poleceń liquibase --url=jdbc:postgresql://… --username postgres --password root tag NAZWA
- 30.
- 31. Rollback liquibase --url=jdbc:postgresql://… --username postgres --password root rollbacktag rollbackSQL tag > rollback.sql
- 32. Rollback • Większość operacjima komplementarne sobie operacje odwrotne. • Jeżeli nie mają, lub chcemy podjąć inne akcje, do changeset’a dodajemy tag <rollback> • Są zapisywane w bazie danych.
- 33.
- 34.
- 35. Preconditions Warunki, które musząbyć spełnione, aby nastąpił cały zestaw changeset’ów lub pojedynczy z nich. Przydają się, gdy: • Osoba przygotowująca changelog ma jakieś założenia. • Zapewnia ich przestrzealność. • Umożliwia sprawdzenie danch, bądź parametrów. • Decyduje, które chengesety są uruchamiane, a które nie.
- 36.
- 37.
- 38.
- 39. Dobre praktyki 1. Trzymajchangelog’i spięte <include> zawarte w master.xml i wykonuj master’a
- 40. Integracja z Maven:pom.xml • Tworzymy główny pom.xml • Przykład dotyczy modułu common-model
- 41. Integracja z Maven:pom.xml
- 42. Integracja z Maven:pom.xml
- 43. Integracja z Maven:pom.xml Kompilacja Maven z changesetami: mvn install:liquibase
- 44. Pytania? 1. 2. 3. 4. 5. 6. Database diff, tag Rollback Preconditions Dobrepraktyki Integracja z Maven i Eclipse Inne… Piotr Pelczar me@athlan.pl
- 45. Wersjonowanie baz danych podczasdevelopmentu Liquibase Piotr Pelczar me@athlan.pl