sp_addtype (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 nenhum 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 incorporados. 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 forma como o tipo de dados de alias trata valores nulos. null_type é varchar(8), com um padrão NULL, e deve estar 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.

  Observação
  O 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 do 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.

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 banco de dados fixa db_owner ou db_ddladmin.

Exemplos

A. Criando um tipo de dados de alias que não permite valores nulos

USE master;
GO
EXEC sp_addtype ssn, 'varchar(11)', 'NOT NULL';
GO

B. Criando um tipo de dados de alias que permite valores nulos

USE master;
GO
EXEC sp_addtype birthday, datetime, 'NULL';

C. Criando tipos de dados de alias adicionais

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