CREATE SPATIAL INDEX (Transact-SQL)

• GEOMETRY_GRID
  Spécifie le schéma de pavage de la grille géométrique que vous utilisez. GEOMETRY_GRID peut être spécifié uniquement sur une colonne du type de données geometry. Il s'agit de l'option par défaut pour ce type de données et il n'est pas nécessaire de la spécifier.

• GEOGRAPHY_GRID
  Spécifie le schéma de pavage de la grille géographique. GEOGRAPHY_GRID peut être spécifié uniquement sur une colonne du type de données geography. Il s'agit de l'option par défaut pour ce type de données et il n'est pas nécessaire de la spécifier.

• BOUNDING_BOX
  Spécifie un jeu de quatre tuples numérique qui définit les quatre coordonnées du cadre englobant : les coordonnées min. x et min. y de l'angle inférieur gauche, et les coordonnées max. x et max. y de l'angle supérieur droit.

  • xmin
    Spécifie la coordonnée x de l'angle inférieur gauche du cadre englobant.

  • ymin
    Spécifie la coordonnée y de l'angle inférieur gauche du cadre englobant.

  • xmax
    Spécifie la coordonnée x de l'angle supérieur droit du cadre englobant.

  • ymax
    Spécifie la coordonnée y de l'angle supérieur droit du cadre englobant.

  • XMIN = xmin
    Spécifie le nom et la valeur de la propriété pour la coordonnée x de l'angle inférieur gauche du cadre englobant.

  • YMIN = ymin
    Spécifie le nom et la valeur de la propriété pour la coordonnée y de l'angle inférieur gauche du cadre englobant.

  • XMAX = xmax
    Spécifie le nom et la valeur de la propriété pour la coordonnée x de l'angle supérieur droit du cadre englobant.

  • YMAX = ymax
    Spécifie le nom et la valeur de la propriété pour la coordonnée y de l'angle supérieur droit du cadre englobant.

  Les coordonnées du cadre englobant s'appliquent uniquement dans une clause USING GEOMETRY_GRID.

  xmax doit être supérieur à xmin et ymax doit être supérieur à ymin. Vous pouvez spécifier toute représentation de valeur float valide en supposant que xmax > xmin et ymax > ymin. Sinon, les erreurs appropriées sont générées.

  Il n'y a pas de valeurs par défaut.

  Les noms de propriété du cadre englobant ne respectent pas la casse, indépendamment du classement de base de données.

  Pour spécifier des noms de propriété, vous devez spécifier chacun d'entre eux une seule et unique fois. Vous pouvez les spécifier dans n'importe quel ordre. Par exemple, les clauses suivantes sont équivalentes :

  • BOUNDING_BOX = ( XMIN = xmin, YMIN = ymin, XMAX = xmax, YMAX = ymax )

  • BOUNDING_BOX = ( XMIN = xmin, XMAX = xmax, YMIN = ymin, YMAX = ymax )

• GRIDS
  Définit la densité de la grille à chaque niveau d'un schéma de pavage.

  [!REMARQUE]

  Pour plus d'informations sur le pavage, consultez Vue d'ensemble de l'indexation spatiale.

  Les paramètres GRIDS sont les suivants :

  • LEVEL_1
    Spécifie la grille de premier niveau (haut).

  • LEVEL_2
    Spécifie la grille de second niveau.

  • LEVEL_3
    Spécifie la grille de troisième niveau.

  • LEVEL_4
    Spécifie la grille de quatrième niveau.

  • LOW
    Spécifie la densité la plus faible possible pour la grille à un niveau donné. LOW équivaut à 16 cellules (grille 4x4).

  • MEDIUM
    Spécifie la densité moyenne pour la grille à un niveau donné. MEDIUM équivaut à 64 cellules (grille 8x8).

  • HIGH
    Spécifie la densité la plus élevée possible pour la grille à un niveau donné. HIGH équivaut à 256 cellules (grille 16x16).

  Grâce aux noms de niveau, vous pouvez spécifier les niveaux dans n'importe quel ordre et omettre des niveaux. Si vous utilisez le nom d'un niveau, vous devez utiliser le nom des autres niveaux que vous spécifiez. Si vous omettez un niveau, sa densité prend MEDIUM comme valeur par défaut.

  Si une densité non valide est spécifiée, une erreur est générée.

• CELLS_PER_OBJECT = n
  Spécifie le nombre de cellules de pavage par objet pouvant être utilisées pour un objet spatial unique dans l'index par le processus de pavage. n peut être un entier compris entre 1 et 8192 (inclus). Le nombre de cellules par objet par défaut est 16. Si un nombre non valide est passé ou que le nombre est supérieur au nombre maximal de cellules pour le pavage spécifié, une erreur est générée.

  Au niveau supérieur, si un objet couvre plus de cellules que le nombre spécifié par n, l'indexation utilise autant de cellules que nécessaire pour fournir un pavage de niveau supérieur complet. Dans de tels cas, un objet peut recevoir plus de cellules que le nombre spécifié. Dans ce cas, le nombre maximal est le nombre de cellules générées par la grille de niveau supérieur, qui dépend de la densité.

  La valeur CELLS_PER_OBJECT est utilisée par la règle de pavage de cellules par objet. Pour plus d'informations sur les règles de pavage, consultez Vue d'ensemble de l'indexation spatiale.

• PAD_INDEX = { ON | OFF }
  Spécifie le remplissage de l'index. La valeur par défaut est OFF.

  • ON
    Le pourcentage d'espace libre indiqué par fillfactor est appliqué aux pages du niveau intermédiaire de l'index.

  • OFF ou fillfactor n'est pas spécifié
    Les pages de niveau intermédiaire sont presque entièrement remplies, ce qui laisse suffisamment d'espace libre pour au moins une ligne de la taille maximale permise par l'index, en prenant en compte l'ensemble de clés sur les pages intermédiaires.

  L'option PAD_INDEX est utile seulement si FILLFACTOR est spécifié car PAD_INDEX utilise le pourcentage spécifié par FILLFACTOR. Si le pourcentage défini pour FILLFACTOR n'est pas suffisamment élevé pour autoriser une ligne, le moteur de base de données remplace en interne le pourcentage de façon à ce qu'il autorise le minimum. Le nombre de lignes dans une page d'index intermédiaire n'est jamais inférieur à deux, quelle que soit la faiblesse de la valeur de fillfactor.

• FILLFACTOR = fillfactor
  Spécifie un pourcentage qui indique l'espace occupé par le niveau feuille de chaque page d'index opéré par le moteur de base de données lors de la création ou de la reconstruction d'index. fillfactor doit être une valeur entière comprise entre 1 et 100. La valeur par défaut est 0. Si fillfactor a pour valeur 100 ou 0, le moteur de base de données crée des index avec des pages de niveau feuille intégralement remplies.

  [!REMARQUE]

  Les taux de remplissage 0 et 100 sont identiques en tous points.

  La valeur FILLFACTOR s'applique uniquement lors de la création ou de la recontruction de l'index. Le moteur de base de données ne conserve pas dynamiquement dans les pages le pourcentage d'espace libre défini. Pour afficher le taux de remplissage, utilisez l'affichage catalogue sys.indexes.

  Important

  La création d'un index cluster avec un taux de remplissage inférieur à 100 affecte la quantité d'espace de stockage qu'occupent les données, car le moteur de base de données redistribue les données lorsqu'il crée l'index cluster.

  Pour plus d'informations, consultez Facteur de remplissage.

• SORT_IN_TEMPDB = { ON | OFF }
  Spécifie si les résultats temporaires du 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 créer l'index sont stockés dans tempdb. Cela permet de réduire la durée de création d'un index si tempdb n'est 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.

  Outre l'espace nécessaire dans la base de données utilisateur pour créer l'index, tempdb doit disposer à peu près du même espace supplémentaire pour stocker les résultats de tri intermédiaires. Pour plus d'informations, consultez tempdb et création d'index.

• IGNORE_DUP_KEY = OFF
  N'a aucun effet pour les index spatiaux, car le type d'index n'est jamais unique. N'activez pas cette option (ON), sinon une erreur est déclenchée.

• STATISTICS_NORECOMPUTE = { ON | OFF}
  Spécifie si les statistiques de distribution sont recalculées. La valeur par défaut est OFF.

  • ON
    Les statistiques obsolètes ne sont pas recalculées automatiquement.

  • OFF
    La mise à jour automatique des statistiques est activée.

  Pour restaurer la mise à jour automatique des statistiques, affectez la valeur OFF à STATISTICS_NORECOMPUTE, ou exécutez UPDATE STATISTICS sans la clause NORECOMPUTE.

  Important

  La désactivation du recalcul automatique des statistiques de distribution peut empêcher l'optimiseur de requête de sélectionner des plans d'exécution optimaux pour les requêtes qui impliquent la table.

• DROP_EXISTING = { ON | OFF }
  Spécifie que l'index spatial nommé préexistant est supprimé et reconstruit. La valeur par défaut est OFF.

  • ON
    L'index existant est supprimé et reconstruit. Le nom d'index défini doit être identique à celui de l'index existant. Toutefois, la définition de l'index peut être modifiée. Par exemple, vous pouvez définir des colonnes, un ordre de tri, un schéma de partition ou des options d'indexation différentes.

  • OFF
    Une erreur s'affiche si le nom d'index spécifié existe déjà.

  Le type d'index ne peut pas être modifié avec DROP_EXISTING.

• ONLINE = OFF
  Indique que les tables sous-jacentes et les index associés ne sont pas disponibles pour les requêtes et la modification de données pendant l'opération d'index. Dans cette version de SQL Server, les constructions d'index en ligne ne sont pas prises en charge pour les index spatiaux. Si cette option a la valeur ON pour un index spatial, une erreur est générée. Omettez l'option ONLINE ou attribuez la valeur OFF à ONLINE.

  Une opération d'index hors connexion qui crée, reconstruit ou supprime un index spatial acquiert un verrou Sch-M (Modification du schéma) sur la table. Cela empêche tous les utilisateurs d'accéder à la table sous-jacente pendant la durée de l'opération.

  [!REMARQUE]

  Les opérations d'index en ligne ne sont disponibles que dans les éditions Enterprise, Developer et Evaluation de SQL Server.

• 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 le moment où les verrous de page sont utilisés.

  • OFF
    Les verrous de page ne sont pas utilisés.

• MAXDOP = max_degree_of_parallelism
  Remplace l'option de configuration max degree of parallelism pendant la durée de l'indexation. Utilisez MAXDOP pour limiter le nombre de processeurs utilisés dans une exécution de plans parallèles. Le nombre maximum de processeurs est 64.

  Important

  Bien que l'option MAXDOP soit prise en charge syntaxiquement, CREATE SPATIAL INDEX n'utilise actuellement qu'un processeur unique.

  Valeurs possibles de max_degree_of_parallelism :

  • 1
    Supprime la génération de plans parallèles.

  • >1
    Limite le nombre maximal de processeurs utilisés dans l'opération d'index parallèle au nombre défini ou à un nombre inférieur en fonction de la charge de travail actuelle du système.

  • 0 (valeur par défaut)
    Utilise le nombre réel de processeurs ou un nombre de processeurs inférieur en fonction de la charge de travail actuelle du système.

  Pour plus d'informations, consultez Configuration d'opérations d'index parallèles.

  [!REMARQUE]

  Les opérations d'index parallèles ne sont disponibles que dans les éditions Enterprise, Developer et Evaluation de SQL Server.

Dans certaines conditions, les index spatiaux prennent en charge plusieurs méthodes de géométrie basées sur les ensembles. Pour plus d'informations, consultez Méthodes géométriques prises en charge par les index spatiaux.

Par défaut, si un index spatial est créé sur une table partitionnée, l'index est partitionné d'après le schéma de partition de la table. Ainsi, les données d'index et la ligne connexe sont stockées dans la même partition.

Dans ce cas, pour altérer le schéma de partition de la table de base, il vous faudrait supprimer l'index spatial avant de pouvoir repartitionner la table de base. Pour éviter cette restriction, vous pouvez spécifier l'option « ON filegroup » lors de la création d'un index spatial. Pour plus d'informations, consultez « Index spatiaux et groupes de fichiers » plus loin dans cette rubrique.

Par défaut, les index spatiaux sont partitionnés dans les mêmes groupes de fichiers que la table sur laquelle l'index est spécifiée. Vous pouvez modifier ce comportement en spécifiant un groupe de fichiers :

[ ON { filegroup_name | "default" } ]

Si vous spécifiez un groupe de fichiers pour un index spatial, l'index est placé sur ce groupe de fichiers, quelle que soit le schéma de partitionnement de la table.

Les affichages catalogue suivants sont propres aux index spatiaux :

• sys.spatial_indexes
  Représente les informations d'index principal des index spatiaux.

• sys.spatial_index_tessellations
  Représente les informations sur le schéma de pavage et les paramètres de chaque index spatial.

Pour plus d'informations sur la structure des métadonnées des index spatiaux, consultez Tables internes.

Pour plus d'informations sur la création d'index, consultez la section « Remarques » dans CREATE INDEX (Transact-SQL).

L'exemple suivant crée une table nommée SpatialTable qui contient une colonne de type geometry, geometry_col. L'exemple crée ensuite un index spatial, SIndx_SpatialTable_geometry_col1, sur la table geometry_col. L'exemple utilise le schéma de pavage par défaut et spécifie le cadre englobant.

CREATE TABLE SpatialTable(id int primary key, geometry_col geometry);
CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col1 
   ON SpatialTable(geometry_col)
   WITH ( BOUNDING_BOX = ( 0, 0, 500, 200 ) );

L'exemple suivant crée un deuxième index spatial, SIndx_SpatialTable_geometry_col2, sur geometry_col dans la table SpatialTable. L'exemple spécifie GEOMETRY_GRID comme schéma de pavage. L'exemple spécifie également le cadre englobant, des densités différentes sur des niveaux de grille différents et 64 cellules par objet. L'exemple attribue aussi la valeur ON au remplissage d'index.

CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col2
   ON SpatialTable(geometry_col)
   USING GEOMETRY_GRID
   WITH (
    BOUNDING_BOX = ( xmin=0, ymin=0, xmax=500, ymax=200 ),
    GRIDS = (LOW, LOW, MEDIUM, HIGH),
    CELLS_PER_OBJECT = 64,
    PAD_INDEX  = ON );

L'exemple suivant crée un troisième index spatial, SIndx_SpatialTable_geometry_col3, sur geometry_col dans la table SpatialTable. L'exemple utilise le schéma de pavage par défaut. L'exemple spécifie le cadre englobant et utilise des densités de cellule différentes sur les troisième et quatrième niveaux, tout en utilisant le nombre par défaut de cellules par objet.

CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col3
   ON SpatialTable(geometry_col)
   WITH (
    BOUNDING_BOX = ( 0, 0, 500, 200 ),
    GRIDS = ( LEVEL_4 = HIGH, LEVEL_3 = MEDIUM ) );

L'exemple suivant reconstruit l'index spatial créé dans l'exemple précédent, SIndx_SpatialTable_geography_col3, en spécifiant une nouvelle densité LEVEL_3 avec DROP_EXISTING = ON.

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col3
   ON SpatialTable(geography_col)
   WITH ( BOUNDING_BOX = ( 0, 0, 500, 200 ),
        GRIDS = ( LEVEL_3 = LOW ),
        DROP_EXISTING = ON );

L'exemple suivant crée une table nommée SpatialTable2 qui contient une colonne de type geography, geography_col. L'exemple crée ensuite un index spatial, SIndx_SpatialTable_geography_col1, sur la table geography_col. L'exemple utilise les valeurs des paramètres par défaut du schéma de pavage GEOGRAPHY_GRID.

CREATE TABLE SpatialTable2(id int primary key, object GEOGRAPHY);
CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col1 
   ON SpatialTable2(object);

L'exemple suivant crée un deuxième index spatial, SIndx_SpatialTable_geography_col2, sur geography_col dans la table SpatialTable2. L'exemple spécifie GEOGRAPHY_GRID comme schéma de pavage. L'exemple spécifie également des densités de grille différentes sur des niveaux différents et 64 cellules par objet. L'exemple attribue aussi la valeur ON au remplissage d'index.

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col2
   ON SpatialTable2(object)
   USING GEOGRAPHY_GRID
   WITH (
    GRIDS = (MEDIUM, LOW, MEDIUM, HIGH ),
    CELLS_PER_OBJECT = 64,
    PAD_INDEX  = ON );

L'exemple crée ensuite un troisième index spatial, SIndx_SpatialTable_geography_col3, sur geography_col dans la table SpatialTable2. L'exemple utilise le schéma de pavage par défaut, GEOGRAPHY_GRID et la valeur CELLS_PER_OBJECT par défaut (16).

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col3
   ON SpatialTable2(object)
   WITH ( GRIDS = ( LEVEL_3 = HIGH, LEVEL_2 = HIGH ) );