TYPEPROPERTY (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Banco de dados SQL no Microsoft Fabric

Retorna informações sobre um tipo de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

TYPEPROPERTY (type , property)  

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 = Verdadeiro 0 = Falso 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 = Verdadeiro 0 = Falso 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)
PROPRIEDADE COLUMN (Transact-SQL)
funções de metadados (Transact-SQL)
OBJECTPROPERTY (Transact-SQL)
ALTERAR AUTORIZAÇÃO (Transact-SQL)
sys.types (Transact-SQL)