TYPE_ID (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Retorna o ID de um nome de tipo de dados especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

TYPE_ID ( [ schema_name ] type_name )   

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

type_name
É o nome do tipo de dados. type_name é do tipo nvarchar. type_name pode ser um tipo de dados do sistema ou definido pelo usuário.

Tipos de retorno

int

Exceções

Retornará NULL em caso de erro ou se um chamador não tiver permissão para exibir o objeto.

No SQL Server, um usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha permissão concedida. Isso significa que as funções internas que emitem metadados, como TYPE_ID, poderão retornar NULL se o usuário não tiver nenhuma permissão para o objeto. Para obter mais informações, consulte Metadata Visibility Configuration.

Comentários

TYPE_ID retorna NULL se o nome do tipo não for válido ou se o chamador não tiver permissão suficiente para fazer referência ao tipo.

Exemplos

a. Pesquisando os valores TYPE ID para nomes de tipo de uma e duas partes

O exemplo a seguir retorna o ID do tipo para nomes de tipo de uma e duas partes.

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. Pesquisando o TYPE ID de um tipo de dados de sistema

O exemplo a seguir retorna o TYPE ID do tipo de dados de sistema datetime.

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

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

C: Pesquisando a TYPE ID de um tipo de dados do sistema

O exemplo a seguir retorna o TYPE ID do tipo de dados de sistema datetime.

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

Consulte Também

TYPE_NAME (Transact-SQL)
TYPEPROPERTY (Transact-SQL)
sys.types (Transact-SQL)
funções de metadados (Transact-SQL)