在Unity中使用SQLite保存配置表數據(For Lua)

在Lua中使用sqlite

Lua版本Sqlite文檔：http://lua.sqlite.org/index.cgi/doc/tip/doc/lsqlite3.wiki

sqlite官網：https://www.sqlite.org/index.html

用途

• 把遊戲中的配置表數據存儲到sqlite中
• 存儲遊戲中的聊天記錄

sqlite的優勢

提升遊戲的啓動速度，在遊戲啓動時，不須要去加載配置文件，而是在用到時，從sqlite中讀取，大大提升啓動速度。

運行環境

咱們是把sqlite編譯進xlua的lib(.so)在lua中調用，沒有經過mono提供的sqlite接口訪問
個人運行環境以下（說明：文章寫於2017年6月1日，在草稿箱一直未發佈）

XLua： v2.1.6

Unity ：5.3.7

luasqlite版本：sqlite 3

使用示例

建立表並查詢

表的建立，添加數據，查詢

--a simple libsqlite3 binding for lua5.0-5.2 that provides 3 functions only and is still fully functional: local db = lsqlite.open(database) results, err = db:exec(statments) db:close()

require("lsqlite")

-- open an in memory database
db = lsqlite.open(":memory:")

-- open a file
-- open an inaccessible file
-- db = lsqlite.open("/root/test.db")

-- check if we got an handle
if not db then print("could not open the database") return end

db:exec("drop table 'my_table';")
db:exec("create table 'my_table' ( 'a', 'b' );")
db:exec("insert into 'my_table' values ( 1, 2 );")
db:exec("insert into 'my_table' values ( 3, 4 );")
db:exec("insert into 'my_table' values ( 5, 6 );")
db:exec("insert into 'my_table' values ( -111, -222 );")
results, err=db:exec("select * from 'my_table';")

print(err, results)

local sum=0
for i = 1, #results do
    for k, v in pairs( results[i] ) do
	print( i, k, v )
	sum=sum+v
    end
end

print("sum: " .. sum)

db:close()

更多例子：https://docs.coronalabs.com/api/library/sqlite3/index.html

判斷某張表是否存在

若是使用sqlite的語法，在lua版本中是無效的。

解決辦法：使用xpcall捕獲異常

數據查詢

---好比select(query)功能
for row in self.db:nrows('SELECT * FROM '..tableName..' where '..idKey..'="'..value..'"') do
--- row就是一行數據
end

對錶的操做

---對table的操做，一般用於insert,update，append，create
self.db:exec(sql)

注意事項

sqlite的部分功能在lua中並不能徹底使用

遇到問題

no lsqlite

直接在lua環境下，'require lsqlite`，報找不到lsqlite，須要導入sqlite，能夠把它編譯到xlua.so中

no field package.preload['lsqlite']
no such builtin lib 'lsqlite'
no such file 'lsqlite' in CustomLoaders!
no such resource 'lsqlite.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\lua\lsqlite.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\lua\lsqlite\init.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\lsqlite.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\lsqlite\init.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\..\share\lua\5.3\lsqlite.lua'
no file 'C:\Program Files\Unity_5_3_7_p4\Editor\..\share\lua\5.3\lsqlite\init.lua'

在Unity的lua環境沒法close全部鏈接，致使Unity鎖定db

查看文檔：http://lua.sqlite.org/index.cgi/doc/tip/doc/lsqlite3.wiki#db_close

使用db:close和db:close_vm() 都沒法徹底關閉db的鏈接

編輯db文件，提示database被鎖定

解決辦法：經過在Unity的C#層進行Close

個人經驗分享

把配置表分紅多個db

經實測在移動設備或模擬器上執行Update/Create Table等SQL語句，性能很是差，執行一次熱更新SQL約須要15s而直接下載並替換db則會快不少，因此我推薦直接替換db文件。

由於當有數據更新時是替換db，建議把常常修改的配置表放在一個db中，不常修改的放另外一個db，也就是把數據存在多個db中。

根據我從業三個rpg遊戲項目的經驗，最常修改的部分有：

1. 語言包
2. 任務表
3. 道具表(裝備，物品等等這些)
4. 新手引導
5. 自寶義配置表(key/value形式的表)
6. 活動表（充值/節日/節日活動表，部分數據放配置，部分配置協議下發）