sp_addtype (Transact-SQL)
Cria um tipo de dados de alias.
.gif "Observação importante") Importante |
|---|
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use CREATE TYPE em vez disso. |
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sp_addtype [ @typename = ] type,
[ @phystype = ] system_data_type
[ , [ @nulltype = ] 'null_type' ] ;
Argumentos
[ @typename= ] type
É o nome do tipo de dados de alias. Os nomes de tipo de dados de alias seguem as regras para identificadores e devem ser exclusivos em cada banco de dados. type é sysname, sem padrão.[ @phystype=] system_data_type
É o tipo de dados físico ou fornecido do SQL Server no qual o tipo de dados de alias se baseia. system_data_type é sysname, sem padrão, e pode ser um dos seguintes valores:bigint
binary(n)
bit
char(n)
datetime
decimal
float
image
int
money
nchar(n)
ntext
numeric
nvarchar(n)
real
smalldatetime
smallint
smallmoney
sql_variant
text
tinyint
uniqueidentifier
varbinary(n)
varchar(n)
São necessárias aspas em todos os parâmetros que têm espaços em branco ou marcas de pontuação inseridos. Para obter mais informações sobre tipos de dados disponíveis, consulte Tipos de dados (Transact-SQL).
n
É um inteiro de não negativo que indica o comprimento pelo tipo de dados escolhido.P
É um inteiro não negativo indicando o número total máximo de dígitos decimais que podem ser armazenados à esquerda e à direita do ponto decimal. Para obter mais informações, consulte decimal e numeric (Transact-SQL).s
É um inteiro não negativo indicando o número máximo de dígitos decimais que podem ser armazenados à direita do ponto decimal e deve ser menor que ou igual à precisão. Para obter mais informações, consulte decimal e numeric (Transact-SQL).[ @nulltype = ] 'null_type'
Indica a maneira como o tipo de dados do alias trata valores nulos. null_type é varchar(8), com um padrão de NULL e deve ser incluído entre aspas simples ('NULL', 'NOT NULL' ou 'NONULL'). Se null_type não for definido explicitamente através de sp_addtype, ele será definido como a nulabilidade padrão atual. Use a função de sistema GETANSINULL para determinar a nulabilidade padrão atual. Isso pode ser ajustado usando a instrução SET ou ALTER DATABASE. A nulabilidade deve ser definida explicitamente. Se @phystype for bit e @nulltype não for especificado, o padrão será NOT NULL..gif "Observação")
ObservaçãoO parâmetro null_type define apenas a nulabilidade padrão para esse tipo de dados. Se a nulabilidade for explicitamente definida quando o tipo de dados de alias for usado durante a criação da tabela, ela terá precedência sobre a nulabilidade padrão. Para obter mais informações, consulte ALTER TABLE (Transact-SQL) e CREATE TABLE (Transact-SQL)..
Valores de código de retorno
0 (êxito) ou 1 (falha)
Conjuntos de resultados
Nenhum
Comentários
Um nome de tipo de dados de alias deve ser exclusivo no banco de dados, mas os tipos de dados com nomes diferentes podem ter a mesma definição.
Executar sp_addtype cria um tipo de dados de alias que aparece na exibição de catálogo sys.types para um banco de dados específico. Para tipo de dados de alias ficar disponível em todos os novos bancos de dados definidos pelo usuário todo novos, adicione-o ao modelo. Depois da criação de um tipo de dados de alias, você pode usá-lo em CREATE TABEL ou ALTER TABLE, e também vincular padrões e regras a ele. Todos os tipos de dados de alias escalares que são criados usando sp_addtype estão contidos no esquema dbo.
Os tipos de dados de alias herdam o agrupamento padrão do banco de dados. Os agrupamentos de colunas e variáveis de tipos de alias são definidos nas instruções Transact-SQL CREATE TABLE, ALTER TABLE e DECLARE @local\_variable. A alteração do agrupamento padrão do banco de dados aplica-se apenas a novas colunas e variáveis do tipo; isso não altera o agrupamento das existentes.
.gif "Observação sobre segurança") Observação sobre segurança |
|---|
Para fins de compatibilidade com versões anteriores, a função de banco de dados pública automaticamente obtém a concessão da permissão REFERENCES nos tipos de dados de alias que são criados usando sp_addtype. Observe que quando tipos de dados de alias são criados usando a instrução CREATE TYPE em vez de sp_addtype, essa concessão automática não ocorre. |
Os tipos de dados de alias não podem ser definidos usando o tipo de dados SQL Servertimestamp,table, xml, varchar(max), nvarchar(max) ou varbinary(max).
Permissões
Requer associação na função de servidor fixa db_owner ou db_ddladmin.
Exemplos
A.Criando um tipo de dados de alias que não permite valores nulos
O exemplo a seguir cria um tipo de dados de alias chamado ssn (número de previdência social) que se baseia no tipo de dados varchar fornecido pelo SQL Server. O tipo de dados ssn é usado para colunas que contém números de previdência social de 11 dígitos (999-99-9999). A coluna não pode ser NULL.
Observe que varchar(11) está entre aspas simples porque contém pontuação (parênteses).
USE master;
GO
EXEC sp_addtype ssn, 'varchar(11)', 'NOT NULL';
GO
B.Criando um tipo de dados de alias que permite valores nulos
O exemplo a seguir cria um tipo de dados de alias (baseado em datetime) chamado birthday que permite valores nulos.
USE master;
GO
EXEC sp_addtype birthday, datetime, 'NULL';
C.Criando tipos de dados de alias adicionais
O exemplo a seguir cria dois tipos de dados de alias adicionais, telephone e fax, para número de telefone e fax nacionais e internacionais.
USE master;
GO
EXEC sp_addtype telephone, 'varchar(24)', 'NOT NULL';
GO
EXEC sp_addtype fax, 'varchar(24)', 'NULL';
GO
Consulte também
Referência
Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)