Megosztás a következőn keresztül:

INDEXPROPERTY (Transact-SQL)

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

Egy megadott táblaazonosítási szám, index- vagy statisztikanév, valamint tulajdonságnév elnevezett index- vagy statisztikai tulajdonságértékét adja vissza. XML-indexek NULL visszaadása.

Transact-SQL szintaxis konvenciók

Szemantika

INDEXPROPERTY ( object_ID , index_or_statistics_name , property )

Arguments

object_ID

A tábla vagy indexelt nézet objektumazonosítási számát tartalmazó kifejezés, amelyhez indextulajdonság-információkat szeretne megadni. object_IDint.

index_or_statistics_name

Olyan kifejezés, amely annak az indexnek vagy statisztikai adatnak a nevét tartalmazza, amelynek a tulajdonságadatait vissza szeretné adni. index_or_statistics_namenvarchar(128).

ingatlan

A visszaadni kívánt index vagy statisztikai tulajdonság nevét tartalmazó kifejezés. tulajdonságavarchar(128), és ezek egyike lehet.

Megjegyzés:

Ha másként nem szerepel, akkor a rendszer akkor adja vissza, NULL ha a tulajdonság nem érvényes tulajdonságnév, object_ID nem érvényes objektumazonosító, object_ID a megadott tulajdonság nem támogatott objektumtípusa, vagy a hívónak nincs engedélye az objektum metaadatainak megtekintésére.

Ingatlan Description Érték
IndexDepth Az index mélysége. Indexszintek száma.

NULL = Az XML-index vagy a bemenet érvénytelen.
IndexFillFactor Az index létrehozásakor vagy az utolsó újraépítéskor használt kitöltési tényező értéke. Kitöltési tényező
IndexID Az index indexazonosítója egy adott táblában vagy indexelt nézetben. Indexazonosító
IsAutoStatistics A statisztikák a következő lehetőséggel AUTO_CREATE_STATISTICSALTER DATABASElettek létrehozva: . 1 = Igaz
0 = Hamis vagy XML-index.
IsClustered Az index fürtözött. 1 = Igaz
0 = Hamis vagy XML-index.
IsDisabled Az index le van tiltva. 1 = Igaz
0 = Hamis
NULL = A bemenet érvénytelen.
IsFulltextKey Az index egy tábla teljes szöveges és szemantikai indexelési kulcsa. 1 = Igaz
0 = Hamis vagy XML-index.
NULL = A bemenet érvénytelen.
IsHypothetical Az index hipotetikus, és nem használható közvetlenül adatelérési útvonalként. A hipotetikus indexek oszlopszintű statisztikákat tartalmaznak, amelyeket a Database Engine Tuning Advisor tart fenn és használ. 1 = Igaz
0 = Hamis vagy XML-index
NULL = A bemenet érvénytelen.
IsPadIndex Az index az egyes belső csomópontokon nyitva hagyandó helyet határozza meg. 1 = Igaz
0 = Hamis vagy XML-index.
IsPageLockDisallowed A lapzárolási érték a ALLOW_PAGE_LOCKS következő beállítással ALTER INDEXállítható be: . 1 = Az oldalzárolás nincs engedélyezve.
0 = Az oldalzárolás engedélyezett.
NULL = A bemenet érvénytelen.
IsRowLockDisallowed A sorzárolási érték a ALLOW_ROW_LOCKS következő beállítással van ALTER INDEXbeállítva: . 1 = A sorzárolás nincs engedélyezve.
0 = A sorzárolás engedélyezett.
NULL = A bemenet érvénytelen.
IsStatistics index_or_statistics_name az utasítás vagy a CREATE STATISTICSAUTO_CREATE_STATISTICS beállítás ALTER DATABASEáltal létrehozott statisztikák. 1 = Igaz
0 = Hamis vagy XML-index.
IsUnique Az index egyedi. 1 = Igaz
0 = Hamis vagy XML-index.
IsColumnstore Az index egy memóriaoptimalizált oszlopcentrikus index. 1 = Igaz
0 = Hamis

A: SQL Server 2012 (11.x) és újabb verziókra vonatkozik.
IsOptimizedForSequentialKey Az index optimalizálja az utolsó oldal beszúrásait. 1 = Igaz
0 = Hamis

A: SQL Server 2019 (15.x) és újabb verziókra vonatkozik.

Visszatérési típusok

int

Exceptions

Hibaüzenetet ad NULL vissza, vagy ha a hívó nem rendelkezik engedéllyel az objektum megtekintéséhez.

A felhasználó csak azoknak a biztonságos adatoknak a metaadatait tekintheti meg, amelyek tulajdonosa a felhasználó, vagy amelyekhez a felhasználó engedélyt kapott. Ez azt jelenti, hogy a metaadatkibocsátó, beépített függvények, például INDEXPROPERTY akkor térhetnek vissza NULL , ha a felhasználónak nincs engedélye az objektumra. További információ: Metaadatok láthatósági konfigurációja.

Példák

A cikkben szereplő kódminták a AdventureWorks2025 vagy AdventureWorksDW2025 mintaadatbázist használják, amelyet a Microsoft SQL Server-minták és közösségi projektek kezdőlapjáról tölthet le.

A. Az Alkalmazott táblában lévő index tulajdonságainak visszaadése

A következő példa adja vissza az IsClusteredAdventureWorks2025 IndexDepthadatbázis index értékeit, , és IndexFillFactor tulajdonságait PK_Employee_BusinessEntityIDEmployee .

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

Itt van az eredmények összessége.

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

Példák: Azure Synapse Analytics and Analytics Platform System (PDW)

B. A FactResellerSales tábla indextulajdonságainak visszaadási tulajdonságai

Az alábbi példa a tábla egyik indexének FactResellerSales tulajdonságait vizsgálja.

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

Kapcsolódó tartalom

  • Last updated on