INDEX_COL (Transact-SQL)INDEX_COL (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)ouiAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Retourne le nom de la colonne indexée.Returns the indexed column name. Retourne la valeur NULL pour les index XML.Returns NULL for XML indexes.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


INDEX_COL ( '[ database_name . [ schema_name ] .| schema_name ]  
    table_or_view_name', index_id , key_id )   

ArgumentsArguments

database_namedatabase_name
Nom de la base de données.Is the name of the database.

schema_nameschema_name
Nom du schéma auquel appartient l'index.Is the name of the schema to which the index belongs.

table_or_view_nametable_or_view_name
Nom de la table ou vue indexée.Is the name of the table or indexed view. table_or_view_name doit être délimité par des guillemets simples et peut être pleinement qualifié par un nom de base de données et un nom de schéma.table_or_view_name must be delimited by single quotation marks and can be fully qualified by database name and schema name.

index_idindex_id
Identificateur de l’index.Is the ID of the index. index_ID est de type int.index_ID is int.

key_idkey_id
Position de la colonne clé d'index.Is the index key column position. key_ID est de type int.key_ID is int.

Types de retourReturn Types

nvarchar (128 )nvarchar (128 )

ExceptionsExceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.Returns NULL on error or if a caller does not have permission to view the object.

Un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'une autorisation.A user can only view the metadata of securables that the user owns or on which the user has been granted permission. Cela signifie que les fonctions intégrées générant des métadonnées, telles que INDEX_COL, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet.This means that metadata-emitting, built-in functions such as INDEX_COL may return NULL if the user does not have any permission on the object. Pour plus d'informations, consultez Metadata Visibility Configuration.For more information, see Metadata Visibility Configuration.

ExemplesExamples

A.A. Utilisation de INDEX_COL pour le renvoi d'une colonne d'indexUsing INDEX_COL to return an index column name

L'exemple suivant renvoie le nom des deux colonnes clés dans l'index PK_SalesOrderDetail_SalesOrderID_LineNumber.The following example returns the column names of the two key columns in the index PK_SalesOrderDetail_SalesOrderID_LineNumber.

USE AdventureWorks2012;  
GO  
SELECT   
    INDEX_COL (N'AdventureWorks2012.Sales.SalesOrderDetail', 1,1) AS  
        [Index Column 1],   
    INDEX_COL (N'AdventureWorks2012.Sales.SalesOrderDetail', 1,2) AS  
        [Index Column 2]  
;  
GO  

Voici l'ensemble de résultats obtenu :Here is the result set:

Index Column 1      Index Column 2  
-----------------------------------------------  
SalesOrderID        SalesOrderDetailID  

Voir aussiSee Also

Expressions (Transact-SQL) Expressions (Transact-SQL)
Fonctions de métadonnées (Transact-SQL) Metadata Functions (Transact-SQL)
sys.indexes (Transact-SQL) sys.indexes (Transact-SQL)
sys.index_columns (Transact-SQL)sys.index_columns (Transact-SQL)