Хранимые процедуры пространственного индекса — аргументы и свойства

Применимо к:SQL Server

В этом разделе перечислены аргументы и свойства хранимых процедур пространственного индекса.

Соглашения о синтаксисе Transact-SQL

Синтаксис

Синтаксис определенных хранимых процедур пространственного индекса см. в следующих разделах.

Аргументы

[ @tabname = ] 'tabname' Полное или неквалифицированное имя таблицы, для которой задан пространственный индекс.

Кавычки требуются, только если определяется уточненная таблица. Если предоставлено полное имя таблицы, включая имя базы данных, в качестве последнего должно использоваться имя текущей базы данных. tabname имеет значение nvarchar(776) без значения по умолчанию.

[ @indexname = ] 'indexname' Имя указанного пространственного индекса. аргумент indexname имеет значение sysname без значения по умолчанию.

[ @verboseoutput = ] 'verboseoutput' Диапазон возвращаемых имен свойств и значений.

0 = основные свойства

>0 = все свойства

verboseoutput имеет значение tinyint без значения по умолчанию.

[ @query_sample = ] 'query_sample' Пример репрезентативного запроса, который можно использовать для проверки полезности индекса. Это может быть репрезентативный объект или окно запроса. query_samplegeometry без значения по умолчанию.

[ @xml_output = ] 'xml_output' Выходной параметр, возвращающий результирующий набор в фрагменте XML. xml_output имеет значение xml без значения по умолчанию.

Свойства

Задайте @verboseoutput =0, чтобы вернуть основные свойства, как показано в таблице ниже; >@verboseoutput Значение 0 для возврата всех свойств пространственного индекса.

Base_Table_Rows
Количество строк в базовой таблице. Значение bigint.

Bounding_Box_xmin
X-минимальные ограничивающие свойства пространственного индекса для типа geometry . Это значение свойства равно NULL для типа geography. Значение равно float.

Bounding_Box_ymin
Минимальные свойства ограничивающего прямоугольника пространственного индекса для типа geometry . Это значение свойства равно NULL для типа geography . Значение равно float.

Bounding_Box_xmax
X-maximum ограничивающие свойства прямоугольник пространственного индекса для типа geometry . Это значение свойства равно NULL для типа geography . Значение равно float.

Bounding_Box_ymax
Максимальные свойства ограничивающего прямоугольника по Y пространственного индекса для типа 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
Указывает, попадает ли репрезентативный пример запроса за пределы ограничивающего прямоугольника геометрического индекса в корневую ячейку (ячейка уровня 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, при этом пустые экземпляры входят в базовую таблицу. Для индексов 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_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 ячеек на 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.

Разрешения

Пользователь должен быть членом общедоступной роли. Необходимо разрешение READ ACCESS на сервере и объекте. Это относится ко всем хранимым процедурам пространственного индекса.

Комментарии

Свойства, которые содержат значения NULL, не включаются в набор возвращаемых значений.

Примеры

Примеры см. в следующих разделах:

Требования

См. также:

Хранимые процедуры пространственного индекса (Transact-SQL)
sp_help_spatial_geometry_index (Transact-SQL)
Общие сведения о пространственных индексах
Основы языка XQuery
Справочник по языку XQuery (SQL Server)