ALTER INDEX (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Modifica uma tabela ou índice de exibição existente (rowstore, columnstore ou XML) desabilitando, recriando ou reorganizando o índice, ou definindo opções no índice.

Convenções de sintaxe de Transact-SQL

Sintaxe

-- 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 }
}

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

index_name

O nome do índice. Os nomes de índice devem ser exclusivos em uma tabela ou exibição, mas não precisam ser exclusivos no banco de dados. Os nomes de índice precisam seguir as regras para identificadores.

ALL

Especifica todos os índices associados à tabela ou exibição, independentemente do tipo de índice. Especificar ALL fará com que a instrução falhe se um ou mais índices estiverem em um grupo de arquivos offline ou somente leitura ou se a operação especificada não for permitida em um ou mais tipos de índice. A tabela a seguir lista as operações de índice e os tipos de índice não permitidos.

Usando a palavra-chave ALL com esta operação Falhará se a tabela tiver um ou mais
REBUILD WITH ONLINE = ON Índice XML

Índice espacial

Índice columnstore: Aplica-se a: SQL Server (Começando pelo SQL Server 2012 (11.x)) e Banco de Dados SQL do Azure
REBUILD PARTITION = partition_number Índice não particionado, índice XML, índice espacial ou índice desabilitado
REORGANIZE Índices com ALLOW_PAGE_LOCKS definido como OFF
REORGANIZE PARTITION = partition_number Índice não particionado, índice XML, índice espacial ou índice desabilitado
IGNORE_DUP_KEY = ON Índice XML

Índice espacial

Índice columnstore: Aplica-se a: SQL Server (Começando pelo SQL Server 2012 (11.x)) e Banco de Dados SQL do Azure
ONLINE = ON Índice XML

Índice espacial

Índice columnstore: Aplica-se a: SQL Server (Começando pelo SQL Server 2012 (11.x)) e Banco de Dados SQL do Azure
RESUMABLE = ON Índices retomáveis não são compatíveis com a palavra-chave All.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Aviso

Para obter mais informações sobre operações de índice que podem ser executadas online, consulte Diretrizes para operações de índice online.

Se ALL for especificado com PARTITION = partition_number, todos os índices deverão ser alinhados. Isso significa que eles serão particionados com base nas funções de partições equivalentes. Usar ALL com PARTITION faz com que todas as partições de índice com o mesmo partition_number sejam recriadas ou reorganizadas. Para obter mais informações sobre índices particionados, consulte Partitioned Tables and Indexes.

database_name

O nome do banco de dados.

schema_name

O nome do esquema ao qual a tabela ou exibição pertence.

table_or_view_name

É o nome da tabela ou exibição associada ao índice. Para exibir um relatório dos índices em um objeto, use a exibição do catálogo sys.indexes.

O Banco de Dados SQL é compatível ao formato de nome de três partes database_name.[schema_name].table_or_view_name quando database_name é o banco de dados atual ou database_name é tempdb e table_or_view_name começa com #.

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

Aplica-se ao: SQL Server (Começando pelo SQL Server 2012 (11.x)) e Banco de Dados SQL do Azure

Especifica que o índice será recriado usando as mesmas colunas, tipo de índice, atributo de exclusividade e ordem de classificação. Essa cláusula é equivalente a DBCC DBREINDEX. REBUILD habilita um índice desabilitado. A recompilação de um índice clusterizado não recriará os índices não clusterizados associados, a menos que a palavra-chave ALL seja especificada. Se as opções de índice não forem especificadas, os valores de opção de índice existentes armazenados em sys.indexes serão aplicados. Para qualquer opção de índice cujo valor não seja armazenado em sys.indexes, o padrão indicado na definição de argumento da opção será aplicado.

Se ALL for especificado e a tabela subjacente for um heap, a operação REBUILD não terá efeito na tabela. Quaisquer índices não clusterizados associados à tabela serão recriados.

A operação REBUILD poderá ser registrada minimamente se o modelo de recuperação de banco de dados for definido como bulk-logged ou simples.

Observação

Ao recriar um índice XML primário, a tabela de usuário subjacente não estará disponível durante a operação de índice.

Para índices columnstore, a operação REBUILD:

  • Não usa a ordem de classificação.
  • Obtém um bloqueio exclusivo na tabela ou na partição durante a REBUILD. Os dados ficam "offline" e não disponíveis durante a REBUILD, mesmo ao usar NOLOCK, RCSI (isolamento de instantâneo com leitura confirmada) ou SI (isolamento de instantâneo).
  • Compacta novamente todos os dados no columnstore. Há duas cópias do índice columnstore durante a REBUILD. Quando a REBUILD é concluída, o SQL Server exclui o índice columnstore original.

Para obter mais informações, veja Reorganizar e recriar índices.

PARTITION

Especifica que somente uma partição de um índice será recriada ou reorganizada. PARTITION não poderá ser especificado se index_name não for um índice particionado.

PARTITION = ALL recria todas as partições.

Aviso

É possível criar e reconstruir índices não alinhados em uma tabela com mais de 1.000 partições, mas não há suporte para isso. Fazer isso pode provocar degradação do desempenho ou consumo excessivo de memória durante essas operações. A Microsoft recomenda usar índices alinhados apenas quando o número de partições for maior que 1.000.

partition_number

É o número de partição de um índice particionado que será recompilado ou reorganizado. partition_number é uma expressão de constante que pode fazer referência a variáveis. Isso inclui variáveis de tipo definido pelo usuário ou funções e funções definidas pelo usuário, mas não é possível fazer referência a uma instrução Transact-SQL. partition_number deve existir ou a instrução falhará.

WITH (<single_partition_rebuild_index_option>)

SORT_IN_TEMPDB, MAXDOP, DATA_COMPRESSION e XML_COMPRESSION são as opções que podem ser especificadas ao executar REBUILD em uma só partição (PARTITION = partition_number). Índices XML não podem ser especificados em uma operação REBUILD de partição.

DISABLE

Marca o índice como desabilitado e indisponível para uso pelo Mecanismo de Banco de Dados. Qualquer índice pode ser desabilitado. A definição de um índice desabilitado permanece no catálogo do sistema sem nenhum dado de índice subjacente. Desabilitar um índice clusterizado evita que o usuário acesse os dados da tabela subjacente. Para habilitar um índice, use ALTER INDEX REBUILD ou CREATE INDEX WITH DROP_EXISTING. Para obter mais informações, consulte Desabilitar índices e restrições e Habilitar índices e restrições.

REORGANIZE um índice rowstore

Para índices rowstore, REORGANIZE especifica reorganizar o nível folha do índice. A operação de REORGANIZE é:

  • sempre executada online. Isso significa que os bloqueios de tabela de longo prazo não são mantidos e que as consultas ou atualizações da tabela subjacente podem continuar durante a transação ALTER INDEX REORGANIZE.
  • Não é permitida para um índice desabilitado.
  • Não é permitida quando ALLOW_PAGE_LOCKS está definido como OFF.
  • Não é revertida quando é executada em uma transação e a transação é revertida.

Observação

Quando ALTER INDEX REORGANIZE usa transações explícitas (por exemplo, ALTER INDEX dentro de uma BEGIN TRAN ... COMMIT/ROLLBACK) em vez do modo de transação implícita padrão, o comportamento de bloqueio de REORGANIZE se torna mais restritivo, potencialmente causando bloqueio. Para obter mais informações sobre transações implícitas, confira SET IMPLICIT_TRANSACTIONS (Transact-SQL).

Para obter mais informações, veja Reorganizar e recriar índices.

REORGANIZE WITH ( LOB_COMPACTION = { ON | OFF } )

Aplica-se a índices rowstore.

LOB_COMPACTION = ON

  • Especifica compactar todas as páginas que contêm dados destes tipos de dados de LOB (objeto grande): image, text, ntext, varchar(max), nvarchar(max), varbinary(max) e xml. A compactação desses dados pode reduzir o tamanho dos dados no disco.
  • Para um índice clusterizado, isso compacta todas as colunas LOB contidas na tabela.
  • Reorganizar um índice não clusterizado, compacta todas as colunas LOB não chave (incluídas) no índice.
  • REORGANIZE ALL executa LOB_COMPACTION em todos os índices. Para cada índice, isso compacta todas as colunas LOB no índice clusterizado, na tabela subjacente ou nas colunas incluídas em um índice não clusterizado.

LOB_COMPACTION = OFF

  • Páginas que contêm dados de objeto grande não são compactadas.
  • OFF não tem nenhum efeito em um heap.

REORGANIZE um índice columnstore

Para índices columnstore, REORGANIZE compacta cada rowgroup delta CLOSED no columnstore como um rowgroup compactado. A operação REORGANIZE é sempre executada online. Isso significa que os bloqueios de tabela de longo prazo não são mantidos e que as consultas ou atualizações da tabela subjacente podem continuar durante a transação ALTER INDEX REORGANIZE. Para obter mais informações, veja Reorganizar e recriar índices.

  • REORGANIZE não é necessário para mover rowgroups delta CLOSED para rowgroups compactados. O processo TM (motor de tupla) em segundo plano é ativado periodicamente para compactar rowgroups delta CLOSED. É recomendável usar REORGANIZE quando o motor de tupla está ficando para trás. REORGANIZE pode compactar rowgroups de maneira mais agressiva.
  • Para compactar todos os rowgroups OPEN e CLOSED, confira a opção REORGANIZE WITH (COMPRESS_ALL_ROW_GROUPS) nesta seção.

Para índices columnstore em SQL Server (a partir de SQL Server 2016 (13.x)) e Banco de Dados SQL do Azure, REORGANIZE executa as seguintes otimizações adicionais desfragmentação online:

  • Remove fisicamente linhas de um grupo de linhas quando 10% ou mais linhas foram excluídas logicamente. Os bytes excluídos são recuperados na mídia física. Por exemplo, se um grupo de linhas compactado de um milhão de linhas tiver cem mil linhas excluídas, o SQL Server removerá as linhas excluídas e recompactará o rowgroup com 900 mil linhas. Ele salva no armazenamento removendo as linhas excluídas.

  • Combina um ou mais rowgroups compactados para aumentar linhas por rowgroup até o máximo de 1.048.576 linhas. Por exemplo, se você importar em massa cinco lotes de 102.400 linhas, obterá cinco rowgroups compactados. Se você executar REORGANIZE, esses rowgroups serão mesclados em um grupo de linhas compactado de 512 mil linhas de tamanho. Isso pressupõe que não havia nenhuma limitação de tamanho ou memória de dicionário.

  • Para rowgroups em que 10% ou mais linhas foram excluídas logicamente, o SQL Server tenta combinar esse grupo de linhas com um ou mais rowgroups. Por exemplo, o rowgroup 1 é compactado com 500 mil linhas e o rowgroup 21 é compactado com o máximo de 1.048.576 linhas. O rowgroup 21 tem 60% das linhas excluídas, o que deixa 409.830 linhas. O SQL Server favorece a combinação desses dois rowgroups para compactar um novo rowgroup com 909.830 linhas.

REORGANIZE WITH ( COMPRESS_ALL_ROW_GROUPS = { ON | OFF } )

Aplica-se em índices columnstore.

Aplica-se a: SQL Server (Começando pelo SQL Server 2016 (13.x)) e Banco de Dados SQL do Azure

COMPRESS_ALL_ROW_GROUPS fornece uma maneira de forçar os rowgroups delta OPEN ou CLOSED para o columnstore. Com essa opção, não é necessário recompilar o índice columnstore para esvaziar os rowgroups delta. Isso, combinado a outros recursos de desfragmentação de remover e mesclar, faz com que não seja mais necessário recompilar o índice na maioria das situações.

  • ON força todos os rowgroups para a columnstore, não importa o tamanho e o estado (CLOSED ou OPEN).
  • OFF força todos os rowgroups CLOSED para o columnstore.

Para obter mais informações, veja Reorganizar e recriar índices.

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

Especifica opções de índice sem recriar ou reorganizar o índice. SET não pode ser especificado para um índice desabilitado.

PAD_INDEX = { ON | OFF }

Especifica o preenchimento do índice. O padrão é OFF.

ATIVADO

O percentual de espaço livre especificada por FILLFACTOR é aplicado às páginas de nível intermediário do índice. Se FILLFACTOR não for especificado ao mesmo tempo que PAD_INDEX é definido como ON, o valor do fator de preenchimento armazenado em sys.indexes será usado.

OFF ou fillfactor não está especificado

As páginas do nível intermediário são preenchidas até próximo à capacidade máxima. Isso deixa espaço suficiente para pelo menos uma linha do tamanho máximo que o índice pode ter, com base no conjunto de chaves das páginas intermediárias.

Para obter mais informações, veja CREATE INDEX (Transact-SQL).

FILLFACTOR = fillfactor

Especifica uma porcentagem que indica quanto Mecanismo de Banco de Dados deve preencher o nível folha de cada página de índice durante a criação ou alteração do índice. O valor de fillfactor deve ser um valor inteiro de 1 a 100. O padrão é 0. Os valores de fator de preenchimento 0 e 100 são iguais em todos os aspectos.

Uma configuração FILLFACTOR explícita é usada somente quando o índice é criado pela primeira vez ou recriado. O Mecanismo de Banco de Dados não mantém dinamicamente o percentual especificado de espaço vazio nas páginas. Para obter mais informações, veja CREATE INDEX (Transact-SQL).

Para ver a configuração do fator de preenchimento, use fill_factor em sys.indexes.

Importante

A criação ou alteração de um índice clusterizado com um valor FILLFACTOR afeta a quantidade de espaço de armazenamento que os dados ocupam, pois o Mecanismo de Banco de Dados redistribui os dados quando cria o índice clusterizado.

SORT_IN_TEMPDB = { ON | OFF }

Especifica se os resultados de classificação devem ser armazenados em tempdb. O padrão é OFF (desativado), exceto para a Hiperescala do Banco de Dados SQL do Azure. Para todas as operações de recompilação de índice em Hiperescala, SORT_IN_TEMPDB está sempre ativado, independentemente da opção especificada, a menos que a recompilação de índice retomável seja usada.

ATIVADO
Os resultados de classificação intermediários usados para criar o índice são armazenados no tempdb. Se tempdb estiver em um conjunto de discos diferente do banco de dados do usuário, isso poderá reduzir o tempo necessário para criar um índice. Entretanto, isso aumenta o espaço em disco usado durante a criação do índice.

OFF
Os resultados intermediários de classificação são armazenados no mesmo banco de dados que o índice.

Se uma operação de classificação não for necessária ou se a classificação puder ser executada na memória, a opção SORT_IN_TEMPDB será ignorada.

Para obter mais informações, consulte a Opção SORT_IN_TEMPDB para índices.

IGNORE_DUP_KEY = { ON | OFF }

Especifica a resposta de erro quando uma operação de inserção tenta inserir valores da chave duplicada em um índice exclusivo. A opção IGNORE_DUP_KEY aplica-se apenas a operações de inserção depois que o índice é criado ou recompilado. O padrão é OFF.

ATIVADO
Uma mensagem de aviso será exibida quando valores de chave duplicados forem inseridos em um índice exclusivo. Ocorrerá falha somente nas linhas que violarem a restrição de exclusividade.

OFF
Ocorrerá uma mensagem de erro quando os valores de chave duplicados forem inseridos em um índice exclusivo. Toda a operação INSERT será revertida.

IGNORE_DUP_KEY não pode ser definido como ON para índices criados em uma exibição, índices não exclusivos, índices XML, índices espaciais e índices filtrados.

Para exibir IGNORE_DUP_KEY, use sys.indexes.

Na sintaxe compatível com versões anteriores, WITH IGNORE_DUP_KEY é equivalente a WITH IGNORE_DUP_KEY = ON.

STATISTICS_NORECOMPUTE = { ON | OFF}

Especifica se as estatísticas de distribuição são recomputadas. O padrão é OFF.

ATIVADO
As estatísticas desatualizadas não são recalculadas automaticamente.

OFF
A atualização automática de estatísticas está habilitada.

Para restaurar a atualização automática de estatísticas, defina STATISTICS_NORECOMPUTE como DESATIVADO ou execute UPDATE STATISTICS sem a cláusula NORECOMPUTE.

Importante

Desabilitar o recálculo automático de estatísticas de distribuição pode impedir que o Otimizador de consulta selecione os planos de execução ideais para consultas que envolvem a tabela.

STATISTICS_INCREMENTAL = { ON | OFF }

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do Azure

Quando estiver ON, as estatísticas serão criadas conforme as estatísticas de partição. Quando estiver OFF, a árvore de estatísticas será removida e o SQL Server calculará as estatísticas novamente. O padrão é OFF.

Se as estatísticas por partição não tiverem suporte, a opção será ignorada e um aviso será gerado. As estatísticas incrementais não têm suporte para os seguintes tipos de estatísticas:

  • Estatísticas criadas com os índices que não estejam alinhados por partição à tabela base
  • Estatísticas criadas sobre bancos de dados que são réplicas secundárias para leitura de grupo de disponibilidade
  • Estatísticas criadas em bancos de dados somente leitura
  • Estatísticas criadas em índices filtrados
  • Estatísticas criadas em exibições
  • Estatísticas criadas em tabelas internas
  • Estatísticas criadas com índices espaciais ou índices XML

ONLINE = { ON | OFF } <conforme se aplica a rebuild_index_option>

Especifica se as tabelas subjacentes e os índices associados estão disponíveis para consultas e modificação de dados durante a operação de índice. O padrão é OFF.

Para um índice XML ou índice espacial, só há suporte para ONLINE = OFF e, se ONLINE for definido como ON, um erro será gerado.

Importante

As operações de índice online não estão disponíveis em todas as edições de Microsoft SQL Server. Para obter uma lista de recursos com suporte nas edições do SQL Server, confira Edições e recursos com suporte no SQL Server 2022.

ATIVADO
Bloqueios de tabela de longa duração não são mantidos durante a operação do índice. Durante a fase principal da operação de índice, apenas um bloqueio IS (Tentativa Compartilhada) é mantido na tabela de origem. Isso permite que as consultas ou atualizações na tabela e nos índices subjacentes continuem. No início da operação, um bloqueio S (Compartilhado) é mantido brevemente no objeto de origem. Ao término da operação, um bloqueio S será brevemente mantido na origem se um índice não clusterizado estiver sendo criado. Um bloqueio Sch-M (Modificação de Esquema) será adquirido quando um índice clusterizado for criado ou descartado online e quando um índice clusterizado ou não clusterizado estiver sendo recompilado. Não será possível definir ONLINE como ON quando um índice estiver sendo criado em uma tabela temporária local.

OFF
Os bloqueios de tabela são aplicados durante a operação de índice. Uma operação de índice offline que cria, recria ou descarta um índice clusterizado, espacial ou XML, ou que recria ou descarta um índice não clusterizado, adquire um bloqueio Sch-M na tabela. Isso evita o acesso de todos os usuários à tabela subjacente enquanto durar a operação. Uma operação de índice offline que cria um índice não clusterizado adquire um bloqueio Compartilhado (S) na tabela. Isso impede atualizações na tabela subjacente, mas permite operações de leitura, como instruções SELECT.

Para obter mais informações, consulte Perform Index Operations Online.

Índices, inclusive aqueles em tabelas temporárias globais, podem ser recriados online exceto nos seguintes casos:

  • Índice XML
  • Índice em uma tabela temporária local
  • Índice clusterizado exclusivo inicial em uma exibição
  • Índices columnstore
  • Índice clusterizado se a tabela subjacente contiver tipos de dados LOB (image, ntext, text) e tipos de dados espaciais
  • As colunas varchar(max) e varbinary(max) não podem fazer parte de um índice. Em SQL Server (começando com o SQL Server 2012 (11.x)) e Banco de Dados SQL do Azure, quando uma tabela contém as colunas varchar(max) ou varbinary(max) , um índice clusterizado contendo outras colunas pode ser criado ou recriado usando a opção ONLINE. Banco de Dados SQL do Azure não permite a opção ONLINE quando a tabela base contém as colunas varchar(max) ou varbinary(max)

Para obter mais informações, consulte Como funcionam as operações de índice online.

Os seguintes XEvents são relacionados a ALTER TABLE ... SWITCH PARTITION e à recompilação de índice online.

  • lock_request_priority_state
  • process_killed_by_abort_blockers
  • ddl_with_wait_at_low_priority

O XEvent progress_report_online_index_operation existente para operações de índice on-line inclui partition_number e partition_id.

RESUMABLE = { ON | OFF}

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Especifica se uma operação de índice online é retomável.

ATIVADO
A operação do índice é retomável.

OFF
A operação do índice não é retomável.

MAX_DURATION = tempo [MINUTOS] usado com RESUMABLE = ON (requer ONLINE = ON)

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Indica o tempo (um valor inteiro especificado em minutos) pelo qual um uma operação de índice online retomável é executada antes de ser colocada em pausa.

Importante

Para obter mais informações sobre operações de índice que podem ser executadas online, consulte Diretrizes para operações de índice online.

Observação

Não há suporte para recompilações de índice online retomáveis em índices columnstore.

ALLOW_ROW_LOCKS = { ON | OFF }

Especifica se bloqueios de linha são permitidos. O padrão é ON.

ATIVADO
Bloqueios de linha são permitidos ao acessar o índice. O Mecanismo de Banco de Dados determina quando os bloqueios de linha são usados.

OFF
Bloqueios de linha não são usados.

ALLOW_PAGE_LOCKS = { ON | OFF }

Especifica se bloqueios de página são permitidos. O padrão é ON.

ATIVADO
Bloqueios de página são permitidos ao acessar o índice. O Mecanismo de Banco de Dados determina quando os bloqueios de página são usados.

OFF
Bloqueios de página não serão usados.

Observação

Um índice não pode ser reorganizado quando ALLOW_PAGE_LOCKS está definido como OFF.

OPTIMIZE_FOR_SEQUENTIAL_KEY = { ON | OFF }

Aplica-se ao: SQL Server (Começando pelo SQL Server 2019 (15.x)) e Banco de Dados SQL do Azure

Especifica se a contenção de inserção de última página será ou não otimizada. O padrão é OFF. Para saber mais, confira as Chaves sequenciais.

MAXDOP = max_degree_of_parallelism

Substitui a opção de configuração max degree of parallelism durante a operação do índice. Para obter mais informações, veja Configurar a opção max degree of parallelism de configuração de servidor. Use MAXDOP para limitar o número de processadores usados em uma execução de plano paralelo. O máximo é de 64 processadores.

Importante

Embora a opção MAXDOP tenha suporte sintaticamente em todos os índices XML, para um índice espacial ou um índice XML primário, no momento, ALTER INDEX usa apenas um processador.

max_degree_of_parallelism pode ser:

1
Suprime a geração de plano paralelo.

>1
Restringe o número máximo de processadores usados em uma operação de índice paralela ao número especificado.

0 (padrão)
Usa o número real de processadores, ou menos, com base na carga de trabalho atual do sistema.

Para obter mais informações, consulte Configurar operações de índice paralelo.

Observação

As operações de índice paralelas não estão disponíveis em todas as edições do SQL Server. Para obter uma lista de recursos com suporte nas edições do SQL Server, confira Edições e recursos com suporte no SQL Server 2022.

COMPRESSION_DELAY = { 0 | duração [Minutos] }

Aplica-se a: SQL Server (Começando pelo SQL Server 2016 (13.x))

Para uma tabela baseada em disco, o atraso especifica o número mínimo de minutos que um rowgroup delta no estado CLOSED precisa permanecer no rowgroup delta antes que o SQL Server possa compactá-lo no rowgroup compactado. Como as tabelas baseadas em disco não controlam os tempos de inserção e atualização em linhas individuais, o SQL Server aplica o atraso aos rowgroups delta no estado CLOSED.

O padrão é 0 minuto.

Para obter recomendações de quando usar COMPRESSION_DELAY, confira Introdução ao Columnstore para análise operacional em tempo real.

DATA_COMPRESSION

Especifica a opção de compactação de dados para o índice, número de partição ou intervalo de partições especificado. As opções são as descritas a seguir:

Nenhuma
A tabela ou as partições especificadas não são compactadas. Não se aplica a índices columnstore.

ROW
O índice ou as partições especificadas são compactados com o uso da compactação de linha. Não se aplica a índices columnstore.

PAGE
O índice ou as partições especificadas são compactados com o uso da compactação de página. Não se aplica a índices columnstore.

COLUMNSTORE

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do Azure

Aplica-se somente a índices columnstore, incluindo índices columnstore não clusterizados e clusterizados. COLUMNSTORE especifica a descompactação do índice ou partições especificadas compactadas com a opção COLUMNSTORE_ARCHIVE. Quando os dados forem restaurados, eles continuarão sendo compactados através da compactação columnstore usada em todos os índices columnstore.

COLUMNSTORE_ARCHIVE

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do Azure

Aplica-se somente a índices columnstore, incluindo índices columnstore não clusterizados e clusterizados. COLUMNSTORE_ARCHIVE compactará ainda mais a partição especificada para um tamanho menor. Isso pode ser usado para fins de arquivamento, ou em outras situações que exijam menos armazenamento e possam dispensar mais tempo para armazenamento e recuperação.

Para obter mais informações sobre compactação, consulte Compactação de dados.

XML_COMPRESSION

Aplicável a: SQL Server 2022 (16.x) e versões posteriores, Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure.

Especifica a opção de compactação XML para o índice especificado que contém uma ou mais colunas de tipo de dados xml. As opções são as descritas a seguir:

ATIVADO
O índice ou as partições especificadas são compactados com a compactação XML.

OFF
O índice ou as partições especificadas não são compactados.

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

Especifica as partições às quais as configurações DATA_COMPRESSION ou XML_COMPRESSION se aplicam. Se o índice não for particionado, o argumento ON PARTITIONS gerará um erro. Se a cláusula ON PARTITIONS não for fornecida, a opção DATA_COMPRESSION ou XML_COMPRESSION será aplicada a todas as partições de um índice particionado.

<partition_number_expression> pode ser especificado das seguintes maneiras:

  • Forneça o número de uma partição, por exemplo: ON PARTITIONS (2).
  • Forneça os números de várias partições individuais separados por vírgulas, por exemplo: ON PARTITIONS (1, 5).
  • Forneça os intervalos e as partições individuais: ON PARTITIONS (2, 4, 6 TO 8).

<range> pode ser especificado como números de partição separados pela palavra TO, por exemplo: ON PARTITIONS (6 TO 8).

Para definir tipos diferentes de compactação de dados para partições diferentes, especifique a opção DATA_COMPRESSION mais de uma vez, por exemplo:

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)
);

Você também pode especificar a opção XML_COMPRESSION mais de uma vez, por exemplo:

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 } <conforme se aplica a single_partition_rebuild_index_option>

Especifica se um índice ou partição do índice de uma tabela subjacente pode ser recriado online ou offline. Se REBUILD ... ONLINE = ON for executada, os dados nessa tabela ficarão disponíveis para consultas e modificação de dados durante a operação de índice. O padrão é OFF.

ATIVADO
Bloqueios de tabela de longa duração não são mantidos durante a operação do índice. Durante a fase principal da operação de índice, apenas um bloqueio IS (Tentativa Compartilhada) é mantido na tabela de origem. Um bloqueio de Sch-S (Estabilidade de Esquema) na tabela é necessário ao iniciar a recompilação do índice, já um bloqueio de Sch-M (Modificação de Esquema) é necessário na tabela no final da recompilação do índice online. Embora ambos os bloqueios de metadados sejam de curta duração, especialmente o bloqueio de Sch-M deve esperar que todas as transações de bloqueio sejam concluídas. Durante o tempo de espera, o bloqueio Sch-M bloqueia todas as transações restantes que esperam atrás desse bloqueio ao acessar a mesma tabela.

Observação

A recompilação de índice online pode definir as opções low_priority_lock_wait, confira WAIT_AT_LOW_PRIORITY com operações de índice online.

OFF
Os bloqueios de tabela são aplicados durante a operação de índice. Isso evita o acesso de todos os usuários à tabela subjacente enquanto durar a operação.

RESUME

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Retome uma operação de índice que seja esteja em pausa manualmente ou devido a uma falha.

MAX_DURATION usada com RESUMABLE = ON

O tempo (um valor de inteiro especificado em minutos) no qual a operação de índice online é executada após ser retomada. Quando o tempo expirar, a operação retomável será colocada em pausa se ainda estiver em execução.

WAIT_AT_LOW_PRIORITY usada com RESUMABLE = ON e ONLINE = ON.

Retomar uma recompilação de índice online após uma pausa precisa esperar as operações de bloqueio nesta tabela. WAIT_AT_LOW_PRIORITY indica que a operação de recriação do índice online aguardará bloqueios de baixa prioridade, permitindo que outras operações continuem enquanto a operação de criação de índice online estiver aguardando. Omitir a opção WAIT_AT_LOW_PRIORITY é equivalente a WAIT_AT_LOW_PRIORITY (MAX_DURATION = 0 minutes, ABORT_AFTER_WAIT = NONE). Para obter mais informações, consulte WAIT_AT_LOW_PRIORITY.

PAUSE

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Pause uma operação de recompilação de índice online retomável.

ABORT

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Anule uma operação de índice em execução ou em pausa declarada como retomável. Você precisa executar explicitamente uma operação ABORT para terminar uma operação de recompilação de índice retomável. A falha ou pausa de uma operação de índice retomável não conclui a execução, mas deixa a operação em um estado de pausa indefinido.

Comentários

ALTER INDEX não pode ser usado para reparticionar um índice ou movê-lo para um grupo de arquivos diferente. Essa instrução não pode ser usada para modificar a definição de índice, como adicionar ou excluir colunas ou alterar a ordem das colunas. Use CREATE INDEX com a cláusula DROP_EXISTING para executar essas operações.

Quando uma opção não for especificada explicitamente, a configuração atual será aplicada. Por exemplo, se uma configuração FILLFACTOR não for especificada na cláusula REBUILD, o valor do fator de preenchimento armazenado no catálogo do sistema será usado durante o processo de recompilação. Para exibir as configurações de opção de índice atuais, use sys.indexes.

Os valores para ONLINE, MAXDOP e SORT_IN_TEMPDB não são armazenados no catálogo do sistema. A menos que especificado na instrução de índice, o valor padrão da opção será usado.

Em computadores multiprocessadores, assim como acontece em outras consultas, ALTER INDEX REBUILD usa automaticamente mais processadores para executar operações de exame e classificação associadas à modificação do índice. Ao executar ALTER INDEX REORGANIZE, com ou sem LOB_COMPACTION, o valor grau máximo de paralelismo é uma operação encadeada única. Para obter mais informações, consulte Configurar operações de índice paralelo.

Importante

Um índice não poderá ser reorganizado ou recriado se o grupo de arquivos no qual ele está localizado estiver offline ou definido como somente leitura. Quando a palavra-chave ALL for especificada e um ou mais índices estiver em um grupo de arquivos offline ou somente leitura, a instrução falhará.

Como recriar índices

A recriação de um índice descarta e recria o índice. Isso remove a fragmentação, recupera espaço em disco ao compactar as páginas com base na configuração do fator de preenchimento especificada ou existente, e reclassifica as linhas do índice em páginas contíguas. Quando ALL é especificado, todos os índices da tabela são descartados e recriados em uma única transação. As restrições de chave estrangeira não precisam ser removidas com antecedência. Quando índices com 128 extensões ou mais são recriados, o Mecanismo de Banco de Dados adia as desalocações de página atuais e seus bloqueios associados até depois da confirmação da transação.

Para obter mais informações, veja Reorganizar e recriar índices.

Reorganização de índices

A reorganização de um índice utiliza recursos mínimos do sistema. Ela desfragmenta o nível folha de índices clusterizados e não clusterizados em tabelas e exibições, reordenando fisicamente as páginas de nível folha para que correspondam à ordem lógica, da esquerda para a direita, dos nós folha. A reorganização também compacta as páginas de índice. A compactação baseia-se no valor do fator de preenchimento existente.

Quando ALL for especificado, os índices relacionais, clusterizados e não clusterizados e os índices XML da tabela serão reorganizados. Algumas restrições se aplicam quando ALL é especificado; veja a definição de ALL na seção Argumentos deste artigo.

Para obter mais informações, veja Reorganizar e recriar índices.

Importante

Para uma tabela do Azure Synapse Analytics com um índice columnstore clusterizado ordenado, ALTER INDEX REORGANIZE não reclassifica os dados. Para reclassificar os dados, use ALTER INDEX REBUILD.

Desabilitação índices

A desabilitação de um índice impede o acesso do usuário ao índice, e, para índices clusterizados, aos dados da tabela subjacente. A definição de índice permanece no catálogo do sistema. A desabilitação de um índice não clusterizado ou clusterizado em uma exibição exclui fisicamente os dados do índice. A desabilitação de um índice clusterizado impede o acesso aos dados, mas eles permanecem inalterados na árvore B até que o índice seja descartado ou recriado. Para exibir o status de um índice habilitado ou desabilitado, consulte a coluna is_disabled na exibição do catálogo sys.indexes.

Observação

A documentação do SQL Server usa o termo árvore B geralmente em referência a índices. Em índices de rowstore, o SQL Server implementa uma árvore B+. Isso não se aplica a índices columnstore ou armazenamentos de dados na memória. Para obter mais informações, confira o Guia de arquitetura e design do índice do SQL Server e SQL do Azure.

Se uma tabela estiver em uma publicação de replicação transacional, não será possível desabilitar nenhum índice associado a colunas de chave primária. Esses índices são necessários para a replicação. Para desabilitar um índice, você deve primeiramente descartar a tabela da publicação. Para obter mais informações, consulte Publicar dados e objetos de banco de dados.

Use a instrução ALTER INDEX REBUILD ou CREATE INDEX WITH DROP_EXISTING para habilitar o índice. A recompilação de um índice clusterizado desabilitado não pode ser executada com a opção ONLINE definida como ON. Para obter mais informações, consulte Desabilitar índices e restrições.

Opções de configuração

Você pode definir as opções de ALLOW_ROW_LOCKS, ALLOW_PAGE_LOCKS, OPTIMIZE_FOR_SEQUENTIAL_KEY, IGNORE_DUP_KEY e STATISTICS_NORECOMPUTE para um índice especificado sem recriar nem reorganizar o índice. Os valores modificados são aplicados imediatamente ao índice. Para exibir essas configurações, use sys.indexes. Para obter mais informações sobre opções de índice, consulte Definir opções de índice.

Opções de bloqueios de linha e de página

Quando ALLOW_ROW_LOCKS = ON e ALLOW_PAGE_LOCK = ON, os bloqueios em nível de linha, página e tabela são permitidos quando você acessa o índice. O Mecanismo de Banco de Dados escolhe o bloqueio apropriado e pode escalar o bloqueio de uma linha ou página para um bloqueio de tabela.

Quando ALLOW_ROW_LOCKS = OFF e ALLOW_PAGE_LOCK = OFF, o bloqueio em nível de tabela é permitido quando você acessa o índice.

Se ALL for especificado quando as opções de bloqueio de linha ou de página forem definidas, as configurações serão aplicadas a todos os índices. Quando a tabela subjacente é um heap, as configurações são aplicadas das seguintes maneiras:

Opção Detalhes
ALLOW_ROW_LOCKS = ON ou OFF Ao heap e a quaisquer índices não clusterizados associados.
ALLOW_PAGE_LOCKS = ON Ao heap e a quaisquer índices não clusterizados associados.
ALLOW_PAGE_LOCKS = OFF Totalmente aos índices não clusterizados. Isso significa que todos os bloqueios de página não são permitidos nos índices não clusterizados. No heap, somente os bloqueios S (compartilhados), U (atualizados) e X (exclusivos) da página não são permitidos. O Mecanismo de Banco de Dados ainda pode adquirir um bloqueio de página intencional (IS, IU ou IX) para fins internos.

Operações de índice online

Ao recriar um índice, se a opção ONLINE estiver definida como ON, os objetos, as tabelas e os índices associados subjacentes estarão disponíveis para consultas e modificação de dados. Você também pode recriar online uma parte de um índice que reside em uma única partição. Os bloqueios de tabela exclusivos são mantidos por pouco tempo durante o processo de alteração.

A reorganização de um índice sempre é executada online. O processo não mantém bloqueios de longo prazo e, portanto, não bloqueia consultas ou atualizações em execução.

É possível executar operações de índice online simultâneas na mesma tabela ou partição de tabela somente ao fazer o seguinte:

  • Criar vários índices não clusterizados.
  • Reorganizar índices diferentes na mesma tabela.
  • Reorganizar índices diferentes ao recriar índices não sobrepostos na mesma tabela.

Todas as outras operações de índice online executadas ao mesmo tempo falham. Por exemplo, não é possível recompilar dois ou mais índices na mesma tabela ao mesmo tempo ou criar um índice ao recompilar um índice existente na mesma tabela.

Para obter mais informações, consulte Perform Index Operations Online.

Operações de índice retomáveis

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

A recriação de índice online é especificada como retomável usando a opção RESUMABLE = ON.

  • A opção RESUMABLE não persiste nos metadados para um determinado índice e se aplica somente à duração de uma instrução DDL atual. Portanto, a cláusula RESUMABLE = ON deve ser especificada explicitamente para habilitar a capacidade de retomada.

  • A opção MAX_DURATION é compatível com a opção RESUMABLE = ON ou a opção low_priority_lock_wait.

    • A opção MAX_DURATION para RESUMABLE especifica o intervalo para um índice que está sendo recompilado. Depois que esse tempo é consumido, a recompilação de índice é colocada em pausa ou conclui sua execução. O usuário decide quando uma recompilação de um índice em pausa pode ser retomada. O tempo em minutos para MAX_DURATION deve ser superior a 0 minutos e inferior ou igual a uma semana (7 * 24 * 60 = 10.080 minutos). Ter uma longa pausa para uma operação de índice pode afetar o desempenho de DML em uma tabela específica, bem como a capacidade de disco de banco de dados, já que tanto o original quanto o recém-criado exigem espaço em disco e precisam ser atualizados durante as operações DML. Se a opção MAX_DURATION for omitida, a operação de índice continuará até sua conclusão ou até que ocorra uma falha.
    • A opção de argumento low_priority_lock_wait permite que você decida como a operação de índice pode continuar quando bloqueada no bloqueio Sch-M.
  • Executar novamente a instrução ALTER INDEX REBUILD original com os mesmos parâmetros retoma uma operação de recompilação de índice em pausa. Você também pode retomar uma operação de recompilação de índice em pausa executando a instrução ALTER INDEX RESUME.

  • Não há suporte para a opção SORT_IN_TEMPDB = ON no índice retomável

  • O comando DDL com RESUMABLE = ON não pode ser executado em uma transação explícita (não pode fazer parte do bloco BEGIN TRAN ... COMMIT).

  • Apenas operações de índice em pausa estão retomáveis.

  • Ao retomar uma operação de índice em pausa, você pode alterar o valor MAXDOP para um novo valor. Se MAXDOP não for especificado ao retomar uma operação de índice que está em pausa, o último valor MAXDOP será usado. Se a opção MAXDOP não for especificada para a operação de recompilação de índice, o valor padrão será usado.

  • Para pausar imediatamente a operação de índice, você pode interromper o comando em andamento (Ctrl-C) ou executar o comando ALTER INDEX PAUSE ou o comando KILL <session_id>. Depois que o comando for colocado em pausa, ele poderá ser retomado usando a opção RESUME.

  • O comando ABORT elimina a sessão que hospedava a recompilação de índice original e elimina a operação de índice

  • Não são necessários recursos extras para recompilação de índice retomáveis exceto para

    • Espaço adicional necessário para manter o índice que está sendo criado, incluindo o tempo em que o índice está em pausa
    • Um estado DDL que impede qualquer modificação de DDL
  • A limpeza de fantasma será executada durante a fase de pausa do índice, mas ficará em pausa durante a execução de índice. A seguinte funcionalidade está desabilitada para operações de recompilação do índice retomáveis

    • Não há suporte para recompilar um índice desabilitado com RESUMABLE = ON
    • Comando ALTER INDEX REBUILD ALL
    • ALTER TABLE usando recompilação de índice
    • O comando DDL com RESUMABLE = ON não pode ser executado em uma transação explícita (não pode fazer parte do bloco BEGIN TRAN ... COMMIT)
    • Recompile um índice que tenha colunas TIMESTAMP ou computadas como colunas chave.
  • Caso a tabela base contenha colunas LOB retomáveis clusterizadas, a recompilação do índice clusterizado exigirá um bloqueio Sch-M no início desta operação

Observação

O comando DDL é executado até ser concluído, pausar ou falhar. Caso o comando pause, será emitido um erro indicando que a operação foi colocada em pausa e que a criação de índice não foi concluída. Para obter mais informações sobre o status atual do índice, veja sys.index_resumable_operations. Como antes, no caso de uma falha, um erro será emitido também.

WAIT_AT_LOW_PRIORITY com operações de índice online

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do Azure

A sintaxe low_priority_lock_wait permite especificar o comportamento WAIT_AT_LOW_PRIORITY. WAIT_AT_LOW_PRIORITY pode ser usado apenas com ONLINE = ON.

Para executar a instrução DDL de uma recompilação de índice online, todas as transações de bloqueio ativas em execução em uma tabela específica devem ser concluídas. Quando a recompilação de índice online for executada, ela bloqueará todas as novas transações que estão prontas para iniciar a execução nessa tabela. Embora a duração do bloqueio da recompilação de índice online seja muito curta, é possível que a espera pela conclusão de todas as transações abertas em uma tabela específica e o bloqueio das novas transações a serem iniciadas afetem significativamente a taxa de transferência, diminuindo a velocidade da carga de trabalho ou ocasionando o tempo limite da mesma, e limite consideravelmente o acesso à tabela subjacente.

A opção WAIT_AT_LOW_PRIORITY permite que os DBAs gerenciem os bloqueios de Sch-S (Estabilidade de Esquema) e os bloqueios de Sch-M (Modificação de Esquema) necessários às recompilações de índice online e que eles selecionem uma das duas opções. Nos dois casos, se, durante o tempo de espera MAX_DURATION = n [minutes], não houver nenhuma atividade de bloqueio, a recompilação de índice online será executada imediatamente sem aguardar e a instrução DDL será concluída.

WAIT_AT_LOW_PRIORITY indica que a operação de recriação do índice online aguardará bloqueios de baixa prioridade, permitindo que outras operações continuem enquanto a operação de criação de índice online estiver aguardando. Omitir a opção WAIT AT LOW PRIORITY é equivalente a WAIT_AT_LOW_PRIORITY (MAX_DURATION = 0 minutes, ABORT_AFTER_WAIT = NONE).

MAX_DURATION = time [MINUTES]

O tempo (um valor inteiro especificado em minutos) que a opção ou os bloqueios de recompilação de índice online deverão aguardar com baixa prioridade ao executar o comando DDL. Se a operação estiver bloqueada pelo tempo MAX_DURATION, a ação ABORT_AFTER_WAIT especificada será executada. O tempo MAX_DURATION está sempre em minutos e a palavra MINUTES pode ser omitida.

ABORT_AFTER_WAIT = [ NONE | SELF | BLOCKERS ]

Nenhuma
Continue aguardando o bloqueio com prioridade normal.

SELF
Saia da operação DDL de recompilação de índice online em execução no momento sem realizar a ação. A opção SELF não pode ser usada com um MAX_DURATION de 0.

BLOCKERS
Elimine todas as transações de usuário que bloqueiam a operação DDL de recompilação de índice online para que a operação possa continuar. A opção BLOCKERS requer que o logon tenha a permissão ALTER ANY CONNECTION.

Restrições em índices espaciais

Quando você recompila um índice espacial, a tabela de usuário subjacente não está disponível durante a operação do índice porque o índice espacial mantém um bloqueio de esquema.

Não é possível modificar a restrição PRIMARY KEY na tabela de usuário quando um índice espacial está definido em uma coluna dessa tabela. Para alterar a restrição PRIMARY KEY, primeiro descarte todos os índices espaciais da tabela. Depois de modificar a restrição PRIMARY KEY, é possível recriar cada um dos índices espaciais.

Em uma só operação de recompilação de partição, não é possível especificar nenhum índice espacial. Entretanto, você pode especificar índices espaciais em uma recriação de partição completa.

Para alterar as opções específicas de um índice espacial, como BOUNDING_BOX ou GRID, você pode usar uma instrução CREATE SPATIAL INDEX que especifica DROP_EXISTING = ON ou remover o índice espacial e criar outro índice. Para obter um exemplo, confira CREATE SPATIAL INDEX (Transact-SQL).

Compactação de dados

Para obter mais informações sobre compactação de dados, veja Compactação de dados.

Para avaliar como a alteração da compactação PAGE e ROW afetará uma tabela, um índice ou uma partição, use o procedimento armazenado sp_estimate_data_compression_savings.

As restrições a seguir se aplicam a índices particionados:

  • Quando você usar ALTER INDEX ALL ..., não será possível alterar a configuração de compactação de uma só partição se a tabela tiver índices não alinhados.
  • A sintaxe ALTER INDEX <index> ... REBUILD PARTITION ... recompila a partição especificada do índice.
  • A sintaxe ALTER INDEX <index> ... REBUILD WITH ... recompila todas as partições do índice.

Estatísticas

Quando você executa ALTER INDEX ALL ... em uma tabela, somente as estatísticas associadas a índices são atualizadas. As estatísticas automáticas ou manuais criadas na tabela (em vez de um índice) não são atualizadas.

Permissões

Para executar ALTER INDEX, no mínimo, a permissão ALTER na tabela ou exibição é necessária.

Notas de versão

  • O Banco de Dados SQL não usa opções de grupo de arquivos nem de fluxo de arquivos.
  • Índices columnstore não estão disponíveis antes do SQL Server 2012 (11.x).
  • Operações de índice retomáveis estão disponíveis começando com SQL Server 2017 (14.x) e Banco de Dados SQL do Azure.

Exemplo de sintaxe básica

ALTER INDEX index1 ON table1 REBUILD;

ALTER INDEX ALL ON table1 REBUILD;

ALTER INDEX ALL ON dbo.table1 REBUILD;

Exemplos: Índices Columnstore

Estes exemplos se aplicam a índices columnstore.

a. Demonstração de REORGANIZE

Este exemplo demonstra como o comando ALTER INDEX REORGANIZE funciona. Ele cria uma tabela que tem vários rowgroups e demonstra como REORGANIZE mescla os rowgroups.

-- 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;

Use a opção TABLOCK para inserir linhas em paralelo. Começando com o SQL Server 2016 (13.x), a operação INSERT INTO pode ser executada em paralelo quando TABLOCK for usado.

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

Execute este comando para ver os rowgroups delta OPEN. O número de rowgroups depende do grau de paralelismo.

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

Execute este comando para forçar todos os rowgroups CLOSED e OPEN para o columnstore.

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

Execute este comando novamente e verá que os rowgroups menores são mesclados em um rowgroup compactado.

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

B. Compactar rowgroups delta CLOSED para o columnstore

Este exemplo usa a opção REORGANIZE para compactar cada rowgroup delta CLOSED no columnstore como um rowgroup compactado. Isso não é necessário, mas é útil quando o motor de tupla não está compactando rowgroups CLOSED com rapidez suficiente.

Você pode executar ambos os exemplos no banco de dados de exemplo AdventureWorksDW2022.

Este exemplo executará REORGANIZE em todas as partições.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE;

Este exemplo executará REORGANIZE em uma partição específica.

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

C. Compactar todos os rowgroups delta OPEN AND CLOSED para o columnstore

Aplica-se a: SQL Server (Começando pelo SQL Server 2016 (13.x)) e Banco de Dados SQL do Azure

O comando REORGANIZE WITH ( COMPRESS_ALL_ROW_GROUPS = ON ) compacta cada rowgroup delta OPEN e CLOSED no columnstore como um rowgroup compactado. Isso esvazia o deltastore e força todas as linhas a serem compactadas no columnstore. Isso é útil principalmente depois de executar várias operações de inserção, já que essas operações armazenam as linhas em um ou mais rowgroups delta.

REORGANIZE combina rowgroups para preencher rowgroups até um número máximo de linhas <= 1.024.576. Portanto, ao compactar todos os rowgroups OPEN e CLOSED, você não acabará com vários rowgroups compactados que tenham apenas algumas linhas neles. Você deseja que rowgroups sejam tão completos quanto possível para reduzir o tamanho compactado e melhorar o desempenho da consulta.

O exemplo a seguir usa o banco de dados AdventureWorksDW2022.

Este exemplo move todos os rowgroups delta OPEN e CLOSED para o índice columnstore.

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

Este exemplo move todos os rowgroups delta OPEN e CLOSED para o índice columnstore para um partição específica.

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

D. Desfragmentar um índice columnstore online

Não se aplica a: SQL Server 2012 (11.x) e SQL Server 2014 (12.x).

Começando com o SQL Server 2016 (13.x), REORGANIZE faz mais que compactar rowgroups delta para o columnstore. Ele também executa a desfragmentação online. Primeiro, reduz o tamanho do columnstore removendo fisicamente linhas excluídas quando 10% ou mais linhas em um grupo de linhas foram excluídos. Em seguida, ele combina rowgroups para formar rowgroups maiores que tenham até o máximo de 1.024.576 linhas por rowgroup. Todos os rowgroups alterados são recompactados.

Observação

Começando com o SQL Server 2016 (13.x), recompilar um índice columnstore não é mais necessário na maioria das situações, já que REORGANIZE remove fisicamente linhas excluídas e mescla rowgroups. A opção COMPRESS_ALL_ROW_GROUPS força todos os rowgroups delta OPEN ou CLOSED para o columnstore, o que antes só podia ser feito com uma recompilação. REORGANIZE está online e ocorre em segundo plano para que consultas possam continuar conforme a operação ocorre.

O exemplo a seguir executa um REORGANIZE para desfragmentar o índice removendo fisicamente linhas que foram excluídas logicamente da tabela e mesclando rowgroups.

ALTER INDEX cci_FactInternetSales2 ON FactInternetSales2 REORGANIZE;

E. Recompilar um índice columnstore clusterizado offline

Aplica-se a: SQL Server (Começando pelo SQL Server 2012 (11.x))

Dica

Começando com SQL Server 2016 (13.x) e no Banco de Dados SQL do Azure, é recomendável usar ALTER INDEX REORGANIZE em vez de ALTER INDEX REBUILD para índices columnstore.

Observação

Em SQL Server 2012 (11.x) e SQL Server 2014 (12.x), REORGANIZE só é usado para compactar rowgroups CLOSED para o columnstore. É a única maneira de realizar operações de desfragmentação e forçar todos os rowgroups delta para o columnstore é recompilar o índice.

Este exemplo mostra como recompilar um índice columnstore clusterizado e forçar todos os rowgroups delta para o columnstore. A primeira etapa prepara uma tabela FactInternetSales2 no banco de dados AdventureWorksDW2022 com um índice columnstore clusterizado e insere dados das quatro primeiras colunas.

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;

Os resultados mostram um rowgroup OPEN, o que significa que o SQL Server aguardará mais linhas serem adicionadas antes de fechar o rowgroup e mover os dados para o columnstore. A próxima instrução recompila o índice columnstore clusterizado, o que força todas as linhas para o columnstore.

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

Os resultados da instrução SELECT mostram que o rowgroup está COMPACTADO, o que significa que os segmentos de coluna do rowgroup agora estão compactados e armazenados no columnstore.

F. Recompilar uma partição de um índice columnstore clusterizado offline

Aplica-se ao: SQL Server (Começando pelo SQL Server 2012 (11.x))

Para recompilar uma partição de um índice columnstore clusterizado grande, use ALTER INDEX REBUILD com a opção de partição. Este exemplo recompila a partição 12. Começando com o SQL Server 2016 (13.x), é recomendável substituir REBUILD por REORGANIZE.

ALTER INDEX cci_fact3
ON fact3
REBUILD PARTITION = 12;

G. Alterar um índice columnstore clusterizado para usar a compactação de arquivamento

Não se aplica a: SQL Server 2012 (11.x)

Você pode optar por reduzir o tamanho de um índice columnstore clusterizado ainda mais usando a opção de compactação de dados COLUMNSTORE_ARCHIVE. Isso é prático para dados mais antigos que você deseja manter em um armazenamento mais econômico. É recomendável usar isso apenas em dados não acessados com frequência, já que a descompactação é mais demorada que a compactação COLUMNSTORE normal.

O exemplo a seguir recompila um índice columnstore clusterizado para usar a compactação de arquivamento e, em seguida, mostra como remover essa compactação. O resultado final usará apenas a compactação columnstore.

Primeiro, prepare o exemplo criando uma tabela com um índice columnstore clusterizado. Em seguida, compacte ainda mais a tabela usando a compactação de arquivamento.

--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

Este exemplo remove a compactação de arquivos e usa apenas a compactação columnstore.

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

Exemplos: Índices Rowstore

a. Recompilar um índice

O exemplo a seguir recompila um único índice na tabela Employee do banco de dados AdventureWorks2022.

ALTER INDEX PK_Employee_EmployeeID ON HumanResources.Employee REBUILD;

B. Recompilar todos os índices em uma tabela e especificar opções

O exemplo a seguir especifica a palavra-chave ALL. Isso recompila todos os índices associados à tabela Production.Product no banco de dados AdventureWorks2022. Três opções são especificadas.

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

O exemplo a seguir adiciona a opção ONLINE que inclui a opção de bloqueio de baixa prioridade e adiciona a opção de compactação de linha.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do 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. Reorganizar um índice com compactação LOB

O exemplo a seguir reorganiza um único índice clusterizado no banco de dados AdventureWorks2022. Como o índice contém um tipo de dados LOB no nível folha, a instrução também compacta todas as páginas que contêm dados de objeto grande. Não é necessário especificar a opção WITH (LOB_COMPACTION = ON) porque o valor padrão é ON.

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

D. Definir opções em um índice

O exemplo a seguir define várias opções no índice AK_SalesOrderHeader_SalesOrderNumber no banco de dados AdventureWorks2022.

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

E. Desabilitar um índice

O exemplo a seguir desabilita um índice não clusterizado na tabela Employee do banco de dados AdventureWorks2022.

ALTER INDEX IX_Employee_ManagerID ON HumanResources.Employee DISABLE;

F. Desabilitar restrições

O exemplo a seguir desabilita uma restrição PRIMARY KEY desabilitando o índice PRIMARY KEY no banco de dados AdventureWorks2022. A restrição FOREIGN KEY na tabela subjacente é automaticamente desabilitada e a mensagem de aviso é exibida.

ALTER INDEX PK_Department_DepartmentID ON HumanResources.Department DISABLE;

O conjunto de resultados retorna esta mensagem de aviso.

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. Habilitar restrições

O exemplo a seguir habilita as restrições PRIMARY KEY e FOREIGN KEY que foram desabilitadas no exemplo F.

A restrição PRIMARY KEY é habilitada com a recriação do índice PRIMARY KEY.

ALTER INDEX PK_Department_DepartmentID ON HumanResources.Department REBUILD;

Em seguida, a restrição FOREIGN KEY é habilitada.

ALTER TABLE HumanResources.EmployeeDepartmentHistory
CHECK CONSTRAINT FK_EmployeeDepartmentHistory_Department_DepartmentID;
GO

H. Recompilar um índice particionado

O exemplo a seguir recompila uma única partição, número de partição 5, do índice particionado IX_TransactionHistory_TransactionDate do banco de dados AdventureWorks2022. A partição 5 é recompilada com ONLINE=ON e os dez minutos do tempo de espera para o bloqueio de baixa prioridade se aplica separadamente a cada bloqueio pela operação de recompilação de índice. Se durante esse tempo o bloqueio não puder ser obtido para a recompilação de índice completa, a instrução da operação de recompilação será anulada devido a ABORT_AFTER_WAIT = SELF.

Aplica-se ao: SQL Server (Começando pelo SQL Server 2014 (12.x)) e Banco de Dados SQL do 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. Alterar a configuração de compactação de um índice

O exemplo a seguir recompila um índice em uma tabela rowstore não particionada.

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

J. Alterar a configuração de um índice com a compactação XML

Aplicável a: SQL Server 2022 (16.x) e versões posteriores, Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure.

O exemplo a seguir recompila um índice em uma tabela rowstore não particionada.

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

Para obter mais exemplos de compactação de dados, confira Compactação de dados.

K. Recompilação de índice online retomável

Aplica-se ao: SQL Server (Começando pelo SQL Server 2017 (14.x)) e Banco de Dados SQL do Azure

Os exemplos a seguir mostram como usar a recompilação de índice online de retomável.

  1. Executar uma recompilação de índice online como uma operação retomável com MAXDOP = 1.

    ALTER INDEX test_idx on test_table REBUILD WITH (ONLINE = ON, MAXDOP = 1, RESUMABLE = ON) ;
    
  2. Executar o mesmo comando novamente (veja acima) após uma operação de índice ter sido colocada em pausa retoma automaticamente a operação de recompilação de índice.

  3. Execute uma recompilação de índice online como uma operação retomável com MAX_DURATION definido como 240 minutos.

    ALTER INDEX test_idx on test_table REBUILD WITH (ONLINE = ON, RESUMABLE = ON, MAX_DURATION = 240) ;
    
  4. Pause uma recompilação de índice online retomável em execução.

    ALTER INDEX test_idx on test_table PAUSE ;
    
  5. Retome uma recompilação de índice online para uma recompilação de índice executada como operação retomável especificando um novo valor de MAXDOP definido como 4.

    ALTER INDEX test_idx on test_table RESUME WITH (MAXDOP = 4) ;
    
  6. Retome uma operação de recompilação de índice online para uma recompilação de índice online executada como retomável. Defina MAXDOP como 2, defina o tempo de execução do índice que está em execução como retomável como 240 minutos e, no caso de um índice que está sendo bloqueado no bloqueio, aguarde dez minutos e depois encerre todos os bloqueadores.

       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)) ;
    
  7. Anule a operação de recompilação de índice retomável que está em execução ou em pausa.

    ALTER INDEX test_idx on test_table ABORT ;
    

Confira também