20. Описание параметров

20.1. Параметры подключения к базе данных

Таблица 20.1 Параметры подключения к базе данных
Название поля	Описание
JDBC драйвер	Выберите `JDBC` драйвер из выпадающего списка для создания новой базы данных. Для Ред Базы Данных и `Firebird` рекомендуется `JDBC` драйвер `Jaybird 3`
Имя подключения	Имя подключения к базе данных
Имя сервера	Хост сервера базы данных или `IP-адрес`
Порт	Порт для подключения к базе данных
Файл базы данных	Путь к файлу базы данных или алиас
Имя пользователя	Логин пользователя, от имени которого будет создана база данных
Пароль	Пароль пользователя
Сохранить пароль	Следует ли сохранить пароль для подключения к базе данных
Зашифровать пароль	Следует ли хранить пароль в зашифрованном виде
Кодировка	Задает набор символов по умолчанию для строковых (символьных) значений всей базы данных.
Размер страницы	Размер страницы базы данных в байтах. Допустимыми значениями являются 4096, 8192 и 16384.

20.2. Расширенные параметры подключения к базе данных

В таблице перечислены некоторые параметры для драйвера Jaybird 3:

Таблица 20.2 Расширенные параметры подключения к базе данных
Параметр	Тип	Описание
isc_dpb_user_name	string	Имя подключающегося пользователя.
isc_dpb_password	string	Пароль пользователя.
isc_dpb_sql_role_name	string	Имя роли.
isc_dpb_sql_dialect	byte	SQL диалект.
isc_dpb_process_id	int	ID процесса.
isc_dpb_process_name	string	Имя процесса.
isc_dpb_lc_ctype	string	Кодировка символов соединения. Этот параметр сообщает серверу базы данных в какой кодировке нужно передавать клиенту строковые значения.
isc_dpb_connect_timeout	int	Время ожидания подключения (в секундах).
isc_dpb_gss	-	Использовать доверительную аутентификацию `Gss`.
isc_dpb_num_buffers	int	Количество страниц базы данных, которые будут кэшироваться.
isc_dpb_set_db_readonly	boolean	Установить базу данных в режим только для чтения.
isc_dpb_set_db_charset	string	Установить набор символов для базы данных.
isc_dpb_trusted_auth	-	Информирование, что будет использоваться доверительная аутентификация.
isc_dpb_multi_factor_auth	boolean	Информирование, что будет использоваться многофакторная аутентификация.
isc_dpb_utf8_filename	-	Информирование, что имя файла передается в формате `UTF-8`.
isc_dpb_certificate	string	Алиас сертификата клиента при многофакторном подключении.
isc_dpb_verify_server	-	Флаг для проверки сертификата сервера (многофакторная аутентификация).
isc_dpb_repository_pin	string	Пин код для контейнера с сертификатом (многофакторная аутентификация).
isc_dpb_wire_crypt_level	string	Параметр устанавливает, следует ли шифровать сетевое соединение. Он может принимать три возможных значения: `REQUIRED`, `ENABLED`, `DISABLED` и `DEFAULT`. По умолчанию шифрование включено (`Enabled`).

20.3. Параметры для добавления драйвера

Таблица 20.3 Параметры для добавления драйвера
Название поля	Описание
Имя драйвера	Имя драйвера для идентификации
Описание	Краткое описание этого драйвера
База данных	Выберите СУБД, для которой этот драйвер предназначен
JDBC URL	Шаблон `URL-адреса` для этого `JDBC` драйвера. Например: `jdbc:firebirdsql://[host]:[port]/[source]`
Путь	Путь к `jar-файлу` `JDBC-драйвера`
Имя класса	Имя класса `JDBC-драйвера`. Выберите кнопку поиска, если имя неизвестно, и система сканирует файл `jar`, введенный в поле пути, для поиска имени класса драйвера

20.4. Параметры файла конфигурации трейс менеджера

Таблица 20.4 Параметры конфигурации трейс менеджера
Параметр	Описание
log_security_incidents	События, связанные с нарушением безопасности сервера (инциденты безопасности)
log_initfini/log_init	События начала/окончания ведения аудита БД в лог-файл
log_connections	События присоединения/отсоединения к БД
log_transactions	События начала и завершения транзакций
log_statement_prepare	События подготовки запросов к БД
log_statement_free	События освобождения запросов к БД
log_statement_start	События начала выполнения запросов к БД
log_statement_finish	События окончания выполнения запросов к БД
log_procedure_start	События начала выполнения хранимых процедур
log_procedure_finish	События завершения выполнения хранимых процедур
log_function_start	События начала выполнения хранимых функций
log_function_finish	События завершения выполнения хранимых функций
log_trigger_start	События начала выполнения триггеров
log_trigger_finish	События завершения выполнения триггеров
log_context	События изменений значений контекстных переменных
log_errors	Запись об ошибках
log_warnings	Запись о предупреждениях
print_plan	Печать планов запросов
print_perf	Печать статистики выполнения запросов
log_blr_requests	События прямого выполнения откомпилированных запросов во внутреннем представлении сервера - `BLR`
print_blr	Содержимое `BLR-запросов` будет преобразовываться в текстовое представление, иначе останется в двоичном виде
log_dyn_requests	События прямого выполнения откомпилированных запросов на изменение метаданных (`DDL`) во внутреннем представлении сервера - `DYN`
print_dyn	Содержимое `DYN-запросов` будет преобразовываться в текстовое представление, иначе останется в двоичном виде
log_privilege_changes	События, связанные с изменением правил разграничения доступа
log_changes_only	Запись только тех событий, которые изменяли данные в базе
print_stack_trace	Печать стека вызовов функций сервера при завершении события с ошибкой
log_auth_factors	События проверки предъявленных факторов аутентификации
log_mandatory_access	Аудит мандатного доступа
log_record_mandatory_access	События о мандатном доступе к записям
log_object_relabeling	События смены метки объектов
log_record_relabeling	События смены метки записей
log_services	События присоединения/отсоединения и старта сервиса
log_service_query	События запросов к сервису
include_user_filter	Регулярное выражение, которому должно соответствовать имя пользователя
exclude_user_filter	Подключения от пользователей, совпавших с этим регулярным выражением не будут регистрироваться
include_process_filter	Регулярное выражение, которому должно соответствовать название пользовательского процесса
exclude_process_filter	Подключения от процессов, совпавших с этим регулярным выражением не будут регистрироваться
include_filter	Регулярное выражение в синтаксисе `SQL` (`SIMILAR TO`), которому должен удовлетворять текст `SQL-запроса`
exclude_filter	Регулярное выражение в синтаксисе `SQL` (`SIMILAR TO`), которому не должен удовлетворять текст `SQL-запроса`
connection_id	Номер (идентификатор) подключения на сервере, которое будет отслеживаться
log_filename	Имя файла лога
max_log_size	Максимальный размер лог файлов в мегабайтах. Значение 0 означает неограниченный размер
time_threshold	События, время выполнения которых меньше указанного (в мс), не будут регистрироваться в журнале
max_sql_length	Максимальная длина одной записи SQL-запроса в лог-файле, в байтах
max_blr_length	Максимальная длина BLR-запроса, сохраняемого в лог, в байтах
max_dyn_length	Максимальная длина DYN-запроса, сохраняемого в лог, в байтах
max_arg_length	Максимальная длина одного параметра запроса/процедуры в лог-файле
max_arg_count	Максимальное количество параметров запроса/процедуры, которое заносится в лог-файл

20.5. Таблица событий трейс менеджера

Краткое описание значения каждого столбца таблицы событий приведено ниже:

Таблица 20.5 Описание столбцов таблицы событий
Параметр	Описание
NUM	Номер строки таблицы
TSTAMP	Время и дата произошедшего события
ID_PROCESS	Идентификатор процесса
ID_THREAD	Идентификатор потока
EVENT_TYPE	Тип события
FAILED	В случае неуспешной или несанкционированной попытки выполнения запроса фиксируется результат `FAILED` или `UNAUTHORIZED`
ID_SESSION	Идентификатор сессии
NAME_SESSION	Имя сессии
ID_SERVICE	Идентификатор сервиса
USERNAME	Имя пользователя
PROTOCOL_CONNECTION	Протокол соединения
CLIENT_ADDRESS	`IP-адрес` или имя компьютера
TYPE_QUERY_SERVICE	Тип запроса к сервису
OPTIONS_START_SERVICE	Опции, переданные сервис-менеджеру от клиента при запуске
ROLE	Роль пользователя
DATABASE	Имя базы данных
CHARSET	Кодировка
ID_CONNECTION	Идентификатор соединения
CLIENT_PROCESS	Клиентский процесс
ID_CLIENT_PROCESS	Идентификатор клиентского процесса
ID_TRANSACTION	Идентификатор транзакции
LEVEL_ISOLATION	Уровень изоляции
MODE_OF_BLOCK	Режим разрешения блокировок
MODE_OF_ACCESS	Режим доступа
TIME_EXECUTION	Время выполнения (в мс)
COUNT_READS	Количество страниц, считанных с диска
COUNT_WRITES	Количество страниц, записанных на диск
COUNT_FETCHES	Количество страниц, считанных из страничного кэша
COUNT_MARKS	Количество страниц, изменённых в страничном кэше
ID_STATEMENT	Идентификатор запроса
RECORDS_FETCHED	Количество выбранных записей
STATEMENT_TEXT	Содержимое запроса
PARAMETERS_TEXT	Параметры выполнения запроса
PLAN_TEXT	План запроса
TABLE_COUNTERS	Табличные счетчики
DECLARE_CONTEXT_VARIABLES	Имя и значение контекстной переменной
EXECUTOR	Список пользователей, ролей и объектов базы данных, для которых выданы привилегии
GRANTOR	Пользователь от имени, которого предоставляются привилегии.
PRIVILEGE	Назначенная/отозванная привилегия
PRIVILEGE_OBJECT	Объект, на который выдана (отозвана) привилегия
PRIVILEGE_USERNAME	Имя пользователя, которому назначена привилегия
PRIVILEGE_ATTACHMENT	Идентификатор соединения
PRIVILEGE_TRANSACTION	Идентификатор транзакции
PROCEDURE_NAME	Имя процедуры
RETURN_VALUE	Возвращаемые значения процедуры
TRIGGER_INFO	`<имя_триггера> [FOR <имя_таблицы>] (ON <событие БД> \| {BEFORE \| AFTER} <событие таблицы или DDL-событие>)`
SENT_DATA	Данные, переданные сервис-менеджеру
RECEIVED_DATA	Данные, полученные сервис-менеджером
ERROR_MESSAGE	Текст сообщения об ошибке
OLDEST_INTERESTING	Номер старейшей заинтересованной транзакции
OLDEST_ACTIVE	Номер старейшей активной транзакции
OLDEST_SNAPSHOT	Номер транзакции, которая была активной на момент старта транзакции `OAT`
NEXT_TRANSACTION	Номер следующей транзакции
SORT_MEMORY_USAGE_TOTAL	Суммарный размер кэша (в байтах), выделенного в процессе сортировки
SORT_MEMORY_USAGE_CACHED	Размер RAM кэша (в байтах), выделенного в процессе сортировки
SORT_MEMORY_USAGE_ON_DISK	Размер дискового кэша

20.6. Анализ трейса

Описание значений столбцов результирующей таблицы:

Таблица 20.6 Описание столбцов результирующей таблицы
Параметр	Описание
QUERY	Текст запроса
COUNT	Количество выполнений запроса
PLAN_COUNT	Количество планов запроса
TOTAL_TIME	Общее время выполнения в миллисекундах
MIN_TIME	Мимимальное время выполнения в миллисекундах
AVG_TIME	Среднее время выполнения в миллисекундах
MAX_TIME	Максимальное время выполнения в миллисекундах
STD_DEV_TIME	Среднеквадратическое отклонение времени выполнения
TOTAL_READ	Общее количество страниц, считанных с диска
MIN_READ	Минимальное количество страниц, считанных с диска
AVG_READ	Среднее количество страниц, считанных с диска
MAX_READ	Максимальное количество страниц, считанных с диска
STD_DEV_READ	Среднеквадратическое отклонение количества страниц, считанных с диска
TOTAL_FETCH	Общее количество страниц, считанных из страничного кэша
MIN_FETCH	Минимальное количество страниц, считанных из страничного кэша
AVG_FETCH	Среднее количество страниц, считанных из страничного кэша
MAX_FETCH	Максимальное количество страниц, считанных из страничного кэша
STD_DEV_FETCH	Среднеквадратическое отклонение количества страниц, считанных из страничного кэша
TOTAL_WRITE	Общее количество страниц, записанных на диск
MIN_WRITE	Минимальное количество страниц, записанных на диск
AVG_WRITE	Среднее количество страниц, записанных на диск
MAX_WRITE	Максимальное количество страниц, записанных на диск
STD_DEV_WRITE	Среднеквадратическое отклонение количества страниц, записанных на диск
TOTAL_MARK	Общее количество страниц, изменённых в страничном кэше
MIN_MARK	Минимальное количество страниц, изменённых в страничном кэше
AVG_MARK	Среднее количество страниц, изменённых в страничном кэше
MAX_MARK	Максимальное количество страниц, изменённых в страничном кэше
STD_DEV_MARK	Среднеквадратическое отклонение количества страниц, изменённых в страничном кэше
TOTAL_RSORT	Общий объём оперативной памяти, использованный для сортировки (в байтах)
MIN_RSORT	Минимальный объём оперативной памяти, использованный для сортировки (в байтах)
AVG_RSORT	Средний объём оперативной памяти, использованный для сортировки (в байтах)
MAX_RSORT	Максимальный объём оперативной памяти, использованный для сортировки (в байтах)
STD_DEV_RSORT	Среднеквадратическое отклонение объёма оперативной памяти, использованного для сортировки
TOTAL_DSORT	Общий размер временных файлов, использованный в запросе (в байтах)
MIN_DSORT	Минимальный размер временных файлов, использованный в запросе (в байтах)
AVG_DSORT	Средний размер временных файлов, использованный в запросе (в байтах)
MAX_DSORT	Максимальный размер временных файлов, использованный в запросе (в байтах)
STD_DEV_DSORT	Среднеквадратическое отклонение размера временных файлов, использованного в запросе

20.7. Статистика базы данных

Статистика страниц данных

Таблица 20.7 Статистика страниц данных

Параметр

Описание

name

Имя таблицы

primary pointer page

Номер первой страницы косвенных указателей на страницы, хранящие данные таблицы

index root page

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

pointer pages

Общее количество страниц косвенных указателей на страницы, хранящие данные таблицы

data pages

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

data page slots

Количество указателей на страницы базы данных, содержащихся на страницах указателей. Должно равняться числу страниц данных

primary pages

Количество страниц, равное (Data pages - Secondary pages)

secondary pages

Количество страниц, на которых не хранятся первичные версии записей

swept pages

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

empty pages

Количество страниц, на которых нет записей

full pages

Количество полностью заполненных страниц

big record pages

Количество страниц, которые полностью заняты только одной записью

blob pages

Количество страниц с блобами

average record length

Средний размер сжатой записи в байтах

total records

Общее количество строк в таблице

average version length

Среднее значение длины старых версий в байтах

total versions

Общее количество старых версий в таблице

max versions

Максимальная цепочка старых версий для записи

average fill

Обобщающая гистограмма распределения использования памяти для всех страниц, выделенных в таблице

total formats

Общее количество форматов в таблице RDB$FORMATS

used formats

Количество используемых форматов

average fragment length

Средний размер фрагмента в байтах

total fragments

Количество всех фрагментов во всех записях

max fragments

Максимальное количество фрагментов в одной записи

average unpacked length

Средний размер записи в байтах (без сжатия)

compression ratio

Отношение средней длины ключа без учета сжатия (Average prefix length + Average data length) к средней длине ключа с учетом сжатия (Average key length).

blobs

Количество всех блобов (0, 1 и 2 уровня)

total length

Размер, занимаемый блобами, в байтах

level <n>

Количество блобов каждого уровня

table size(without blobs)

Размер таблицы в байтах (data pages * page size). Вычисляемый столбец

size with blobs

Совокупный размер данных таблицы (table size(without blobs) + blobs total length). Вычисляемый столбец

size with blob pages

(table size(without blobs) + blob pages * page size). Вычисляемый столбец

size with indices

Совокупный размер данных таблицы и совокупный размер всех индексов по таблице. Вычисляется по формуле:

$X = S + \sum_{i=0}^{n} E_i$,

где S – size with blob pages;

n – количество индексов в таблице;

E – предполагаемый размер индекса в байтах (estimated full size).

range <процент заполненности>

Количество страниц, которые заполнены на указанный процент

Статистика по индексам

Таблица 20.8 Статистика по индексам

Параметр

Описание

name

Имя индекса

table name

Имя таблицы

real selectivity

Вычисляется по формуле 1 / (nodes - totalDup)

average data length

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

total dup

Общее количество строк дубликатов индекса

max dup

Количество дублирующих узлов, имеющих наибольшее количество дубликатов. Всегда будет нулем для уникальных индексов. Если число велико по сравнению с числом в total dup, то это признак плохой селективности

root page

Номер корневой страницы индекса

depth

Количество уровней в странице индексного дерева. Если глубина дерева индексной страницы превышает 3, то доступ к записям через индекс не будет максимально эффективным. Для уменьшения глубины дерева индексной страницы увеличьте размер страницы. Если увеличение размера страницы не уменьшает глубины, снова увеличьте размер страницы

leaf buckets

Количество страниц самого низкого уровня (листовых) в дереве индекса. Это страницы, которые содержат указатели на записи. Страницы высокого уровня содержат косвенные связи.

leaf full size

Размер страниц самого низкого уровня (листовых) в дереве индекса (leaf buckets * page size). Вычисляемый столбец

estimated full size

Приблизительный размер индекса в байтах. Вычисляется по формуле:

$N = L * (1+\frac{A}{P})^{D - 1}*P$

, где N – приблизительный размер индекса в байтах;

L – количество страниц самого низкого уровня (листовых) в дереве индекса (leaf buckets);

A – средний размер узлов в байтах (average node length);

P – размер страницы базы данных (page size);

D – количество уровней в странице индексного дерева (depth).

nodes

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

average node length

Средний размер узлов в байтах

average key length

Средний размер ключа в байтах с учетом сжатия. К длине каждого ключа прибавляется от 1 до 5 байт в зависимости от размера ключа и префикса. Затем высчитывается средний размер ключа

compression ratio

Средняя длина ключа и префикса в байтах

average prefix length

Средний размер (в байтах), занимаемый префиксами узлов

average data length

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

clustering factor

Это мера того, насколько много операций ввода-вывода будет осуществлять база данных, если бы ей пришлось читать каждую строку таблицы посредством индекса, в порядке индекса. То есть она показывает, насколько упорядочены строки в таблице по значениям индекса. Если значение близко к общему количеству страниц, значит таблица очень хорошо упорядочена. В этом случае записи индекса на одной странице листа индекса обычно указывают на строки, находящиеся в одних и тех же страницах данных. Если значение близко к общему количеству строк, значит, таблица весьма неупорядочена. В этом случае маловероятно, что записи индекса на одной странице листа индекса указывают на те же страницы данных

ratio

Отношение Clustering factor к общему количеству узлов в индексе

full size

Размер индекса в байтах. Рассчитывается по формуле: $L * (1+\frac{A}{P})^{D - 1}*P$,

где L – количество страниц самого низкого уровня (листовых) в дереве индекса (leaf buckets);

A – средний размер узлов в байтах (average node length);

P – размер страницы базы данных (page size);

D – количество уровней в странице индексного дерева (depth).

Статистика по табличным пространствам

Таблица 20.9 Статистика по табличным пространствам

Параметр

Описание

name

Имя табличного пространства

full path

Путь к файлу табличного пространства

table count

Количество таблиц, находящихся в табличном пространстве

index count

Количество индексов, находящихся в табличном пространстве