db

SQLite: база — файл в каталоге плагина. Вкомпилирован в модуль: сервера, драйвера и конфига нет. Нужен там, где данные надо запрашивать; для конфига и списка админов проще store. Значения передаются через ? и подставляются драйвером.

db:exec("INSERT INTO kills VALUES (?, ?, ?)", p:steamid(), weapon, os.time())

Не склеивай запрос из данных игрока. Ник — это то, что игрок написал сам: через ? он попадёт в базу строкой, чем бы ни был, в склейке — станет частью запроса.

Типы

Lua	SQLite
`nil`	`NULL`
`true`, `false`	`1`, `0` — булева типа в SQLite нет
целое число	`INTEGER`
дробное	`REAL`
строка	`TEXT` с длиной: двоичные данные проходят целиком

Обратно INTEGER и REAL приходят числом, TEXT и BLOB — строкой. NULL приходит как nil, то есть ключа в таблице строки просто нет. Числа в Lua — double: точность целых кончается на 2^53.

Запросы идут в кадре

Модуль однопоточный, запрос выполняется прямо в игровом кадре. Локальный файл в WAL отвечает за доли миллисекунды, но запрос по таблице без индекса заморозит сервер целиком, поэтому слишком долгий прерывается:

query aborted after 203ms (cslua_db_timeout_ms is 200).
Add an index, narrow the query, or raise the limit

cvar	по умолчанию
`cslua_db_timeout_ms`	`200`	дольше — прерывание ошибкой; `0` снимает ограничение
`cslua_db_warn_ms`	`25`	дольше — предупреждение с именем плагина

Увидел предупреждение — ставь индекс, а не поднимай лимит. Сторож не покрывает ожидание блокировки: если файл базы держит другой процесс, ждать придётся честно.

Открытие


`db.open`	Открывает базу в каталоге плагина

Объект базы


`db:exec`	Выполняет запрос, ничего не возвращающий
`db:query`	Выполняет запрос и возвращает все строки
`db:first`	Выполняет запрос и возвращает первую строку
`db:prepare`	Разбирает SQL один раз для многократного выполнения
`db:transaction`	Выполняет блок одной транзакцией
`db:last_id`	Rowid последней вставки
`db:changes`	Сколько строк изменил последний запрос
`db:path`	Путь к файлу базы
`db:close`	Закрывает базу

Подготовленное выражение


`st:run`	Выполняет выражение, ничего не возвращающее
`st:query`	Выполняет выражение и возвращает все строки
`st:first`	Выполняет выражение и возвращает первую строку
`st:sql`	Исходный текст запроса
`st:close`	Освобождает выражение