Compartilhar via

sys.index_columns (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System) Banco de Dados SQL no Microsoft Fabric

Contém uma linha por coluna que faz parte de um índice ou tabela não ordenada (heap).

Nome da coluna Tipo de dados Descrição
object_id int ID do objeto em que o índice está definido.
index_id int ID do índice no qual a coluna está definida.
index_column_id int ID da coluna de índice. index_column_id é único apenas dentro de index_id.
column_id int ID da coluna em object_id.

0 = RID (Identificador de Linha) em um índice não clusterizado.

column_id é único apenas dentro de object_id.
key_ordinal tinyint Ordinal (com base em 1) dentro do conjunto de colunas chave.

0 = Não é uma coluna de chave ou é um índice XML, índice columnstore ou índice espacial.

Nota: Um índice XML ou espacial não pode ser uma chave porque as colunas subjacentes não são comparáveis, o que significa que seus valores não podem ser ordenados.
partition_ordinal tinyint Ordinal (com base em 1) dentro do conjunto de colunas de particionamento. Um índice columnstore clusterizado pode ter no máximo uma coluna de particionamento.

0 = Não é uma coluna de particionamento.
is_descending_key bit 1 = A coluna de chave de índice tem uma direção de classificação decrescente.

0 = A coluna de chave de índice tem uma direção de classificação crescente ou a coluna faz parte de um columnstore ou índice de hash.
is_included_column bit 1 = Column é uma coluna não chave adicionada ao índice usando a cláusula CREATE INDEX INCLUDE ou a coluna faz parte de um índice columnstore.

0 = Column não é uma coluna incluída.

As colunas adicionadas implicitamente porque fazem parte da chave de clustering não são listadas em sys.index_columns.

As colunas adicionadas implicitamente porque são uma coluna de particionamento são retornadas como 0.
column_store_order_ordinal tinyint Aplica-se: Azure Synapse Analytics e SQL Server 2022 (16.x)
Ordinal (baseado em 1) dentro do conjunto de colunas de ordem em um índice columnstore clusterizado ordenado. Para obter mais informações sobre índices columnstore clusterizados ordenados, consulte Diretrizes de design de índice columnstore.

Permissões

A visibilidade dos metadados em exibições do catálogo está limitada aos protegíveis que pertencem a um usuário ou para os quais o usuário recebeu permissão. Para obter mais informações, consulte Metadata Visibility Configuration.

Exemplos

O exemplo a seguir retorna todos os índices e colunas de índice para a tabela Production.BillOfMaterials.

USE AdventureWorks2022;
GO
SELECT i.name AS index_name
    ,COL_NAME(ic.object_id,ic.column_id) AS column_name
    ,ic.index_column_id
    ,ic.key_ordinal
,ic.is_included_column
FROM sys.indexes AS i
INNER JOIN sys.index_columns AS ic
    ON i.object_id = ic.object_id AND i.index_id = ic.index_id
WHERE i.object_id = OBJECT_ID('Production.BillOfMaterials');

Veja a seguir o conjunto de resultados.

index_name                                                 column_name        index_column_id key_ordinal is_included_column
---------------------------------------------------------- -----------------  --------------- ----------- -------------
AK_BillOfMaterials_ProductAssemblyID_ComponentID_StartDate ProductAssemblyID  1               1           0
AK_BillOfMaterials_ProductAssemblyID_ComponentID_StartDate ComponentID        2               2           0
AK_BillOfMaterials_ProductAssemblyID_ComponentID_StartDate StartDate          3               3           0
PK_BillOfMaterials_BillOfMaterialsID                       BillOfMaterialsID  1               1           0
IX_BillOfMaterials_UnitMeasureCode                         UnitMeasureCode    1               1           0
  
(5 row(s) affected)

Próximas etapas