最新play框架手册19管理数据库变化evolution资料Word文档下载推荐.docx
《最新play框架手册19管理数据库变化evolution资料Word文档下载推荐.docx》由会员分享，可在线阅读，更多相关《最新play框架手册19管理数据库变化evolution资料Word文档下载推荐.docx（9页珍藏版）》请在冰豆网上搜索。
emailvarchar（255）NOTNULL,
passwordvarchar（255）NOTNULL,
fullnamevarchar（255）NOTNULL,
isAdminbooleanNOTNULL,
PRIMARYKEY（id）
）;
Downs
DROPTABLEUser;
正如你看到的一样，必须在sql脚本里使用注释来界定Ups和Downs节
如果在applictaion.conf里配置了数据库，那么Evolutions将被自动激活，而
且evolutionscripts将被显示出来。
通过设置evolutions.enabled为false
可以禁此显示脚本。
比如，当测试他们自己的数据库里，你可以为测试环境设置为禁用模式。
当evolutions被激活后，在DEV莫式下，Play将为每个请求检查数据库结构状态，或在PRODS式下启动应用程序时进行数据库结构状态检查。
在DEV莫式
下，如果数据库结构不是最新的，一个错误页面会显示出来，它会建议你运行合适的sql脚本同步你的数据结构。
Applicationerror
+*http:
//localhost:
9000/
Yourdatabaseneedsevolution!
AnSQLscriptwillberunonyourdatabase,
ThisSQLscriptmustberun:
idbigint（20）NOTNULLAUTO_INCREHENTfemailvarchar（255）NOTNULL,passwordvarchar（255）NOTNULL,fallnamcvarchar（255）NOTNULL,iaAdminbooleanNOTKULLt
PRIMARYKEY（id}
Thisexceptionhasbeenloggedwithid662c0klcb如果你同意推荐的SQU脚本，你可以点击‘Applyevolutions'
按钮执行该建议脚本。
如果使用的是内存数据库（db=mem）,并且数据库是空的情况下，Play会自动运行所有的evolutions脚本。
同步同时发生的改变
现在让我们假定现在在同一项目中有两个开发者，A开发者因工作需要必须创建
一个新的数据库表，因此他将2.sqlevolution脚本:
#AddPost
CREATETABLEPost（
idbigint（20）NOTNULLAUTO_INCREMENT,
titlevarchar（255）NOTNULL,
contenttextNOTNULL,postedAtdateNOTNULL,author_idbigint（20）NOTNULL,
FOREIGNKEY（author_id）REFERENCESUser（id）,
Downs
DROPTABLEPost;
Play将应用这个evolution脚本到A开发者的数据库。
另外一方面，B开发者因工作需要，必须删除User表。
因此他也将创建2.sqlevolution脚本：
#UpdateUser
ALTERTABLEUserADDageINT;
ALTERTABLEUserDROPage;
B开发者结束开发工作后进行了提交（称为Git）。
现在，A开发者在继续开发前必须合并他的同事的工作，因此他运行gitpull，但合并操作产生了一个冲突，如下：
Auto-mergingdb/evolutions/2.sql
CONFLICT（add/add）:
Mergeconflictindb/evolutions/2.sqlAutomaticmergefailed;
fixconflictsandthencommittheresult.
每个开发者都创建了一个2.sqlevolution脚本。
因此，A开发者需要合并这个文件：
<
HEAD
#AddPost
#---!
UpsCREATETABLEPost（
titlevarchar（255）NOTNULL,contenttextNOTNULL,postedAtdateNOTNULL,author_idbigint（20）NOTNULL,
DownsDROPTABLEPost;
#UpdateUser
>
devB
这个合并操作其实很容易做:
#AddPostandupdateUser
idbigint（20）NOTNULLAUTO_INCREMENT,titlevarchar（255）NOTNULL,contenttextNOTNULL,postedAtdateNOTNULL,
author_idbigint（20）NOTNULL,
这个evolution脚本显示为新修订revision2的数据库，这个版本不同于A开发者之前已经应用的修订2版本。
因此Play会察觉到这个情况，并要求A开发者通过首先恢复已经应用的旧的修订2版本来同步他的数据库，并应用新的修订2版本脚本：
+**http:
//localhost:
AnSQLscriptwillberunonyourdatabase.
flEWARNING!
ThiascriptcontainsDOWNSevolutionsthatarelikelydestructives
#---Revi21Downs-lb^Of5f
DROPTABLEPest;
#Rev：
2,Ups»
?
cf7el2
ALTERTABLEUserADDagoINT;
CREATETASLEPost（
idbigint（20）NOTNULLAUTOINCREMENTttitlevarchar（25S）NOTNULL?
contenttextNOTNULL,postedAtdateNOTNULL,author^idbigint（20）NOTNULL,
FOREIGNKEY（author_id）REFERENCESUser{idPRIMARYKEY（id）
）；
ApplyevaluiTcns
Thisexceptionhasbeenloggedwithid6S2c0klcd
数据不一致状态
某些时候可能会在evolution脚本里犯错，那么这些脚本就会失效。
在这种情况下，play将标记数据库结构为数据不一致状态，同时要求你在继续工作前手工解决这个问题。
比如，Evolution脚本的Ups存在一个错误：
#AddanothercolumntoUser
ALTERTABLEUserxxxADDcompanyvarchar（255）;
ALTERTABLEUserDROPcompany;
因此，试着应用这个evolution将导致失败，play将把数据库结构标记为
inconsistent:
+t*hnp：
//localhost：
Yourdatabaseisaninconsistentstate!
Anevolutionhasnotbeenappliedproperly.Pleasechecktheproblemandresolveitmanual
ThisSQLscripthasbeenrun,andtherewasaproblem:
#---Rev:
3fUps-c0d5el7
ALTERTABLEUserxxxADDconipanyvarchar（255};
Thiserrorhasbeenthrown:
Table*te3t*uscrxxx1doosn*texist（EftROR;
1.146,SQLSTATE*42S02）
Markitresotved
Thisexceptionhasbeenloggedwithid662cDkld3
现在要继续工作前，你必须解决这个不一致的问题，因此你就运行了fixedSQL
命令:
ALTERTABLEUserADDcompanyvarchar（255）;
…之后，通过单击按钮，手工解决了这个标记的问题。
但是由于你的evolution脚本存在错误，你或许希望修复这个错误。
因此你修改了3.sql脚本：
#AddanothercolumntoUser
ALTERTABLEUserDROPcompany;
Play检测到这个新的evolution，然后替换了之前的3版，之后将运行下面的脚本：
+**hnp:
#llJWARNINGEThiascriptcontainsDOWNSevolutionsthatarelikelydestructives
#---Rev:
3rDowns■c0d5cl7
#Rev：
3,Ups■L5ed3f5
ALTERTABLEUserADDcompanyvarchar（255;
Applyevolutions
Thisexceptionhasbeenloggedwithid662c0kld7
现在所有的问题都已处理好，你又可以继续工作了。
在开发模式里，处理这样的问题非常简单，可以直接丢弃现在的开发数据库，然后再次重头申请所有的evolutions脚本即可。
Evolutions命令
在DEV模式里，evolutions是交互式执行的。
然而在PRO模式里，在运行应用程序前，你就必须使用evolutions命令来修订你的数据库结构。
在生产模式下如果你试着运行一个数据库不是最新版的应用程序时，应用程序将不能启动。
~___||||
~|'
_\||/_'
||||_|
~|__/|_|\|\__（_）
~|_||__/
~play!
master-localbuild,http:
//www.playframework.org
~frameworkIDisprod
~Ctrl+Ctostop
13:
33:
22INFO~Starting~/test
22INFO~Precompiling...
24INFO~Connectedtojdbc:
mysql:
//localhost
24WARN~
24WARN~Yourdatabaseisnotuptodate.
24WARN~Use'
playevolutions'
commandtomanagedatabaseevolutions.
24ERROR~
@662c6n234
Can'
tstartinPRODmodewitherrors
play.db.Evolutions$InvalidDatabaseRevision
atplay.db.Evolutions.checkEvolutionsState（Evolutions.java:
323）
atplay.db.Evolutions.onApplicationStart（Evolutions.java:
197）
atplay.Play.start（Play.java:
452）
atplay.Play.init（Play.java:
298）
atplay.server.Server.main（Server.java:
141）
Exceptioninthread"
main"
play.db.Evolutions$InvalidDatabaseRevisionat
play.db.Evolutions.checkEvolutionsState（Evolutions.java:
错误消息要求你运行playevolutions命令：
$playevolutions
~frameworkIDisgbo
~Connectedtojdbc:
~Applicationrevisionis3[15ed3f5]andDatabaserevisionis0[da39a3e]
~Yourdatabaseneedsevolutions!
#
1,Ups-6b21167
idbigint（20）NOTNULLAUTO_INCREMENT,emailvarchar（255）NOTNULL,passwordvarchar（255）NOTNULL,fullnamevarchar（255）NOTNULL,isAdminbooleanNOTNULL,PRIMARYKEY（id）
2,Ups-9cf7e12
contenttextNOTNULL,
postedAtdateNOTNULL,
3,Ups-15ed3f5
~Run'
playevolutions:
apply'
toautomaticallyapplythisscripttothe
db
~orapplyityourselfandmarkitdoneusing'
playevolutions:
markApplied'
如果你打算让Play自动为你运行evolution，那么要使用如下命令：
$playevolutions:
apply
如果你喜欢在你的生产数据库上手工运行脚本，那么你需要告诉play你的数据库是最新的：
markApplied
如果在自动运行evolution脚本时存在错误，在DEV莫式下，可以手工解决他们，之后标记数据库结构为已修正状态：
resolve
升级会员 