self:sync
Server
Synchronises all defined table schemas with the database, creating any tables that do not already exist
Syntax
local promise = self:sync()This function returns a promise and starts processing the query. Use thread:await inside a thread to retrieve the result.
- Inside a thread —
self:await(db:sync())yields until the sync completes, then returns the resolved values - Outside a thread — the promise can still be created, but must be awaited from within a thread to retrieve the result
Parameters
| No parameters are accepted by this function |
|---|
Returns
| Type | Name | Description |
|---|---|---|
promise | promise | Refer Settlements section |
Settlements
| Type | Name | Description |
|---|---|---|
bool | status | true on success, false on failure |
bool | resolved | true |
string | rejected | Error message describing the failure |
Examples
local db = database.create("127.0.0.1", "root", "", "vital_sandbox")
db:define("players", {
id = { type = "INT UNSIGNED", primary = true, autoincrement = true, nullable = false },
name = { type = "VARCHAR(64)", nullable = false },
score = { type = "INT", nullable = true }
})
thread.create(function(self)
local ok, err = self:await(db:sync())
if not ok then
engine.print("error", err)
end
end):resume()