sp_datatype_info (Transact-SQL)
Aplica-se a: SQL Server Azure Synapse Analytics
Retorna informações sobre os tipos de dados para os quais o ambiente atual oferece suporte.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_datatype_info [ [ @data_type = ] data_type ]
[ , [ @ODBCVer = ] odbc_version ]
Argumentos
[ @data_type = ] data_type
É o número do código para o tipo de dados especificado. Para obter uma lista de todos os tipos de dados, omita este parâmetro. data_type é int, com um padrão de 0.
[ @ODBCVer = ] odbc_version
É a versão do ODBC usada. odbc_version é tinyint, com um padrão de 2.
Valores do 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 única aspa (') para tipos de caractere e 0x para binário. |
LITERAL_SUFFIX | varchar(32) | Caractere ou caracteres usados para terminar uma constante. Por exemplo, uma única aspa (') 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 é "precisão, escala", 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 ordenações). 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 exceção do tipo de dados bit , AUTO_INCREMENT é válido apenas para tipos de dados que pertencem às categorias tipo 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, esta coluna conterá o mesmo valor que a coluna PRECISION. |
SQL_DATA_TYPE | smallint | Valor do tipo de dados SQL conforme exibido no campo TYPE do descritor. Essa coluna é igual à coluna DATA_TYPE, exceto para os tipos de dadosdatetime e INTERVALO ANSI. Esse campo sempre retorna um valor. |
SQL_DATETIME_SUB | smallint | datetime ou subcodificação de intervalo ANSI se o valor de SQL_DATA_TYPE for SQL_DATETIME ou SQL_INTERVAL. Para tipos de dados diferentes de datetime e intervalo ANSI, esse 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 à esquerda do intervalo se data_type for intervalo; caso contrário, 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 ao 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 de -9
.
USE master;
GO
EXEC sp_datatype_info -9;
GO
Consulte Também
Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
Tipos de dados (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários