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

  • Статья

Область применения: SQL Server

В этой статье описываются аргументы и свойства хранимых процедур пространственного индекса.

Соглашения о синтаксисе 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 содержащие значения, не включаются в возвращаемый набор.

Примеры

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

Связанный контент