Firebird РУКОВОДСТВО РАЗРАБОТЧИКА БАЗ ДАННЫХ

где имя-базы-данных- полный путь к базе данных.

Графические инструменты

gstat не является дружественным пользователю инструментом. Некоторые графические инструменты (например, IBAnalyst) четко выполняют ту же работу gstat по выводу результатов, используя Services API. Формы экранов были взяты из утилиты с открытыми кодами IBOConsole[60].

Переключатели

В табл. 18.1 описаны переключатели gstat.

Таблица 18.1. Переключатели gstat

Переключатель	Описание
-user имя-пользователя	Проверяет имя пользователя перед доступом к базе данных
-pa[ssword] пароль	Проверяет пароль перед доступом к базе данных
-header	Выводит информацию заголовочной страницы, затем прекращает работу
-log	Выводит информацию заголовочной страницы и страницы протокола, затем прекращает работу
-index	Отыскивает и отображает статистику по индексам базы данных
-data	Отыскивает и отображает статистику по таблицам пользователя базы данных
-all	Это значение по умолчанию, если вы не запросили -index, -data или -all. Отыскивает и отображает статистику по -index и-data
-system	Как и -all, но дополнительно включает статистику по системным таблицам
-r	Отыскивает и отображает статистику по размеру и версиям записей (включая все версии)
-t список-таблиц	Используется вместе с -data. Ограничивает отображаемые данные таблицами из списка таблиц
-z	Печатает версию утилиты gstat

Рекомендуется назначить вывод результатов в текстовый файл и просматривать его в текстовом редакторе.

! ! !

ПРИМЕЧАНИЕ. Поскольку gstat выполняет собственный анализ на уровне файла, она не выполняется в контексте какой-либо транзакции. Следовательно, статистика по индексам также включает информацию по тем индексам, которые используются в незавершенных транзакциях. Например, не будет предупреждений, если отчет показывает некоторые дублирующие записи в индексе первичного ключа.

. ! .

Переключатель -index

Синтаксис:

gstat -i[ndex] база-данных

Этот ключ отыскивает и отображает статистику по индексам в базе данных: средняя длина ключа (в байтах), общее количество дубликатов и максимальное количество дубликатов одного ключа. Включите переключатель -s[ystem], если вам нужна информация о системных индексах.

К сожалению, не существует способа получить статистику по одному индексу, однако вы можете ограничить результат одной таблицей, используя переключатель -t, за которым следует имя таблицы. Вы можете записать разделенный пробелами список имен таблиц для получения результатов более чем по одной таблице. Если имена ваших таблиц являются чувствительными к регистру - были объявлены идентификаторами, заключенными в кавычки, - то аргументы переключателя -t должны быть записаны в правильном регистре, но не должны заключаться в кавычки. Для таблиц с пробелами в их именах gstat вовсе не работает.

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

Чтобы запустить утилиту для базы данных employee и направить ее вывод в текстовый файл с именем gstat.index.txt, выполните следующее:

* в POSIX наберите (все в одной строке):

./gstat -index /opt/firebird/examples/employee.fdb -t CUSTOMER -user SYSDBA -password masterkey

> /opt/firebird/examples/gstat.index.txt

* в Win32 наберите (все в одной строке):

gstat -index

"c:\Program Files\Firebird\Firebird_1_5\examples\employee.fdb" -t CUSTOMER

-user SYSDBA -password masterkey

> "c:\Program Files\Firebird\Firebird_1_5\examples\gstat.index.txt"

! ! !

ПРИМЕЧАНИЕ. Двойные кавычки для пути к базе данных требуются в Windows, если ваш путь содержит пробелы.

. ! .

На рис. 18.3 показано, как отображаются данные индексной страницы.

Рис. 18.3. Пример отображения данных индексной страницы

Что все это значит

Вначале появляется итоговая информация об индексе. В табл. 18.2 объясняются записи строка за строкой.

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

Таблица 18.2. Вывод gstat -i[ndex]