TYPEPROPERTY (Transact-SQL)

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

Retorna informações sobre um tipo de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

TYPEPROPERTY (type , property)  

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

tipo
É o nome do tipo de dados.

property
É o tipo das informações a serem retornadas para o tipo de dados. property pode ser um dos valores a seguir.

Propriedade Descrição Valor retornado
AllowsNull Tipo de dados permite valores nulos. 1 = True

0 = False

NULL = Tipo de dados não localizado.
OwnerId Proprietário do tipo.

Observação: o proprietário do esquema não é necessariamente o proprietário do tipo.
Nonnull = A ID de usuário de banco de dados do proprietário do tipo.

NULL = Tipo sem-suporte ou ID de tipo inválida.
Precisão Precisão para o tipo de dados. O número de dígitos ou caracteres.

-1 = xml ou um tipo de dados de valor grande

NULL = Tipo de dados não localizado.
Escala Escala para o tipo de dados. O número de lugares decimais para o tipo de dados.

NULL = o tipo de dados não é numeric ou não foi encontrado.
UsesAnsiTrim Configuração de preenchimento ANSI era ON quando o tipo de dados foi criado. 1 = True

0 = False

NULL = Tipo de dados não localizado ou não é um tipo de dados binário ou de cadeia de caracteres.

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 emissoras de metadados, como TYPEPROPERTY, podem retornar NULL se o usuário não tiver nenhuma permissão no objeto. Para obter mais informações, consulte Metadata Visibility Configuration.

Exemplos

a. Identificando o proprietário de um tipo de dados

O exemplo a seguir retorna o proprietário de um tipo de dados.

SELECT TYPEPROPERTY(SCHEMA_NAME(schema_id) + '.' + name, 'OwnerId') AS owner_id, name, system_type_id, user_type_id, schema_id  
FROM sys.types;  

B. Retornando a precisão do tipo de dados tinyint

O exemplo a seguir retorna a precisão ou o número de dígitos para o tipo de dados tinyint.

SELECT TYPEPROPERTY( 'tinyint', 'PRECISION');  

Consulte Também

TYPE_ID (Transact-SQL)
TYPE_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
funções de metadados (Transact-SQL)
OBJECTPROPERTY (Transact-SQL)
ALTER AUTHORIZATION (Transact-SQL)
sys.types (Transact-SQL)