TYPE_NAME (Transact-SQL)TYPE_NAME (Transact-SQL)

03/14/2017

適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse

指定した型の ID について、修飾なしの名前を返します。Returns the unqualified type name of a specified type ID.

トピックリンクアイコン Transact-SQL 構文表記規則 Topic link icon Transact-SQL Syntax Conventions

構文Syntax

TYPE_NAME ( type_id )

注意

SQL Server 2014 以前の Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

引数Arguments

type_idtype_id
使用する型の ID です。Is the ID of the type that will be used. type_id のデータ型は int です。呼び出し元がアクセス権を所有しているスキーマの型を参照できます。type_id is an int, and it can refer to a type in any schema that the caller has permission to access.

戻り値の型Return Types

sysnamesysname

例外Exceptions

エラーが発生した場合、または呼び出し元にオブジェクトの表示権限がない場合は、NULL が返されます。Returns NULL on error or if a caller does not have permission to view the object.

SQL ServerSQL Server では、そのユーザーが所有している、または権限を与えられている、セキュリティ保護可能なアイテムのメタデータのみを表示できます。In SQL ServerSQL Server, a user can only view the metadata of securables that the user owns or on which the user has been granted permission. つまり、ユーザーがオブジェクトに対する権限を与えられていない場合、メタデータを生成する TYPE_NAME などの組み込み関数では NULL が返される可能性があります。This means that metadata-emitting, built-in functions such as TYPE_NAME may return NULL if the user does not have any permission on the object. 詳細については、「 Metadata Visibility Configuration」を参照してください。For more information, see Metadata Visibility Configuration.

解説Remarks

type_id が無効であるか、呼び出し元が型の参照に必要な権限を所有していない場合、TYPE_NAME では NULL が返されます。TYPE_NAME will return NULL when type_id is not valid or when the caller does not have sufficient permission to reference the type.

TYPE_NAME は、システムデータ型と、ユーザー定義データ型にも使用できます。TYPE_NAME works for system data types and also for user-defined data types. 型が含まれるスキーマはあらゆるスキーマが対象になりますが、常に修飾なしの名前が返されます。The type can be contained in any schema, but an unqualified type name is always returned. つまり、名前に schema.This means the name does not have the schema. プレフィックスは含まれません。prefix.

システム関数は、選択リストの中、WHERE 句の中、また、式を使える所ならどこにでも使用できます。System functions can be used in the select list, in the WHERE clause, and anywhere an expression is allowed. 詳しくは、「式 (Transact-SQL)」および「WHERE (Transact-SQL)」をご覧ください。For more information, see Expressions (Transact-SQL) and WHERE (Transact-SQL).

例Examples

次の例では、AdventureWorks2012AdventureWorks2012 データベースの Vendor テーブルにある各列の、オブジェクト名、列名、型名を返します。The following example returns the object name, column name, and type name for each column in the Vendor table of the AdventureWorks2012AdventureWorks2012 database.

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

結果セットは次のようになります。Here is the result set.

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 row(s) affected)

例: Azure Synapse AnalyticsAzure Synapse Analytics、Parallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

次の例では、ID が 1 のデータ型の TYPE ID が返されます。The following example returns the TYPE ID for the data type with id 1.

SELECT TYPE_NAME(36) AS Type36, TYPE_NAME(239) AS Type239;  
GO

型のリストの場合は、sys.types のクエリを行います。For a list of types, query sys.types.

SELECT * FROM sys.types;  
GO