Аргументы и свойства хранимых процедур пространственного индекса
В этом разделе перечислены аргументы и свойства хранимых процедур пространственного индекса.
Синтаксические обозначения в Transact-SQL
Синтаксис
Синтаксис определенных хранимых процедур пространственного индекса см. в следующих разделах.
Аргументы
[ @tabname =] 'tabname'
Полное или неполное имя определенной таблицы, для которой был указан пространственный индекс.Кавычки требуются, только если определяется уточненная таблица. Если предоставлено полное имя таблицы, включая имя базы данных, в качестве последнего должно использоваться имя текущей базы данных. Аргумент tabname имеет тип nvarchar(776) и не имеет значения по умолчанию.
[ @indexname = ] 'indexname'
Имя указанного пространственного индекса. Аргумент indexname имеет тип sysname и не имеет значения по умолчанию.[ @verboseoutput = ] 'verboseoutput'
Диапазон возвращаемых имен свойств и значений.0 = основные свойства
> 0 = все свойства
Аргумент verboseoutput имеет тип tinyint и не имеет значения по умолчанию.
[ @query_sample = ] 'query_sample'
Это репрезентативный образец запроса, который можно использовать для проверки ценности индекса. Это может быть репрезентативный объект или окно запроса. Аргумент query_sample имеет тип geometry и не имеет значения по умолчанию.[ @xml_output = ] 'xml_output'
Этот выходной параметр возвращает результирующий набор во фрагменте XML. Аргумент xml_output имеет тип xml и не имеет значения по умолчанию.
Свойства
Задается @verboseoutput=0 для возврата основных свойств, как показано в таблице ниже. Значение @verboseoutput > 0 используется для возврата всех свойств пространственного индекса.
Base_Table_Rows
Количество строк в базовой таблице. Значение bigint.Bounding_Box_xmin
Свойства ограничивающего прямоугольника X-minimum пространственного индекса для типа geometry. Это свойство имеет значение NULL для типа geography. Значение float.Bounding_Box_ymin
Свойства ограничивающего прямоугольника Y-minimum пространственного индекса для типа geometry. Это свойство имеет значение NULL для типа geography. Значение float.Bounding_Box_xmax
Свойства ограничивающего прямоугольника X-maximum пространственного индекса для типа geometry. Это свойство имеет значение NULL для типа geography. Значение float.Bounding_Box_ymax
Свойства ограничивающего прямоугольника Y-maximum пространственного индекса для типа geometry. Это свойство имеет значение NULL для типа geography. Значение 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
Указывается, выходит ли образец репрезентативного запроса за пределы ограничивающего прямоугольника индекса geometry и входит ли в корневую ячейку (ячейка уровня 0). Это либо значение 0 (не в ячейке уровня 0), либо 1. Если входит в ячейку уровня 0, то анализируемый индекс не может быть использован в образце запроса. Это свойство является основным. Значение bigint.Total_Number_Of_ObjectCells_In_Level0_In_Index
Количество экземпляров ячейки индексированных объектов, которые тесселируются на уровне 0 (корневая ячейка, вне ограничивающего прямоугольника для geometry). Это свойство является основным. Значение bigint.Для индексов geometry это будет происходить, если ограничивающий прямоугольник индекса меньше, чем домен данных. Для большого количества объектов на уровне 0 необходимы дополнительные фильтры, если окно запроса не входит полностью в ограничивающий прямоугольник и снизит производительность индекса (например, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample имеет значение 1). Если окно запроса не входит в ограничивающий прямоугольник, то большое количество объектов на уровне 0 может действительно повысить производительность индекса.
NULL и пустые экземпляры считаются на уровне 0, но не влияют на производительность. На уровне 0 имеется столько же ячеек, что и для NULL, при этом пустые экземпляры входят в базовую таблицу. Для индексов geography на уровне 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_attribute имеет значение 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 ячеек на 4 различных уровнях сетки, покрывая область, которая эквивалентна общему числу 100 конечных ячеек. Предположим, существует 3 внутренних ячейки, которые полностью входят в объект. Область, которая покрывается 3 внутренними ячейками, эквивалентна 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 представляет собой количество выведенных строк, то возвращается доля в процентах O/P. Чем выше эффективность основного фильтра, тем меньше ложных положительных результатов необходимо обработать дополнительному фильтру. Это свойство является основным. Значение float..
Разрешения
Пользователь должен быть членом роли public. Необходимо разрешение READ ACCESS на сервере и объекте. Это относится ко всем хранимым процедурам пространственного индекса.
Замечания
Свойства, которые содержат значения NULL, не включаются в набор возвращаемых значений.
Примеры
Примеры см. в следующих разделах.
См. также
Справочник
sp_help_spatial_geometry_index (Transact-SQL)
Основные понятия
Общие сведения о пространственных индексах