Skip to content

Latest commit

 

History

History
95 lines (74 loc) · 3.37 KB

type-id-transact-sql.md

File metadata and controls

95 lines (74 loc) · 3.37 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs monikerRange
TYPE_ID (Transact-SQL)
TYPE_ID (Transact-SQL)
MikeRayMSFT
mikeray
03/14/2017
sql
t-sql
reference
TYPE_ID
TYPE_ID_TSQL
IDs [SQL Server], types
TYPE_ID function
type IDs [SQL Server]
data types [SQL Server], IDs
TSQL
>= aps-pdw-2016 || = azuresqldb-current || = azure-sqldw-latest || >= sql-server-2016 || >= sql-server-linux-2017 || = azuresqldb-mi-current

TYPE_ID (Transact-SQL)

[!INCLUDE sql-asdb-asdbmi-asa-pdw]

Returns the ID for a specified data type name.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

TYPE_ID ( [ schema_name ] type_name )   

Arguments

type_name
Is the name of the data type. type_name is of type nvarchar. type_name can be a system or user-defined data type.

Return Types

int

Exceptions

Returns NULL on error or if a caller does not have permission to view the object.

In [!INCLUDEssNoVersion], a user can only view the metadata of securables that the user owns or on which the user has been granted permission. This means that metadata-emitting, built-in functions such as TYPE_ID may return NULL if the user does not have any permission on the object. For more information, see Metadata Visibility Configuration.

Remarks

TYPE_ID returns NULL if the type name is not valid, or if the caller does not have sufficient permission to reference the type.

Examples

A. Looking up the TYPE ID values for single- and two-part type names

The following example returns type ID for single- and two-part type names.

USE tempdb;  
GO  
CREATE TYPE NewType FROM int;  
GO  
CREATE SCHEMA NewSchema;  
GO  
CREATE TYPE NewSchema.NewType FROM int;  
GO  
SELECT TYPE_ID('NewType') AS [1 Part Data Type ID],  
       TYPE_ID('NewSchema.NewType') AS [2 Part Data Type ID];  
GO  

B. Looking up the TYPE ID of a system data type

The following example returns the TYPE ID for the datetime system data type.

SELECT TYPE_NAME(TYPE_ID('datetime')) AS [TYPE_NAME]  
    ,TYPE_ID('datetime') AS [TYPE_ID];  
GO  

Examples: [!INCLUDEssazuresynapse-md] and [!INCLUDEssPDW]

C: Looking up the TYPE ID of a system data type

The following example returns the TYPE ID for the datetime system data type.

SELECT TYPE_NAME(TYPE_ID('datetime')) AS typeName,   
    TYPE_ID('datetime') AS typeID FROM table1;  

See Also

TYPE_NAME (Transact-SQL)
TYPEPROPERTY (Transact-SQL)
sys.types (Transact-SQL)
Metadata Functions (Transact-SQL)