Partilhar via

Procedimentos armazenados de índice espacial - argumentos e propriedades

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

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 são necessárias somente se uma tabela qualificada for especificada. Se um nome totalmente 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'nome_índice'

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 é minúsculo, 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

Número de linhas na tabela base. O valor é grande.

Bounding_Box_xmin

Propriedades da caixa delimitadora mínima X do índice espacial para o tipo de geometria . Este valor de propriedade é NULL para o tipo de geografia . O valor é flutuante.

Bounding_Box_ymin

Propriedades da caixa delimitadora mínima em Y do índice espacial para o tipo de geometria . Este valor de propriedade é NULL para o tipo de geografia . O valor é flutuante.

Bounding_Box_xmax

Propriedades da caixa delimitadora máxima X do índice espacial para o tipo de geometria . Este valor de propriedade é NULL para o tipo de geografia . O valor é flutuante.

Bounding_Box_ymax

Propriedades da caixa delimitadora máxima em Y do índice espacial para o tipo de geometria . Este valor de propriedade é NULL para o tipo de geografia . O valor é flutuante.

Grid_Size_Level_1

Densidade da grelha de nível 1 do índice espacial:

  • 16 para BAIXO
  • 64 para MÉDIO
  • 256 para ALTA

O valor é int.

Grid_Size_Level_2

Densidade da grelha de nível 2 do índice espacial:

  • 16 para BAIXO
  • 64 para MÉDIO
  • 256 para ALTA

O valor é int.

Grid_Size_Level_3

Densidade da grelha de nível 3 do índice espacial:

  • 16 para BAIXO
  • 64 para MÉDIO
  • 256 para ALTA

O valor é int.

Grid_Size_Level_4

Densidade da grelha de nível 4 do índice espacial:

  • 16 para BAIXO
  • 64 para MÉDIO
  • 256 para ALTA

O valor é int.

Cells_Per_Object

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

Total_Primary_Index_Rows

Número de linhas no índice. O valor é grande.

Total_Primary_Index_Pages

Número de páginas no índice. O valor é grande.

Average_Number_Of_Index_Rows_Per_Base_Row

Número de linhas de índice / número de linhas da tabela base. O valor é grande.

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). Isto é 0 (não na 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 é grande.

Total_Number_Of_ObjectCells_In_Level0_In_Index

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

Para índices de geometria , isso ocorre se a caixa delimitadora do índice for menor que o domínio de dados. Um alto número de objetos no nível 0 pode 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 é 1). Se a janela de consulta estiver dentro da caixa delimitadora, um alto número de objetos no nível 0 pode 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 e instâncias vazias +1 célula, porque 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 tesseladas com precisão de nível 1. Esta é uma propriedade principal. O valor é grande.

Total_Number_Of_ObjectCells_In_Level2_In_Index

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

Total_Number_Of_ObjectCells_In_Level3_In_Index

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

Total_Number_Of_ObjectCells_In_Level4_In_Index

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

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 tesselação 1 e, portanto, são interiores ao objeto. (Cell_attributevalue é 2.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 2 e, portanto, são interiores ao objeto. (Cell_attribute valor é 2.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 3 e, portanto, são interiores ao objeto. (Cell_attribute valor é 2.) Esta é uma propriedade principal. O valor é grande.

Total_Number_Of_interior_ObjectCells_In_Level4_In_Index

Número de células que são completamente cobertas por um objeto no nível de tesselação 4 e, portanto, são interiores ao objeto. (Cell_attribute valor é 2.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 1. (Cell_attribute valor é 1.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 2. (Cell_attribute valor é 1.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 3. (Cell_attribute valor é 1.) Esta é uma propriedade principal. O valor é grande.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Número de células que são interseccionadas por um objeto no nível de tesselação 4. (Cell_attribute valor é 1.) Esta é uma propriedade principal. O valor é grande.

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 é grande.

Observação

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

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

Número de objetos no nível 0 que tocam na caixa delimitadora. (Cell_attribute valor é 0.) O valor é grande.

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 tesselação 1. (Cell_attribute valor é 0.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 2. (Cell_attribute valor é 0.) Esta é uma propriedade principal. O valor é grande.

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 tesselação 3. (Cell_attribute valor é 0.) Esta é uma propriedade principal. O valor é grande.

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 nível de tesselação 4. (Cell_attribute valor é 0.) Esta é uma propriedade principal. O valor é grande.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

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

Por exemplo, um objeto é tesselado em 10 células nos quatro diferentes níveis de grade cobrindo uma área que é equivalente a 100 células de folha no total. Suponha que existem três células interiores que estão completamente cobertas pelo objeto. A área coberta pelas três células interiores é equivalente a 42 células foliares. Assim, o percentual de área coberta é de 42%. Esta é uma boa medida de quão bem os objetos no índice são triturados.

O valor é flutuante.

Intersecting_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 parcialmente cobertas. O valor é flutuante.

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 é flutuante.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Média de células por objeto normalizada para a grade foliar. Isso nos dá uma indicação do tamanho espacial do objeto, ou quão grandes são os objetos. O valor é flutuante.

Average_Objects_PerLeaf_GridCell

Espantura do índice. Número médio de objetos por célula foliar. O valor é flutuante.

Number_Of_SRIDs_Found

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

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

Width_Of_Cell_In_Level1

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

Width_Of_Cell_In_Level2

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

Width_Of_Cell_In_Level3

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

Width_Of_Cell_In_Level4

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

Height_Of_Cell_In_Level1

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

Height_Of_Cell_In_Level2

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

Height_Of_Cell_In_Level3

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

Height_Of_Cell_In_Level4

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

Area_Of_Cell_In_Level1

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

Area_Of_Cell_In_Level2

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

Area_Of_Cell_In_Level3

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

Area_Of_Cell_In_Level4

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

CellArea_To_BoundingBoxArea_Percentage_In_Level1

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

CellArea_To_BoundingBoxArea_Percentage_In_Level2

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

CellArea_To_BoundingBoxArea_Percentage_In_Level3

A percentagem de cobertura da caixa delimitadora por uma célula de nível 3. O valor é flutuante.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

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

Number_Of_Rows_Selected_By_Primary_Filter

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

Number_Of_Rows_Selected_By_Internal_Filter

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

O número devolvido só é aplicável para STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

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

Percentage_Of_Rows_NotSelected_By_Primary_Filter

Se houver N linhas na tabela base e P for selecionado pelo filtro primário, isso retornará (N-P)/N como porcentagem. Esta é uma propriedade principal. O valor é flutuante.

Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter

Se as linhas P forem selecionadas pelo filtro primário e as linhas S forem selecionadas pelo filtro interno, isso retornará S/P como uma porcentagem. Quanto maior a porcentagem, melhor o índice é para evitar o filtro secundário mais caro de desempenho. Esta é uma propriedade principal. O valor é flutuante.

Number_Of_Rows_Output

Número de linhas saídas pela consulta. Esta é uma propriedade principal. O valor é grande.

Internal_Filter_Efficiency

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

Primary_Filter_Efficiency

Se as linhas P 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 maior a eficiência do filtro primário, menos falsos positivos o filtro secundário tem que processar. Esta é uma propriedade principal. O valor é flutuante.

Permissões

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

Observações

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

Exemplos

Para obter exemplos, consulte os seguintes artigos:

Conteúdo relacionado

  • Last updated on