Compartilhar via


Procedimentos armazenados de índice espacial - argumentos e propriedades

Aplica-se a: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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 [ = ] N'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. @verboseoutput é tinyint, sem padrão, e pode ser um desses valores.

  • 0 = propriedades do núcleo
  • >0 = todas as propriedades

@query_sample [ = ] query_sample

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

@xml_output [ = ] SAÍDA N'xml_output'

Retorna o conjunto de resultados em um fragmento XML. @xml_output é um parâmetro OUTPUT do tipo xml.

Propriedades

Defina @verboseoutput = 0 para retornar as 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 X-maximum do índice espacial para o tipo de geometria. Esse valor de propriedade é NULL para o tipo geography . O valor é float.

Bounding_Box_ymax

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

Grid_Size_Level_1

Densidade da 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 da 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 da 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 a amostra 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 tesselados 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 grande número de objetos no nível 0 pode exigir filtros secundários se a janela de consulta estiver parcialmente fora da caixa delimitadora e diminuir o desempenho do índice (por exemplo, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample é 1). Se a janela de consulta estiver dentro da caixa delimitadora, um grande número de objetos no nível 0 poderá realmente melhorar o desempenho do índice.

As instâncias NULL 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 instâncias vazias na tabela base. Para índices geográficos , o nível 0 tem tantas células quanto NULL 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 tesselados 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 tesselados 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 tesselados 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 internas ao objeto. (Cell_attributevalue é 2.) Esta é uma propriedade central. 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 internas ao objeto. (Cell_attribute valor é 2.) Esta é uma propriedade central. 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 internas ao objeto. (Cell_attribute valor é 2.) Esta é uma propriedade central. 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.) Esta é uma propriedade central. O valor é bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

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

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

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

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Número de células que são interceptadas por um objeto no nível de mosaico 3. (Cell_attribute valor é 1.) Esta é uma propriedade central. 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.) Esta é uma propriedade central. 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

Essas informações só são úteis para determinar se há objetos que a caixa delimitadora pode ter perdido por perto.

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.) Esta é uma propriedade central. 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.) Esta é uma propriedade central. 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.) Esta é uma propriedade central. 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.) Esta é uma propriedade central. O valor é bigint.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Porcentagem da área total (total de células folhas) da grade que contém células folha cobertas por um objeto.

Por exemplo, um objeto é tesselado em 10 células nos quatro níveis de grade diferentes, cobrindo uma área equivalente a 100 células folha no total. Suponha que haja três células internas completamente cobertas pelo objeto. A área coberta pelas três células internas equivale a 42 células foliares. 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 estas 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

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

CellArea_To_BoundingBoxArea_Percentage_In_Level2

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

CellArea_To_BoundingBoxArea_Percentage_In_Level3

A porcentagem 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 P linhas forem selecionadas pelo filtro primário e O for o número de linhas de saída, 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 NULL valores não são incluídas no conjunto de retornos.

Exemplos

Para exemplos, confira os seguintes artigos: