index_option (Transact-SQL)
Spécifie un ensemble d'options applicables à un index qui fait partie d'une définition de contrainte créée à l'aide de ALTER TABLE.
Syntaxe
{
PAD_INDEX = { ON | OFF }
| FILLFACTOR = fillfactor
| IGNORE_DUP_KEY = { ON | OFF }
| STATISTICS_NORECOMPUTE = { ON | OFF }
| ALLOW_ROW_LOCKS = { ON | OFF }
| ALLOW_PAGE_LOCKS = { ON | OFF }
| SORT_IN_TEMPDB = { ON | OFF }
| ONLINE = { ON | OFF }
| MAXDOP = max_degree_of_parallelism
| DATA_COMPRESSION = { NONE |ROW | PAGE}
[ ON PARTITIONS ( { <partition_number_expression> | <range> }
[ , ...n ] ) ]
}
<range> ::=
<partition_number_expression> TO <partition_number_expression>
<single_partition_rebuild__option> ::=
{
SORT_IN_TEMPDB = { ON | OFF }
| MAXDOP = max_degree_of_parallelism
| DATA_COMPRESSION = {NONE | ROW | PAGE } }
}
Arguments
PAD_INDEX = { ON | OFF }
Spécifie le remplissage de l'index. La valeur par défaut est OFF.ON
Le pourcentage d'espace libre spécifié par FILLFACTOR est appliqué aux pages de niveau intermédiaire de l'index.OFF ou fillfactor n'est pas spécifié
Les pages de niveau intermédiaire sont remplies jusqu'à la presque totalité de la capacité, laissant suffisamment d'espace pour au moins une ligne de la taille maximale possible de l'index, compte tenu du jeu de clés des pages intermédiaires.
FILLFACTOR **=**fillfactor
Spécifie un pourcentage indiquant le taux de remplissage appliqué par le moteur de base de données au niveau feuille de chaque page d'index lors de la création ou de la modification de l'index. La valeur spécifiée doit être un entier compris entre 1 et 100. La valeur par défaut est 0.Notes
Les facteurs de remplissage de valeur 0 et 100 sont en tout point identiques.
IGNORE_DUP_KEY = { ON | OFF }
Spécifie la réponse d'erreur lorsqu'une opération d'insertion essaie d'insérer des valeurs de clé en double dans un index unique. L'option IGNORE_DUP_KEY s'applique uniquement aux opérations d'insertion après la création ou la régénération de l'index. Cette option n'a aucun effet lors de l'exécution de CREATE INDEX, ALTER INDEX ou de UPDATE. La valeur par défaut est OFF.ON
Un message d'avertissement s'affichera lorsque des valeurs de clé en double sont insérées dans un index unique. Seules les lignes qui violent la contrainte d'unicité échoueront.OFF
Un message d'erreur s'affichera lorsque des valeurs de clé en double sont insérées dans un index unique. L'intégralité de l'opération INSERT sera restaurée.
IGNORE_DUP_KEY ne peut pas être activé (ON) dans le cas d'index créés sur une vue, d'index non uniques, d'index XML, d'index spatiaux et d'index filtrés.
Pour afficher IGNORE_DUP_KEY, utilisez sys.indexes.
Dans la syntaxe de compatibilité descendante, WITH IGNORE_DUP_KEY est équivalent à WITH IGNORE_DUP_KEY = ON.
STATISTICS_NORECOMPUTE = { ON | OFF }
Indique si les statistiques sont recalculées. La valeur par défaut est OFF.ON
Les statistiques obsolètes ne sont pas automatiquement recalculées.OFF
La mise à jour automatique des statistiques est activée.
ALLOW_ROW_LOCKS = { ON | OFF }
Indique si les verrous de ligne sont autorisés. La valeur par défaut est ON.ON
Les verrous de ligne sont autorisés lors de l'accès à l'index. Le moteur de base de données détermine le moment où les verrous de ligne sont utilisés.OFF
Les verrous de ligne ne sont pas utilisés.
ALLOW_PAGE_LOCKS = { ON | OFF }
Spécifie si les verrous de page sont autorisés. La valeur par défaut est ON.ON
Les verrous de page sont autorisés lors de l'accès à l'index. Le moteur de base de données détermine à quel moment les verrous de page sont utilisés.OFF
Les verrous de page ne sont pas utilisés.
SORT_IN_TEMPDB = { ON | OFF }
Indique si les résultats de tri doivent être stockés dans tempdb. La valeur par défaut est OFF.ON
Les résultats de tri intermédiaires utilisés pour construire l'index sont stockés dans tempdb. Ceci peut accélérer la création d'un index si tempdb ne se trouve pas sur le même groupe de disques que la base de données utilisateur. Toutefois, une plus grande quantité d'espace disque est alors utilisée lors de la création de l'index.OFF
Les résultats de tri intermédiaires sont stockés dans la même base de données que l'index.
ONLINE = { ON | OFF }
Indique si les tables sous-jacentes et les index associés sont disponibles pour les requêtes et la modification de données pendant l'opération d'index. La valeur par défaut est OFF.Notes
Les index uniques non cluster ne peuvent pas être créés en ligne. Il s'agit des index qui sont créés en raison d'une contrainte UNIQUE ou PRIMARY KEY.
ON
Les verrous de table à long terme ne sont pas maintenus pendant la durée de l'opération d'index. Lors de la principale phase de l'indexation, seul le verrou de partage intentionnel (IS, Intent Share) est maintenu sur la table source. Ceci permet d'exécuter les requêtes ou les mises à jour dans la table sous-jacente et ses index. Au début de l'opération, un verrou partagé (S, Shared) est placé sur l'objet source pendant une période de temps très courte. À la fin de l'opération, pendant une période de temps très courte, un verrou partagé (S, Shared) est placé sur la source si un index non cluster est créé, ou bien un verrou de SCH-M (Modification du schéma) est placé lorsqu'un index cluster est créé ou supprimé en ligne et lorsqu'un index cluster ou non cluster est régénéré. ONLINE ne peut pas avoir la valeur ON lors de la création d'un index sur une table temporaire locale.OFF
Des verrous de table sont appliqués pendant l'opération d'indexation. Une opération d'indexation hors ligne qui crée, régénère ou supprime un index cluster, ou régénère ou supprime un index non cluster, acquiert un verrou Sch-M (Modification du schéma) sur la table. Ceci empêche tous les utilisateurs d'accéder à la table sous-jacente pendant la durée de l'opération. Une opération d'indexation hors ligne qui crée un index non cluster acquiert un verrou partagé (S, Shared) sur la table. Ceci empêche la mise à jour de la table sous-jacente, mais autorise les opérations de lecture, telles que des instructions SELECT.
Pour plus d'informations, consultez Fonctionnement des opérations d'index en ligne. Pour plus d'informations sur les verrous, consultez Modes de verrouillage.
Notes
Les opérations d'index en ligne ne sont disponibles que dans les éditions Enterprise, Developer et Evaluation de SQL Server.
MAXDOP **=**max_degree_of_parallelism
Prévaut sur l'option de configuration Max Degree of Parallelism pendant la durée de l'opération d'indexation. Pour plus d'informations, consultez Option Degré maximal de parallélisme. Utilisez MAXDOP pour limiter le nombre de processeurs utilisés dans une exécution de plans parallèles. Le nombre maximal de processeurs est 64.Valeurs possibles de max_degree_of_parallelism :
1
Supprime la génération de plan parallèle.>1
Limite au nombre spécifié la quantité maximale de processeurs utilisés dans une opération d'index parallèle.0 (valeur par défaut)
Utilise le nombre de processeurs effectivement mis en œuvre ou un nombre inférieur d'après la charge de travail actuelle du système.
Pour plus d'informations, consultez Configuration d'opérations d'index parallèles.
Notes
Les opérations d'index parallèles ne sont disponibles que dans les éditions Enterprise, Developer et Evaluation de SQL Server.
DATA_COMPRESSION
Spécifie l'option de compression de données pour la table, le numéro de partition ou la plage de partitions spécifiés. Les options disponibles sont les suivantes :NONE
La table ou les partitions spécifiées ne sont pas compressées.ROW
La table ou les partitions spécifiées sont compressées au moyen de la compression de ligne.PAGE
La table ou les partitions spécifiées sont compressées au moyen de la compression de page.
Pour plus d'informations sur la compression, consultez Création de tables et d'index compressés.
ON PARTITIONS ( { <expression_numéro_partition> | <plage> } [ ,...n ] )
Spécifie les partitions auxquelles le paramètre DATA_COMPRESSION s'applique. Si la table n'est pas partitionnée, l'argument ON PARTITIONS génère une erreur. Si la clause ON PARTITIONS n'est pas fournie, l'option DATA_COMPRESSION s'applique à toutes les partitions d'une table partitionnée.<expression_numéro_partition> peut être spécifié des manières suivantes :
Spécifiez le numéro d'une partition, par exemple : ON PARTITIONS (2).
Spécifiez des numéros de partition pour plusieurs partitions individuelles séparées par des virgules, par exemple : ON PARTITIONS (1, 5).
Spécifiez à la fois des plages et des partitions individuelles, par exemple : ON PARTITIONS (2, 4, 6 TO 8).
La <plage> peut être spécifiée sous la forme de numéros de partitions séparés par le mot TO, par exemple : ON PARTITIONS (6 TO 8).
Pour définir différents types de compression de données pour différentes partitions, spécifiez plusieurs fois l'option DATA_COMPRESSION, par exemple :
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) )
<single_partition_rebuild__option>
Dans la plupart des cas, la reconstruction d'un index reconstruit toutes les partitions d'un index partitionné. Les options suivantes, lorsqu'elles sont appliquées à une partition unique, ne reconstruisent pas toutes les partitions.SORT_IN_TEMPDB
MAXDOP
DATA_COMPRESSION