Procedimentos armazenados de índice espacial – argumentos e propriedades

  • Artigo

Aplica-se a:SQL Server

Este artigo descreve os argumentos e as propriedades para procedimentos armazenados de índice espacial.

Convenções de sintaxe de Transact-SQL

Syntax

Para obter a sintaxe de procedimentos armazenados de índice espacial específicos, consulte os seguintes artigos:

Argumentos

[ @tabname = ] N'tabname'

O nome qualificado ou não qualificado da tabela para a qual o índice espacial foi especificado.

As aspas somente serão requeridas se uma tabela qualificada for especificada. Se um nome completamente qualificado, incluindo um nome de banco de dados, for fornecido, o nome do banco de dados deverá ser o nome do banco de dados atual. @tabname é nvarchar(776), sem padrão.

[ @indexname = ] 'indexname'

O nome do índice espacial especificado. @indexname é sysname sem padrão.

[ @verboseoutput = ] verboseoutput

O intervalo de nomes de propriedade e valores a serem retornados.

  • 0 = propriedades principais
  • >0 = todas as propriedades

@verboseoutput é tinyint sem padrão.

[ @query_sample = ] 'query_sample'

Um exemplo de consulta representativa que pode ser usado para testar a utilidade do índice. Pode ser um objeto representativo ou uma janela de consulta. query_sample é geometria sem padrão.

[ @xml_output = ] 'xml_output'

Um parâmetro de saída que retorna o conjunto de resultados em um fragmento XML. xml_output é xml sem padrão.

Propriedades

Defina @verboseoutput = 0 para retornar propriedades principais, conforme mostrado na tabela a seguir, ou @verboseoutput > 0 para retornar todas as propriedades do índice espacial.

Base_Table_Rows

O número de linhas da tabela base. O valor é bigint.

Bounding_Box_xmin

Propriedades da caixa delimitadora mínima X do índice espacial para o tipo de geometria . Esse valor de propriedade é NULL para o tipo geography . O valor é float.

Bounding_Box_ymin

Propriedades da caixa delimitadora mínima Y do índice espacial para o tipo de geometria . Esse valor de propriedade é NULL para o tipo geography . O valor é float.

Bounding_Box_xmax

Propriedades da caixa delimitadora máxima X do índice espacial para o tipo de geometria . Esse valor de propriedade é NULL para o tipo geography . O valor é float.

Bounding_Box_ymax

Y-maximum bounding box properties of the spatial index for geometry type. Esse valor de propriedade é NULL para o tipo geography . O valor é float.

Grid_Size_Level_1

Densidade de grade de nível 1 do índice espacial:

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

O valor é int.

Grid_Size_Level_2

Densidade de grade de nível 2 do índice espacial:

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

O valor é int.

Grid_Size_Level_3

Densidade de grade de nível 3 do índice espacial:

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

O valor é int.

Grid_Size_Level_4

Densidade da grade Nível 4 do índice espacial:

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

O valor é int.

Cells_Per_Object

Número de células por objeto (propriedade de índice). O valor é int.

Total_Primary_Index_Rows

O número de linhas no índice. O valor é bigint.

Total_Primary_Index_Pages

O número de páginas no índice. O valor é bigint.

Average_Number_Of_Index_Rows_Per_Base_Row

O número de linhas do índice/linhas da tabela base. O valor é bigint.

Total_Number_Of_ObjectCells_In_Level0_For_QuerySample

Indica se o exemplo de consulta representativa está fora da caixa delimitadora do índice de geometria e na célula raiz (célula de nível 0). Este é 0 (não em célula de nível 0) ou 1. Se estiver na célula de nível 0, o índice investigado não será um índice apropriado para o exemplo de consulta. Esta é uma propriedade principal. O valor é bigint.

Total_Number_Of_ObjectCells_In_Level0_In_Index

Número de instâncias de célula de objetos indexados que são mosaicados no nível 0 (célula raiz, fora da caixa delimitadora para geometria). Esta é uma propriedade principal. O valor é bigint.

Para índices de geometria , isso ocorrerá se a caixa delimitadora do índice for menor que o domínio de dados. Um alto número de objetos no nível 0 poderá exigir filtros secundários se a janela de consulta ficar parcialmente fora da caixa delimitadora e diminuir o desempenho do índice (por exemplo, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample for 1). Se a janela de consulta estiver dentro da caixa delimitadora, um número elevado de objetos no nível 0 pode melhorar o desempenho do índice.

As instâncias NULA e vazias são contadas no nível 0, mas não afetam o desempenho. O nível 0 tem tantas células quanto NULL e instâncias vazias na tabela base. Para índices geography , o nível 0 tem tantas células quanto NULL e instâncias vazias +1 célula, pois a amostra de consulta é contada como 1.

Total_Number_Of_ObjectCells_In_Level1_In_Index

Número de instâncias de célula de objetos indexados que são mosaico com precisão de nível 1. Esta é uma propriedade principal. O valor é bigint.

Total_Number_Of_ObjectCells_In_Level2_In_Index

Número de instâncias de célula de objetos indexados que são mosaico com precisão de nível 2. Esta é uma propriedade principal. O valor é bigint.

Total_Number_Of_ObjectCells_In_Level3_In_Index

Número de instâncias de célula de objetos indexados que são mosaico com precisão de nível 3. Esta é uma propriedade principal. O valor é bigint.

Total_Number_Of_ObjectCells_In_Level4_In_Index

O número de instâncias de célula de objetos indexados que são incluídas em mosaicos com previsão de nível 4. Esta é uma propriedade principal. O valor é bigint.

Total_Number_Of_interior_ObjectCells_In_Level1_In_Index

Número de células que são completamente cobertas por um objeto no nível de mosaico 1 e, portanto, são interiores para o objeto. (Cell_attributevalue é 2.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_interior_ObjectCells_In_Level2_In_Index

Número de células que são completamente cobertas por um objeto no nível de mosaico 2 e, portanto, são interiores do objeto. (Cell_attribute valor é 2.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_interior_ObjectCells_In_Level3_In_Index

Número de células que são completamente cobertas por um objeto no nível de mosaico 3 e, portanto, são interiores para o objeto. (Cell_attribute valor é 2.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_interior_ObjectCells_In_Level4_In_Index

O número de células que são completamente abrangidas por um objeto em um mosaico de nível 4 e, portanto, fazem parte do objeto. (Cell_attribute valor é 2.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

Número de células que são interseccionadas por um objeto no nível de mosaico 1. (Cell_attribute valor é 1.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

Número de células que são interseccionadas por um objeto no nível de mosaico 2. (Cell_attribute valor é 1.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Número de células que são interseccionadas por um objeto no nível de mosaico 3. (Cell_attribute valor é 1.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Número de células que são intersectadas por um objeto no mosaico de nível 4. (Cell_attribute valor é 1.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample

Indica se o exemplo de consulta está na célula raiz 0 fora da caixa delimitadora, mas tocando-a. Esta é uma propriedade principal. O valor é bigint.

Observação

Esta informações é útil apenas ao determinar se há objetos que a caixa delimitadora pode ter ignorado.

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

Número de objetos em nível 0 que ticam a caixa delimitadora. (Cell_attribute valor é 0.) O valor é bigint.

Total_Number_Of_Border_ObjectCells_In_Level1_In_Index

Número de células de objeto que tocam um limite de célula de grade no nível de mosaico 1. (Cell_attribute valor é 0.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_Border_ObjectCells_In_Level2_In_Index

Número de células de objeto que tocam um limite de célula de grade no nível de mosaico 2. (Cell_attribute valor é 0.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_Border_ObjectCells_In_Level3_In_Index

Número de células de objeto que tocam um limite de célula de grade no nível de mosaico 3. (Cell_attribute valor é 0.) Essa é uma propriedade principal. O valor é bigint.

Total_Number_Of_Border_ObjectCells_In_Level4_In_Index

Número de células de objeto que tocam um limite de célula de grade no mosaico nível 4. (Cell_attribute valor é 0.) Essa é uma propriedade principal. O valor é bigint.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Percentual da área total (células folha totais) da grade que contém células folha cobertas por um objeto .

Por exemplo, um objeto é mosaico em 10 células nos quatro níveis de grade diferentes que abrangem uma área equivalente a 100 células folhas no total. Suponha que haja três células internas completamente cobertas pelo objeto . A área coberta pelas três células internas é equivalente a 42 células folha. Assim, a porcentagem de área coberta é 42 por cento. Esse é um bom exemplo de quão bem os objetos estão fragmentados no índice.

O valor é float.

Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

O mesmo que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, exceto que são células parcialmente cobertas. O valor é float.

Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

O mesmo que Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage , exceto que são células de borda. O valor é float.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Células comuns por objeto normalizado na grade da folha. Isso nos dá uma indicação do tamanho espacial do objeto ou do tamanho dos objetos. O valor é float.

Average_Objects_PerLeaf_GridCell

Dispersão do índice. Número médio de objetos por célula folha. O valor é float.

Number_Of_SRIDs_Found

O número de SRIDs exclusivo no índice e na coluna. O valor é int.

Como uma coluna pode conter mais de um SRID e os objetos de SRIDs diferentes nunca cruzam, o número de SRIDs indicam a seletividade do índice.

Width_Of_Cell_In_Level1

Propriedade de largura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Width_Of_Cell_In_Level2

Propriedade de largura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Width_Of_Cell_In_Level3

Propriedade de largura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Width_Of_Cell_In_Level4

Propriedade de largura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende do SRID dos dados indexados. O valor é float.

Height_Of_Cell_In_Level1

Propriedade de altura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Height_Of_Cell_In_Level2

Propriedade de altura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Height_Of_Cell_In_Level3

Propriedade de altura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Height_Of_Cell_In_Level4

Propriedade de altura da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Area_Of_Cell_In_Level1

Propriedade de área da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Area_Of_Cell_In_Level2

Propriedade de área da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Area_Of_Cell_In_Level3

Propriedade de área da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

Area_Of_Cell_In_Level4

Propriedade de área da célula na grade de indexação. A unidade de medida é fornecida pelo índice e depende no SRID dos dados indexados. O valor é float.

CellArea_To_BoundingBoxArea_Percentage_In_Level1

O percentual de cobertura da caixa delimitadora por uma célula de nível 1. O valor é float.

CellArea_To_BoundingBoxArea_Percentage_In_Level2

O percentual de cobertura da caixa delimitadora por uma célula de nível 2. O valor é float.

CellArea_To_BoundingBoxArea_Percentage_In_Level3

O percentual de cobertura da caixa delimitadora por uma célula de nível 3. O valor é float.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

A porcentagem de cobertura da caixa delimitadora por uma célula de nível 4. O valor é float.

Number_Of_Rows_Selected_By_Primary_Filter

O número de linhas selecionadas pelo filtro primário. Esta é uma propriedade principal. O valor é bigint.

Number_Of_Rows_Selected_By_Internal_Filter

O número de linhas selecionadas pelo filtro interno. O filtro secundário não é chamado para essas linhas. Esta é uma propriedade principal. O valor é bigint.

O número retornado só é aplicável a STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

O número de vezes que o filtro secundário é chamado. Esta é uma propriedade principal. O valor é bigint.

Percentage_Of_Rows_NotSelected_By_Primary_Filter

Se houver linhas N na tabela base e P forem selecionados pelo filtro primário, (N-P)/N será retornado como porcentagem. Esta é uma propriedade principal. O valor é float.

Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter

Se linhas P estiverem selecionadas pelo filtro primário e linhas S estiverem selecionadas pelo filtro interno, S/P será retornado como porcentagem. Quando mais alta for a porcentagem, melhor será o índice ao evitar o filtro secundário com desempenho mais caro. Esta é uma propriedade principal. O valor é float.

Number_Of_Rows_Output

O número de saída de linhas produzido pela consulta. Esta é uma propriedade principal. O valor é bigint.

Internal_Filter_Efficiency

Se O for o número de saída de linhas, S/O será retornado como uma porcentagem. Esta é uma propriedade principal. O valor é float.

Primary_Filter_Efficiency

Se as linhas P forem selecionadas pelo filtro primário e O for o número de saídas de linhas, isso retornaráO/P como uma porcentagem. Quanto mais alta for a eficiência do filtro primário, menores serão os positivos falsos que o filtro secundário terá que processar. Esta é uma propriedade principal. O valor é float.

Permissões

O usuário deve ser membro da função pública . Requer permissão READ ACCESS no servidor e no objeto. Isto se aplica a procedimentos armazenados de índice espacial.

Comentários

As propriedades que contêm valores NULL não estão incluídas no conjunto de retorno.

Exemplos

Para exemplos, confira os seguintes artigos:

Confira também