Хранимые процедуры пространственного индекса — аргументы и свойства
Область применения: 
SQL Server
В этой статье описываются аргументы и свойства хранимых процедур пространственного индекса.
Соглашения о синтаксисе Transact-SQL
Синтаксис
Синтаксис определенных хранимых процедур пространственного индекса см. в следующих статьях:
- sp_help_spatial_geometry_index (Transact-SQL)
- sp_help_spatial_geometry_index_xml (Transact-SQL)
- sp_help_spatial_geography_index (Transact-SQL)
- sp_help_spatial_geography_index_xml (Transact-SQL)
Аргументы
[ @tabname = ] N'tabname'
Полное или неквалифицированное имя таблицы, для которой был указан пространственный индекс.
Кавычки требуются, только если определяется уточненная таблица. Если предоставлено полное имя таблицы, включая имя базы данных, в качестве последнего должно использоваться имя текущей базы данных. @tabname — nvarchar(776), без значения по умолчанию.
[ @indexname = ] N'indexname'
Имя указанного пространственного индекса. @indexname — sysname, без значения по умолчанию.
[ @verboseoutput = ] подробный путь
Диапазон возвращаемых имен свойств и значений. @verboseoutput является крошечным, без значения по умолчанию и может быть одним из этих значений.
0= основные свойства>0= все свойства
[ @query_sample = ] query_sample
Пример репрезентативного запроса, который можно использовать для проверки полезности индекса. @query_sample — география без значения по умолчанию. Это может быть представительный объект или окно запроса.
[ @xml_output = ] N'xml_output' OUTPUT
Возвращает результирующий набор в фрагменте XML. @xml_output — это параметр OUTPUT типа XML.
Свойства
Задайте @verboseoutput = 0 для возврата основных свойств, как показано в следующей таблице, или @verboseoutput > 0 для возврата всех свойств пространственного индекса.
Base_Table_Rows
Количество строк в базовой таблице. Значение bigint.
Bounding_Box_xmin
Свойства ограничивающего прямоугольника X для типа геометрии . Это значение свойства для NULL географического типа. Значение имеет значение float.
Bounding_Box_ymin
Минимальные свойства ограничивающего прямоугольного поля пространственного индекса для геометрического типа. Это значение свойства для NULL географического типа. Значение имеет значение float.
Bounding_Box_xmax
Свойства ограничивающего прямоугольного поля X для геометрического типа. Это значение свойства для NULL географического типа. Значение имеет значение float.
Bounding_Box_ymax
Свойства ограничивающего поля Y пространственного индекса для геометрического типа. Это значение свойства для NULL географического типа. Значение имеет значение float.
Grid_Size_Level_1
Плотность сетки первого уровня пространственного индекса:
- 16 для LOW
- 64 для MEDIUM
- 256 для HIGH
Значение имеет значение int.
Grid_Size_Level_2
Плотность сетки второго уровня пространственного индекса:
- 16 для LOW
- 64 для MEDIUM
- 256 для HIGH
Значение имеет значение int.
Grid_Size_Level_3
Плотность сетки третьего уровня пространственного индекса:
- 16 для LOW
- 64 для MEDIUM
- 256 для HIGH
Значение имеет значение int.
Grid_Size_Level_4
Плотность сетки четвертого уровня пространственного индекса:
- 16 для LOW
- 64 для MEDIUM
- 256 для HIGH
Значение имеет значение int.
Cells_Per_Object
Число ячеек на пространственный объект (свойство индекса). Значение имеет значение int.
Total_Primary_Index_Rows
Количество строк в индексе. Значение bigint.
Total_Primary_Index_Pages
Количество страниц в индексе. Значение bigint.
Average_Number_Of_Index_Rows_Per_Base_Row
Количество строк в индексе / количество строк в базовой таблице. Значение bigint.
Total_Number_Of_ObjectCells_In_Level0_For_QuerySample
Указывает, попадает ли пример репрезентативного запроса за пределы ограничивающего поля геометрического индекса и корневой ячейки (уровень 0 ячейки). Это либо значение 0 (не в ячейке уровня 0), либо 1. Если он находится в ячейке уровня 0, исследуемый индекс не является подходящим индексом для примера запроса. Это свойство является основным. Значение bigint.
Total_Number_Of_ObjectCells_In_Level0_In_Index
Число экземпляров ячеек индексированных объектов, которые тесселлированы на уровне 0 (корневая ячейка, за пределами ограничивающего поля для геометрии). Это свойство является основным. Значение bigint.
Для геометрических индексов это происходит, если ограничивающий прямоугольник индекса меньше домена данных. Для большого количества объектов уровня 0 может потребоваться вторичный фильтр, если окно запроса частично выходит за пределы ограничивающего поля и уменьшает производительность индекса (например, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample равно 1). Если окно запроса попадает в ограничивающее поле, большое количество объектов на уровне 0 может фактически повысить производительность индекса.
Значения NULL и пустые экземпляры учитываются на уровне 0, но не влияют на производительность. Уровень 0 имеет столько ячеек, сколько NULL и пустых экземпляров в базовой таблице. Для географических индексов уровень 0 имеет столько ячеек NULL , сколько и пустых экземпляров +1 ячейки, так как пример запроса считается 1.
Total_Number_Of_ObjectCells_In_Level1_In_Index
Количество экземпляров ячеек индексированных объектов тесселируются с точностью первого уровня. Это свойство является основным. Значение bigint.
Total_Number_Of_ObjectCells_In_Level2_In_Index
Количество экземпляров ячеек индексированных объектов тесселируются с точностью второго уровня. Это свойство является основным. Значение bigint.
Total_Number_Of_ObjectCells_In_Level3_In_Index
Количество экземпляров ячеек индексированных объектов тесселируются с точностью третьего уровня. Это свойство является основным. Значение bigint.
Total_Number_Of_ObjectCells_In_Level4_In_Index
Количество экземпляров ячеек индексированных объектов тесселируются с точностью четвертого уровня. Это свойство является основным. Значение bigint.
Total_Number_Of_interior_ObjectCells_In_Level1_In_Index
Число ячеек, которые полностью покрыты объектом на уровне тесселяции 1 и, следовательно, являются внутренними для объекта. (Cell_attributevalue равно 2.) Это основное свойство. Значение bigint.
Total_Number_Of_interior_ObjectCells_In_Level2_In_Index
Количество ячеек, полностью покрытых объектом на уровне тесселяции 2, и поэтому являются внутренними для объекта. (значение Cell_attribute равно 2.) Это основное свойство. Значение bigint.
Total_Number_Of_interior_ObjectCells_In_Level3_In_Index
Количество ячеек, полностью покрытых объектом на уровне тесселяции 3, и, следовательно, являются внутренними для объекта. (значение Cell_attribute равно 2.) Это основное свойство. Значение bigint.
Total_Number_Of_interior_ObjectCells_In_Level4_In_Index
Количество ячеек, которые полностью входят в объект на уровне тесселяции 4 и, следовательно, являются внутренними для объекта. (значение Cell_attribute равно 2.) Это основное свойство. Значение bigint.
Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index
Число ячеек, пересекающихся объектом на уровне тесселяции 1. (значение Cell_attribute равно 1.) Это основное свойство. Значение bigint.
Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index
Число ячеек, пересекающихся объектом на уровне тесселяции 2. (значение Cell_attribute равно 1.) Это основное свойство. Значение bigint.
Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index
Число ячеек, пересекающихся объектом на уровне тесселяции 3. (значение Cell_attribute равно 1.) Это основное свойство. Значение bigint.
Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index
Число ячеек, которые пересекаются объектом на уровне тесселяции 4. (значение Cell_attribute равно 1.) Это основное свойство. Значение bigint.
Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample
Указывает, находится ли образец запроса в корневой ячейке 0 вне ограничивающего прямоугольника, но на границе с ним. Это свойство является основным. Значение bigint.
Примечание.
Эта информация полезна только при определении наличия объектов, которые могут быть пропущены ограничивающим полем.
Total_Number_Of_Border_ObjectCells_In_Level0_In_Index
Количество объектов на уровне 0, которые граничат с ограничивающим прямоугольником. (значение Cell_attribute равно 0.) Значение bigint.
Total_Number_Of_Border_ObjectCells_In_Level1_In_Index
Число ячеек объектов, касающих границу ячейки сетки на уровне тесселяции 1. (значение Cell_attribute равно 0.) Это основное свойство. Значение bigint.
Total_Number_Of_Border_ObjectCells_In_Level2_In_Index
Число ячеек объектов, касающих границу ячейки сетки на уровне тесселяции 2. (значение Cell_attribute равно 0.) Это основное свойство. Значение bigint.
Total_Number_Of_Border_ObjectCells_In_Level3_In_Index
Число ячеек объектов, касающихся границы ячейки сетки на уровне тесселяции 3. (значение Cell_attribute равно 0.) Это основное свойство. Значение bigint.
Total_Number_Of_Border_ObjectCells_In_Level4_In_Index
Количество ячеек, которые граничат с ячейкой сетки на уровне тесселяции 4. (значение Cell_attribute равно 0.) Это основное свойство. Значение bigint.
Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
Процент общей области (общих конечных ячеек) сетки, содержащей конечные ячейки, покрытые объектом.
Например, объект тесселлируется на 10 ячеек на четырех разных уровнях сетки, охватывающих область, эквивалентную 100 конечным ячейкам в общей сложности. Предположим, есть три внутренних ячейки, которые полностью покрыты объектом. Область, покрытая тремя внутренними ячейками, эквивалентна 42 конечным ячейкам. Таким образом, доля в процентах составляет 42 (процента). Это показатель того, насколько целесообразно распределены объекты в индексе.
Значение имеет значение float.
Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
То же, что и Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, за исключением того, что они частично покрыты ячейками. Значение имеет значение float.
Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
То же, что и Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage , за исключением того, что они являются пограничными ячейками. Значение имеет значение float.
Average_Cells_Per_Object_Normalized_To_Leaf_Grid
Среднее число ячеек на объект, нормализованных в сетке конечных ячеек. Это дает нам представление о пространственном размере объекта или о том, насколько большие объекты. Значение имеет значение float.
Average_Objects_PerLeaf_GridCell
Разреженность индекса. Среднее число объектов на конечную ячейку. Значение имеет значение float.
Number_Of_SRIDs_Found
Количество уникальных SRID в индексе и столбце. Значение имеет значение int.
Поскольку в столбце может содержаться более одного SRID и объекты различных SRID никогда не пересекаются, то количество SRID указывает на избирательность индекса.
Width_Of_Cell_In_Level1
Свойство ширины ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Width_Of_Cell_In_Level2
Свойство ширины ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Width_Of_Cell_In_Level3
Свойство ширины ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Width_Of_Cell_In_Level4
Свойство ширины ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Height_Of_Cell_In_Level1
Свойство высоты ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Height_Of_Cell_In_Level2
Свойство высоты ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Height_Of_Cell_In_Level3
Свойство высоты ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Height_Of_Cell_In_Level4
Свойство высоты ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Area_Of_Cell_In_Level1
Свойство площади ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Area_Of_Cell_In_Level2
Свойство площади ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Area_Of_Cell_In_Level3
Свойство площади ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
Area_Of_Cell_In_Level4
Свойство площади ячейки в индексированной сетке. Единица измерения обеспечивается индексом и зависит от SRID индексированных данных. Значение имеет значение float.
CellArea_To_BoundingBoxArea_Percentage_In_Level1
Процент покрытия ограничивающего прямоугольника на уровне 1 ячейки. Значение имеет значение float.
CellArea_To_BoundingBoxArea_Percentage_In_Level2
Процент покрытия ограничивающего прямоугольника на уровне 2 ячейки. Значение имеет значение float.
CellArea_To_BoundingBoxArea_Percentage_In_Level3
Процент охвата ограничивающего прямоугольника на уровне 3 ячейки. Значение имеет значение float.
CellArea_To_BoundingBoxArea_Percentage_In_Level4
Доля покрытия в процентах ограничивающего прямоугольника ячейки уровня 4. Значение имеет значение float.
Number_Of_Rows_Selected_By_Primary_Filter
Количество строк, выбранных основным фильтром. Это свойство является основным. Значение bigint.
Number_Of_Rows_Selected_By_Internal_Filter
Количество строк, выбранных внутренним фильтром. Вторичный фильтр не вызывается для этих строк. Это свойство является основным. Значение bigint.
Возвращаемое число применимо только для STintersects.
Number_Of_Times_Secondary_Filter_Is_Called
Количество вызовов дополнительного фильтра. Это свойство является основным. Значение bigint.
Percentage_Of_Rows_NotSelected_By_Primary_Filter
Если в базовой таблице содержится N строк, а основным фильтром выбрано P, то возвращается доля в процентах (N-P)/N. Это свойство является основным. Значение имеет значение float.
Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter
Если основным фильтром выбрано P строк, а S строк выбрано внутренним фильтром, то возвращается доля в процентах S/P. Чем выше доля в процентах, тем выше уровень индекса в области избегания использования дополнительного фильтра, более требовательного к производительности. Это свойство является основным. Значение имеет значение float.
Number_Of_Rows_Output
Количество строк, выведенных при запросе. Это свойство является основным. Значение bigint.
Internal_Filter_Efficiency
Если O представляет собой количество выведенных строк, то возвращается доля в процентах S/O. Это свойство является основным. Значение имеет значение float.
Primary_Filter_Efficiency
Если строки P выбираются первичным фильтром, а число выходных данных O — это число строк, это возвращаемое значение в процентах. Чем выше эффективность основного фильтра, тем меньше ложных положительных результатов необходимо обработать дополнительному фильтру. Это свойство является основным. Значение имеет значение float.
Разрешения
Пользователь должен быть членом общедоступной роли. Необходимо разрешение READ ACCESS на сервере и объекте. Это относится ко всем хранимым процедурам пространственного индекса.
Замечания
Свойства, NULL содержащие значения, не включаются в возвращаемый набор.
Примеры
Примеры см. в следующих статьях:
- sp_help_spatial_geometry_index (Transact-SQL)
- sp_help_spatial_geometry_index_xml (Transact-SQL)
- sp_help_spatial_geography_index (Transact-SQL)
- sp_help_spatial_geography_index_xml (Transact-SQL)