Argomenti e proprietà delle stored procedure relative agli indici spaziali

In questo argomento vengono descritti gli argomenti e le proprietà per le stored procedure relative agli indici spaziali.

Convenzioni della sintassi Transact-SQL

Sintassi

Per la sintassi di stored procedure relative agli indici spaziali specifiche, vedere gli argomenti seguenti:

• sp_help_spatial_geometry_index (Transact-SQL)

• sp_help_spatial_geometry_index_xml (Transact-SQL)

• sp_help_spatial_geography_index (Transact-SQL)

• sp_help_spatial_geography_index_xml (Transact-SQL)

Argomenti

• [ @tabname =] 'tabname'
  Nome qualificato o non qualificato della tabella per cui è stato specificato l'indice spaziale.

  Le virgolette sono necessarie solo se viene specificata una tabella qualificata. Nel caso di un nome completo, ovvero contenente un nome di database, il nome del database deve corrispondere a quello del database corrente. tabname è di tipo nvarchar(776) e non prevede alcun valore predefinito.

• [ @indexname = ] 'indexname'
  Nome dell'indice spaziale specificato. indexname è di tipo sysname e non prevede alcun valore predefinito.

• [ @verboseoutput = ] 'verboseoutput'
  Intervallo di nomi e valori delle proprietà da restituire.

  0 = proprietà principali

  >0 = tutte le proprietà

  verboseoutput è di tipo tinyint e non prevede alcun valore predefinito.

• [ @query_sample = ] 'query_sample'
  Campione rappresentativo di query che può essere utilizzato per valutare l'utilità dell'indice. Tale campione può essere un oggetto rappresentativo o una finestra Query. query_sample è di tipo geometry e non prevede alcun valore predefinito.

• [ @xml_output = ] 'xml_output'
  Parametro di output tramite cui viene restituito il set di risultati in un frammento XML. xml_output è di tipo xml e non prevede alcun valore predefinito.

Proprietà

Impostare @verboseoutput = 0 per restituire le proprietà principali come illustrato nella tabella sottostante. Impostare @verboseoutput > 0 per restituire tutte le proprietà dell'indice spaziale.

• Base_Table_Rows
  Numero di righe nella tabella di base. Valore di tipo bigint.

• Bounding_Box_xmin
  Proprietà relative al valore minimo della coordinata X del riquadro dell'indice spaziale per il tipo geometry. Il valore di questa proprietà per il tipo geography è NULL. Valore di tipo float.

• Bounding_Box_ymin
  Proprietà relative al valore minimo della coordinata Y del riquadro dell'indice spaziale per il tipo geometry. Il valore di questa proprietà per il tipo geography è NULL. Valore di tipo float.

• Bounding_Box_xmax
  Proprietà relative al valore massimo della coordinata X del riquadro dell'indice spaziale per il tipo geometry. Il valore di questa proprietà per il tipo geography è NULL. Valore di tipo float.

• Bounding_Box_ymax
  Proprietà relative al valore massimo della coordinata Y del riquadro dell'indice spaziale per il tipo geometry. Il valore di questa proprietà per il tipo geography è NULL. Valore di tipo float.

• Grid_Size_Level_1
  Densità della griglia di livello 1 dell'indice spaziale:

  16 per LOW

  64 per MEDIUM

  256 per HIGH

  Valore di tipo int.

• Grid_Size_Level_2
  Densità della griglia di livello 2 dell'indice spaziale:

  16 per LOW

  64 per MEDIUM

  256 per HIGH

  Valore di tipo int.

• Grid_Size_Level_3
  Densità della griglia di livello 3 dell'indice spaziale:

  16 per LOW

  64 per MEDIUM

  256 per HIGH

  Valore di tipo int.

• Grid_Size_Level_4
  Densità della griglia di livello 4 dell'indice spaziale:

  16 per LOW

  64 per MEDIUM

  256 per HIGH

  Valore di tipo int.

• Cells_Per_Object
  Numero di celle per oggetto (proprietà dell'indice). Valore di tipo int.

• Total_Primary_Index_Rows
  Numero di righe nell'indice. Valore di tipo bigint.

• Total_Primary_Index_Pages
  Numero di pagine nell'indice. Valore di tipo bigint.

• Average_Number_Of_Index_Rows_Per_Base_Row
  Rapporto tra il numero di righe dell'indice e il numero di righe della tabella di base. Valore di tipo bigint.

• Total_Number_Of_ObjectCells_In_Level0_For_QuerySample
  Indica se il campione rappresentativo di query è esterno al riquadro dell'indice geometry e interno alla cella radice (cella di livello 0). Il valore può essere 0 (campione esterno alla cella di livello 0) oppure 1. Se il campione di query è interno alla cella di livello 0, l'indice controllato non è appropriato. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_ObjectCells_In_Level0_In_Index
  Numero di istanze della cella di oggetti indicizzati suddivisi a mosaico a livello 0 (cella radice, all'esterno del riquadro per geometry). Si tratta di una proprietà principale. Valore di tipo bigint.

  Per gli indici geometry, questa situazione si verificherà se il riquadro dell'indice è minore del dominio dati. Se il numero di oggetti presenti a livello 0 è elevato, può essere necessario utilizzare filtri secondari se la finestra Query è parzialmente esterna al riquadro con la conseguente riduzione delle prestazioni dell'indice (ad esempio il valore di Total_Number_Of_ObjectCells_In_Level0_For_QuerySample è 1). Se la finestra Query è interna al riquadro, un numero elevato di oggetti presenti a livello 0 può migliorare effettivamente le prestazioni dell'indice.

  Le istanze NULL e vuote vengono conteggiate a livello 0, ma non avranno alcun impatto sulle prestazioni. A livello 0 sarà presente un numero di celle pari a quello delle istanze NULL e vuote nella tabella di base. Per gli indici geography, a livello 0 sarà presente un numero di celle pari a quello delle istanze NULL e vuote aumentato di uno, poiché il campione di query viene conteggiato come 1.

• Total_Number_Of_ObjectCells_In_Level1_In_Index
  Numero di istanze della cella di oggetti indicizzati suddivisi a mosaico con precisione di livello 1. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_ObjectCells_In_Level2_In_Index
  Numero di istanze della cella di oggetti indicizzati suddivisi a mosaico con precisione di livello 2. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_ObjectCells_In_Level3_In_Index
  Numero di istanze della cella di oggetti indicizzati suddivisi a mosaico con precisione di livello 3. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_ObjectCells_In_Level4_In_Index
  Numero di istanze della cella di oggetti indicizzati suddivisi a mosaico con precisione di livello 4. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_interior_ObjectCells_In_Level1_In_Index
  Numero di celle completamente coperte da un oggetto a livello 1 del mosaico e di conseguenza interne all'oggetto. Il valore di Cell_attribute è 2. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_interior_ObjectCells_In_Level2_In_Index
  Numero di celle completamente coperte da un oggetto a livello 2 del mosaico e di conseguenza interne all'oggetto. Il valore di Cell_attribute è 2. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_interior_ObjectCells_In_Level3_In_Index
  Numero di celle completamente coperte da un oggetto a livello 3 del mosaico 3 e di conseguenza interne all'oggetto. Il valore di Cell_attribute è 2. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_interior_ObjectCells_In_Level4_In_Index
  Numero di celle completamente coperte da un oggetto a livello 4 del mosaico e di conseguenza interne all'oggetto. Il valore di Cell_attribute è 2. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index
  Numero di celle intersecate da un oggetto a livello 1 del mosaico. Il valore di Cell_attribute è 1. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index
  Numero di celle intersecate da un oggetto a livello 2 del mosaico. Il valore di Cell_attribute è 1. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index
  Numero di celle intersecate da un oggetto a livello 3 del mosaico. Il valore di Cell_attribute è 1. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index
  Numero di celle intersecate da un oggetto a livello 4 del mosaico. Il valore di Cell_attribute è 1. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample
  Indica se il campione di query si trova nella cella radice 0 esterna al riquadro, ma contigua a esso. Si tratta di una proprietà principale. Valore di tipo bigint.

  [!NOTA]

  Questa informazione è utile solo per determinare se vi sono oggetti eventualmente mancanti nel riquadro.

• Total_Number_Of_Border_ObjectCells_In_Level0_In_Index
  Numero di oggetti a livello 0 contigui al riquadro. Il valore di Cell_attribute è 0. Valore di tipo bigint.

• Total_Number_Of_Border_ObjectCells_In_Level1_In_Index
  Numero di celle dell'oggetto contigue al limite di una cella della griglia a livello 1 del mosaico. Il valore di Cell_attribute è 0. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_Border_ObjectCells_In_Level2_In_Index
  Numero di celle dell'oggetto contigue a un limite della cella della griglia a livello 2 del mosaico. Il valore di Cell_attribute è 0. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_Border_ObjectCells_In_Level3_In_Index
  Numero di celle dell'oggetto contigue a un limite della cella della griglia a livello 3 del mosaico. Il valore di Cell_attribute è 0. Si tratta di una proprietà principale. Valore di tipo bigint.

• Total_Number_Of_Border_ObjectCells_In_Level4_In_Index
  Numero di celle dell'oggetto contigue a un limite della cella della griglia a livello 4 del mosaico. Il valore di Cell_attribute è 0. Si tratta di una proprietà principale. Valore di tipo bigint.

• Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
  Percentuale dell'area totale (celle foglia totali) della griglia in cui sono contenute celle foglia coperte da un oggetto.

  Si supponga che un oggetto sia suddiviso a mosaico in 10 celle a 4 livelli della griglia diversi coprendo un'area equivalente a 100 celle foglia totali e che siano presenti 3 celle interne completamente coperte dall'oggetto. L'area coperta dalle 3 celle interne è equivalente a 42 celle foglia. Di conseguenza, la percentuale di area coperta è 42%. Tale valore rappresenta una misura efficace del livello di suddivisione degli oggetti nell'indice.

  Valore di tipo float.

• Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
  Proprietà analoga a Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, con la differenza che in questo caso vengono considerate le celle parzialmente coperte. Valore di tipo float.

• Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage
  Proprietà analoga a Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, con la differenza che in questo caso vengono considerate le celle sul bordo. Valore di tipo float.

• Average_Cells_Per_Object_Normalized_To_Leaf_Grid
  Numero medio di celle per oggetto normalizzato rispetto alla griglia foglia. Indica le dimensioni spaziali dell'oggetto o le dimensioni degli oggetti. Valore di tipo float.

• Average_Objects_PerLeaf_GridCell
  Livello di distribuzione dell'indice. Numero medio di oggetti per cella foglia. Valore di tipo float.

• Number_Of_SRIDs_Found
  Numero di identificatori SRID univoci presenti nell'indice e nella colonna. Valore di tipo int.

  Poiché una colonna può contenere più di un identificatore SRID e gli oggetti con identificatori SRID diversi non si intersecano mai, il numero di identificatori SRID indica la selettività dell'indice.

• Width_Of_Cell_In_Level1
  Proprietà relativa alla larghezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Width_Of_Cell_In_Level2
  Proprietà relativa alla larghezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Width_Of_Cell_In_Level3
  Proprietà relativa alla larghezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Width_Of_Cell_In_Level4
  Proprietà relativa alla larghezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Height_Of_Cell_In_Level1
  Proprietà relativa all'altezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Height_Of_Cell_In_Level2
  Proprietà relativa all'altezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Height_Of_Cell_In_Level3
  Proprietà relativa all'altezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Height_Of_Cell_In_Level4
  Proprietà relativa all'altezza della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Area_Of_Cell_In_Level1
  Proprietà relativa all'area della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Area_Of_Cell_In_Level2
  Proprietà relativa all'area della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Area_Of_Cell_In_Level3
  Proprietà relativa all'area della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• Area_Of_Cell_In_Level4
  Proprietà relativa all'area della cella nella griglia di indicizzazione. L'unità di misura viene specificata dall'indice e dipende dall'identificatore SRID dei dati indicizzati. Valore di tipo float.

• CellArea_To_BoundingBoxArea_Percentage_In_Level1
  Percentuale di copertura del riquadro da una cella di livello 1. Valore di tipo float.

• CellArea_To_BoundingBoxArea_Percentage_In_Level2
  Percentuale di copertura del riquadro da una cella di livello 2. Valore di tipo float.

• CellArea_To_BoundingBoxArea_Percentage_In_Level3
  Percentuale di copertura del riquadro da una cella di livello 3. Valore di tipo float.

• CellArea_To_BoundingBoxArea_Percentage_In_Level4
  Percentuale di copertura del riquadro da una cella di livello 4. Valore di tipo float.

• Number_Of_Rows_Selected_By_Primary_Filter
  Numero di righe selezionate dal filtro primario. Si tratta di una proprietà principale. Valore di tipo bigint.

• Number_Of_Rows_Selected_By_Internal_Filter
  Numero di righe selezionate dal filtro interno. Per queste righe il filtro secondario non viene utilizzato. Si tratta di una proprietà principale. Valore di tipo bigint.

  Il numero restituito è applicabile solo a STintersects.

• Number_Of_Times_Secondary_Filter_Is_Called
  Numero di volte in cui viene utilizzato il filtro secondario. Si tratta di una proprietà principale. Valore di tipo bigint.

• Percentage_Of_Rows_NotSelected_By_Primary_Filter
  Se nella tabella di base sono presenti N righe e se P è il numero di righe selezionate dal filtro primario, questa proprietà restituisce il valore (N-P)/N come percentuale. Si tratta di una proprietà principale. Valore di tipo float.

• Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter
  Se P è il numero di righe selezionate dal filtro primario, mentre S è quello delle righe selezionate dal filtro interno, questa proprietà restituisce il valore S/P come percentuale. Maggiore è la percentuale, migliore è il livello di efficacia dell'indice nell'evitare il filtro secondario più costoso in termini di prestazioni. Si tratta di una proprietà principale. Valore di tipo float.

• Number_Of_Rows_Output
  Numero di righe di output dalla query. Si tratta di una proprietà principale. Valore di tipo bigint.

• Internal_Filter_Efficiency
  Se O è il numero di righe di output, questa proprietà restituisce il valore S/O come percentuale. Si tratta di una proprietà principale. Valore di tipo float.

• Primary_Filter_Efficiency
  Se P è il numero di righe selezionate dal filtro primario e O è il numero di righe di output, questa proprietà restituisce il valore O/P come percentuale. Maggiore è l'efficienza dell'indice principale, minore è il numero di falsi positivi che il filtro secondario deve elaborare. Si tratta di una proprietà principale. Valore di tipo float.

Autorizzazioni

L'utente deve essere un membro del ruolo public. È necessario disporre dell'autorizzazione READ ACCESS per il server e l'oggetto. Queste condizioni si applicano a tutte le stored procedure relative agli indici spaziali.

Osservazioni

Le proprietà che contengono valori NULL non sono incluse nel set restituito.

Esempi

Per gli esempi, vedere gli argomenti seguenti:

• sp_help_spatial_geometry_index (Transact-SQL)

• sp_help_spatial_geometry_index_xml (Transact-SQL)

• sp_help_spatial_geography_index (Transact-SQL)

• sp_help_spatial_geography_index_xml (Transact-SQL)

Vedere anche

Riferimento

sp_help_spatial_geometry_index (Transact-SQL)

Concetti

Panoramica degli indici spaziali

Altre risorse

Stored procedure relative agli indici spaziali (Transact-SQL)

Nozioni fondamentali su XQuery

Riferimento al linguaggio XQuery (SQL Server)