ALTER INDEX (Transact-SQL)

Статья
10/04/2023

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Изменяет существующий индекс таблицы или представления (rowstore, columnstore или XML) посредством его отключения, перестройки или реорганизации либо посредством настройки параметров индекса.

Соглашения о синтаксисе Transact-SQL

Синтаксис

-- Syntax for SQL Server and Azure SQL Database

ALTER INDEX { index_name | ALL } ON <object>
{
      REBUILD {
            [ PARTITION = ALL [ WITH ( <rebuild_index_option> [ ,...n ] ) ] ]
          | [ PARTITION = partition_number [ WITH ( <single_partition_rebuild_index_option> [ ,...n ] ) ] ]
      }
    | DISABLE
    | REORGANIZE  [ PARTITION = partition_number ] [ WITH ( <reorganize_option>  ) ]
    | SET ( <set_index_option> [ ,...n ] )
    | RESUME [WITH (<resumable_index_option> [, ...n])]
    | PAUSE
    | ABORT
}
[ ; ]

<object> ::=
{
    { database_name.schema_name.table_or_view_name | schema_name.table_or_view_name | table_or_view_name }
}

<rebuild_index_option> ::=
{
      PAD_INDEX = { ON | OFF }
    | FILLFACTOR = fillfactor
    | SORT_IN_TEMPDB = { ON | OFF }
    | IGNORE_DUP_KEY = { ON | OFF }
    | STATISTICS_NORECOMPUTE = { ON | OFF }
    | STATISTICS_INCREMENTAL = { ON | OFF }
    | ONLINE = { ON [ ( <low_priority_lock_wait> ) ] | OFF }
    | RESUMABLE = { ON | OFF }
    | MAX_DURATION = <time> [MINUTES]
    | ALLOW_ROW_LOCKS = { ON | OFF }
    | ALLOW_PAGE_LOCKS = { ON | OFF }
    | MAXDOP = max_degree_of_parallelism
    | DATA_COMPRESSION = { NONE | ROW | PAGE | COLUMNSTORE | COLUMNSTORE_ARCHIVE }
        [ ON PARTITIONS ( {<partition_number> [ TO <partition_number>] } [ , ...n ] ) ]
    | XML_COMPRESSION = { ON | OFF }
        [ ON PARTITIONS ( {<partition_number> [ TO <partition_number>] } [ , ...n ] ) ]}

<single_partition_rebuild_index_option> ::=
{
      SORT_IN_TEMPDB = { ON | OFF }
    | MAXDOP = max_degree_of_parallelism
    | RESUMABLE = { ON | OFF }
    | MAX_DURATION = <time> [MINUTES]
    | DATA_COMPRESSION = { NONE | ROW | PAGE | COLUMNSTORE | COLUMNSTORE_ARCHIVE }
    | XML_COMPRESSION = { ON | OFF }
    | ONLINE = { ON [ ( <low_priority_lock_wait> ) ] | OFF }
}

<reorganize_option> ::=
{
       LOB_COMPACTION = { ON | OFF }
    |  COMPRESS_ALL_ROW_GROUPS =  { ON | OFF}
}

<set_index_option> ::=
{
      ALLOW_ROW_LOCKS = { ON | OFF }
    | ALLOW_PAGE_LOCKS = { ON | OFF }
    | OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }
    | IGNORE_DUP_KEY = { ON | OFF }
    | STATISTICS_NORECOMPUTE = { ON | OFF }
    | COMPRESSION_DELAY = { 0 | delay [Minutes] }
}

<resumable_index_option> ::=
 {
    MAXDOP = max_degree_of_parallelism
    | MAX_DURATION =<time> [MINUTES]
    | <low_priority_lock_wait>
 }

<low_priority_lock_wait> ::=
{
    WAIT_AT_LOW_PRIORITY ( MAX_DURATION = <time> [ MINUTES ] ,
                          ABORT_AFTER_WAIT = { NONE | SELF | BLOCKERS } )
}

-- Syntax for Azure Synapse Analytics and Parallel Data Warehouse

ALTER INDEX { index_name | ALL }
    ON   [ schema_name. ] table_name
{
      REBUILD {
            [ PARTITION = ALL [ WITH ( <rebuild_index_option> ) ] ]
          | [ PARTITION = partition_number [ WITH ( <single_partition_rebuild_index_option> )] ]
      }
    | DISABLE
    | REORGANIZE [ PARTITION = partition_number ]
}
[;]

<rebuild_index_option> ::=
{
    DATA_COMPRESSION = { COLUMNSTORE | COLUMNSTORE_ARCHIVE }
        [ ON PARTITIONS ( {<partition_number> [ TO <partition_number>] } [ , ...n ] ) ]
    | XML_COMPRESSION = { ON | OFF }
        [ ON PARTITIONS ( {<partition_number> [ TO <partition_number>] } [ , ...n ] ) ]
}

<single_partition_rebuild_index_option> ::=
{
    DATA_COMPRESSION = { COLUMNSTORE | COLUMNSTORE_ARCHIVE }
    | XML_COMPRESSION = { ON | OFF }
}

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

index_name

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

ВСЕ

Указывает все индексы, связанные с таблицей или представлением, независимо от типа индекса. При указании ALL инструкция не будет выполнена, если один или несколько индексов находятся в автономной или предназначенной только для чтения файловой группе либо указанная операция запрещена для одного или нескольких типов индекса. В следующей таблице перечислены операции с индексами и запрещенные типы индексов.

Использование ключевого слова ALL с этой операцией	Отказывает, если в таблице имеется один или несколько
REBUILD WITH ONLINE = ON	XML-индекс Пространственный индекс Индекс Columnstore: применяется к: SQL Server (начиная с SQL Server 2012 (11.x)) и База данных SQL Azure
REBUILD PARTITION = partition_number	Несекционированный, пространственный, отключенный индекс или XML-индекс
REORGANIZE	Индексы с параметром ALLOW_PAGE_LOCKS, равным OFF
REORGANIZE PARTITION = partition_number	Несекционированный, пространственный, отключенный индекс или XML-индекс
IGNORE_DUP_KEY = ON	XML-индекс Пространственный индекс Индекс Columnstore: применяется к: SQL Server (начиная с SQL Server 2012 (11.x)) и База данных SQL Azure
ONLINE = ON	XML-индекс Пространственный индекс Индекс Columnstore: применяется к: SQL Server (начиная с SQL Server 2012 (11.x)) и База данных SQL Azure
RESUMABLE = ON	Возобновляемые индексы не поддерживаются с ключевым словом All. Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Предупреждение

Более подробные сведения об операциях с индексами, которые можно выполнить в сети, см. в разделе Рекомендации по операциям с индексами в сети.

Если ключевое слово ALL указывается вместе с PARTITION = partition_number, то все индексы должны быть выровнены. Следовательно, они секционируются на основе эквивалентных функций секционирования. При использовании ключевого слова ALL вместе с PARTITION все индексные секции с одинаковым аргументом partition_number будут перестроены или реорганизованы. Дополнительные сведения о секционированных индексах см. в разделе Секционированные таблицы и индексы.

database_name

Имя базы данных.

schema_name

Имя схемы, которой принадлежит таблица или представление.

table_or_view_name

Имя таблицы или представления, связанного с индексом. Чтобы отобразить отчет по индексам объекта, следует воспользоваться представлением каталога sys.indexes.

База данных SQL поддерживает формат имени трех частей database_name. [schema_name].table_or_view_name, если database_name является текущей базой данных или database_name является tempdb, а table_or_view_name начинается с #.

REBUILD [ WITH (<rebuild_index_option> [ ,... n]) ]

Область применения: SQL Server (начиная с SQL Server 2012 (11.x)) и База данных SQL Azure

Указывает, что индекс будет перестроен с использованием тех же столбцов, типов индекса, атрибута уникальности и порядка сортировки. Это предложение эквивалентно DBCC DBREINDEX. REBUILD включает отключенный индекс. Если не указано ключевое слово ALL, при перестройке кластеризованного индекса ассоциированные некластеризованные индексы не перестраиваются. Если параметры индекса не заданы, то применяется существующий параметр индекса, который хранится в sys.indexes. Для любого параметра индекса, значение которого не хранится в sys.indexes, применяется значение по умолчанию, указанное в определении аргумента.

Если указано ключевое слово ALL, а базовая таблица реализована в виде кучи, операция REBUILD не воздействует на таблицу. Перестраиваются все некластеризованные индексы, ассоциированные с таблицей.

Возможно минимальное протоколирование операции REBUILD, если модель восстановления базы данных настроена на массовый или простой режим.

Примечание.

При перестроении первичного XML-индекса индексированная пользовательская таблица недоступна в течение действия операции с индексами.

Для индексов columnstore операция REBUILD:

Не использует порядок сортировки.
Приобретает монопольную блокировку на таблице или секции на то время, как происходит операция REBUILD. Данные находятся в автономном режиме и недоступны во время операции REBUILD даже при использовании NOLOCK, изоляции моментальных снимков с уровнем READ COMMITED (RCSI) или обычной изоляции моментальных снимков (SI).
Повторно сжимает все данные в columnstore. Во время операции REBUILD существуют две копии индекса columnstore. REBUILD По завершении SQL Server удаляет исходный индекс columnstore.

Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

СЕКЦИЯ

Указывает, что только одна секция индекса будет перестроена или реорганизована. PARTITION нельзя указать, если index_name является несекционированным индексом.

PARTITION = ALL, перестроение всех секций.

Предупреждение

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

partition_number

Количество секций секционированного индекса, который необходимо перестроить или реорганизовать. Аргумент partition_number является постоянным выражением, которое может обращаться к переменным. Ими являются переменные пользовательских типов или функции и определяемые пользователем функции, но не инструкция Transact-SQL. partition_numberдолжен существовать, или выполнение инструкции завершится с ошибкой.

WITH (<single_partition_rebuild_index_option>)

SORT_IN_TEMPDB, MAXDOP, DATA_COMPRESSION и XML_COMPRESSION — это параметры, которые можно указывать при выполнении операции REBUILD для одиночной секции (PARTITION = partition_number). XML-индексы нельзя указывать в операции REBUILD одиночной секции.

DISABLE

Помечает индекс как отключенный и недоступный для использования ядро СУБД. Любой индекс может быть отключен. Определение отключенного индекса остается в системном каталоге без базовых индексных данных. Отключение кластеризованного индекса блокирует доступ пользователя к данным базовой таблицы. Чтобы включить индекс, используйте ALTER INDEX REBUILD или CREATE INDEX WITH DROP_EXISTING. Дополнительные сведения см. в разделах Отключение индексов и ограничений и Включение индексов и ограничений.

Операция REORGANIZE для индекса rowstore

Для индексов rowstore REORGANIZE указывает необходимость реорганизации конечного уровня индекса. Операция REORGANIZE:

всегда выполняется в сети. Это означает, что долгосрочные блокировки таблицы не удерживаются и запросы или обновления базовой таблицы могут продолжаться во время выполнения транзакции ALTER INDEX REORGANIZE.
не разрешается для отключенного индекса;
не разрешается, если параметру ALLOW_PAGE_LOCKS задано значение OFF;
при выполнении в транзакции не откатывается при откате транзакции.

Примечание.

Когда ALTER INDEX REORGANIZE использует явные транзакции (например, ALTER INDEX внутри BEGIN TRAN ... COMMIT/ROLLBACK) вместо режима неявных транзакций по умолчанию, поведение блокировки REORGANIZE становится более строгим, что может привести к блокировке. Дополнительные сведения о неявных транзакциях см. в статье SET IMPLICIT_TRANSACTIONS (Transact-SQL).

Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

REORGANIZE WITH ( LOB_COMPACTION = { ON | OFF } )

Применяется к индексам rowstore.

LOB_COMPACTION = ON

Указывает сжатие всех страниц, содержащих данные следующих типов данных больших объектов (LOB): image, text, ntext, varchar(max), nvarchar(max), varbinary(max) и xml. Сжатие этих данных может привести к уменьшению размера данных на диске.
Для кластеризованного индекса сжимаются все столбцы LOB, содержащиеся в таблице.
Для некластеризованного индекса сжимаются все столбцы LOB, являющиеся неключевыми столбцами, включенными в индекс.
REORGANIZE ALL выполняет операцию LOB_COMPACTION для всех индексов. Для каждого индекса сжимаются все столбцы LOB в кластеризованном индексе, базовой таблице или включенные столбцы в некластеризованном индексе.

LOB_COMPACTION = OFF

Страницы, содержащие данные большого объекта, не сжимаются.
Параметр OFF не влияет на кучу.

Операция REORGANIZE для индекса columnstore

Для индексов columnstore REORGANIZE сжимает каждую разностную группу строк CLOSED в columnstore в виде сжатой группы строк. Операция REORGANIZE всегда выполняется в режиме "в сети". Это означает, что долгосрочные блокировки таблицы не удерживаются и запросы или обновления базовой таблицы могут продолжаться во время выполнения транзакции ALTER INDEX REORGANIZE. Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

REORGANIZE не требуется для перемещения разностных групп строк CLOSED в сжатые группы строк. Для сжатия разностных групп строк CLOSED периодически активируется фоновый процесс перемещения кортежей (TM). REORGANIZE рекомендуется использовать при отставании процесса перемещения кортежей. REORGANIZE может сжимать группы строк более агрессивно.
Сведения о сжатии всех групп строк OPEN и CLOSED см. далее в разделе о параметре REORGANIZE WITH (COMPRESS_ALL_ROW_GROUPS).

Для индексов columnstore в SQL Server (начиная с SQL Server 2016 (13.x)) и База данных SQL Azure REORGANIZE выполняет следующие дополнительные оптимизации дефрагментации в Сети:

Физически удаляет строки из группы строк, если были логически удалено 10 % или более строк. Удаленные байты освобождают место на физическом носителе. Например, если в сжатой группе, содержащей 1 миллион строк, удалено 100 000 строк, SQL Server удалит эти строки и выполнит повторное сжатие группы с 900 тыс. строк. Группа будет сохранена в хранилище за счет удаления удаленных строк.
Объединяет одну или несколько сжатых групп строк для увеличения числа строк для каждой группы до максимального значения, составляющего 1 048 576 строк. Например, при массовом импорте 5 пакетов по 102 400 строк вы получите 5 сжатых групп строк. При выполнении команды REORGANIZE эти групп строк будут объединены в 1 сжатую группу строк, содержащую 512 000 строк. Предполагается отсутствие ограничений на размер словаря или объем памяти.
SQL Server попытается объединить группу строк, из которой были логически удалены 10 % или более строк, с одной или несколькими группами строк. Например, группа строк 1 сжимается с 500 000 строками, а группа строк 21 сжимается с максимум 1 048 576 строками. В группе строк 21 удалено 60 % строк и осталось 409 830 строк. SQL Server объединяет этих две группы строк для сжатия новой группы строк, содержащей 909 830 строк.

REORGANIZE WITH ( COMPRESS_ALL_ROW_GROUPS = { ON | OFF } )

Применимо к индексам columnstore.

Область применения: SQL Server (начиная с SQL Server 2016 (13.x)) и База данных SQL Azure

COMPRESS_ALL_ROW_GROUPS позволяет принудительно отправлять разностные группы строк OPEN или CLOSED в columnstore. При использовании этого параметра не требуется перестраивать индекс columnstore для очистки разностных групп строк. Это, в сочетании и другими функциями дефрагментации удаления и слияния, отменяет необходимость перестроения индекса в большинстве случаев.

ON принудительно отправляет все группы строк в columnstore независимо от размера и состояния (CLOSED или OPEN).
OFF принудительно отправляет все группы строк CLOSED в columnstore.

Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

SET ( <set_index option> [ ,... n] )

Указывает параметры индекса без перестройки или реорганизации индекса. SET нельзя указать для отключенного индекса.

PAD_INDEX = { ON | OFF }

Определяет разреженность индекса. Значение по умолчанию — OFF.

DNS

Процент свободного места, определяемый параметром FILLFACTOR, применяется к страницам индекса промежуточного уровня. Если FILLFACTOR не указано и при этом для PAD_INDEX задано значение ON, то используется значение коэффициента заполнения, хранимое в sys.indexes.

OFF или fillfactor не указан

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

Дополнительные сведения см. в статье CREATE INDEX (Transact-SQL).

FILLFACTOR = fillfactor

Указывает процент, указывающий, насколько полный ядро СУБД должен сделать конечный уровень каждой страницы индекса во время создания или изменения индекса. Значение fillfactor должно быть целым числом от 1 до 100. По умолчанию установлено значение 0. Значения коэффициентов заполнения 0 и 100 идентичны.

Явный параметр FILLFACTOR применяется, только если индекс создается впервые или перестраивается. Ядро СУБД не сохраняет динамически указанный процентный объем свободного места на страницах. Дополнительные сведения см. в статье CREATE INDEX (Transact-SQL).

Увидеть коэффициент заполнения можно в таблице fill_factor в sys.indexes.

Важно!

Создание или изменение кластеризованного индекса со FILLFACTOR значением влияет на объем дискового пространства, которое занимает данные, так как ядро СУБД перераспространяет данные при создании кластеризованного индекса.

SORT_IN_TEMPDB = { ON | OFF }

Указывает, следует ли сохранять результаты сортировки в базе данных tempdb. Значение по умолчанию — OFF, за исключением функции гипермасштабирования базы данных SQL Azure. Для всех операций построения индекса в режиме гипермасштабирования параметр SORT_IN_TEMPDB всегда включен независимо от указанного параметра, если не используется возобновляемое перестроение индекса.

DNS
Промежуточные результаты сортировки, которые используются при индексировании, хранятся в базе данных tempdb. Это может сократить время, требуемое для создания индекса, если база данных tempdb размещена на иных дисках, нежели пользовательская база данных. Однако это увеличивает использование места на диске, которое используется при индексировании.

ВЫКЛ.
Промежуточные результаты сортировки хранятся в той же базе данных, где и индекс.

Если операция сортировки не требуется или сортировка может быть выполнена в памяти, параметр SORT_IN_TEMPDB игнорируется.

Дополнительные сведения см. в разделе Параметр SORT_IN_TEMPDB для индексов.

IGNORE_DUP_KEY = { ON | OFF }

Определяет ответ на ошибку, случающуюся, когда операция вставки пытается вставить в уникальный индекс повторяющиеся значения ключа. Параметр IGNORE_DUP_KEY применяется только к операциям вставки, производимым после создания или перестроения индекса. Значение по умолчанию — OFF.

DNS
Если в уникальный индекс вставляются повторяющиеся значения ключа, выводится предупреждающее сообщение. С ошибкой завершаются только строки, нарушающие ограничение уникальности.

ВЫКЛ.
Если в уникальный индекс вставляются повторяющиеся значения ключа, выводится сообщение об ошибке. Будет выполнен откат всей операции INSERT.

Для IGNORE_DUP_KEY нельзя установить значение ON для индексов, создаваемых для представлений, неуникальных индексов, XML-индексов, пространственных индексов и фильтруемых индексов.

Для просмотра значения IGNORE_DUP_KEY используйте sys.indexes.

Для обратной совместимости синтаксиса аргумент WITH IGNORE_DUP_KEY эквивалентен WITH IGNORE_DUP_KEY = ON.

STATISTICS_NORECOMPUTE = { ON | OFF }

Указывает, выполнялся ли перерасчет статистики распределения. Значение по умолчанию — OFF.

DNS
Устаревшие статистики не пересчитываются автоматически.

ВЫКЛ.
Автоматическое обновление статистических данных включено.

Чтобы восстановить автоматическое обновление статистики, установите для параметра STATISTICS_NORECOMPUTE значение OFF или выполните UPDATE STATISTICS без предложения NORECOMPUTE.

Важно!

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

STATISTICS_INCREMENTAL = { ON | OFF }

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

При значении ON статистики создаются как статистики отдельно по секциям. При значении OFF дерево статистики удаляется, SQL Server выполняет повторный пересчет статистики. Значение по умолчанию — OFF.

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

Статистика, созданная с индексами, невыровненными по секциям для базовой таблицы
Статистика, созданная в базах данных вторичных реплик для чтения для групп доступности.
Статистика, созданная в базах данных, доступных только для чтения.
Статистика, созданная по фильтрованным индексам.
Статистика, созданная по представлениям.
Статистика, созданная по внутренним таблицам.
Статистика, созданная с пространственными индексами или XML-индексами.

ONLINE = { ON | OFF } <применимо к rebuild_index_option>

Определяет, будут ли базовые таблицы и связанные индексы доступны для запросов и изменения данных во время операций с индексами. Значение по умолчанию — OFF.

Для XML-индекса или пространственного индекса поддерживается только значение ONLINE = OFF. Если для ONLINE задано состояние ON, возникает ошибка.

Важно!

Операции с индексами в Сети недоступны в каждом выпуске Microsoft SQL Server. Список функций, поддерживаемых выпусками SQL Server, см. в выпусках и поддерживаемых функциях SQL Server 2022.

DNS
Долгосрочные блокировки таблицы не выполняются во время операций с индексами. Во время главной фазы операций с индексами только блокировка с намерением совмещаемого доступа (IS) удерживается в исходной таблице. Это позволяет продолжить выполнение запросов или обновлений для базовых таблиц и индексов. В начале операции совмещаемая блокировка (S) исходного объекта поддерживается в течение очень короткого времени. Если создается некластеризованный индекс, в конце операции на короткое время выполняется совмещаемая блокировка (S) для исходного объекта. Блокировка SCH-M (изменение схемы) запрашивается, если в режиме "в сети" создается или удаляется кластеризованный индекс либо перестраивается кластеризованный или некластеризованный индекс. При создании индекса для временной локальной таблицы параметр ONLINE не может принимать значение ON.

ВЫКЛ.
Блокировки таблиц применяются при выполнении операций с индексами. Операция с индексами в режиме «вне сети», которая создает, перестраивает или удаляет кластеризованный, пространственный или XML-индекс либо перестраивает или удаляет некластеризованный индекс, получает блокировку изменения схемы (Sch-M) для этой таблицы. Это предотвращает доступ к базовой таблице всех пользователей во время выполнения операции. Операция с индексами вне сети, создающая некластеризованный индекс, получает совмещаемую блокировку (S) в таблице. Это запрещает проводить обновления базовой таблицы, но разрешает проводить операции чтения, например инструкции SELECT.

Дополнительные сведения см. в статье Выполнение операции с индексами в сети.

Индексы, в том числе индексы глобальных временных таблиц, могут быть перестроены при подключении к сети, за исключением следующего:

XML-индекс
Индекс локальной временной таблицы
Исходные уникальные кластеризованные индексы представлений.
Индексы columnstore
Кластеризованные индексы, если базовая таблица содержит типы данных LOB: image, ntext, text и пространственные типы данных.
Столбцы varchar(max) и varbinary(max) не могут быть частью индекса. В SQL Server (начиная с SQL Server 2012 (11.x)) и База данных SQL Azure, если таблица содержит столбцы varchar(max) или varbinary(max), кластеризованный индекс, содержащий другие столбцы, можно создать или перестроить с помощью этого ONLINE параметра. В базе данных SQL Azure запрещено использовать параметр ONLINE, если базовая таблица содержит столбец varchar(max) или varbinary(max)

Дополнительные сведения см. в разделе Об операциях с индексами в режиме "в сети".

Следующие XEvents связаны с ALTER TABLE ... SWITCH PARTITION перестроениями индексов в сети.

lock_request_priority_state
process_killed_by_abort_blockers
ddl_with_wait_at_low_priority

Существующие XEvent progress_report_online_index_operation для операций с индексами в сети включают partition_number и partition_id.

RESUMABLE = { ON | OFF}

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Указывает, является ли операция с индексами в режиме "в сети" возобновляемой.

DNS
Операция с индексами является возобновляемой.

ВЫКЛ.
Операция с индексами является невозобновляемой.

MAX_DURATION = time [MINUTES] используется с `RESUMABLE = ON` (требуется `ONLINE = ON`)

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

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

Важно!

Примечание.

Возобновляемое перестроение индекса с подключением к сети не поддерживается для индексов columnstore.

ALLOW_ROW_LOCKS = { ON | OFF }

Указывает, разрешена ли блокировка строк. Значение по умолчанию — ON.

DNS
Блокировки строк допустимы при доступе к индексу. Ядро СУБД определяет, когда используются блокировки строк.

ВЫКЛ.
Блокировки строк не используются.

ALLOW_PAGE_LOCKS = { ON | OFF }

Указывает, разрешена ли блокировка страниц. Значение по умолчанию — ON.

DNS
Блокировки страниц допустимы при доступе к индексу. Ядро СУБД определяет, когда используются блокировки страниц.

ВЫКЛ.
Блокировки страниц не используются.

Примечание.

Индекс не может быть реорганизован, если ALLOW_PAGE_LOCKS установлен в состояние OFF.

OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }

Область применения: SQL Server (начиная с SQL Server 2019 (15.x)) и База данных SQL Azure

Определяет, следует ли выполнять оптимизацию, связанную с состязанием при операциях вставки на последнюю страницу. Значение по умолчанию — OFF. Дополнительные сведения см. в разделе о последовательных ключах.

MAXDOP = max_degree_of_parallelism

Переопределяет параметр конфигурации максимальной степени параллелизма на время выполнения операции с индексами. Дополнительные сведения см. в разделе Настройка параметра конфигурации сервера max degree of parallelism. MAXDOP можно использовать для ограничения числа процессоров, используемых при параллельном выполнении планов. Максимальное число процессоров — 64.

Важно!

Хотя параметр MAXDOP синтаксически поддерживается для всех индексов XML, для пространственного или первичного XML-индекса инструкция ALTER INDEX в настоящее время использует только один процессор.

Параметр max_degree_of_parallelism может иметь одно из следующих значений:

1
Подавляет формирование параллельных планов.

>1
Ограничивает указанным значением максимальное число процессоров, используемых для параллельных операций с индексами.

0 (по умолчанию)
В зависимости от текущей рабочей нагрузки системы использует реальное или меньшее число процессоров.

Дополнительные сведения см. в статье Настройка параллельных операций с индексами.

Примечание.

Параллельные операции индексов недоступны в каждом выпуске SQL Server. Список функций, поддерживаемых выпусками SQL Server, см. в выпусках и поддерживаемых функциях SQL Server 2022.

COMPRESSION_DELAY = { 0 | duration [Minutes] }

Область применения: SQL Server (начиная с SQL Server 2016 (13.x))

Для таблицы на основе диска значение delay указывает минимальное количество минут, в течение которых разностная группа строк в состоянии CLOSED должна оставаться в разностной группе строк до того, как SQL Server сожмет ее в сжатую группу строк. Поскольку таблицы на основе диска не отслеживают время вставки и обновления отдельных строк, SQL Server применяет задержку к разностным группам строк в состоянии CLOSED.

Значение по умолчанию — 0 минут.

Рекомендации по использованию COMPRESSION_DELAY см. в разделе Начало работы с columnstore для получения операционной аналитики в реальном времени.

DATA_COMPRESSION

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

NONE
Индекс или указанные секции не сжимаются. Это не относится к индексам columnstore.

ROW
Для индекса или заданных секций производится сжатие строк. Это не относится к индексам columnstore.

СТРАНИЦА
Для индекса или заданных секций производится сжатие страниц. Это не относится к индексам columnstore.

COLUMNSTORE

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

Применяется только к индексам columnstore, включая некластеризованные и кластеризованные индексы columnstore. COLUMNSTORE указывает, что должны быть распакованы индекс или конкретные секции, которые были упакованы с помощью параметра COLUMNSTORE_ARCHIVE. При восстановлении данных сжатие будет продолжаться с применением сжатия columnstore, предусмотренного для всех индексов columnstore.

COLUMNSTORE_ARCHIVE

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

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

Дополнительные сведения о сжатии см. в разделе Сжатие данных.

XML_COMPRESSION

Область применения: SQL Server 2022 (16.x) и более поздних версий, База данных SQL Azure и Управляемый экземпляр SQL Azure.

Задает параметр сжатия XML для указанного индекса, содержащего один или несколько столбцов с типом данных xml. Существуют следующие варианты выбора.

DNS
Для индекса или заданных секций производится сжатие XML.

ВЫКЛ.
Индекс или заданные секции не сжимаются.

ON PARTITIONS ( { <partition_number_expression> | <range> } [,...n] )

Указывает секции, к которым применяются параметры DATA_COMPRESSION или XML_COMPRESSION. Если индекс не секционирован, аргумент ON PARTITIONS создаст ошибку. Если предложение ON PARTITIONS не указано, параметры DATA_COMPRESSION или XML_COMPRESSION применяются ко всем секциям секционированного индекса.

<partition_number_expression> можно указать одним из следующих способов.

указав номер секции, например ON PARTITIONS (2);
указав номера нескольких секций, разделив их запятыми, например ON PARTITIONS (1, 5);
указав как диапазоны секций, так и отдельные секции, например ON PARTITIONS (2, 4, 6 TO 8).

<range> можно указать в виде номеров секций, разделенных ключевым словом TO, например: ON PARTITIONS (6 TO 8).

Чтобы для разных секций задать разные типы сжатия данных, укажите параметр DATA_COMPRESSION несколько раз, например следующим образом.

REBUILD WITH
(
DATA_COMPRESSION = NONE ON PARTITIONS (1),
DATA_COMPRESSION = ROW ON PARTITIONS (2, 4, 6 TO 8),
DATA_COMPRESSION = PAGE ON PARTITIONS (3, 5)
);

Параметр XML_COMPRESSION можно указывать несколько раз, например:

REBUILD WITH
(
  XML_COMPRESSION = OFF ON PARTITIONS (1),
  XML_COMPRESSION = ON ON PARTITIONS (2, 4, 6 TO 8),
  XML_COMPRESSION = OFF ON PARTITIONS (3, 5)
);

ONLINE = { ON | OFF } <применимо к single_partition_rebuild_index_option>

Указывает, может ли быть перестроен индекс или секция индекса базовой таблицы в режиме "в сети" или "вне сети". Если выполняется REBUILD ... ONLINE = ON, то данные таблицы доступны для запросов и изменения данных во время операций с индексами. Значение по умолчанию — OFF.

DNS
Долгосрочные блокировки таблицы не выполняются во время операций с индексами. Во время главной фазы операций с индексами только блокировка с намерением совмещаемого доступа (IS) удерживается в исходной таблице. Блокировка стабильности схемы (Sch-S) для таблицы требуется при запуске перестроения индекса, а блокировка изменения схемы (Sch-M) требуется в таблице в конце перестроения индекса в сети. Обе блокировки метаданных являются кратковременными, но при этом блокировка Sch-M должна ожидать завершения всех блокирующих транзакций. В этот период ожидания блокировка Sch-M блокирует все другие транзакции, которые получат доступ к этой таблице только после завершения блокировки.

Примечание.

При перестроении индекса в режиме "в сети" могут задаваться параметры low_priority_lock_wait. См. WAIT_AT_LOW_PRIORITY с операциями с индексами в режиме "в сети".

ВЫКЛ.
Блокировки таблиц применяются при выполнении операций с индексами. Это предотвращает доступ к базовой таблице всех пользователей во время выполнения операции.

RESUME

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Возобновить операцию с индексами, приостановленную вручную или из-за сбоя.

MAX_DURATION используется с RESUMABLE = ON

Время (целочисленное значение минутах), в течение которого выполняется возобновляемая операция с индексами с подключением к сети после приостановки. После истечения этого времени, если возобновляемая операция все еще выполняется, она приостанавливается.

WAIT_AT_LOW_PRIORITY используется с RESUMABLE = ON и ONLINE = ON.

Возобновление перестроения индекса в режиме "в сети" после приостановки должно ожидать операции блокировки в этой таблице. WAIT_AT_LOW_PRIORITY указывает, что операция перестроения индекса в сети ожидает низкоприоритетных блокировок, позволяя другим операциям продолжаться, пока операция сборки индекса в сети ожидается. Пропуск параметра WAIT_AT_LOW_PRIORITY эквивалентен WAIT_AT_LOW_PRIORITY (MAX_DURATION = 0 minutes, ABORT_AFTER_WAIT = NONE). Дополнительные сведения см. в разделе WAIT_AT_LOW_PRIORITY.

PAUSE

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Приостановить возобновляемую операцию перестроения индексов в режиме "в сети".

ABORT

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Прервать выполняющуюся или приостановленную операцию с индексами, объявленную как возобновляемая. Чтобы завершить возобновляемую операцию перестроения индексов, необходимо явно выполнить команду ABORT. Сбой или приостановка возобновляемой операции с индексами не завершает ее выполнение, а оставляет ее в неопределенном состоянии приостановки.

Замечания

ALTER INDEX не может использоваться для повторного секционирования индекса или его перемещения в другую файловую группу. Эта инструкция не может использоваться для изменения определения индекса, в том числе для добавления или удаления столбцов или изменения их порядка. Для выполнения этих операций используйте CREATE INDEX с предложением DROP_EXISTING.

Если параметр не указан явно, тогда применяется текущий параметр. Например, если параметр FILLFACTOR не указан в предложении REBUILD, коэффициент заполнения, сохраненный в системном каталоге, будет использоваться в процессе перестроения. Для просмотра текущего параметра индекса следует использовать таблицу sys.indexes.

Значения для ONLINE, MAXDOP и SORT_IN_TEMPDB не хранятся в системном каталоге. Если значение некоторого параметра не указано в инструкции индекса, то используется значение по умолчанию.

На компьютерах с несколькими процессорами инструкция ALTER INDEX REBUILD, как и другие запросы, использует больше процессоров для операций просмотра и сортировки, связанных с изменением индекса. При выполнении инструкции ALTER INDEX REORGANIZE без предложения LOB_COMPACTION или с ним значение аргумента max degree of parallelism представляет собой однопотоковую операцию. Дополнительные сведения см. в статье Настройка параллельных операций с индексами.

Важно!

Индекс нельзя реорганизовать или перестроить, если файловая группа, в которой он находится, размещена вне сети или настроена только для чтения. Если указывается ключевое слово ALL, а один или несколько индексов размещены в файловой группе, которая находится в автономном режиме или предназначена только для чтения, то выполнить инструкцию не удастся.

Перестроение индексов

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

Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

Реорганизация индексов

Для реорганизации индекса требуется минимальный объем системных ресурсов. При реорганизации концевой уровень кластеризованных и некластеризованных индексов на таблицах и представлениях дефрагментируется путем физической реорганизации страниц конечного уровня, в результате чего они выстраиваются в соответствии с логическим порядком конечных узлов (слева направо). Кроме того, реорганизация сжимает страницы индекса. Их сжатие производится в соответствии с текущим значением коэффициента заполнения.

Если указывается ключевое слово ALL, то реляционные индексы, как кластеризованные, так и некластеризованные, и XML-индексы для таблицы реорганизуются. Существуют некоторые ограничения при указаниии ALL. См. определение ALL в разделе "Аргументы" этой статьи.

Дополнительные сведения см. в статье Реорганизация и перестроение индексов.

Важно!

Для таблицы Azure Synapse Analytics с упорядоченным кластеризованным индексом ALTER INDEX REORGANIZE columnstore не выполняет повторную сортировку данных. Для повторной сортировки данных используйте ALTER INDEX REBUILD.

Отключение индексов

Отключение индексов предотвращает доступ пользователя к индексам в случае использования кластеризованных индексов к данным базовой таблицы. Определение индекса остается в системном каталоге. Отключение некластеризованных индексов или кластеризованных индексов в представлении физически удаляет данные индекса. При отключении кластеризованного индекса блокируется доступ к данным, но данные остаются необслуживаемыми в сбалансированном дереве до тех пор, пока индекс не будет удален или перестроен. Чтобы просмотреть состояние включенного или отключенного индекса, запросите is_disabled столбец в представлении sys.indexes каталога.

Примечание.

В документации по SQL Server термин "сбалансированное дерево" обычно используется в отношении индексов. В индексах rowstore SQL Server реализует B+-дерево. Это не относится к индексам columnstore или хранилищам данных в памяти. Дополнительные сведения см. в руководстве по архитектуре и проектированию индексов SQL Sql Server и Azure.

Если таблица входит в публикацию репликации транзакций, нельзя отключить индексы, связанные с столбцами первичного ключа. Эти индексы необходимы для репликации. Чтобы отключить индексы, сначала необходимо удалить таблицу из публикации. Дополнительные сведения см. в статье Публикация данных и объектов базы данных.

С помощью инструкции ALTER INDEX REBUILD или CREATE INDEX WITH DROP_EXISTING включите индекс. Отключенный кластеризованный индекс нельзя перестроить, если для параметра ONLINE установлено значение ON. Дополнительные сведения см. в статье Отключение индексов и ограничений.

Параметры настройки

Вы можете задать параметры ALLOW_ROW_LOCKS, ALLOW_PAGE_LOCKS, OPTIMIZE_FOR_SEQUENTIAL_KEY, IGNORE_DUP_KEY и STATISTICS_NORECOMPUTE для определенного индекса без перестройки или реорганизации этого индекса. Измененные значения немедленно применяются к индексу. Чтобы просмотреть эти параметры, используйте sys.indexes. Дополнительные сведения см. в разделе Установка параметров индекса.

Параметры блокировок строк и страниц

Когда присвоены значения ALLOW_ROW_LOCKS = ON и ALLOW_PAGE_LOCK = ON, при доступе к индексу допустимы блокировки на уровне строк, страниц и таблиц. Ядро СУБД выбирает соответствующую блокировку и может передавать блокировку из строки или блокировки страницы на блокировку таблицы.

Если присвоены значения ALLOW_ROW_LOCKS = OFF и ALLOW_PAGE_LOCK = OFF, при доступе к индексу допустима только блокировка на уровне таблиц.

Если при установке параметров блокировки строки или страницы указывается ключевое слово ALL, то установки применяются ко всем индексам. Если базовая таблица представляет собой кучу, установки применяются следующими способами:

Вариант	Details
ALLOW_ROW_LOCKS = ON или OFF	Для кучи и любых соответствующих некластеризованных индексов.
ALLOW_PAGE_LOCKS = ON	Для кучи и любых соответствующих некластеризованных индексов.
ALLOW_PAGE_LOCKS = OFF	Полностью для некластеризованных индексов. Это означает, что для некластеризованных индексов запрещаются все блокировки страниц. В куче запрещены только общая блокировка (S), блокировка обновления (U) и монопольная блокировка (X) для страниц. Ядро СУБД по-прежнему может получить блокировку страницы намерений (IS, IU или IX) для внутренних целей.

Операции с индексом в сети

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

Реорганизация индекса всегда выполняется в режиме в сети. Процесс не удерживает блокировку в течение долгого времени и поэтому не блокирует выполняемые запросы и обновления.

Параллельные операции с индексами в режиме «в сети» для одной таблицы или секции можно выполнять лишь при выполнении следующих действий:

создание нескольких некластеризованных индексов;
реорганизация различных индексов в одной таблице;
реорганизация различных индексов при перестройке неперекрывающихся индексов в одной таблице.

Все остальные попытки выполнения операций с индексами в сети завершаются ошибкой. Например, нельзя одновременно перестроить два или несколько индексов в одной таблице или создать новый индекс в процессе перестройки существующего индекса для этой таблицы.

Дополнительные сведения см. в статье Выполнение операции с индексами в сети.

Возобновляемые операции с индексами

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

Операция ONLINE INDEX REBUILD указывается как возобновляемая с помощью параметра RESUMABLE = ON.

Параметр RESUMABLE не сохраняется среди метаданных для указанного индекса и применяется только на время выполнения текущей инструкции DDL. Таким образом, для включения возобновляемости предложение RESUMABLE = ON должно быть указано явным образом.
Параметр MAX_DURATION поддерживается для параметра RESUMABLE = ON или low_priority_lock_wait.
- Параметр MAX_DURATION для RESUMABLE задает временной интервал для перестраиваемого индекса. После окончания этого времени операция перестроения индекса приостанавливается или завершает выполнение. Пользователь решает, когда можно возобновить перестроение приостановленного индекса. Значение time в минутах для MAX_DURATION должно быть больше 0 минут и меньше или равно 1 неделе (7 × 24 × 60 = 10080 минут). Длинная пауза в операции с индексами может повлиять на производительность DML в конкретной таблице, а также на емкость диска базы данных, поскольку они оба индексируют исходное и только что созданное требуемое место на диске и должны быть обновлены во время операций DML. Если параметр MAX_DURATION пропускается, операция с индексами будет продолжаться вплоть до ее завершения или до момента возникновения сбоя.
- Параметр аргумента low_priority_lock_wait позволяет решить, каким образом будет продолжена операция с индексами при Sch-M-блокировке.
Повторное выполнение исходной инструкции ALTER INDEX REBUILD с теми же параметрами возобновляет приостановленную операцию перестроение индексов. Возобновить приостановленную операцию перестроения индексов можно также путем выполнения инструкции ALTER INDEX RESUME.
Параметр SORT_IN_TEMPDB = ON не поддерживается для возобновляемых индексов
Команду DDL с RESUMABLE = ON невозможно выполнить внутри явной транзакции (она не может быть частью блока BEGIN TRAN ... COMMIT).
Возобновляемыми являются только приостановленные операции с индексами.
При возобновлении приостановленной операции с индексами можно изменить значение MAXDOP на новое. Если при возобновлении приостановленной операции с индексами не указан параметр MAXDOP, берется последнее значение MAXDOP. Если этот параметр вообще не указан для операции перестроения индексов, берется значение по умолчанию.
Чтобы немедленно приостановить операцию с индексами, можно остановить текущую команду (CTRL+C) либо выполнить команду ALTER INDEX PAUSE или KILL <session_id>. После приостановки команду можно возобновить с помощью параметра RESUME.
Команда ABORT завершает сеанс, размещающий исходное перестроение индекса, и прерывает выполнение операции с индексами.
Для возобновляемого перестроения индекса не требуются дополнительные ресурсы, за исключением перечисленных ниже.
- Дополнительное место для хранения создаваемого индекса, включая время, когда индекс будет приостановлен.
- Состояние DDL, запрещающее изменения DDL.
На этапе приостановки индекса будет выполняться процесс очистки фантомных записей, но он будет приостановлен во время выполнения индекса. Для возобновляемых операций перестроения индексов отключены следующие функциональные возможности.
- Перестроение отключенного индекса не поддерживается с RESUMABLE = ON
- Команда ALTER INDEX REBUILD ALL
- ALTER TABLE с использованием перестроения индекса
- Команду DDL с RESUMABLE = ON невозможно выполнить внутри явной транзакции (она не может быть частью блока BEGIN TRAN ... COMMIT)
- Перестроение индекса, который содержит вычисляемые столбцы или столбцы TIMESTAMP в качестве ключевых столбцов.
Если базовая таблица содержит столбцы LOB, для возобновляемого перестроения кластеризованных индексов требуется Sch-M-блокировка в начале этой операции.

Примечание.

Команда DDL выполняется вплоть до завершения, приостанавливается или завершается ошибкой. Если команда приостанавливается, возникнет ошибка, указывающая на приостановку операции и невозможность завершения создания индекса. Дополнительные сведения о текущем состоянии индекса можно получить из sys.index_resumable_operations. Как и в случае выше, при сбое также будет выведено сообщение об ошибке.

WAIT_AT_LOW_PRIORITY с операциями с индексами в режиме "в сети"

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

Синтаксис low_priority_lock_wait позволяет указать поведение WAIT_AT_LOW_PRIORITY. WAIT_AT_LOW_PRIORITY может использоваться только с ONLINE = ON.

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

Параметр WAIT_AT_LOW_PRIORITY позволяет администратору базы данных управлять блокировками стабильности схемы (Sch-S) и изменения схемы (Sch-M), необходимыми для перестроения индекса в режиме "в сети". Для этого доступно два варианта. Во всех случаях, если во время ожидания MAX_DURATION = n [minutes] нет блокирующих действий, перестроение индекса в режиме "в сети" выполняется немедленно и без ожидания завершения инструкции DDL.

WAIT_AT_LOW_PRIORITY указывает, что операция перестроения индекса в сети ожидает низкоприоритетных блокировок, позволяя другим операциям продолжаться, пока операция сборки индекса в сети ожидается. Пропуск параметра WAIT AT LOW PRIORITY эквивалентен WAIT_AT_LOW_PRIORITY (MAX_DURATION = 0 minutes, ABORT_AFTER_WAIT = NONE).

MAX_DURATION = time [MINUTES]

Время ожидания (целочисленное значение, указанное в минутах) в течение которого блокировки для операции перестроения индекса в режиме «в сети» будут ожидать с низким приоритетом при выполнении команды DDL. Если операция заблокирована в течение времени MAX_DURATION, будет выполнено указанное действие ABORT_AFTER_WAIT. Время MAX_DURATION всегда указывается в минутах, и слово MINUTES можно опустить.

ABORT_AFTER_WAIT = [ NONE | SELF | BLOCKERS ]

NONE
Продолжить ожидание блокировки с обычным приоритетом.

САМО-
Прекратить операцию DDL по перестроению индекса в режиме «в сети», выполняемую в данный момент без выполнения какого-либо действия. Параметр SELF не может использоваться с параметром MAX_DURATION, равным нулю.

BLOCKERS
Остановить все пользовательские транзакции, в данный момент блокирующие операцию DDL по перестроению индекса в режиме «в сети», чтобы можно было продолжить данную операцию. Параметр BLOCKERS требует, чтобы учетная запись имела разрешение ALTER ANY CONNECTION.

Ограничения пространственного индекса

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

Ограничение PRIMARY KEY в таблице пользователя не может быть изменено, пока для столбца этой таблицы определен пространственный индекс. Для изменения ограничения PRIMARY KEY сначала необходимо удалить все пространственные индексы таблицы. После изменения ограничения PRIMARY KEY все пространственные индексы можно создать повторно.

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

Чтобы изменить параметры, относящиеся к пространственному индексу, например BOUNDING_BOX или GRID, можно либо использовать инструкцию CREATE SPATIAL INDEX, указывающую DROP_EXISTING = ON, либо удалить пространственный индекс и создать новый. Пример см. в статье CREATE SPATIAL INDEX (Transact-SQL).

Сжатие данных

Дополнительную информацию о сжатии данных см. в разделе Сжатие данных.

Чтобы оценить, как изменение параметров сжатия PAGE и ROW повлияет на таблицу, индекс или секцию, используйте хранимую процедуру sp_estimate_data_compression_savings.

На секционированные индексы налагаются следующие ограничения.

Если при использовании ALTER INDEX ALL ... у таблицы есть невыровненные индексы, настройку сжатия отдельной секции изменить нельзя.
Синтаксис ALTER INDEX <index> ... REBUILD PARTITION ... производит перестроение указанной секции индекса.
Синтаксис ALTER INDEX <index> ... REBUILD WITH ... производит перестроение всех секций индекса.

Статистика

При применении инструкции ALTER INDEX ALL ... к таблице происходит обновление только тех статистических данных, которые связаны с индексами. Автоматические или созданные вручную статические данные таблицы (вместо индекса) не обновляются.

Разрешения

Для выполнения ALTER INDEX необходимо иметь как минимум разрешение ALTER для таблицы или представления.

Заметки о версии

В базе данных SQL не используются параметры файловой группы и файлового потока.
Индексы columnstore недоступны в версиях ранее SQL Server 2012 (11.x).
Операции возобновления индексов доступны начиная с SQL Server 2017 (14.x) и База данных SQL Azure.

Пример простого синтаксиса

ALTER INDEX index1 ON table1 REBUILD;

ALTER INDEX ALL ON table1 REBUILD;

ALTER INDEX ALL ON dbo.table1 REBUILD;

Примеры: индексы columnstore

Эти примеры относятся к индексам columnstore.

А. Демонстрация REORGANIZE

В этом примере показано, как работает команда ALTER INDEX REORGANIZE. В нем создается таблица с несколькими группами строк и показано использование команды REORGANIZE для объединения этих групп строк.

-- Create a database
CREATE DATABASE [ columnstore ];
GO

-- Create a rowstore staging table
CREATE TABLE [ staging ] (
     AccountKey              int NOT NULL,
     AccountDescription      nvarchar (50),
     AccountType             nvarchar(50),
     AccountCodeAlternateKey     int
     )

-- Insert 10 million rows into the staging table.
DECLARE @loop int
DECLARE @AccountDescription varchar(50)
DECLARE @AccountKey int
DECLARE @AccountType varchar(50)
DECLARE @AccountCode int

SELECT @loop = 0
BEGIN TRAN
    WHILE (@loop < 300000)
      BEGIN
        SELECT @AccountKey = CAST (RAND()*10000000 as int);
        SELECT @AccountDescription = 'accountdesc ' + CONVERT(varchar(20), @AccountKey);
        SELECT @AccountType = 'AccountType ' + CONVERT(varchar(20), @AccountKey);
        SELECT @AccountCode =  CAST (RAND()*10000000 as int);

        INSERT INTO  staging VALUES (@AccountKey, @AccountDescription, @AccountType, @AccountCode);

        SELECT @loop = @loop + 1;
    END
COMMIT

-- Create a table for the clustered columnstore index

CREATE TABLE cci_target (
     AccountKey              int NOT NULL,
     AccountDescription      nvarchar (50),
     AccountType             nvarchar(50),
     AccountCodeAlternateKey int
     )

-- Convert the table to a clustered columnstore index named inxcci_cci_target;
CREATE CLUSTERED COLUMNSTORE INDEX idxcci_cci_target ON cci_target;

Используйте параметр TABLOCK для параллельной вставки строк. Начиная с SQL Server 2016 (13.x), INSERT INTO операция может выполняться параллельно при использовании TABLOCK.

INSERT INTO cci_target WITH (TABLOCK)
SELECT TOP 300000 * FROM staging;

Выполните эту команду, чтобы увидеть разностные группы строк OPEN. Количество групп строк зависит от уровня параллелизма.

SELECT *
FROM sys.dm_db_column_store_row_group_physical_stats
WHERE object_id  = object_id('cci_target');

Выполните эту команду для принудительной отправки всех групп строк CLOSED и OPEN в columnstore.

ALTER INDEX idxcci_cci_target ON cci_target REORGANIZE WITH (COMPRESS_ALL_ROW_GROUPS = ON);

Выполните эту команду еще раз, и вы увидите, что небольшие группы строк объединены в одну сжатую группу строк.

ALTER INDEX idxcci_cci_target ON cci_target REORGANIZE WITH (COMPRESS_ALL_ROW_GROUPS = ON);

B. Сжатие разностных групп строк CLOSED в columnstore

В этом примере для сжатия каждой разностной группы строк CLOSED в columnstore в виде сжатой группы строк используется параметр REORGANIZE. Это делать необязательно, но полезно, когда процесс перемещения кортежей выполняет сжатие группы строк CLOSED недостаточно быстро.

Вы можете запустить оба примера в образце базы данных AdventureWorksDW2022.

В этом примере во всех секциях будет выполняться REORGANIZE.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE;

В этом примере некоторых секциях будет выполняться REORGANIZE.

-- REORGANIZE a specific partition
ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE PARTITION = 0;

C. Сжатие всех разностных групп строк OPEN и CLOSED в columnstore

Область применения: SQL Server (начиная с SQL Server 2016 (13.x)) и База данных SQL Azure

Команда REORGANIZE WITH ( COMPRESS_ALL_ROW_GROUPS = ON ) сжимает каждую разностную группу строк OPEN и CLOSED в columnstore в виде сжатой группы строк. При этом очищается хранилище deltastore и все строки принудительно сжимаются в columnstore. Это особенно полезно после выполнения множества операций вставки, так как они хранят строки в одном или нескольких разностных группах строк.

REORGANIZE объединяет группы строк для заполнения групп строк до максимального числа строк <= 1 024 576. Таким образом, при сжатии всех групп строк OPEN и CLOSED у вас не будет большого количества сжатых групп строк, содержащих небольшое количество строк. Чтобы сократить размер в сжатом виде и повысить производительность запросов, группы строк следует заполнить как можно плотнее.

В следующих примерах используется база данных AdventureWorksDW2022.

В этом примере все разностные группы строк OPEN и CLOSED перемещаются в индекс columnstore.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE WITH (COMPRESS_ALL_ROW_GROUPS = ON);

В этом примере все разностные группы строк OPEN и CLOSED перемещаются в индекс columnstore для определенной секции.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE PARTITION = 0 WITH (COMPRESS_ALL_ROW_GROUPS = ON);

D. Дефрагментация индекса columnstore в режиме "в сети"

Не применяется к SQL Server 2012 (11.x) и SQL Server 2014 (12.x).

Начиная с SQL Server 2016 (13.x), REORGANIZE делает больше, чем сжатие разностных групп строк в columnstore. Эта команда также выполняет дефрагментацию в режиме "в сети". Сначала она уменьшает размер columnstore путем физического удаления удаленных строк, если в группе строк было удалено 10 % или более строк. Затем она объединяет группы строк для формирования более крупных групп, каждая из которых может содержать до 1 024 576 строк. Все измененные группы строк проходят повторное сжатие.

Примечание.

Начиная с SQL Server 2016 (13.x), перестроение индекса columnstore больше не требуется в большинстве случаев, так как REORGANIZE физически удаляет удаленные строки и объединяет группы строк. Параметр COMPRESS_ALL_ROW_GROUPS принудительно отправляет все разностные группы строк OPEN или CLOSED в columnstore. Ранее это можно было сделать только с помощью перестроения. REORGANIZE работает в режиме "в сети" и выполняется в фоне, поэтому запросы могут продолжаться по мере выполнения операции.

В следующем примере для дефрагментации индекса путем физического удаления строк, логически удаленных из таблицы, и объединения групп строк выполняется REORGANIZE.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE;

Д. Перестроение кластеризованного индекса columnstore в режиме "вне сети"

Область применения: SQL Server (начиная с SQL Server 2012 (11.x))

Совет

Начиная с SQL Server 2016 (13.x) и в База данных SQL Azure мы рекомендуем использовать ALTER INDEX REORGANIZE вместо ALTER INDEX REBUILD индексов columnstore.

Примечание.

В SQL Server 2012 (11.x) и SQL Server 2014 (12.x) REORGANIZE используется только для сжатия групп строк CLOSED в columnstore. Единственным способом выполнения операций дефрагментация и принудительной отправки всех разностных групп строк в columnstore является перестроение индекса.

В этом примере показано, как перестроить кластеризованный индекс columnstore и принудительно отправить все разностные группы строк в columnstore. В этом первом шаге подготавливается таблица FactInternetSales2 в базе данных AdventureWorksDW2022 с кластеризованным индексом columnstore, а также выполняется вставка данных из первых четырех столбцов.

CREATE TABLE dbo.FactInternetSales2 (
    ProductKey [int] NOT NULL,
    OrderDateKey [int] NOT NULL,
    DueDateKey [int] NOT NULL,
    ShipDateKey [int] NOT NULL);

CREATE CLUSTERED COLUMNSTORE INDEX cci_FactInternetSales2
ON dbo.FactInternetSales2;

INSERT INTO dbo.FactInternetSales2
SELECT ProductKey, OrderDateKey, DueDateKey, ShipDateKey
FROM dbo.FactInternetSales;

SELECT * FROM sys.column_store_row_groups;

Результатом становится одна группа строк OPEN, а это означает, что SQL Server будет ожидать добавления большего количества строк и только после этого закроет группу строк и переместит данные в columnstore. Следующая инструкция перестраивает кластеризованный индекс columnstore, что приводит к принудительной отправке всех строк в columnstore.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REBUILD;
SELECT * FROM sys.column_store_row_groups;

Результаты инструкции SELECT показывают, что группа строк имеет атрибут COMPRESSED, а это означает, что сегменты столбца этой группы строк теперь упакованы и хранятся в columnstore.

F. Перестроение секции кластеризованного индекса columnstore в режиме "вне сети"

Область применения: SQL Server (начиная с SQL Server 2012 (11.x))

Для перестроения секции большого кластеризованного индекса columnstore используйте инструкцию ALTER INDEX REBUILD с параметром секции. В этом примере перестраивается секция 12. Начиная с SQL Server 2016 (13.x), рекомендуется заменить REBUILDREORGANIZEна .

ALTER INDEX cci_fact3
ON fact3
REBUILD PARTITION = 12;

G. Изменение кластеризованного индекса columnstore для использования архивного сжатия

Не применяется к SQL Server 2012 (11.x)

Используя параметр сжатия данных COLUMNSTORE_ARCHIVE, можно еще больше уменьшить размер кластеризованного индекса columnstore. Это целесообразно для более старых данных, которые будут храниться в дешевом хранилище. Этот параметр рекомендуется применять только для редко используемых данных, поскольку распаковка выполняется медленнее, чем обычное сжатие COLUMNSTORE.

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

Сначала подготовьте пример, создав таблицу с кластеризованным индексом columnstore. Затем еще выполните сжатие таблицы, используя архивное сжатие.

--Prepare the example by creating a table with a clustered columnstore index.
CREATE TABLE SimpleTable (
    ProductKey [int] NOT NULL,
    OrderDateKey [int] NOT NULL,
    DueDateKey [int] NOT NULL,
    ShipDateKey [int] NOT NULL
);

CREATE CLUSTERED INDEX cci_SimpleTable ON SimpleTable (ProductKey);

CREATE CLUSTERED COLUMNSTORE INDEX cci_SimpleTable
ON SimpleTable
WITH (DROP_EXISTING = ON);

--Compress the table further by using archival compression.
ALTER INDEX cci_SimpleTable ON SimpleTable
REBUILD
WITH (DATA_COMPRESSION = COLUMNSTORE_ARCHIVE);
GO

В этом примере удаляется сжатие архива, а используется только сжатие columnstore.

ALTER INDEX cci_SimpleTable ON SimpleTable
REBUILD
WITH (DATA_COMPRESSION = COLUMNSTORE);
GO

Примеры: индексы rowstore

А. Перестроение индекса

В следующем примере показано, как перестроить единственный индекс на таблице Employee базы данных AdventureWorks2022.

ALTER INDEX PK_Employee_EmployeeID ON HumanResources.Employee REBUILD;

B. Перестроение всех индексов в таблице и указание параметров

В следующем примере указывается ключевое слово ALL. Тем самым выполняется перестроение всех индексов, связанных с таблицей Production.Product в базе данных AdventureWorks2022. Указываются три параметра.

ALTER INDEX ALL ON Production.Product
REBUILD WITH (FILLFACTOR = 80, SORT_IN_TEMPDB = ON, STATISTICS_NORECOMPUTE = ON);

В следующем примере добавляется параметр ONLINE, содержащий параметры блокировки с низким приоритетом, и добавляется параметр сжатия строк.

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

ALTER INDEX ALL ON Production.Product
REBUILD WITH
(
    FILLFACTOR = 80,
    SORT_IN_TEMPDB = ON,
    STATISTICS_NORECOMPUTE = ON,
    ONLINE = ON ( WAIT_AT_LOW_PRIORITY ( MAX_DURATION = 4 MINUTES, ABORT_AFTER_WAIT = BLOCKERS ) ),
    DATA_COMPRESSION = ROW
);

C. Реорганизация индекса со сжатием данных LOB

В следующем примере показано, как реорганизовать единственный кластеризованный индекс в базе данных AdventureWorks2022. Поскольку индекс содержит тип данных LOB на конечном уровне, инструкция также подвергает сжатию все страницы, в которых содержатся данные больших объектов. Параметр WITH (LOB_COMPACTION = ON) не требуется указывать, так как значением по умолчанию является ON.

ALTER INDEX PK_ProductPhoto_ProductPhotoID ON Production.ProductPhoto REORGANIZE WITH (LOB_COMPACTION = ON);

D. Установка параметров в индексе

В следующем примере задается несколько параметров индекса AK_SalesOrderHeader_SalesOrderNumber в базе данных AdventureWorks2022.

ALTER INDEX AK_SalesOrderHeader_SalesOrderNumber ON
    Sales.SalesOrderHeader
SET (
    STATISTICS_NORECOMPUTE = ON,
    IGNORE_DUP_KEY = ON,
    ALLOW_PAGE_LOCKS = ON
    ) ;
GO

Д. Отключение индекса

В следующем примере показано отключение некластеризованного индекса на таблице Employee базы данных AdventureWorks2022.

ALTER INDEX IX_Employee_ManagerID ON HumanResources.Employee DISABLE;

F. Отключение ограничений

В следующем примере показано отключение ограничения PRIMARY KEY путем отключения индекса PRIMARY KEY в базе данных AdventureWorks2022. Ограничение FOREIGN KEY в базовой таблице автоматически отключается, и выводится предупредительное сообщение.

ALTER INDEX PK_Department_DepartmentID ON HumanResources.Department DISABLE;

Результирующий набор возвращает это предупреждающее сообщение.

Warning: Foreign key 'FK_EmployeeDepartmentHistory_Department_DepartmentID'
on table 'EmployeeDepartmentHistory' referencing table 'Department'
was disabled as a result of disabling the index 'PK_Department_DepartmentID'.

G. Включение ограничений

В следующем примере активируются ограничения PRIMARY KEY и FOREIGN KEY, снятые в примере Е.

Ограничение PRIMARY KEY активируется путем перестройки индекса PRIMARY KEY.

ALTER INDEX PK_Department_DepartmentID ON HumanResources.Department REBUILD;

Затем активируется ограничение FOREIGN KEY.

ALTER TABLE HumanResources.EmployeeDepartmentHistory
CHECK CONSTRAINT FK_EmployeeDepartmentHistory_Department_DepartmentID;
GO

H. Перестроение секционированного индекса

В следующем примере перестраивается единственная секция с номером 5 секционированного индекса IX_TransactionHistory_TransactionDate в базе данных AdventureWorks2022. Секция 5 перестраивается с ONLINE=ON, а 10 минут времени ожидания для низкоприоритетной блокировки применяется отдельно к каждой блокировке, полученной вследствие операции перестроения индекса. Если в течение этого времени не удается получить блокировку для завершения перестроения индекса, инструкция по перестроению прерывается по причине ABORT_AFTER_WAIT = SELF.

Область применения: SQL Server (начиная с SQL Server 2014 (12.x)) и База данных SQL Azure

-- Verify the partitioned indexes.
SELECT *
FROM sys.dm_db_index_physical_stats (DB_ID(),OBJECT_ID(N'Production.TransactionHistory'), NULL , NULL, NULL);
GO
--Rebuild only partition 5.
ALTER INDEX IX_TransactionHistory_TransactionDate
ON Production.TransactionHistory
REBUILD Partition = 5
   WITH (ONLINE = ON (WAIT_AT_LOW_PRIORITY (MAX_DURATION = 10 minutes, ABORT_AFTER_WAIT = SELF)));
GO

I. Изменение настроек сжатия для индекса

В следующем примере перестраивается индекс на несекционированной таблице rowstore.

ALTER INDEX IX_INDEX1
ON T1
REBUILD
WITH (DATA_COMPRESSION = PAGE);
GO

J. Изменение параметра индекса со сжатием XML

Область применения: SQL Server 2022 (16.x) и более поздних версий, База данных SQL Azure и Управляемый экземпляр SQL Azure.

В следующем примере перестраивается индекс на несекционированной таблице rowstore.

ALTER INDEX IX_INDEX1
ON T1
REBUILD
WITH (XML_COMPRESSION = ON);
GO

Дополнительные примеры сжатия данных см. в разделе о сжатии данных.

K. Возобновляемое перестроение индексов в режиме "в сети"

Область применения: SQL Server (начиная с SQL Server 2017 (14.x)) и База данных SQL Azure

В следующих примерах показано использование возобновляемого перестроения индексов в режиме "в сети".

Выполните перестроение индекса в режиме "в сети" как возобновляемую операцию с параметром MAXDOP = 1.
```
ALTER INDEX test_idx on test_table REBUILD WITH (ONLINE = ON, MAXDOP = 1, RESUMABLE = ON) ;
```
При повторном выполнении этой команды (см. выше) после приостановки операции индекса автоматически возобновляется операция перестроения индекса.
Выполните перестроение индекса в режиме "в сети" в качестве возобновляемой операции с параметром MAX_DURATION = 240.
```
ALTER INDEX test_idx on test_table REBUILD WITH (ONLINE = ON, RESUMABLE = ON, MAX_DURATION = 240) ;
```
Приостановите выполняющееся возобновляемое перестроение индексов в режиме "в сети".
```
ALTER INDEX test_idx on test_table PAUSE ;
```
Возобновите перестроение индекса в режиме "в сети" для перестроения индекса, который был выполнен как возобновляемая операция, указав новое значение для MAXDOP, равное 4.
```
ALTER INDEX test_idx on test_table RESUME WITH (MAXDOP = 4) ;
```
Возобновите операцию перестроения индекса в режиме "в сети" для перестроения индекса в режиме "в сети", которое было выполнено как возобновляемое. Задайте параметру MAXDOP значение 2, установите для возобновляемого индекса время выполнения равное 240 минутам, а в случае блокировки индекса подождите 10 минут, после чего удалите все блокировщики.
```
   ALTER INDEX test_idx on test_table
      RESUME WITH (MAXDOP = 2, MAX_DURATION = 240 MINUTES,
      WAIT_AT_LOW_PRIORITY (MAX_DURATION = 10, ABORT_AFTER_WAIT = BLOCKERS)) ;
```
Прервите возобновляемую операцию перестроения индекса, которая выполняется или приостановлена.
```
ALTER INDEX test_idx on test_table ABORT ;
```

ALTER INDEX (Transact-SQL)

Синтаксис

Аргументы

index_name

ВСЕ

database_name

schema_name

table_or_view_name

REBUILD [ WITH (<rebuild_index_option> [ ,... n]) ]

СЕКЦИЯ

DISABLE

Операция REORGANIZE для индекса rowstore

REORGANIZE WITH ( LOB_COMPACTION = { ON | OFF } )

Операция REORGANIZE для индекса columnstore

REORGANIZE WITH ( COMPRESS_ALL_ROW_GROUPS = { ON | OFF } )

SET ( <set_index option> [ ,... n] )

PAD_INDEX = { ON | OFF }

FILLFACTOR = fillfactor

SORT_IN_TEMPDB = { ON | OFF }

IGNORE_DUP_KEY = { ON | OFF }

STATISTICS_NORECOMPUTE = { ON | OFF }

STATISTICS_INCREMENTAL = { ON | OFF }

ONLINE = { ON | OFF } <применимо к rebuild_index_option>

RESUMABLE = { ON | OFF}

MAX_DURATION = time [MINUTES] используется с RESUMABLE = ON (требуется ONLINE = ON)

ALLOW_ROW_LOCKS = { ON | OFF }

ALLOW_PAGE_LOCKS = { ON | OFF }

OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }

MAXDOP = max_degree_of_parallelism

COMPRESSION_DELAY = { 0 | duration [Minutes] }

DATA_COMPRESSION

XML_COMPRESSION

ON PARTITIONS ( { <partition_number_expression> | <range> } [,...n] )

ONLINE = { ON | OFF } <применимо к single_partition_rebuild_index_option>

RESUME

PAUSE

ABORT

Замечания

Перестроение индексов

Реорганизация индексов

Отключение индексов

Параметры настройки

Параметры блокировок строк и страниц

Операции с индексом в сети

Возобновляемые операции с индексами

WAIT_AT_LOW_PRIORITY с операциями с индексами в режиме "в сети"

Ограничения пространственного индекса

Сжатие данных

Статистика

Разрешения

Заметки о версии

Пример простого синтаксиса

Примеры: индексы columnstore

А. Демонстрация REORGANIZE

B. Сжатие разностных групп строк CLOSED в columnstore

C. Сжатие всех разностных групп строк OPEN и CLOSED в columnstore

D. Дефрагментация индекса columnstore в режиме "в сети"

Д. Перестроение кластеризованного индекса columnstore в режиме "вне сети"

F. Перестроение секции кластеризованного индекса columnstore в режиме "вне сети"

G. Изменение кластеризованного индекса columnstore для использования архивного сжатия

Примеры: индексы rowstore

А. Перестроение индекса

B. Перестроение всех индексов в таблице и указание параметров

C. Реорганизация индекса со сжатием данных LOB

D. Установка параметров в индексе

Д. Отключение индекса

F. Отключение ограничений

G. Включение ограничений

H. Перестроение секционированного индекса

I. Изменение настроек сжатия для индекса

J. Изменение параметра индекса со сжатием XML

K. Возобновляемое перестроение индексов в режиме "в сети"

См. также

Обратная связь

Обратная связь

Дополнительные ресурсы

MAX_DURATION = time [MINUTES] используется с `RESUMABLE = ON` (требуется `ONLINE = ON`)