Procédures stockées d’index spatial - arguments et propriétés

  • Article

S’applique à :SQL Server

Cet article décrit les arguments et les propriétés des procédures stockées d’index spatial.

Conventions de la syntaxe Transact-SQL

Syntaxe

Pour connaître la syntaxe des procédures stockées d’index spatiaux spécifiques, consultez les articles suivants :

Arguments

[ @tabname = ] N’tabname'

Nom qualifié ou non qualifié de la table pour laquelle l’index spatial a été spécifié.

Les guillemets ne sont nécessaires que si une une table qualifiée est spécifiée. Si un nom qualifié complet (incluant un nom de base de données) est fourni, le nom de base de données doit être celui de la base de données active. @tabname est nvarchar(776), sans valeur par défaut.

[ @indexname = ] 'indexname'

Nom de l’index spatial spécifié. @indexname est sysname sans valeur par défaut.

[ @verboseoutput = ] verboseoutput

Plage de noms et de valeurs de propriété à renvoyer.

  • 0 = propriétés principales
  • >0 = toutes les propriétés

@verboseoutput est tinyint sans valeur par défaut.

[ @query_sample = ] 'query_sample'

Exemple de requête représentatif qui peut être utilisé pour tester l’utilité de l’index. Il peut s'agir d'un objet représentatif ou d'une fenêtre de requête. query_sample est geometry sans valeur par défaut.

[ @xml_output = ] 'xml_output'

Paramètre de sortie qui retourne le jeu de résultats dans un fragment XML. xml_output est xml sans valeur par défaut.

Propriétés

Définissez pour @verboseoutput = 0 retourner les propriétés principales, comme indiqué dans le tableau suivant, ou @verboseoutput > 0 pour renvoyer toutes les propriétés de l’index spatial.

Base_Table_Rows

Nombre de lignes dans la table de base. La valeur est biginte.

Bounding_Box_xmin

Propriétés de zone englobante X de l’index spatial pour le type geometry . Cette valeur de propriété est NULL pour le type geography . La valeur est flottante.

Bounding_Box_ymin

Propriétés de zone englobante Y de l’index spatial pour le type geometry . Cette valeur de propriété est NULL pour le type geography . La valeur est flottante.

Bounding_Box_xmax

Propriétés de zone englobante X de l’index spatial pour le type geometry . Cette valeur de propriété est NULL pour le type geography . La valeur est flottante.

Bounding_Box_ymax

Propriétés de zone englobante maximale Y de l’index spatial pour le type geometry . Cette valeur de propriété est NULL pour le type geography . La valeur est flottante.

Grid_Size_Level_1

Densité de grille de niveau 1 de l’index spatial :

  • 16 pour LOW
  • 64 pour MEDIUM
  • 256 pour HIGH

La valeur est int.

Grid_Size_Level_2

Densité de grille de niveau 2 de l’index spatial :

  • 16 pour LOW
  • 64 pour MEDIUM
  • 256 pour HIGH

La valeur est int.

Grid_Size_Level_3

Densité de grille de niveau 3 de l’index spatial :

  • 16 pour LOW
  • 64 pour MEDIUM
  • 256 pour HIGH

La valeur est int.

Grid_Size_Level_4

Densité de la grille de niveau 4 de l'index spatial :

  • 16 pour LOW
  • 64 pour MEDIUM
  • 256 pour HIGH

La valeur est int.

Cells_Per_Object

Nombre de cellules par objet spatial (propriété d'index). La valeur est int.

Total_Primary_Index_Rows

Nombre de lignes dans l'index. La valeur est biginte.

Total_Primary_Index_Pages

Nombre de pages dans l'index. La valeur est biginte.

Average_Number_Of_Index_Rows_Per_Base_Row

Nombre de lignes d'index / nombre de lignes de table de base. La valeur est biginte.

Total_Number_Of_ObjectCells_In_Level0_For_QuerySample

Indique si l’exemple de requête représentatif se trouve en dehors du cadre englobant de l’index geometry et dans la cellule racine (cellule de niveau 0). Il s'agit de 0 (pas dans la cellule de niveau 0) ou de 1. S’il se trouve dans la cellule de niveau 0, l’index examiné n’est pas un index approprié pour l’exemple de requête. Il s'agit d'une propriété principale. La valeur est biginte.

Total_Number_Of_ObjectCells_In_Level0_In_Index

Nombre d’instances de cellules d’objets indexés qui sont tessellés au niveau 0 (cellule racine, en dehors de la zone englobante pour la géométrie). Il s'agit d'une propriété principale. La valeur est biginte.

Pour les index géométriques , cela se produit si la zone englobante de l’index est inférieure au domaine de données. Un grand nombre d’objets au niveau 0 peut nécessiter des filtres secondaires si la fenêtre de requête tombe partiellement en dehors du cadre englobant et diminue les performances de l’index (par exemple, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample est 1). Si la fenêtre de requête se situe à l'intérieur du cadre englobant, un nombre élevé d'objets au niveau 0 peut améliorer réellement la performance de l'index.

Les instances NULL et vides sont comptabilisées au niveau 0, mais n’affectent pas les performances. Le niveau 0 a autant de cellules que NULL et les instances vides dans la table de base. Pour les index géographiques , le niveau 0 a autant de cellules que null et les instances vides +1 cellule, car l’exemple de requête est compté comme 1.

Total_Number_Of_ObjectCells_In_Level1_In_Index

Nombre d’instances de cellules d’objets indexés qui sont tessellés avec une précision de niveau 1. Il s'agit d'une propriété principale. La valeur est biginte.

Total_Number_Of_ObjectCells_In_Level2_In_Index

Nombre d’instances de cellules d’objets indexés qui sont tessellés avec une précision de niveau 2. Il s'agit d'une propriété principale. La valeur est biginte.

Total_Number_Of_ObjectCells_In_Level3_In_Index

Nombre d’instances de cellules d’objets indexés qui sont tessellés avec une précision de niveau 3. Il s'agit d'une propriété principale. La valeur est biginte.

Total_Number_Of_ObjectCells_In_Level4_In_Index

Nombre d'instances de cellule d'objets indexés qui sont pavées avec la précision de niveau 4. Il s'agit d'une propriété principale. La valeur est biginte.

Total_Number_Of_interior_ObjectCells_In_Level1_In_Index

Nombre de cellules entièrement couvertes par un objet au niveau de pavage 1 et sont donc intérieures à l’objet. (Cell_attributevalue est 2.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_interior_ObjectCells_In_Level2_In_Index

Nombre de cellules entièrement couvertes par un objet au niveau de pavage 2 et sont donc intérieures à l’objet. (Cell_attribute valeur est 2.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_interior_ObjectCells_In_Level3_In_Index

Nombre de cellules entièrement couvertes par un objet au niveau de pavage 3 et sont donc intérieures à l’objet. (Cell_attribute valeur est 2.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_interior_ObjectCells_In_Level4_In_Index

Nombre de cellules qui sont complètement couvertes par un objet au pavage niveau 4 et se situent donc à l'intérieur de l'objet. (Cell_attribute valeur est 2.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

Nombre de cellules qui sont croisées par un objet au niveau de pavage 1. (Cell_attribute valeur est 1.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

Nombre de cellules qui sont croisées par un objet au niveau de pavage 2. (Cell_attribute valeur est 1.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Nombre de cellules qui sont croisées par un objet au niveau de pavage 3. (Cell_attribute valeur est 1.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Nombre de cellules qui sont croisées par un objet au pavage niveau 4. (Cell_attribute valeur est 1.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample

Indique si l'exemple de requête est dans la cellule racine 0 à l'extérieur du cadre englobant, mais le touche. Il s'agit d'une propriété principale. La valeur est biginte.

Remarque

Cette information est uniquement utile pour déterminer s'il y a des objets que le cadre englobant a pu manquer de peu.

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

Nombre d'objets au niveau 0 qui touchent le cadre englobant. (Cell_attribute valeur est 0.) La valeur est biginte.

Total_Number_Of_Border_ObjectCells_In_Level1_In_Index

Nombre de cellules d’objet qui touchent une limite de cellule de grille au niveau de pavage 1. (Cell_attribute valeur est 0.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_Border_ObjectCells_In_Level2_In_Index

Nombre de cellules d’objet qui touchent une limite de cellule de grille au niveau de pavage 2. (Cell_attribute valeur est 0.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_Border_ObjectCells_In_Level3_In_Index

Nombre de cellules d’objet qui touchent une limite de cellule de grille au niveau de pavage 3. (Cell_attribute valeur est 0.) Il s’agit d’une propriété principale. La valeur est biginte.

Total_Number_Of_Border_ObjectCells_In_Level4_In_Index

Nombre de cellules d'objet qui touchent une limite de cellule de grille au pavage niveau 4. (Cell_attribute valeur est 0.) Il s’agit d’une propriété principale. La valeur est biginte.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Pourcentage de la zone totale (cellules feuilles totales) de la grille qui contient des cellules feuilles couvertes par un objet.

Par exemple, un objet est tessellé en 10 cellules aux quatre niveaux de grille différents couvrant une zone équivalente à 100 cellules feuilles au total. Supposons qu’il existe trois cellules intérieures entièrement couvertes par l’objet. La zone couverte par les trois cellules intérieures équivaut à 42 cellules feuilles. Le pourcentage de zone couverte est donc de 42 pour cent. Il s'agit d'une bonne mesure de la manière dont les objets dans l'index sont déchiquetés.

La valeur est flottante.

Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Identique à Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, sauf que ces cellules sont partiellement couvertes. La valeur est flottante.

Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Identique à Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage sauf qu’il s’agit de cellules de bordure. La valeur est flottante.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Cellules moyennes par objet normalisées selon la grille feuilles. Cela nous donne une indication de la taille spatiale de l’objet, ou de la taille des objets. La valeur est flottante.

Average_Objects_PerLeaf_GridCell

Fragmentation de l'index Nombre moyen d'objets par cellule feuille. La valeur est flottante.

Number_Of_SRIDs_Found

Nombre de SRID uniques dans l'index et la colonne. La valeur est int.

Dans la mesure où une colonne peut contenir plusieurs SRID et que les objets de SRID différent ne se croisent jamais, le nombre de SRID indique la sélectivité de l'index.

Width_Of_Cell_In_Level1

Propriété de largeur (Width) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Width_Of_Cell_In_Level2

Propriété de largeur (Width) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Width_Of_Cell_In_Level3

Propriété de largeur (Width) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Width_Of_Cell_In_Level4

Propriété de largeur (Width) de cellule dans la grille d'indexation. L'unité de mesure est fournie par l'index et dépend du SRID des données indexées. La valeur est flottante.

Height_Of_Cell_In_Level1

Propriété de hauteur (Height) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Height_Of_Cell_In_Level2

Propriété de hauteur (Height) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Height_Of_Cell_In_Level3

Propriété de hauteur (Height) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Height_Of_Cell_In_Level4

Propriété de hauteur (Height) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Area_Of_Cell_In_Level1

Propriété de zone (Area) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Area_Of_Cell_In_Level2

Propriété de zone (Area) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Area_Of_Cell_In_Level3

Propriété de zone (Area) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

Area_Of_Cell_In_Level4

Propriété de zone (Area) de cellule dans la grille d'indexation. L’unité de mesure est fournie par l’index et dépend du SRID des données indexées. La valeur est flottante.

CellArea_To_BoundingBoxArea_Percentage_In_Level1

Pourcentage de couverture du cadre englobant par une cellule de niveau 1. La valeur est flottante.

CellArea_To_BoundingBoxArea_Percentage_In_Level2

Pourcentage de couverture du cadre englobant par une cellule de niveau 2. La valeur est flottante.

CellArea_To_BoundingBoxArea_Percentage_In_Level3

Pourcentage de couverture du cadre englobant par une cellule de niveau 3. La valeur est flottante.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

Le pourcentage de couverture du cadre englobant par une cellule de niveau 4. La valeur est flottante.

Number_Of_Rows_Selected_By_Primary_Filter

Nombre de lignes sélectionnées par le filtre principal. Il s'agit d'une propriété principale. La valeur est biginte.

Number_Of_Rows_Selected_By_Internal_Filter

Nombre de lignes sélectionnées par le filtre interne. Le filtre secondaire n’est pas appelé pour ces lignes. Il s'agit d'une propriété principale. La valeur est biginte.

Le nombre retourné s’applique uniquement aux STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

Nombre de fois que le filtre secondaire est appelé. Il s'agit d'une propriété principale. La valeur est biginte.

Percentage_Of_Rows_NotSelected_By_Primary_Filter

S'il y a N lignes dans la table de base, et si P est sélectionné par le filtre principal, cela retourne (N-P)/N comme pourcentage. Il s'agit d'une propriété principale. La valeur est flottante.

Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter

Si les lignes P sont sélectionnées par les filtre principal et si les lignes S sont sélectionnées par le filtre interne, cela retourne S/P comme pourcentage. Plus le pourcentage est élevé, mieux l'index se comporte pour éviter le filtre secondaire qui est plus pénalisant en termes de performances. Il s'agit d'une propriété principale. La valeur est flottante.

Number_Of_Rows_Output

Nombre réel de lignes générées par la requête. Il s'agit d'une propriété principale. La valeur est biginte.

Internal_Filter_Efficiency

Si O est le nombre de lignes générées, cela retourne S/O comme pourcentage. Il s'agit d'une propriété principale. La valeur est flottante.

Primary_Filter_Efficiency

Si les lignes P sont sélectionnées par le filtre principal et que le nombre de lignes est le nombre de lignes générées, cela retourne l’authentification unique/P sous la forme d’un pourcentage. Plus le rendement du filtre principal est principal, moins il y a de faux positifs que le filtre secondaire doit traiter. Il s'agit d'une propriété principale. La valeur est flottante.

Autorisations

L’utilisateur doit être membre du rôle public . Nécessite une autorisation READ ACCESS sur le serveur et l'objet. Cela s'applique à toutes les procédures stockées de l'index spatial.

Notes

Les propriétés contenant des valeurs NULL ne sont pas incluses dans le jeu de retour.

Exemples

Pour obtenir des exemples, consultez les articles suivants :

Contenu connexe