sp_datatype_info (Transact-SQL)

Retorna informações sobre os tipos de dados para os quais o ambiente atual oferece suporte.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_datatype_info [ [ @data_type = ] data_type ] 
     [ , [ @ODBCVer = ] odbc_version ] 

Argumentos

• [ @data_type= ] data_type
  É o número de código do tipo de dados especificado. Para obter uma lista de todos os tipos de dados, omita este parâmetro. data_type é int, com o padrão de 0.

• [ @ODBCVer= ] odbc_version
  É a versão do ODBC usada. odbc_version é tinyint, com o padrão de 2.

Valores de código de retorno

Nenhum

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
TYPE_NAME	sysname	Tipo de dados dependente do DBMS.
DATA_TYPE	smallint	Código do tipo ODBC para o qual são mapeadas todas as colunas deste tipo.
PRECISION	int	Precisão máxima do tipo de dados na fonte de dados. NULL é retornado para os tipos de dados para os quais a precisão não é aplicável. O valor de retorno da coluna PRECISION está na base 10.
LITERAL_PREFIX	varchar(32)	Caractere ou caracteres usados antes de uma constante. Por exemplo, uma aspa simples (') para tipos de caractere e 0x para binário.
LITERAL_SUFFIX	varchar(32)	Caractere ou caracteres usados para terminar uma constante. Por exemplo, uma aspa simples (') para tipos de caractere e nenhuma aspa para binário.
CREATE_PARAMS	varchar(32)	Descrição dos parâmetros de criação para este tipo de dados. Por exemplo, decimal é "precision, scale", float é NULL e varchar é "max_length".
NULLABLE	smallint	Especifica possibilidade de nulidade: 1 = Permite valores nulos. 0 = Não permite valores nulos.
CASE_SENSITIVE	smallint	Especifica diferenciação de maiúsculas e minúsculas. 1 = Todas as colunas deste tipo fazem diferenciação de maiúsculas e minúsculas (para agrupamentos). 0 = Todas as colunas deste tipo não fazem distinção entre maiúsculas e minúsculas.
SEARCHABLE	smallint	Especifica o recurso de pesquisa do tipo de coluna: 1 = Não pode ser pesquisado. 2 = Pesquisável com LIKE. 3 = Pesquisável com WHERE. 4 = Pesquisável com WHERE ou LIKE.
UNSIGNED_ATTRIBUTE	smallint	Especifica o sinal do tipo de dados. 1 = Tipo de dados não assinado. 0 = Tipo de dados assinado.
MONEY	smallint	Especifica o tipo de dados money. 1 = Tipo de dados money. 0 = Não é um tipo de dados money.
AUTO_INCREMENT	smallint	Especifica incremento automático. 1 = Incremento automático. 0 = Não tem incremento automático. NULL = Atributo não aplicável. Um aplicativo pode inserir valores em uma coluna que tenha esse atributo, mas o aplicativo não pode atualizar os valores da coluna. Com a exceção do tipo de dados bit, AUTO_INCREMENT é válido somente para os tipos de dados pertencentes às categorias de tipos de dados Numérico Exato e Numérico Aproximado.
LOCAL_TYPE_NAME	sysname	Versão localizada do nome do tipo de dados dependente da fonte de dados. Por exemplo, DECIMAL é DECIMALE em francês. NULL será retornado se a fonte de dados não oferecer suporte a um nome localizado.
MINIMUM_SCALE	smallint	Escala mínima do tipo de dados na fonte de dados. Se um tipo de dados tiver uma escala fixa, as colunas MINIMUM_SCALE e MAXIMUM_SCALE conterão esse valor. NULL será retornado onde escala não for aplicável.
MAXIMUM_SCALE	smallint	Escala máxima do tipo de dados na fonte de dados. Se a escala máxima não estiver definida separadamente na fonte de dados, mas em vez disso estiver definida como sendo a mesma que a precisão máxima, essa coluna conterá o mesmo valor que a coluna PRECISION.
SQL_DATA_TYPE	smallint	Valor do tipo de dados SQL como ele aparece no campo TYPE do descritor. Essa coluna é igual à coluna DATA_TYPE, com exceção dos tipos de dados datetime e ANSI interval. Esse campo sempre retorna um valor.
SQL_DATETIME_SUB	smallint	O subcódigo de datetime ou ANSI interval se o valor de SQL_DATA_TYPE for SQL_DATETIME ou SQL_INTERVAL. Para tipos de dados diferentes de datetime e interval ANSI, este campo é NULL.
NUM_PREC_RADIX	int	Número de bits ou dígitos para calcular o número máximo que uma coluna pode conter. Se o tipo de dados for numérico aproximado, esta coluna conterá o valor 2 para indicar vários bits. Para tipos numéricos exatos, esta coluna contém o valor 10 para indicar vários dígitos decimais. Caso contrário, esta coluna será NULL. Ao combinar a precisão com a base, o aplicativo pode calcular o número máximo que a coluna pode conter.
INTERVAL_PRECISION	smallint	Valor da precisão principal do intervalo, se data_type for interval; caso contrário será NULL.
USERTYPE	smallint	Valor usertype da tabela systypes.

Comentários

sp_datatype_info é equivalente a SQLGetTypeInfo no ODBC. Os resultados retornados são ordenados por DATA_TYPE e depois pela proximidade com que o tipo de dados é mapeado para o tipo de dados ODBC SQL correspondente.

Permissões

Requer associação à função public.

Exemplos

O exemplo a seguir recupera informações para os tipos de dados sysname e nvarchar especificando o valor data_type igual a -9.

USE master;
GO
EXEC sp_datatype_info -9;
GO

Consulte também

Referência

Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)

Tipos de dados (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)