Управление базами данных

Управление базами данных в Wilmo нужно для тех случаев, когда тебе надо быстро открыть базу проекта, посмотреть таблицы, проверить реальные записи и при необходимости выполнить точечное действие без отдельного SQL-клиента. Это полезно и для обычной проверки, и для диагностики, когда сайт, API или внутренний сервис ведут себя странно и нужно понять, что происходит в данных.

Через это окно удобно работать даже тогда, когда ты не хочешь постоянно держать в голове SQL-команды. Wilmo показывает структуру работы более наглядно: сначала движок, потом база, потом таблицы, а уже после этого конкретные данные внутри таблицы.

СКРИНШОТ: (сюда надо добавить общий скриншот окна управления базами данных, чтобы было видно движок, список баз, список таблиц и область со строками)

Что можно делать через это окно

Через Управление базами данных можно:

определить, какие движки БД доступны на сервере;
открыть список баз данных;
выбрать нужную базу;
просматривать таблицы;
смотреть строки и структуру таблиц;
выполнять SQL-запросы;
добавлять записи;
менять значения в таблице;
удалять строки;
работать с колонками таблицы;
смотреть пользователей базы данных.

Это особенно удобно, если ты поддерживаешь сайт, CRM, API, Telegram-бота или любой другой сервис, где время от времени нужно быстро заглядывать в данные.

Как открыть Управление базами данных

Открой Control Panel.
Нажми Управление базами данных.
Подожди, пока Wilmo загрузит доступные движки и базы.

Если на сервере установлен один поддерживаемый движок, он может открыться сразу. Если движков несколько, ты сможешь выбрать нужный вручную.

Как устроено окно

Обычно работа идёт по простой логике:

в одной части окна выбирается движок базы данных;
рядом показывается список баз;
после выбора базы открывается список таблиц;
в основной области отображаются данные, структура и дополнительные действия.

Такой формат помогает не потеряться, даже если на сервере несколько проектов и несколько баз.

СКРИНШОТ: (сюда надо добавить скриншот после открытия базы, чтобы было видно список таблиц и основную рабочую область)

Как выбрать нужную базу данных

Если на сервере несколько баз:

Сначала выбери нужный движок.
Найди в списке баз нужное название.
Если баз много, используй поиск по списку.
Нажми по базе.
Дождись загрузки таблиц.

Обычно по названию базы уже можно понять, к какому проекту она относится. Если названия похожие, лучше заранее свериться с конфигом проекта или .env, чтобы не открыть не ту базу.

Как открыть таблицу

После выбора базы:

Найди список таблиц.
При необходимости используй поиск по таблицам.
Выбери нужную таблицу.
Дождись загрузки содержимого.

С этого момента ты уже можешь смотреть строки, колонки и данные внутри таблицы.

Это очень полезно, когда нужно быстро проверить:

действительно ли таблица существует;
есть ли в ней данные;
какие поля используются;
всё ли в порядке со структурой проекта.

Как посмотреть содержимое таблицы

Когда таблица открыта, Wilmo показывает строки в табличном виде. Это заметно удобнее, чем читать сырой вывод из консоли, потому что ты сразу видишь:

реальные значения;
пустые поля;
даты;
id записей;
общую картину по данным.

Такой просмотр особенно полезен для таблиц с:

пользователями;
заказами;
контентом;
настройками сайта;
токенами;
задачами очереди;
служебными данными проекта.

СКРИНШОТ: (сюда надо добавить скриншот открытой таблицы со строками, чтобы было видно, как выглядит просмотр записей)

Как посмотреть структуру таблицы

Если тебе важно понять не только данные, но и само устройство таблицы:

Открой нужную таблицу.
Найди блок структуры или список колонок.
Посмотри названия полей, типы и основные параметры.

Это помогает, когда:

нужно найти правильное имя поля;
приложение ругается на отсутствующую колонку;
ты хочешь понять, где хранится конкретная информация;
нужно подготовиться к ручному редактированию данных.

Как выполнить SQL-запрос

Иногда нужно не просто смотреть таблицу, а сделать свою выборку или точечное изменение.

Для этого:

Открой нужную базу данных.
Найди область SQL-запросов.
Введи запрос вручную.
Ещё раз проверь его.
Нажми выполнение запроса.

Этот режим особенно полезен, когда нужно:

найти запись по условию;
сделать нестандартную выборку;
быстро проверить количество строк;
обновить конкретную запись;
удалить мусорные данные осознанно, а не по одной строке.

Если ты не уверен в запросе, сначала лучше использовать SELECT, а не UPDATE или DELETE.

СКРИНШОТ: (сюда надо добавить скриншот области SQL-запросов, чтобы было видно поле ввода и результат выполнения)

Как добавить новую строку

Если таблица поддерживает ручное добавление записи:

Открой нужную таблицу.
Найди кнопку добавления строки.
Заполни поля, которые предлагает Wilmo.
Проверь значения.
Подтверди создание.

Это удобно, когда нужно:

создать тестовую запись;
быстро завести объект вручную;
восстановить отдельную строку;
внести небольшое изменение без отдельного импорта.

Как изменить существующее значение

Если в таблице уже есть нужная запись:

Найди её в списке строк.
Выбери нужную ячейку или действие редактирования.
Измени значение.
Подтверди сохранение.

Перед этим полезно убедиться, что ты редактируешь именно ту запись, которая нужна. В production-базе лучше сначала понять, как это изменение повлияет на приложение, сайт или пользователей.

Как удалить строку

Если запись нужно убрать:

Найди нужную строку.
Нажми действие удаления.
Ещё раз проверь, что выбрана правильная запись.
Подтверди удаление.

Удалять строки надо особенно осторожно. Если у проекта нет мягкого удаления или журнала изменений, такая операция может быть необратимой.

Как работать с колонками таблицы

Через окно управления БД можно работать не только с данными, но и со структурой таблицы.

Обычно доступны действия:

добавить колонку;
изменить существующую колонку;
удалить колонку.

Такой режим полезен, если нужно быстро внести небольшое изменение в структуру таблицы и ты понимаешь, что именно делаешь. Но если база используется живым проектом, сначала стоит убедиться, что приложение действительно готово к такому изменению.

Как работать с пользователями базы данных

В некоторых сценариях Wilmo показывает и пользователей БД. Это полезно, если тебе нужно разобраться:

какой пользователь используется приложением;
есть ли отдельный пользователь под конкретный проект;
не перепутаны ли доступы между несколькими сайтами;
кто вообще имеет доступ к базе.

Это особенно помогает после переезда проекта, при диагностике ошибок подключения к базе или при работе сразу с несколькими сервисами на одном сервере.

Когда этот инструмент особенно полезен

Управление базами данных особенно выручает, когда:

сайт работает странно и нужно посмотреть реальные данные;
надо быстро проверить, существует ли нужная таблица;
приложение не может подключиться к базе;
нужно сравнить данные до и после изменения;
ты не хочешь открывать отдельный SQL-клиент ради одной задачи;
нужно аккуратно проверить production-базу без хаотичной работы в терминале.

Для повседневной работы это один из самых удобных инструментов Wilmo, потому что он сильно сокращает путь от вопроса "что у нас в БД?" до реального ответа.