Браузер БД

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

Внимание

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

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

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

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

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

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

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

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

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

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

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

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

База данных

Чтобы собрать информацию по HEALTHCHECKS, нажмите на кнопку «Собрать данные» (цифра 1 на рисунке выше). После этого справа появится список метрик:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Каждую проверку можно разворачивать 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».

Примечание

Платформа отображает максимум 1000 записей, в экспортированном файле CSV будет вся запись без ограничений.

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

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