[Гайд] Безпечна робота з MySQL в MTA:SA без фризів сервера (dbQuery vs dbExec)

SanAndreasDev

⚡ Full-Stack MTA Scripter & SQL Master
⚡ DOWNLOADER
Перевірений продавець
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️ 🏎️ ❤️ ⚡
Рейтинг
550 pts
Часто бачу, як навіть досвідчені розробники використовують синхронний dbPoll(qh, -1) прямо в головному потоці обробників команд чи подій. Коли на сервері грає 80+ людей, один повільний запит до бази фризить абсолютно весь сервер на 1-2 секунди, від чого у всіх гравців підстрибує пінг!

У цьому мануалі розберемо, як писати повністю асинхронний код:

1. Ніколи не блокуйте потік
Не передавайте -1 у dbPoll всередині функцій геймплею.

2. Завжди використовуйте callback у dbQuery
Код:
function loadPlayerStats(player, accountId)
    dbQuery(function(qh)
        local result, rows, err = dbPoll(qh, 0)
        -- Критично важливо перевірити, чи гравець ще на сервері!
        if not isElement(player) then return end
        
        if result and rows > 0 then
            local data = result[1]
            setElementData(player, "money", data.money)
            setElementData(player, "level", data.level)
            outputChatBox("Ваші дані успішно завантажено з бази!", player, 0, 255, 0)
        end
    end, dbConnection, "SELECT money, level FROM users WHERE id = ? LIMIT 1", accountId)
end

3. Для INSERT та UPDATE використовуйте dbExec
Функція dbExec за замовчуванням виконується у фоновому потоці C++ та ніколи не зупиняє ігровий цикл сервера.

Дотримуйтесь цих простих правил, і ваш сервер працюватиме зі стабільним тікрейтом 60 TPS!
 

Yaroslav_LUA

💻 Senior Lua Architect | CEF & Sync
⚡ DOWNLOADER
Перевірений продавець
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ ❤️ ⚡
Рейтинг
760 pts
Чудовий та своєчасний гайд! Хотів би наголосити на рядку if not isElement(player) then return end.
Багато скриптерів забувають, що поки база обробляє запит (навіть 10-15 мілісекунд), гравець може натиснути Quit або вилетіти через втрату зв'язку. І якщо не поставити перевірку на валідність елемента, сервер виплюне warning у debugscript 3.
Дякую за деталізацію, колего!
 

Віталій Литвин

Новий учасник
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈
Рейтинг
385 pts
Дуже корисний мануал! Забрав собі у закладки, якраз переписую систему авторизації.
А підкажи, будь ласка, чи є велика різниця у швидкодії між зовнішньою MySQL та вбудованою SQLite для невеликих локальних серверів на 20-30 слотів?
 

SanAndreasDev

⚡ Full-Stack MTA Scripter & SQL Master
⚡ DOWNLOADER
Перевірений продавець
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️ 🏎️ ❤️ ⚡
Рейтинг
550 pts
Віталій Литвин, для локалки або серверів до 30 людей вбудована в MTA SQLite працює блискавично, бо база зберігається локально в одному файлі. Але якщо у планах веб-сайт, автодонат або Discord-бот — тоді однозначно переходь на MySQL / MariaDB!
 
Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
Вітаю, SanAndreasDev! Дякую за активність на порталі URBAN MTA.

Щира подяка за внесок у навчальну базу нашого порталу! Якісні українськомовні гайди по MTA — це саме те, що допомагає новачкам швидше опанувати скриптинг та моделювання.

Питання до автора:
Чи плануєте ви випустити другу частину з практичними прикладами або відеоуроком? Якщо потрібна допомога з оформленням теми чи виділенням коду в спойлери — звертайтеся, ми завжди підтримаємо!
 
Зверху
\n\n