Браузер БД

Браузер БД — это инструмент, с помощью которого можно просматривать содержимое баз данных и управлять ими (осуществлять все CRUD-операции) из Платформы без сторонних программных решений.

Внимание

Этот функциональный модуль Платформы доступен:

  • только по дополнительной лицензии;

  • только с Агентом версии 5.0 и выше.

Страница Браузер БД

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

На странице отображается список с информацией о базах данных, присутствующих в экземпляре PostgreSQL, а также их количество и общий размер.

У каждой базы данных есть три кнопки: «Аудит», «SQL-редактор» и «Схема данных».

  1. «Аудит» — открывает страницу инспектирования БД с дополнительной информацией о ней.

  2. «SQL-редактор» — позволяет подключиться к БД и открыть панель Браузера БД на вкладке SQL-редактора.

  3. «Схема данных» — позволяет подключиться к БД и открыть панель Браузера БД.

Страница инспектирования БД

После нажатия на кнопку «Аудит» откроется страница с подробной информацией о базе данных, присутствующей в PostgreSQL.

База данных

Информация по HEALTHCHECKS собирается автоматически при входе на страницу.

Чтобы обновить собранные данные, нажмите на кнопку «Обновить данные» (цифра 2 на рисунке выше). Информация кешируется в рамках пользовательской сессии с указанием времени сбора данных.

Кнопка «Скачать отчет» позволяет скачать отчет по аудиту в формате pdf. В отчете собрана основная информация о БД, полная аналитика таблиц, а также указаны все проблемы и даны рекомендации по их решению.

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

На текущий момент поддерживается следующий список проверок (HEALTHCHECKS):

  • Таблицы с кандидатами для частичных индексов,

  • Индексы таблиц с значениями NULL > 50%,

  • Самые большие таблицы,

  • Таблицы с индексами максимального размера,

  • Топ записываемых таблиц,

  • Топ читаемых таблиц,

  • Таблицы с наибольшим раздутием,

  • Таблицы с наибольшим количеством последовательных сканирований,

  • Таблицы с недопустимыми индексами,

  • Таблицы с неиспользуемыми индексами,

  • Таблицы с избыточными индексами,

  • Таблицы с внешними ключами без индексов,

  • Таблицы, у которых тип данных внешнего ключа отличен от исходного,

  • Таблицы с низким коэффициентом обновления HOT,

  • Таблицы с возможными проблемами при автоанализе,

  • Таблицы с возможными проблемами автоочистки,

  • Таблицы без уникальных индексов.

Максимальное количество таблиц для одной проверки — 20.

Если в базе данных есть проблемы со схемой данных или настройками конфигурации, в соответствующем HEALTHCHECK отобразится таблица. Затем вы можете выбрать интересующую проблему в разделе «Проверка состояния» (цифра 3 на рисунке выше). HEALTHCHECKS можно отфильтровать по уровню важности (цифра 4 на рисунке выше).

Карта таблиц

По карте таблиц можно отследить их размер и состояние.

15 самых больших таблиц отображаются отдельными блоками. Размер блока зависит от размера таблицы. Очень маленькие таблицы могут не отображаться на карте. Блок каждой таблицы будет окрашен в зависимости от её состояния:

  • зелёный — нет ошибок или предупреждений;

  • жёлтый — есть предупреждения;

  • красный — есть ошибки.

Щёлкните по блоку таблицы, чтобы просмотреть ошибки или предупреждения.

Таблицы не из ТОП-15 будут объединены в блок «Остальные таблицы». Щёлкните по блоку, чтобы открыть подробную информацию. В открывшемся окне отображается:

  • общий список таблиц с их размерами;

  • таблицы с ошибками;

  • таблицы с предупреждениями.

В поисковой строке можно искать таблицы по названию.

На вкладках «Ошибки» и «Предупреждения» щелкните по стрелочке рядом с названием таблицы, чтобы открыть подробную информацию.

Вкладка «Обзор»

Каждую проверку можно разворачивать c помощью стрелочки слева от проверки и нажимать на файл с результатами её прохождения (цифра 1 на рисунке ниже):

На экране появится информация с описанием проблемы и рекомендациями по её исправлению. Можно перемещаться между несколькими проблемами, относящимися к одному объекту (цифра 2 на рисунке выше).

Некоторые проблемы можно решить инструментами Платформы. В этом случае в секции с описанием будет соответствующая кнопка (цифра 3 на рисунке выше).

Для запуска нажмите на кнопку «Запустить обслуживание» в появившемся модальном окне.

Вкладка «Статистика»

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

Подключение к базе данных

Чтобы открыть панель БД Браузера, нужно подключиться к БД. Чтобы подключиться к БД:

  1. Откройте окно подключения. Это можно сделать следующими способами:

    • Кликнуть на пункт «Браузер БД» в меню экземпляра на странице со списком экземпляров внутри пространства или на уровне пространств внутри тенанта.

    • Кликнуть на кнопку «SQL-редактор» на странице Браузера БД.

    • Кликнуть на кнопку «Схема данных» на странице Браузера БД.

  2. В модальном окне подключения к базе данных заполните следующие поля:

    • В выпадающем списке выберите название БД, к которой нужно подключиться. При подключении со страницы Браузера БД это поле будет автоматически заполнено названием БД, в строке которой вы нажали на кнопку «SQL-редактор» или «Схема данных».

    • Введите логин пользователя БД.

    • Введите пароль пользователя.

Примечание

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

  1. После заполнения полей нажмите на кнопку «Подключиться».

При подключении к БД первым и вторым способом откроется панель Браузера БД на редакторе SQL.

При подключении к БД третьим способом откроется панель Браузера БД без открытого редактора SQL.

С этой страницы можно переподключиться к другой БД. Для этого выберите её название из выпадающего списка и заполните описанные выше поля в модальном окне подключения к БД.

Панель Браузера БД

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

Чтобы развернуть схему и все элементы, кликните на стрелочку слева от них:

  • В пункте «Tables» отображается список названий таблиц, содержащихся в данной БД.

  • В пункте «Structure» отображается структура таблицы — перечисление всех её полей и их подробное описание:

    • название поля;

    • тип поля;

    • информация о том, может ли данное поле иметь значения, равные NULL;

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

    • максимальная длина значения данного поля;

    • значение по умолчанию;

    • комментарий к полю.

  • В пункте «Rows» отображается всё содержимое таблицы.

  • В пункте «Keys» отображается список первичных ключей и информация о них:

    • название первичного ключа таблицы,

    • тип первичного ключа,

    • название поля таблицы, являющегося первичным ключом.

  • В пункте «Foreign keys» отображается список вторичных (или внешних) ключей и информация о них:

    • название вторичного ключа;

    • название поля, являющегося вторичным ключом;

    • название схемы, в которой находится данный ключ;

    • название таблицы, в которой находится данный ключ;

    • название первичного ключа, на который ссылается данный вторичный ключ;

    • описание данного вторичного ключа.

  • В пункте «indexes» отображается список всех индексов таблицы и информация о них:

    • название индекса,

    • размер индекса,

    • источник создания индекса.

    • В пункте «Views» отображаются представления данной таблицы.

    • В пункте «Functions» отображаются хранимые процедуры или функции таблицы.

    • В пункет «Sequences» отображаются сгенерированные уникальные числовые значения и информация о них:

      • название последовательности;

      • тип последовательности;

      • первое значение последовательности;

      • минимально возможное значение последовательности;

      • максимально возможное значение последовательности;

      • шаг увеличения;

      • характер поведения последовательности (цикличный или нет), показывающий, будет ли последовательность снова начинаться с минимального значения после достижения своего максимума, или вернёт ошибку;

      • размер символа;

      • последнее значение.

С помощью поисковой строки (цифра 2 на рисунке ниже) можно найти любой объект данных по его названию.

Также на странице есть SQL-редактор. Чтобы его открыть, кликните на кнопку «SQL-редактор», обозначенную цифрой 1 на рисунке выше. Редактор откроется автоматически при подключении к БД с помощью кнопки «SQL-редактор».

В редактор можно написать запрос к базе данных, а затем выполнить его с помощью кнопки «Выполнить запрос». Если запрос написан корректно, после нажатия на кнопку отобразится зелёное оповещение о том, что запрос отправлен на сервер. Если запрос некорректный — придёт красное оповещение с описанием ошибки.

Внимание

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

Полученный результат можно экспортировать в формат CSV и скачать с помощью кнопки «Экспортировать в формат CSV».

Открыть новые вкладки для запросов можно с помощью иконки «+». Максимальное количество вкладок — 10.

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