Condividi tramite


Stored procedure per indici spaziali - argomenti e proprietà

Si applica a: SQL Server

Questo articolo descrive gli argomenti e le proprietà per le stored procedure dell'indice spaziale.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

Per la sintassi di stored procedure di indice spaziale specifiche, vedere gli articoli seguenti:

Argomenti

[ @tabname = ] N'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 è nvarchar(776), senza impostazione predefinita.

[ @indexname = ] N'indexname'

Nome dell'indice spaziale specificato. @indexname è sysname, senza impostazione predefinita.

[ @verboseoutput = ] verboseoutput

Intervallo di nomi e valori delle proprietà da restituire. @verboseoutput è tinyint, senza impostazione predefinita e può essere uno di questi valori.

  • 0 = proprietà principali
  • >0 = tutte le proprietà

[ @query_sample = ] query_sample

Esempio di query rappresentativo che può essere usato per testare l'utilità dell'indice. @query_sample è geography, senza impostazione predefinita. Potrebbe trattarsi di un oggetto rappresentativo o di una finestra di query.

[ @xml_output = ] N'xml_output' OUTPUT

Restituisce il set di risultati in un frammento XML. @xml_output è un parametro OUTPUT di tipo xml.

Proprietà

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

Base_Table_Rows

Numero di righe nella tabella di base. Il valore è bigint.

Bounding_Box_xmin

Proprietà del rettangolo di selezione minimo X dell'indice spaziale per il tipo geometry . Questo valore della proprietà è NULL per il tipo geography . Il valore è float.

Bounding_Box_ymin

Proprietà del rettangolo di selezione minimo Y dell'indice spaziale per il tipo geometry . Questo valore della proprietà è NULL per il tipo geography . Il valore è float.

Bounding_Box_xmax

Proprietà del rettangolo di selezione massimo X dell'indice spaziale per il tipo geometry . Questo valore della proprietà è NULL per il tipo geography . Il valore è float.

Bounding_Box_ymax

Proprietà del rettangolo di delimitazione massimo Y dell'indice spaziale per il tipo geometry . Questo valore della proprietà è NULL per il tipo geography . Il valore è float.

Grid_Size_Level_1

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

  • 16 per LOW
  • 64 per MEDIUM
  • 256 per HIGH

Il valore è int.

Grid_Size_Level_2

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

  • 16 per LOW
  • 64 per MEDIUM
  • 256 per HIGH

Il valore è int.

Grid_Size_Level_3

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

  • 16 per LOW
  • 64 per MEDIUM
  • 256 per HIGH

Il valore è int.

Grid_Size_Level_4

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

  • 16 per LOW
  • 64 per MEDIUM
  • 256 per HIGH

Il valore è int.

Cells_Per_Object

Numero di celle per oggetto (proprietà dell'indice). Il valore è int.

Total_Primary_Index_Rows

Numero di righe nell'indice. Il valore è bigint.

Total_Primary_Index_Pages

Numero di pagine nell'indice. Il valore è 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. Il valore è bigint.

Total_Number_Of_ObjectCells_In_Level0_For_QuerySample

Indica se l'esempio di query rappresentativo non rientra nel rettangolo di selezione dell'indice geometry e nella cella radice (cella di livello 0). Il valore può essere 0 (campione esterno alla cella di livello 0) oppure 1. Se si trova nella cella di livello 0, l'indice analizzato non è un indice appropriato per l'esempio di query. Si tratta di una proprietà principale. Il valore è bigint.

Total_Number_Of_ObjectCells_In_Level0_In_Index

Numero di istanze di cella di oggetti indicizzati a mosaico nel livello 0 (cella radice, all'esterno del rettangolo di selezione per la geometria). Si tratta di una proprietà principale. Il valore è bigint.

Per gli indici geometry , ciò si verifica se il rettangolo di selezione dell'indice è inferiore al dominio dati. Un numero elevato di oggetti nel livello 0 potrebbe richiedere filtri secondari se la finestra di query rientra parzialmente all'esterno del rettangolo di selezione e riduce le prestazioni dell'indice, ad esempio Total_Number_Of_ObjectCells_In_Level0_For_QuerySample è 1. Se la finestra di query rientra nel rettangolo di selezione, un numero elevato di oggetti nel livello 0 potrebbe effettivamente migliorare le prestazioni dell'indice.

Le istanze NULL e vuote vengono conteggiate al livello 0, ma non influiscono sulle prestazioni. Il livello 0 include tutte le celle NULL e le istanze vuote nella tabella di base. Per gli indici geography , il livello 0 include tutte le celle NULL e le istanze vuote +1 cella, perché l'esempio di query viene conteggiato come 1.

Total_Number_Of_ObjectCells_In_Level1_In_Index

Numero di istanze di cella di oggetti indicizzati a mosaico con precisione di livello 1. Si tratta di una proprietà principale. Il valore è bigint.

Total_Number_Of_ObjectCells_In_Level2_In_Index

Numero di istanze di cella di oggetti indicizzati a mosaico con precisione di livello 2. Si tratta di una proprietà principale. Il valore è bigint.

Total_Number_Of_ObjectCells_In_Level3_In_Index

Numero di istanze di cella di oggetti indicizzati a mosaico con precisione di livello 3. Si tratta di una proprietà principale. Il valore è 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. Il valore è bigint.

Total_Number_Of_interior_ObjectCells_In_Level1_In_Index

Numero di celle completamente coperte da un oggetto al livello di tassellatura 1 e quindi sono interne all'oggetto. (Cell_attributevalue è 2. Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_interior_ObjectCells_In_Level2_In_Index

Numero di celle completamente coperte da un oggetto al livello di tassellatura 2 e quindi sono interne all'oggetto. (Cell_attribute valore è 2.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_interior_ObjectCells_In_Level3_In_Index

Numero di celle completamente coperte da un oggetto a livello di tassellatura 3 e quindi sono interne all'oggetto. (Cell_attribute valore è 2.) Si tratta di una proprietà di base. Il valore è 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. (Cell_attribute valore è 2.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

Numero di celle intersecate da un oggetto a livello di tassellatura 1. (Cell_attribute valore è 1.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

Numero di celle intersecate da un oggetto a livello di tassellatura 2. (Cell_attribute valore è 1.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Numero di celle intersecate da un oggetto a livello di tassellatura 3. (Cell_attribute valore è 1.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Numero di celle intersecate da un oggetto a livello 4 del mosaico. (Cell_attribute valore è 1.) Si tratta di una proprietà di base. Il valore è 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. Il valore è bigint.

Nota

Queste informazioni sono utili solo per determinare se sono presenti oggetti che il rettangolo di selezione potrebbe non essere stato accuratamente perso.

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

Numero di oggetti a livello 0 contigui al riquadro. (Cell_attribute valore è 0.) Il valore è bigint.

Total_Number_Of_Border_ObjectCells_In_Level1_In_Index

Numero di celle oggetto che toccano un limite di cella della griglia al livello di tassellatura 1. (Cell_attribute valore è 0.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_Border_ObjectCells_In_Level2_In_Index

Numero di celle oggetto che toccano un limite di cella della griglia al livello di tassellatura 2. (Cell_attribute valore è 0.) Si tratta di una proprietà di base. Il valore è bigint.

Total_Number_Of_Border_ObjectCells_In_Level3_In_Index

Numero di celle oggetto che toccano un limite di cella della griglia al livello di tassellatura 3. (Cell_attribute valore è 0.) Si tratta di una proprietà di base. Il valore è 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. (Cell_attribute valore è 0.) Si tratta di una proprietà di base. Il valore è bigint.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Percentuale dell'area totale (celle foglia totali) della griglia contenente celle foglia coperte da un oggetto .

Ad esempio, un oggetto viene tassellato in 10 celle a quattro livelli di griglia diversi che coprono un'area equivalente a 100 celle foglia in totale. Si supponga che siano presenti tre celle interne completamente coperte dall'oggetto . L'area coperta dalle tre celle interne equivale 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.

Il valore è float.

Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Uguale a Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, ad eccezione del fatto che si tratta di celle parzialmente coperte. Il valore è float.

Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Uguale a Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage ad eccezione del fatto che si tratta di celle di bordo. Il valore è float.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Numero medio di celle per oggetto normalizzato rispetto alla griglia foglia. In questo modo viene fornita un'indicazione delle dimensioni spaziali dell'oggetto o della dimensione degli oggetti. Il valore è float.

Average_Objects_PerLeaf_GridCell

Livello di distribuzione dell'indice. Numero medio di oggetti per cella foglia. Il valore è float.

Number_Of_SRIDs_Found

Numero di identificatori SRID univoci presenti nell'indice e nella colonna. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è 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. Il valore è float.

CellArea_To_BoundingBoxArea_Percentage_In_Level1

Percentuale di copertura del rettangolo delimitatore da una cella di livello 1. Il valore è float.

CellArea_To_BoundingBoxArea_Percentage_In_Level2

Percentuale di copertura del rettangolo delimitatore da una cella di livello 2. Il valore è float.

CellArea_To_BoundingBoxArea_Percentage_In_Level3

Percentuale di copertura del rettangolo delimitatore da una cella di livello 3. Il valore è float.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

Percentuale di copertura del riquadro da una cella di livello 4. Il valore è float.

Number_Of_Rows_Selected_By_Primary_Filter

Numero di righe selezionate dal filtro primario. Si tratta di una proprietà principale. Il valore è bigint.

Number_Of_Rows_Selected_By_Internal_Filter

Numero di righe selezionate dal filtro interno. Il filtro secondario non viene chiamato per queste righe. Si tratta di una proprietà principale. Il valore è bigint.

Il numero restituito è applicabile solo per STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

Numero di volte in cui viene utilizzato il filtro secondario. Si tratta di una proprietà principale. Il valore è 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. Il valore è 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. Il valore è float.

Number_Of_Rows_Output

Numero di righe di output dalla query. Si tratta di una proprietà principale. Il valore è 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. Il valore è float.

Primary_Filter_Efficiency

Se le righe P sono selezionate dal filtro primario e O è il numero di righe di output, restituisceO/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. Il valore è float.

Autorizzazioni

L'utente deve essere membro del ruolo pubblico . È 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à contenenti NULL valori non sono incluse nel set restituito.

Esempi

Per gli esempi, vedere gli articoli seguenti: