Sdílet prostřednictvím

INDEXPROPERTY (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)databáze SQL v Microsoft Fabric

Vrátí pojmenovanou hodnotu vlastnosti indexu nebo statistiky zadaného identifikačního čísla tabulky, názvu indexu nebo statistiky a názvu vlastnosti. Vrátí NULL pro indexy XML.

Transact-SQL konvence syntaxe

Syntaxe

INDEXPROPERTY ( object_ID , index_or_statistics_name , property )

Arguments

object_ID

Výraz, který obsahuje identifikační číslo objektu tabulky nebo indexovaného zobrazení, pro které chcete poskytnout informace o vlastnosti indexu. object_ID je int.

index_or_statistics_name

Výraz, který obsahuje název indexu nebo statistiky, pro které se mají vrátit informace o vlastnosti. index_or_statistics_name je nvarchar(128).

vlastnost

Výraz, který obsahuje název vlastnosti indexu nebo statistiky, která se má vrátit. vlastnost je varchar(128) a může být jednou z těchto hodnot.

Poznámka:

Pokud není uvedeno jinak, vrátí se, NULL pokud vlastnost není platný název vlastnosti, object_ID není platné ID objektu, object_ID je nepodporovaný typ objektu pro zadanou vlastnost nebo volající nemá oprávnění k zobrazení metadat objektu.

Vlastnictví Description Hodnota
IndexDepth Hloubka indexu Počet úrovní indexu

NULL = Index XML nebo vstup nejsou platné.
IndexFillFactor Hodnota faktoru výplně použitá při vytvoření nebo posledním vytvoření indexu Vyplnit faktor
IndexID ID indexu v zadané tabulce nebo indexovaném zobrazení ID indexu
IsAutoStatistics Statistiky byly generovány AUTO_CREATE_STATISTICS možností ALTER DATABASE. 1 = Pravda
0 = Nepravda nebo index XML.
IsClustered Index je clusterovaný. 1 = Pravda
0 = Nepravda nebo index XML.
IsDisabled Index je zakázaný. 1 = Pravda
0 = Nepravda
NULL = Vstup není platný.
IsFulltextKey Index je fulltextový a sémantický indexovací klíč tabulky. 1 = Pravda
0 = Nepravda nebo index XML.
NULL = Vstup není platný.
IsHypothetical Index je hypotetický a nedá se použít přímo jako cesta přístupu k datům. Hypotetické indexy uchovávají statistiky na úrovni sloupců a udržují se a používají poradce pro ladění databázového stroje. 1 = Pravda
0 = Nepravda nebo index XML
NULL = Vstup není platný.
IsPadIndex Index určuje prostor, který se má nechat otevřený na každém vnitřním uzlu. 1 = Pravda
0 = Nepravda nebo index XML.
IsPageLockDisallowed Hodnota uzamčení stránky nastavená ALLOW_PAGE_LOCKS možností ALTER INDEX. 1 = Uzamčení stránky je zakázáno.
0 = Uzamčení stránky je povoleno.
NULL = Vstup není platný.
IsRowLockDisallowed Hodnota uzamčení řádku nastavená ALLOW_ROW_LOCKS možností ALTER INDEX. 1 = Uzamčení řádku je zakázáno.
0 = Uzamčení řádku je povoleno.
NULL = Vstup není platný.
IsStatistics index_or_statistics_name je statistika vytvořená příkazem CREATE STATISTICS nebo AUTO_CREATE_STATISTICS možností ALTER DATABASE. 1 = Pravda
0 = Nepravda nebo index XML.
IsUnique Index je jedinečný. 1 = Pravda
0 = Nepravda nebo index XML.
IsColumnstore Index je index columnstore optimalizovaný pro paměť. 1 = Pravda
0 = Nepravda

platí pro: SQL Server 2012 (11.x) a novější verze.
IsOptimizedForSequentialKey Index má povolenou optimalizaci pro vložení poslední stránky. 1 = Pravda
0 = Nepravda

platí pro: SQL Server 2019 (15.x) a novější verze.

Návratové typy

int

Exceptions

Vrátí NULL chybu nebo pokud volající nemá oprávnění k zobrazení objektu.

Uživatel může zobrazit pouze metadata zabezpečitelných, která uživatel vlastní nebo na kterých má uživatel udělená oprávnění. To znamená, že předdefinované funkce pro metadata, například INDEXPROPERTY můžou vrátit NULL , pokud uživatel nemá k objektu žádná oprávnění. Další informace naleznete v tématu Konfigurace viditelnosti metadat.

Examples

Ukázky kódu v tomto článku používají ukázkovou databázi AdventureWorks2025 nebo AdventureWorksDW2025, kterou si můžete stáhnout z domovské stránky Microsoft SQL Serveru pro ukázky a komunitní projekty .

A. Vrácení vlastností indexu v tabulce Employee

Následující příklad vrací hodnoty pro , IsClusteredIndexDepth, a IndexFillFactor vlastnosti PK_Employee_BusinessEntityID indexu Employee tabulky v databázi AdventureWorks2025.

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

Tady je soubor výsledků.

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

Příklady: Azure Synapse Analytics a Analytický platformový systém (PDW)

B. Vrácení vlastností indexu v tabulce FactResellerSales

Následující příklad prozkoumá vlastnosti jednoho z indexů v FactResellerSales tabulce.

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

Související obsah

  • Last updated on