Procedimientos almacenados de índice espacial: argumentos y propiedades

  • Artículo

Se aplica a: SQL Server

En este artículo se describen los argumentos y las propiedades de los procedimientos almacenados del índice espacial.

Convenciones de sintaxis de Transact-SQL

Sintaxis

Para obtener la sintaxis de procedimientos almacenados de índices espaciales específicos, consulte los siguientes artículos:

Argumentos

[ @tabname = ] N'tabname'

Nombre completo o no calificado de la tabla para la que se ha especificado el índice espacial.

Se requieren comillas únicamente si se especifica una tabla certificada. Si se proporciona un nombre completo, incluido el nombre de la base de datos, el nombre de la base de datos debe ser el de la base de datos actual. @tabname es nvarchar(776), sin ningún valor predeterminado.

[ @indexname = ] N'indexname'

Nombre del índice espacial especificado. @indexname es sysname, sin ningún valor predeterminado.

[ @verboseoutput = ] verboseoutput

Intervalo de nombres de propiedad y valores que se van a devolver. @verboseoutput es tinyint, sin valor predeterminado, y puede ser uno de estos valores.

  • 0 = propiedades principales
  • >0 = todas las propiedades

[ @query_sample = ] query_sample

Ejemplo de consulta representativo que se puede usar para probar la utilidad del índice. @query_sample es geography, sin valor predeterminado. Puede ser un objeto representativo o una ventana de consulta.

[ @xml_output = ] SALIDA de N'xml_output'

Devuelve el conjunto de resultados en un fragmento XML. @xml_output es un parámetro OUTPUT de tipo xml.

Propiedades

Establezca @verboseoutput = 0 para devolver las propiedades principales como se muestra en la tabla siguiente o @verboseoutput > 0 para devolver todas las propiedades del índice espacial.

Base_Table_Rows

Número de filas de la tabla base. El valor es bigint.

Bounding_Box_xmin

Propiedades del cuadro de límite mínimo X del índice espacial para el tipo de geometría. Este valor de propiedad es NULL para el tipo geography . El valor es float.

Bounding_Box_ymin

Propiedades del rectángulo de límite mínimo Y del índice espacial para el tipo de geometría. Este valor de propiedad es NULL para el tipo geography . El valor es float.

Bounding_Box_xmax

Propiedades del rectángulo de límite máximo X del índice espacial para el tipo de geometría. Este valor de propiedad es NULL para el tipo geography . El valor es float.

Bounding_Box_ymax

Propiedades del rectángulo de límite máximo Y del índice espacial para el tipo de geometría. Este valor de propiedad es NULL para el tipo geography . El valor es float.

Grid_Size_Level_1

Densidad de cuadrícula de nivel 1 del índice espacial:

  • 16 para LOW
  • 64 para MEDIUM
  • 256 para HIGH

El valor es int.

Grid_Size_Level_2

Densidad de cuadrícula de nivel 2 del índice espacial:

  • 16 para LOW
  • 64 para MEDIUM
  • 256 para HIGH

El valor es int.

Grid_Size_Level_3

Densidad de cuadrícula de nivel 3 del índice espacial:

  • 16 para LOW
  • 64 para MEDIUM
  • 256 para HIGH

El valor es int.

Grid_Size_Level_4

Densidad de la cuadrícula de nivel 4 del índice espacial:

  • 16 para LOW
  • 64 para MEDIUM
  • 256 para HIGH

El valor es int.

Cells_Per_Object

Número de celdas por cada objeto (propiedad de índice). El valor es int.

Total_Primary_Index_Rows

Número de filas del índice. El valor es bigint.

Total_Primary_Index_Pages

Número de páginas del índice. El valor es bigint.

Average_Number_Of_Index_Rows_Per_Base_Row

Número de filas de índice / número de filas de la tabla base. El valor es bigint.

Total_Number_Of_ObjectCells_In_Level0_For_QuerySample

Indica si el ejemplo de consulta representativo está fuera del rectángulo de límite del índice de geometría y en la celda raíz (celda de nivel 0). Es 0 (no está en la celda de nivel 0) ó 1. Si está en la celda de nivel 0, el índice investigado no es un índice adecuado para el ejemplo de consulta. Ésta es una propiedad básica. El valor es bigint.

Total_Number_Of_ObjectCells_In_Level0_In_Index

Número de instancias de celda de objetos indexados que se teselan en el nivel 0 (celda raíz, fuera del rectángulo de límite para geometría). Ésta es una propiedad básica. El valor es bigint.

En el caso de los índices de geometría, esto ocurre si el cuadro de límite del índice es menor que el dominio de datos. Un gran número de objetos en el nivel 0 puede requerir filtros secundarios si la ventana de consulta está parcialmente fuera del cuadro de límite y disminuye el rendimiento del índice (por ejemplo, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample es 1). Si la ventana de consulta está dentro del cuadro de límite, un gran número de objetos en el nivel 0 podría mejorar realmente el rendimiento del índice.

Las instancias NULAs y vacías se cuentan en el nivel 0, pero no afectan al rendimiento. El nivel 0 tiene tantas celdas como NULL instancias vacías en la tabla base. En el caso de los índices de geografía, el nivel 0 tiene tantas celdas como NULL y las instancias vacías +1, ya que el ejemplo de consulta se cuenta como 1.

Total_Number_Of_ObjectCells_In_Level1_In_Index

Número de instancias de celda de objetos indexados que se teselan con precisión de nivel 1. Ésta es una propiedad básica. El valor es bigint.

Total_Number_Of_ObjectCells_In_Level2_In_Index

Número de instancias de celda de objetos indizado que se teselan con precisión de nivel 2. Ésta es una propiedad básica. El valor es bigint.

Total_Number_Of_ObjectCells_In_Level3_In_Index

Número de instancias de celda de objetos indexados que se teselan con precisión de nivel 3. Ésta es una propiedad básica. El valor es bigint.

Total_Number_Of_ObjectCells_In_Level4_In_Index

Número de instancias de celdas de objetos indizados que se teselan con precisión de nivel 4. Ésta es una propiedad básica. El valor es bigint.

Total_Number_Of_interior_ObjectCells_In_Level1_In_Index

Número de celdas que están completamente cubiertas por un objeto en el nivel de teselación 1 y, por tanto, son interiores para el objeto. (Cell_attributevalue es 2). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_interior_ObjectCells_In_Level2_In_Index

Número de celdas que están completamente cubiertas por un objeto en el nivel de teselación 2 y, por tanto, son interiores para el objeto. (Cell_attribute valor es 2). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_interior_ObjectCells_In_Level3_In_Index

Número de celdas que están completamente cubiertas por un objeto en el nivel de teselación 3 y, por tanto, son interiores para el objeto. (Cell_attribute valor es 2). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_interior_ObjectCells_In_Level4_In_Index

Número de celdas que están cubiertas completamente por un objeto en el nivel 4 de teselación y, por lo tanto, son interiores al objeto. (Cell_attribute valor es 2). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

Número de celdas intersecadas por un objeto en el nivel de teselación 1. (Cell_attribute valor es 1). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

Número de celdas intersecadas por un objeto en el nivel de teselación 2. (Cell_attribute valor es 1). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Número de celdas intersecadas por un objeto en el nivel de teselación 3. (Cell_attribute valor es 1). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Número de celdas que intersecta un objeto en el nivel 4 de teselación. (Cell_attribute valor es 1). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample

Indica si el ejemplo de consulta está en la celda raíz 0, fuera del cuadro de límite, pero tocándolo. Ésta es una propiedad básica. El valor es bigint.

Nota:

Esta información solo es útil para determinar si hay objetos que es posible que el rectángulo de límite se haya perdido estrechamente.

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

El número de objetos del nivel 0 que tocan al cuadro de límite. (Cell_attribute valor es 0). El valor es bigint.

Total_Number_Of_Border_ObjectCells_In_Level1_In_Index

Número de celdas de objeto que tocan un límite de celda de cuadrícula en el nivel de teselación 1. (Cell_attribute valor es 0). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_Border_ObjectCells_In_Level2_In_Index

Número de celdas de objeto que tocan un límite de celda de cuadrícula en el nivel de teselación 2. (Cell_attribute valor es 0). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_Border_ObjectCells_In_Level3_In_Index

Número de celdas de objeto que tocan un límite de celda de cuadrícula en el nivel de teselación 3. (Cell_attribute valor es 0). Se trata de una propiedad principal. El valor es bigint.

Total_Number_Of_Border_ObjectCells_In_Level4_In_Index

Número de celdas de objeto que tocan un límite de celda de cuadrícula en el nivel 4 de teselación. (Cell_attribute valor es 0). Se trata de una propiedad principal. El valor es bigint.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Porcentaje del área total (celdas hoja totales) de la cuadrícula que contiene celdas hoja cubiertas por un objeto .

Por ejemplo, un objeto se tesela en 10 celdas en los cuatro niveles de cuadrícula diferentes que cubren un área equivalente a 100 celdas hoja en total. Supongamos que hay tres celdas interiores que están completamente cubiertas por el objeto . El área cubierta por las tres celdas interiores es equivalente a 42 células hoja. Así, el porcentaje de área cubierta es del 42 por ciento. Esta es una buena medida de cómo se dividen los objetos en el índice.

El valor es float.

Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Igual que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, salvo que estas celdas están parcialmente cubiertas. El valor es float.

Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Igual que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage excepto que son celdas de borde. El valor es float.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Promedio de celdas por objeto normalizadas en la cuadrícula hoja. Esto nos da una indicación del tamaño espacial del objeto, o el tamaño de los objetos. El valor es float.

Average_Objects_PerLeaf_GridCell

Grado de dispersión del índice. Número promedio de objetos por cada celda hoja. El valor es float.

Number_Of_SRIDs_Found

Número de SRID únicos en el índice y columna. El valor es int.

Dado que una columna puede contener más de un SRID y objetos de SRID diferentes que nunca intersecten, el número de SRID indica la selectividad del índice.

Width_Of_Cell_In_Level1

Propiedad de ancho de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Width_Of_Cell_In_Level2

Propiedad de ancho de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Width_Of_Cell_In_Level3

Propiedad de ancho de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Width_Of_Cell_In_Level4

Propiedad de ancho de la celda en la cuadrícula de indización. La unidad de medida la proporciona el índice y depende del SRID de los datos indizados. El valor es float.

Height_Of_Cell_In_Level1

Propiedad de alto de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Height_Of_Cell_In_Level2

Propiedad de alto de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Height_Of_Cell_In_Level3

Propiedad de alto de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Height_Of_Cell_In_Level4

Propiedad de alto de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Area_Of_Cell_In_Level1

Propiedad de área de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Area_Of_Cell_In_Level2

Propiedad de área de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Area_Of_Cell_In_Level3

Propiedad de área de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

Area_Of_Cell_In_Level4

Propiedad de área de la celda en la cuadrícula de indización. El índice proporciona la unidad de medida y depende del SRID de los datos indexados. El valor es float.

CellArea_To_BoundingBoxArea_Percentage_In_Level1

Porcentaje de cobertura del rectángulo de límite por una celda de nivel 1. El valor es float.

CellArea_To_BoundingBoxArea_Percentage_In_Level2

Porcentaje de cobertura del rectángulo de límite por una celda de nivel 2. El valor es float.

CellArea_To_BoundingBoxArea_Percentage_In_Level3

Porcentaje de cobertura del rectángulo de límite por una celda de nivel 3. El valor es float.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

Porcentaje de cobertura del cuadro de límite por una celda de nivel 4. El valor es float.

Number_Of_Rows_Selected_By_Primary_Filter

Número de filas seleccionadas por el filtro primario. Ésta es una propiedad básica. El valor es bigint.

Number_Of_Rows_Selected_By_Internal_Filter

Número de filas seleccionadas por el filtro interno. No se llama al filtro secundario para estas filas. Ésta es una propiedad básica. El valor es bigint.

El número devuelto solo es aplicable a STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

Número de veces que se llama al filtro secundario. Ésta es una propiedad básica. El valor es bigint.

Percentage_Of_Rows_NotSelected_By_Primary_Filter

Si hay N filas en la tabla base y el filtro primario selecciona P, devuelve (N-P)/N como porcentaje. Ésta es una propiedad básica. El valor es float.

Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter

Si el filtro primario selecciona P filas y el filtro interno selecciona S filas, devuelve S/P como porcentaje. Cuanto mayor es el porcentaje, más eficaz es el índice evitando el filtro secundario con un rendimiento más caro. Ésta es una propiedad básica. El valor es float.

Number_Of_Rows_Output

Número de filas que produce la consulta. Ésta es una propiedad básica. El valor es bigint.

Internal_Filter_Efficiency

Si O es el número de filas de salida, devuelve S/O como porcentaje. Ésta es una propiedad básica. El valor es float.

Primary_Filter_Efficiency

Si el filtro principal selecciona filas P y O es el número de filas de salida, devuelve O/P como porcentaje. Cuanto más eficaz es el filtro primario, menos falsos positivos tiene que procesar el filtro secundario. Ésta es una propiedad básica. El valor es float.

Permisos

El usuario debe ser miembro del rol público . Requiere el permiso READ ACCESS en el servidor y el objeto. Esto se aplica a todos los procedimientos almacenados de índice espacial.

Comentarios

Las propiedades que contienen NULL valores no se incluyen en el conjunto de valor devuelto.

Ejemplos

Consulte algunos ejemplos en los artículos siguientes:

Contenido relacionado