將 Schema 加入變更群組

小巧。快速。可靠。
任選三項。

Session 模組 C 介面

將 Schema 加入變更群組

int sqlite3changegroup_schema(sqlite3_changegroup*, sqlite3*, const char *zDb);

此方法可用於選擇性強制執行規則，即加入變更群組處理的變更集必須與資料庫 zDb（「main」、「temp」或附加資料庫的名稱）的 Schema 相符。如果呼叫 sqlite3changegroup_add() 以加入與已設定 Schema 不相容的變更集，則會傳回 SQLITE_SCHEMA，且變更群組物件會保留在未定義的狀態。

變更集 Schema 被視為與資料庫 Schema 相容，方式與 sqlite3changeset_apply() 相同。特別是，對於變更集中每個表格，都存在一個資料庫表格，其

名稱由變更集識別，且
欄位至少與變更集中記錄的欄位數目一樣多，且
主鍵欄位與變更集中記錄的位置相同。

變更群組物件的輸出始終與使用此函式指定的資料庫 Schema 相同。在傳遞給 sqlite3changegroup_add() 的變更集欄位數目少於資料庫 Schema 中對應表格的欄位數目的情況下，這些欄位會使用資料庫 Schema 中的預設欄位值填入。這使得可以合併變更群組中單一表格中欄位數目不同的變更集，前提是它們在其他方面相容。

另請參閱物件、常數和函式清單。