FirebirdSQL logo
 TABLEVIEW 

ALTER INDEX

Назначение

Перевод индекса в активное/неактивное состояние, перестройка индекса.

Доступно в

DSQL, ESQL.

Синтаксис
ALTER INDEX indexname {ACTIVE | INACTIVE};
Table 1. Параметры оператора ALTER INDEX
Параметр Описание

indexname

Имя индекса.

Оператор ALTER INDEX переводит индекс в активное/неактивное состояние.Возможность изменения структуры и порядка сортировки ключей этот оператор не предусматривает.

INACTIVE

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

Активный индекс может быть отключен, только если отсутствуют запросы использующие этот индекс, иначе будет возвращена ошибка “object in use”.

Активация неактивного индекс также безопасна.Тем не менее, если есть активные транзакции, модифицирующие таблицу, то транзакция, содержащая оператор ALTER INDEX потерпит неудачу, если она имеет атрибут NO WAIT.Если транзакция находится в режиме WAIT, то она будет ждать завершения параллельных транзакций.

С другой стороны, если наш оператор ALTER INDEX начинает перестраивать индекс на COMMIT, то другие транзакции, изменяющие эту таблицу, потерпят неудачу или будут ожидать в соответствии с их WAIT/NO WAIT атрибутами.Та же самая ситуация будет и при выполнении CREATE INDEX.

Tip

Перевод индекса в неактивное состояние может быть полезен при массовой вставке, модификации или удалении записей из таблицы, для которой этот индекс построен.
ACTIVE

При выборе альтернативы ACTIVE индекс переводится из неактивного состояния в активное. При переводе индекса из неактивного состояния в активное — индекс перестраивается.

Tip

Даже если индекс находится в активном состоянии оператор ALTER INDEX …​ ACTIVE всё равно перестраивает индекс.Таким образом, эту команду можно использовать как часть обслуживания БД для перестройки индексов, автоматически созданных для ограниченийPRIMARY KEY, FOREIGN KEY, UNIQUE, для которых выполнение оператора ALTER INDEX …​ INACTIVE невозможно.

Использование ALTER INDEX для индексов ограничений

Принудительный перевод индексов созданных для ограничений PRIMARY KEY, FOREIGN KEY и UNIQUE не допускается.Тем не менее выполнение оператора ALTER INDEX …​ INACTIVE работает так же хорошо для индексов ограничений, как и другие инструменты для других индексов.

docnext count = 9

Кто может выполнить ALTER INDEX?

Выполнить оператор ALTER INDEX могут:

  • Администраторы

  • Владелец таблицы, для которой построен индекс;

  • Пользователи с привилегией ALTER ANY TABLE.

Примеры

Example 1. Перевод индекса в неактивное состояние
ALTER INDEX IDX_UPDATER INACTIVE;
Example 2. Возврат индекса в активное состояние
ALTER INDEX IDX_UPDATER ACTIVE;
См. также:

CREATE INDEX, DROP INDEX.

DROP INDEX

Назначение

Удаление индекса из базы данных.

Доступно в

DSQL, ESQL.

Синтаксис
DROP INDEX indexname
Table 1. Параметры оператора DROP INDEX
Параметр Описание

indexname

Имя индекса.

Оператор DROP INDEX удаляет существующий индекс из базы данных.При наличии зависимостей для существующего индекса (если он используется в ограничении) удаление не будет выполнено.

Кто может удалить индекс?

Выполнить оператор DROP INDEX могут:

  • Администраторы

  • Владелец таблицы, для которой построен индекс;

  • Пользователи с привилегией ALTER ANY TABLE.

Примеры

Example 1. Удаление индекса
DROP INDEX IDX_UPDATER;
См. также:

CREATE INDEX, ALTER INDEX.

SET STATISTICS

Назначение

Пересчёт селективности индекса.

Доступно в

DSQL, ESQL.

Синтаксис
SET STATISTICS INDEX indexname
Table 1. Параметры оператора SET STATISTICS
Параметр Описание

indexname

Имя индекса.

Оператор SET STATISTICS пересчитывает значение селективности для указанного индекса.

Селективность индекса

Селективность (избирательность) индекса — это оценочное количество строк, которые могут быть выбраны при поиске по каждому значению индекса.Уникальный индекс имеет максимальную селективность, поскольку при его использовании невозможно выбрать более одной строки для каждого значения ключа индекса.Актуальность селективности индекса важна для выбора наиболее оптимального плана выполнения запросов оптимизатором.

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

Note

Отметим, что в Firebird статистика индексов автоматически не пересчитывается ни после массовых изменений данных, ни при каких либо других условиях.При создании (CREATE) или его активации (ALTER INDEX ACTIVE) статистика индекса полностью соответствует его содержимому.

Пересчёт селективности индекса может быть выполнен под высоко параллельной нагрузкой без риска его повреждения.Тем не менее следует помнить, что при высоком параллелизме рассчитанная статистика может устареть, как только закончится выполнение оператора SET STATISTICS.

Кто может обновить статистику?

Выполнить оператор SET STATISTICS могут:

  • Администраторы

  • Владелец таблицы, для которой построен индекс;

  • Пользователи с привилегией ALTER ANY TABLE.

Примеры

Example 1. Пересчёт селективности индекса IDX_UPDATER
SET STATISTICS INDEX IDX_UPDATER;
См. также:

CREATE INDEX, ALTER INDEX.