Delen via

INDEXPROPERTY (Transact-SQL)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Retourneert de benoemde index- of statistiekeneigenschapswaarde van een opgegeven tabelidentificatienummer, index- of statistiekennaam en eigenschapsnaam. Retourneert NULL voor XML-indexen.

Transact-SQL syntaxis-conventies

Syntaxis

INDEXPROPERTY ( object_ID , index_or_statistics_name , property )

Arguments

object_ID

Een expressie die het objectidentificatienummer van de tabel of geïndexeerde weergave bevat waarvoor informatie over de indexeigenschap moet worden opgegeven. object_ID is int.

index_or_statistics_name

Een expressie die de naam bevat van de index of statistieken waarvoor eigenschapsgegevens moeten worden geretourneerd. index_or_statistics_name is nvarchar(128).

eigenschap

Een expressie die de naam van de index- of statistiekeneigenschap bevat die moet worden geretourneerd. eigenschap is varchar(128), en kan een van deze waarden zijn.

Opmerking

Tenzij anders vermeld, NULL wordt geretourneerd wanneer de eigenschap geen geldige eigenschapsnaam is, object_ID geen geldige object-id is, object_ID een niet-ondersteund objecttype voor de opgegeven eigenschap is of de aanroeper geen machtiging heeft om de metagegevens van het object weer te geven.

Vastgoed Description Waarde
IndexDepth Diepte van de index. Aantal indexniveaus.

NULL = XML-index of -invoer is niet geldig.
IndexFillFactor Waarde voor opvulfactor die wordt gebruikt toen de index werd gemaakt of voor het laatst opnieuw werd opgebouwd. Vulfactor
IndexID Index-id van de index in een opgegeven tabel of geïndexeerde weergave. Index-id
IsAutoStatistics Statistieken zijn gegenereerd door de AUTO_CREATE_STATISTICS optie van ALTER DATABASE. 1 = Waar
0 = Onwaar of XML-index.
IsClustered De index is geclusterd. 1 = Waar
0 = Onwaar of XML-index.
IsDisabled Index is uitgeschakeld. 1 = Waar
0 = Onwaar
NULL = Invoer is ongeldig.
IsFulltextKey Index is de volledige tekst en semantische indexeringssleutel voor een tabel. 1 = Waar
0 = Onwaar of XML-index.
NULL = Invoer is ongeldig.
IsHypothetical De index is hypothetisch en kan niet rechtstreeks worden gebruikt als gegevenstoegangspad. Hypothetische indexen bevatten statistieken op kolomniveau en worden onderhouden en gebruikt door Database Engine Tuning Advisor. 1 = Waar
0 = Onwaar of XML-index
NULL = Invoer is ongeldig.
IsPadIndex Index geeft ruimte op om open te laten op elk binnenknooppunt. 1 = Waar
0 = Onwaar of XML-index.
IsPageLockDisallowed Paginavergrendelingswaarde ingesteld door de ALLOW_PAGE_LOCKS optie van ALTER INDEX. 1 = Paginavergrendeling is niet toegestaan.
0 = Paginavergrendeling is toegestaan.
NULL = Invoer is ongeldig.
IsRowLockDisallowed De waarde voor het vergrendelen van rijen die is ingesteld door de ALLOW_ROW_LOCKS optie van ALTER INDEX. 1 = Rijvergrendeling is niet toegestaan.
0 = Rijvergrendeling is toegestaan.
NULL = Invoer is ongeldig.
IsStatistics index_or_statistics_name zijn statistieken die zijn gemaakt door de CREATE STATISTICS instructie of door de AUTO_CREATE_STATISTICS optie van ALTER DATABASE. 1 = Waar
0 = Onwaar of XML-index.
IsUnique Index is uniek. 1 = Waar
0 = Onwaar of XML-index.
IsColumnstore Index is een columnstore-index die is geoptimaliseerd voor geheugen. 1 = Waar
0 = Onwaar

Van toepassing op: SQL Server 2012 (11.x) en latere versies.
IsOptimizedForSequentialKey Index heeft optimalisatie voor invoegingen op laatste pagina ingeschakeld. 1 = Waar
0 = Onwaar

van toepassing op: SQL Server 2019 (15.x) en latere versies.

Retourtypen

int

Exceptions

Retourneert NULL een fout of als een aanroeper niet gemachtigd is om het object weer te geven.

Een gebruiker kan alleen de metagegevens bekijken van beveiligbare items waarvan de gebruiker eigenaar is of waarvoor de gebruiker toestemming krijgt. Dit betekent dat metagegevens die ingebouwde functies verzenden, zoals INDEXPROPERTY die kunnen worden geretourneerd NULL als de gebruiker geen machtigingen heeft voor het object. Zie de zichtbaarheidsconfiguratie voor metagegevens voor meer informatie.

Voorbeelden

De codevoorbeelden in dit artikel gebruiken de AdventureWorks2022 of AdventureWorksDW2022 voorbeelddatabase die u kunt downloaden van de startpagina van Microsoft SQL Server Samples en Community Projects .

Eén. Retoureigenschappen voor index in de tabel Werknemer

In het volgende voorbeeld worden de waarden voor de IsClustered, IndexDepthen IndexFillFactor eigenschappen voor de PK_Employee_BusinessEntityID index van de Employee tabel in de Database AdventureWorks2022 geretourneerd.

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];

Hier is het resultatenoverzicht.

Is Clustered Index Depth Fill Factor
------------ ----------- -----------
1            2           0

Voorbeelden: Azure Synapse Analytics and Analytics Platform System (PDW)

B. Eigenschappen retourneren voor index in de tabel FactResellerSales

In het volgende voorbeeld worden de eigenschappen van een van de indexen in de FactResellerSales tabel onderzocht.

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

Verwante inhoud