COLUMNPROPERTY (Transact-SQL)

更新 : 2006 年 7 月 17 日

列またはプロシージャ パラメータに関する情報を返します。

Transact-SQL 構文表記規則

構文

COLUMNPROPERTY ( id , column , property ) 

引数

• id
  テーブルまたはプロシージャの識別子 (ID) を含む式です。

• column
  列またはパラメータの名前を含む式です。

• property
  id として返される情報を含む式を指定します。次のいずれかの値を指定できます。

  値

戻り値の型

int

例外

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

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

解説

列の決定的なプロパティを調べるときは、まず、その列が計算列であるかどうかをテストします。計算列でない場合は、IsDeterministic によって NULL が返されます。計算列は、インデックス列として指定できます。

例

次の例では、LastName 列の長さを返します。

USE AdventureWorks;
GO
SELECT COLUMNPROPERTY( OBJECT_ID('Person.Contact'),'LastName','PRECISION')AS 'Column Length';
GO

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

Column Length 
------------- 
50

(1 row(s) affected)

参照

関連項目

メタデータ関数 (Transact-SQL)
OBJECTPROPERTY (Transact-SQL)
TYPEPROPERTY (Transact-SQL)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴