INDEXPROPERTY (Transact-SQL)

Articolo
05/11/2023

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

Restituisce il valore delle proprietà di indice o statistiche specificate in base al numero di identificazione della tabella, al nome dell'indice o delle statistiche e al nome della proprietà. Restituisce NULL per gli indici XML.

Convenzioni di sintassi Transact-SQL

Sintassi

INDEXPROPERTY ( object_ID , index_or_statistics_name , property )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

object_ID
Espressione che contiene il numero di identificazione della tabella o vista indicizzata di cui si desidera ottenere informazioni sulla proprietà dell'indice. object_ID è di tipo int.

index_or_statistics_name
Espressione che contiene il nome dell'indice o delle statistiche per cui si desidera ottenere informazioni sulle proprietà. index_or_statistics_name è di tipo nvarchar(128).

property
Espressione che contiene il nome della proprietà del database da restituire. property è di tipo varchar(128). I valori possibili sono i seguenti.

Nota

Se non specificato diversamente, viene restituito NULL quando property non è un nome di proprietà valido, object_ID non è un ID di oggetto valido, object_ID è un tipo di oggetto non supportato per la proprietà specificata oppure il chiamante non ha l'autorizzazione necessaria per visualizzare i metadati dell'oggetto.

Proprietà	Descrizione	Valore
IndexDepth	Dettagli dell'indice.	Numero di livelli dell'indice. NULL = indice XML o input non valido.
IndexFillFactor	Valore del fattore di riempimento utilizzato quando l'indice è stato creato o ricompilato per l'ultima volta.	Fattore di riempimento
IndexID	ID dell'indice della tabella o vista indicizzata specificata.	ID dell'indice
IsAutoStatistics	Le statistiche sono state generate mediante l'opzione AUTO_CREATE_STATISTICS di ALTER DATABASE.	1 = True 0 = False o indice XML.
IsClustered	Indice cluster.	1 = True 0 = False o indice XML.
IsDisabled	L'indice è disabilitato.	1 = True 0 = False NULL = Input non valido.
IsFulltextKey	L'indice è la chiave di indicizzazione full-text e semantica per una tabella.	Si applica a: SQL Server 2008 (10.0.x) e versioni successive. 1 = True 0 = False o indice XML. NULL = Input non valido.
IsHypothetical	L'indice è ipotetico e non può essere utilizzato direttamente come percorso di accesso ai dati. Gli indici ipotetici contengono statistiche a livello di colonna e vengono gestiti e utilizzati da Ottimizzazione guidata motore di database.	1 = True 0 = false o indice XML. NULL = Input non valido.
IsPadIndex	All'indice è associata la quantità di spazio da lasciare aperto in ogni nodo interno.	Si applica a: SQL Server 2008 (10.0.x) e versioni successive. 1 = True 0 = False o indice XML.
IsPageLockDisallowed	Valore per il blocco di pagina impostato mediante l'opzione ALLOW_PAGE_LOCKS di ALTER INDEX.	Si applica a: SQL Server 2008 (10.0.x) e versioni successive. 1 = il blocco di pagina è disattivato. 0 = il blocco di pagina è attivato. NULL = Input non valido.
IsRowLockDisallowed	Valore per il blocco di riga impostato tramite l'opzione ALLOW_ROW_LOCKS di ALTER INDEX.	Si applica a: SQL Server 2008 (10.0.x) e versioni successive. 1 = il blocco di riga è disattivato. 0 = il blocco di riga è attivato. NULL = Input non valido.
IsStatistics	index_or_statistics_name rappresenta le statistiche create dall'istruzione CREATE STATISTICS o dall'opzione AUTO_CREATE_STATISTICS di ALTER DATABASE.	1 = True 0 = False o indice XML.
IsUnique	Indice univoco.	1 = True 0 = False o indice XML.
IsColumnstore	L'indice è un indice columnstore con ottimizzazione per la memoria xVelocity.	Si applica a: SQL Server 2012 (11.x) e versioni successive. 1 = True 0 = False
IsOptimizedForSequentialKey	L'ottimizzazione dell'indice per gli inserimenti dell'ultima pagina è abilitata.	Si applica a: SQL Server 2019 (15.x) e versioni successive. 1 = True 0 = False

Tipi restituiti

int

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non dispone dell'autorizzazione necessaria per visualizzare l'oggetto.

Un utente può visualizzare esclusivamente i metadati delle entità a sicurezza diretta di cui è proprietario o per cui ha ricevuto un'autorizzazione. Di conseguenza, le funzioni predefinite di creazione dei metadati come INDEXPROPERTY possono restituire NULL se l'utente non dispone di alcuna autorizzazione per l'oggetto. Per altre informazioni, vedere Metadata Visibility Configuration.

Esempi

Nell'esempio seguente vengono restituiti i valori per le proprietà IsClustered, IndexDepth e IndexFillFactor per l'indice PK_Employee_BusinessEntityID della Employee tabella nel database AdventureWorks2022.

SELECT   
    INDEXPROPERTY(OBJECT_ID('HumanResources.Employee'),  
        'PK_Employee_BusinessEntityID','IsClustered')AS [Is Clustered],  
    INDEXPROPERTY(OBJECT_ID('HumanResources.Employee'),  
        'PK_Employee_BusinessEntityID','IndexDepth') AS [Index Depth],  
    INDEXPROPERTY(OBJECT_ID('HumanResources.Employee'),  
        'PK_Employee_BusinessEntityID','IndexFillFactor') AS [Fill Factor];

Set di risultati:

Is Clustered Index Depth Fill Factor   
------------ ----------- -----------   
1            2           0  
  
(1 row(s) affected)

Esempi: Azure Synapse Analytics e Piattaforma di strumenti analitici (PDW)

Nell'esempio seguente vengono esaminate le proprietà di uno degli indici nella tabella FactResellerSales.

-- Uses AdventureWorks  
  
SELECT   
INDEXPROPERTY(OBJECT_ID('dbo.FactResellerSales'),  
    'ClusteredIndex_6d10fa223e5e4c1fbba087e29e16a7a2','IsClustered') AS [Is Clustered],  
INDEXPROPERTY(OBJECT_ID('dbo.FactResellerSales'),  
    'ClusteredIndex_6d10fa223e5e4c1fbba087e29e16a7a2','IsColumnstore') AS [Is Columnstore Index],  
INDEXPROPERTY(OBJECT_ID('dbo.FactResellerSales'),  
    'ClusteredIndex_6d10fa223e5e4c1fbba087e29e16a7a2','IndexFillFactor') AS [Fill Factor];  
GO

Vedi anche

CREATE INDEX (Transact-SQL)
Statistica
sys.indexes (Transact-SQL)
sys.index_columns (Transact-SQL)
sys.stats (Transact-SQL)
sys.stats_columns (Transact-SQL)