TYPEPROPERTY (Transact-SQL)

Artículo
12/22/2023

Se aplica a:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Devuelve información acerca de un tipo de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

TYPEPROPERTY (type , property)

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

type
Es el nombre del tipo de datos.

property
Es el tipo de información que se devuelve del tipo de datos. property puede tener uno de estos valores.

Propiedad	Descripción	Valor devuelto
AllowsNull	El tipo de datos permite valores nulos.	1 = True 0 = False NULL = No se encuentra el tipo de datos.
OwnerId	Propietario del tipo. Nota: El propietario del esquema no es necesariamente el propietario del tipo.	NonNULL = El Id. de usuario de la base de datos del propietario del tipo. NULL = Tipo no compatible o Id. de tipo no válido.
Precisión	Precisión del tipo de datos.	El número de dígitos o caracteres. -1 = xml o un tipo de datos de valor largo NULL = No se encuentra el tipo de datos.
Escala	Escala para el tipo de datos.	El número de decimales del tipo de datos. NULL = El tipo de datos no es numeric o no se encontró.
UsesAnsiTrim	La configuración del relleno ANSI era ON cuando se creó el tipo de datos.	1 = True 0 = False NULL = No se encuentra el tipo de datos o no es un tipo de datos de cadena o binario.

Tipos de valor devuelto

int

Excepciones

Devuelve NULL si se produce un error o si el autor de la llamada no tiene permiso para ver el objeto.

En SQL Server, un usuario solo puede ver los metadatos de elementos protegibles que posea o para los que se le haya concedido permiso. Esto significa que las funciones integradas de emisión de metadatos, como TYPEPROPERTY, pueden devolver NULL si el usuario no tiene ningún permiso para el objeto. Para obtener más información, consulte Metadata Visibility Configuration.

Ejemplos

A. Identificar el propietario de un tipo de datos

En el ejemplo siguiente se devuelve el propietario de un tipo de datos.

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

B. Devolver la precisión del tipo de datos tinyint

En el siguiente ejemplo se devuelve la precisión o el número de dígitos del tipo de datos tinyint.

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

Consulte también

TYPE_ID (Transact-SQL)
TYPE_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)
Funciones de metadatos (Transact-SQL)
OBJECTPROPERTY (Transact-SQL)
ALTER AUTHORIZATION (Transact-SQL)
sys.types (Transact-SQL)