Браузер БД

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

  1. Страница Браузер БД — общее описание страницы «Браузер БД».

  2. Страница инспектирования БД — описание функционала страницы «Инспектирования БД», отображающей подробную информацию о БД экземпляра.

  3. Подключение к базе данных — описание алгоритма подключения к БД экземпляра.

  4. Панель Браузера БД — подробное описание функционала панели Браузера БД, позволяющей посмотреть схему конкретной БД и написать к ней SQL-запросы.

Внимание

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

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

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

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

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

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

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

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

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

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

После нажатия кнопки «Аудит» откроется следующая страница:

База данных

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

  • Развернув пункт «Tables» («Таблицы»), можно увидеть список названий таблиц, содержащихся в данной БД.

  • Кликнув на пункт «Structure», вы увидите структуру интересующей таблицы — перечисление всех её полей и их подробное описание:

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

    • тип поля;

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

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

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

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

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

  • При нажатии на пункт «Rows» («Строки») отобразится всё содержимое данной таблицы. На данной странице используется новый тип таблиц — ag-grid, который позволяет менять колонки местами и располагать их в удобном порядке.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Пункт «Functions» показывает хранимые процедуры или функции у данной таблицы.

  • В самом низу показаны «Sequences» («Последовательности») — сгенерированные уникальные числовые значения и информация о них:

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

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

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

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

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

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

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

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

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

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

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

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

Внимание

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

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

Примечание

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

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

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