COL_NAME (Transact-SQL)

更新 : 2006 年 7 月 17 日

指定したテーブルの ID 番号および列の ID 番号から、その列の名前を返します。

Transact-SQL 構文表記規則

構文

COL_NAME ( table_id , column_id )

引数

• table_id
  列を含むテーブルの ID 番号を指定します。table_id のデータ型は int です。

• column_id
  列の ID 番号を指定します。column_id のデータ型は int です。

戻り値の型

sysname

例外

エラー時、または呼び出し側にオブジェクトの表示権限がない場合は、NULL が返されます。

SQL Server 2005 では、そのユーザーが所有しているか、または権限を与えられているセキュリティ保護可能なアイテムのメタデータのみを表示できます。つまり、オブジェクトに対する権限がユーザーに与えられていない場合、メタデータを生成する組み込み関数 (COL_NAME など) が NULL を返す可能性があります。詳細については、「メタデータ表示の構成」および「メタデータ表示のトラブルシューティング」を参照してください。

解説

table_id パラメータと column_id パラメータを合わせると、列名文字列を生成できます。

テーブルおよび列の ID 番号の取得の詳細については、「OBJECT_ID (Transact-SQL)」を参照してください。

例

次の例では、AdventureWorks データベースの Employee テーブル内の最初の列の名前を返します。

USE AdventureWorks;
GO
SET NOCOUNT OFF;
GO
SELECT COL_NAME(OBJECT_ID('HumanResources.Employee'), 1) AS 'Column Name';
GO

以下に結果セットを示します。

Column Name        
------------ 
EmployeeID

(1 row(s) affected

参照

関連項目

式 (Transact-SQL)
メタデータ関数 (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
COL_LENGTH (Transact-SQL)

その他の技術情報

列プロパティの変更

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴