Создать драйвер БД
Подготовьте отдельный адаптер вашей СУБД или внутреннего сервиса. Общая панель GrigDesk сможет использовать его через контракт движка.
Порядок разработки
- Изучите контракт и структуру пакета и адаптеры установленной версии GrigDesk. Определите поддерживаемые подключения, запросы, права и способ отмены.
- Создайте отдельный репозиторий с уникальным
id,engine.jsonи точкой входа.mjs. Для своего MySQL используйте собственный id, напримерteam-mysql, а не встроенныйmysql. - Реализуйте все восемь методов адаптера. Если СУБД не умеет оценивать или отменять запрос определённым способом, отразите это в поведении и возможностях, а не возвращайте фиктивный успех.
- Начните с подготовленных данных и отдельной тестовой базы. Не используйте рабочую базу для первых экспериментов с записью и отменой.
- Оформите стабильную версию тегом
vX.Y.Z, затем выполните обычную установку и ручной перезапуск сервера. - Создайте тестовый профиль, откройте сессию и проверьте сценарии в панели.
Что проверить
| Сценарий | Ожидаемый результат |
|---|---|
| Соединение и неверный пароль | Корректный вход или понятная ошибка без раскрытия секрета. |
| Чтение схемы и запрос | Согласованный формат таблиц, столбцов и строк. |
| Роль чтения | Анализ запроса и реальные права подключения не разрешают скрытую запись. |
| Ограничение результата | Драйвер соблюдает лимиты; усечённый результат не выдаётся за полный. |
| Долгий запрос | Работают предусмотренные таймаут и отмена. |
| SSH, если поддерживается | Используется переданный канал, корректно закрываются ресурсы. |
| Обновление пакета | Активная сессия блокирует замену; новая версия загружается после перезапуска. |
Драйвер получает пароль и доступ к сети. Не сохраняйте секреты в репозитории и не подменяйте проверку прав заявлением readOnly без проверки подключения. Пример или успешная установка не доказывают готовность драйвера к рабочим данным.
Вернуться к драйверам БД или подключениям и сессиям.