• [アーティクル]

TYPE_NAME (Transact-SQL)

指定した型の ID について、修飾なしの名前を返します。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

TYPE_NAME ( type_id )

引数

  • type_id
    使用する型の ID を指定します。type_id のデータ型は int です。呼び出し元がアクセス権を所有しているスキーマの型を参照できます。

戻り値の型

sysname

例外

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

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

説明

type_id が無効であるか、呼び出し元が型の参照に必要な権限を所有していない場合、TYPE_NAME では NULL が返されます。

TYPE_NAME は、システム データ型と、ユーザー定義データ型にも使用できます。型が含まれるスキーマはあらゆるスキーマが対象になりますが、常に修飾なしの名前が返されます。つまり、名前に schema**.** プレフィックスは含まれません。

システム関数は、選択リストや WHERE 句のほか、式が許可される場所であればどこでも使用できます。詳細については、「式 (Transact-SQL)」および「WHERE (Transact-SQL)」を参照してください。

例

次の例では、AdventureWorks2008R2 データベースの Vendor テーブルにある各列の、オブジェクト名、列名、型名を返します。

USE AdventureWorks2008R2;
GO
SELECT o.name AS obj_name, c.name AS col_name,
       TYPE_NAME(c.user_type_id) AS type_name
FROM sys.objects AS o 
JOIN sys.columns AS c  ON o.object_id = c.object_id
WHERE o.name = 'Vendor'
ORDER BY col_name;
GO

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

obj_name col_name type_name

--------------- ------------------------ --------------

Vendor AccountNumber AccountNumber

Vendor ActiveFlag Flag

Vendor BusinessEntityID int

Vendor CreditRating tinyint

Vendor ModifiedDate datetime

Vendor Name Name

Vendor PreferredVendorStatus Flag

Vendor PurchasingWebServiceURL nvarchar

(8 行処理されました)