Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se documentan los argumentos y propiedades de los procedimientos almacenados de índice espacial.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
Para obtener la sintaxis específica de los procedimientos almacenados de índice espacial, consulte los temas siguientes:
Argumentos
[ @tabname =] 'tabname'
Es el nombre completo o incompleto 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 de tipo nvarchar(776) y no tiene ningún valor predeterminado.
[ @indexname = ] 'indexname'
Es el nombre del índice espacial especificado. indexname es de tipo sysname y no tiene ningún valor predeterminado.[ @verboseoutput = ] 'verboseoutput'
Es el intervalo de nombres de propiedad y valores que se van a devolver.0 = propiedades básicas
>0 = todas las propiedades
verboseoutput es de tipo tinyint y no tiene ningún valor predeterminado.
[ @query_sample = ] 'query_sample'
Es un ejemplo de consulta representativo que se puede utilizar para probar la utilidad del índice. Puede ser un objeto representativo o una ventana de consulta. query_sample es de tipo geometry y no tiene ningún valor predeterminado.[ @xml_output = ] 'xml_output'
Es un parámetro de salida que devuelve el conjunto de resultados de un fragmento XML. xml_output es de tipo xml y no tiene ningún valor predeterminado.
Propiedades
Establezca @verboseoutput = 0 para devolver las propiedades básicas como se muestra en la tabla siguiente; @verboseoutput > 0 para devolver todas las propiedades del índice espacial.
Base_Table_Rows
Número de filas de la tabla base. El valor es de tipo bigint.Bounding_Box_xmin
Propiedades de cuadro de límite X mínimo del índice espacial para el tipo geometry. El valor de esta propiedad es NULL para el tipo geography. El valor es de tipo float.Bounding_Box_ymin
Propiedades de cuadro de límite Y mínimo del índice espacial para el tipo geometry. El valor de esta propiedad es NULL para el tipo geography. El valor es de tipo float.Bounding_Box_xmax
Propiedades de cuadro de límite X máximo del índice espacial para el tipo geometry. El valor de esta propiedad es NULL para el tipo geography. El valor es de tipo float.Bounding_Box_ymax
Propiedades de cuadro de límite Y máximo del índice espacial para el tipo geometry. El valor de esta propiedad es NULL para el tipo geography. El valor es de tipo float.Grid_Size_Level_1
Densidad de la cuadrícula de nivel 1 del índice espacial:16 para LOW
64 para MEDIUM
256 para HIGH
El valor es de tipo int.
Grid_Size_Level_2
Densidad de la cuadrícula de nivel 2 del índice espacial:16 para LOW
64 para MEDIUM
256 para HIGH
El valor es de tipo int.
Grid_Size_Level_3
Densidad de la cuadrícula de nivel 3 del índice espacial:16 para LOW
64 para MEDIUM
256 para HIGH
El valor es de tipo 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 de tipo int.
Cells_Per_Object
Número de celdas por cada objeto (propiedad de índice). El valor es de tipo int.Total_Primary_Index_Rows
Número de filas del índice. El valor es de tipo bigint.Total_Primary_Index_Pages
Número de páginas del índice. El valor es de tipo 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 de tipo bigint.Total_Number_Of_ObjectCells_In_Level0_For_QuerySample
Indica si el ejemplo de consulta representativo no entra dentro del cuadro de límite del índice geometry 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 adecuado para el ejemplo de consulta. Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_ObjectCells_In_Level0_In_Index
Número de celdas de objetos indizados que se teselan en el nivel 0 (celda raíz, fuera del cuadro de límite para geometry). Ésta es una propiedad básica. El valor es de tipo bigint.Para los índices geometry, esto ocurrirá si el cuadro de límite del índice es menor que el dominio de los datos. Un número alto de objetos de nivel 0 puede hacer que se requieran filtros secundarios si la ventana de consulta sale fuera parcialmente del cuadro de límite y va a disminuir el rendimiento del índice (por ejemplo, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample es 1). Si la ventana de consulta cae dentro del cuadro de límite, un número alto de objetos en el nivel 0 puede mejorar realmente el rendimiento del índice.
NULL y las instancias vacías se contabilizan en el nivel 0 pero no afectarán al rendimiento. El nivel 0 tendrá tantas celdas como NULL y las instancias vacías en la tabla base. Con los índices geography, el nivel 0 tendrá tantas celdas como NULL y las instancias vacías +1 celda, porque el ejemplo de consulta se cuenta como 1.
Total_Number_Of_ObjectCells_In_Level1_In_Index
Número de instancias de celdas de objetos indizados que se teselan con precisión de nivel 1. Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_ObjectCells_In_Level2_In_Index
Número de instancias de celdas de objetos indizados que se teselan con precisión de nivel 2. Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_ObjectCells_In_Level3_In_Index
Número de instancias de celdas de objetos indizados que se teselan con precisión de nivel 3. Ésta es una propiedad básica. El valor es de tipo 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 de tipo bigint.Total_Number_Of_interior_ObjectCells_In_Level1_In_Index
Número de celdas que están cubiertas completamente por un objeto en el nivel 1 de teselación y, por lo tanto, son interiores al objeto. (El valor de Cell_attribute es 2). Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_interior_ObjectCells_In_Level2_In_Index
Número de celdas que están cubiertas completamente por un objeto en el nivel 2 de teselación y, por lo tanto, son interiores al objeto. (El valor de Cell_attribute es 2). Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_interior_ObjectCells_In_Level3_In_Index
Número de celdas que están cubiertas completamente por un objeto en el nivel 3 de teselación y, por lo tanto, son interiores al objeto. (El valor de Cell_attribute es 2). Ésta es una propiedad básica. El valor es de tipo 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. (El valor de Cell_attribute es 2). Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index
Número de celdas que intersecta un objeto en el nivel 1 de teselación. (El valor de Cell_attribute es 1). Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index
Número de celdas que intersecta un objeto en el nivel 2 de teselación. (El valor de Cell_attribute es 1). Ésta es una propiedad básica. El valor es de tipo bigint.Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index
Número de celdas que intersecta un objeto en el nivel 3 de teselación. (El valor de Cell_attribute es 1). Ésta es una propiedad básica. El valor es de tipo 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. (El valor de Cell_attribute es 1). Ésta es una propiedad básica. El valor es de tipo 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 de tipo bigint.[!NOTA]
Esta información solo es útil para determinar si hay objetos que el cuadro de límite pueda echar mucho en falta.
Total_Number_Of_Border_ObjectCells_In_Level0_In_Index
El número de objetos del nivel 0 que tocan al cuadro de límite. (El valor de Cell_attribute es 0). El valor es de tipo 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 1 de teselación. (El valor de Cell_attribute es 0). Ésta es una propiedad básica. El valor es de tipo 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 2 de teselación. (El valor de Cell_attribute es 0). Ésta es una propiedad básica. El valor es de tipo 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 3 de teselación. (El valor de Cell_attribute es 0). Ésta es una propiedad básica. El valor es de tipo 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. (El valor de Cell_attribute es 0). Ésta es una propiedad básica. El valor es de tipo bigint.Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
Porcentaje del área total (celdas hoja totales) de la cuadrícula que contienen celdas hoja cubiertas por un objeto.Por ejemplo, un objeto está teselado en 10 celdas en los 4 niveles de cuadrícula diferentes que abarcan un área que es equivalente a 100 celdas hoja en total. Suponga que hay 3 celdas interiores que están completamente cubiertas por el objeto. El área cubierta por las 3 celdas interiores es equivalente a 42 celdas 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 de tipo float.
Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
Igual que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, solo que estas son celdas cubiertas parcialmente. El valor es de tipo float.Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
Igual que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, solo que estas son celdas de borde. El valor es de tipo float.Average_Cells_Per_Object_Normalized_To_Leaf_Grid
Promedio de celdas por objeto normalizadas en la cuadrícula hoja. Nos da una indicación del tamaño espacial del objeto o de la magnitud de los objetos. El valor es de tipo float.Average_Objects_PerLeaf_GridCell
Grado de dispersión del índice. Número promedio de objetos por cada celda hoja. El valor es de tipo float.Number_Of_SRIDs_Found
Número de SRID únicos en el índice y columna. El valor es de tipo 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. La unidad de medida la proporciona el índice y depende del SRID de los datos indizados. El valor es de tipo float.Width_Of_Cell_In_Level2
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 de tipo float.Width_Of_Cell_In_Level3
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 de tipo 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 de tipo float.Height_Of_Cell_In_Level1
Propiedad de alto 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 de tipo float.Height_Of_Cell_In_Level2
Propiedad de alto 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 de tipo float.Height_Of_Cell_In_Level3
Propiedad de alto 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 de tipo float.Height_Of_Cell_In_Level4
Propiedad de alto 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 de tipo float.Area_Of_Cell_In_Level1
Propiedad de área 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 de tipo float.Area_Of_Cell_In_Level2
Propiedad de área 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 de tipo float.Area_Of_Cell_In_Level3
Propiedad de área 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 de tipo float.Area_Of_Cell_In_Level4
Propiedad de área 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 de tipo float.CellArea_To_BoundingBoxArea_Percentage_In_Level1
Porcentaje de cobertura del cuadro de límite por una celda de nivel 1. El valor es de tipo float.CellArea_To_BoundingBoxArea_Percentage_In_Level2
Porcentaje de cobertura del cuadro de límite por una celda de nivel 2. El valor es de tipo float.CellArea_To_BoundingBoxArea_Percentage_In_Level3
Porcentaje de cobertura del cuadro de límite por una celda de nivel 3. El valor es de tipo float.CellArea_To_BoundingBoxArea_Percentage_In_Level4
Porcentaje de cobertura del cuadro de límite por una celda de nivel 4. El valor es de tipo 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 de tipo 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 de tipo bigint..El número devuelto solo es aplicable para 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 de tipo 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 de tipo 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 de tipo float..Number_Of_Rows_Output
Número de filas que produce la consulta. Ésta es una propiedad básica. El valor es de tipo 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 de tipo float..Primary_Filter_Efficiency
Si el filtro primario selecciona P filas 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 de tipo float..
Permisos
El usuario debe ser miembro del rol public. 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 valores NULL están incluidas en el conjunto que se devuelve.
Ejemplos
Para obtener ejemplos, vea los siguientes temas:
Vea también
Referencia
sp_help_spatial_geometry_index (Transact-SQL)
Conceptos
Información general sobre los índices espaciales
Otros recursos
Procedimientos almacenados de índice espacial (Transact-SQL)