sp_addtype (Transact-SQL)

Создает тип данных псевдонима.

Важно!
В будущей версии Microsoft SQL Server эта возможность будет удалена. Избегайте использования этой возможности в новых разработках и запланируйте изменение существующих приложений, в которых она применяется. Используйте вместо нее инструкцию CREATE TYPE.

Соглашения о синтаксисе в Transact-SQL

Синтаксис

sp_addtype [ @typename = ] type, 
    [ @phystype = ] system_data_type 
    [ , [ @nulltype = ] 'null_type' ] ;

Аргументы

• [ @typename= ] type
  Имя типа данных псевдонима. Имена типов данных псевдонима должны соответствовать правилам для идентификаторов и должны быть уникальными в каждой базе данных. Аргумент type имеет тип sysname и не имеет значения по умолчанию.

• [ @phystype=] system_data_type
  Физический (предоставляемый SQL Server) тип данных, на котором основан тип данных псевдонима. Аргумент system_data_type имеет тип sysname и не имеет значения по умолчанию, и он может принимать одно из следующих значений:

  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)

  Кавычки необходимы для всех параметров, в которых содержатся начальные пробелы или знаки пунктуации. Дополнительные сведения о доступных типах данных см. в разделе Типы данных (Transact-SQL).

• n
  Неотрицательное целое число, которое показывает длину выбранного типа данных.

• P
  Неотрицательное целое число, показывающее максимальное количество десятичных разрядов числа (как слева, так и справа от десятичного разделителя). Дополнительные сведения см. в разделе десятичные и числовые (Transact-SQL).

• s
  Неотрицательное целое число, показывающее максимальное количество десятичных разрядов числа (справа от десятичного разделителя), которое не должно превышать точность. Дополнительные сведения см. в разделе десятичные и числовые (Transact-SQL).

• [ @nulltype = ] 'null_type'
  Указывает способ обработки значений NULL типом данных псевдонима. Аргумент null_type имеет тип varchar(8) и значение по умолчанию NULL, и его следует заключать в одинарные кавычки ('NULL', 'NOT NULL' или 'NONULL'). Если аргумент null_type не указывается в явном виде в процедуре sp_addtype, ему присваивается текущее значение параметра возможности по умолчанию иметь значения NULL. Для определения текущего значения параметра возможности по умолчанию иметь значения NULL используйте системную функцию NULLGETANSINULL. Его можно настраивать с помощью инструкции SET или ALTER DATABASE. Возможность иметь значения NULL необходимо задавать в явной форме. Если аргумент @phystype имеет тип bit, а аргумент @nulltype не указывается, по умолчанию используется значение NOT NULL.

  Примечание.
  Аргумент null_type указывает возможность по умолчанию иметь значения NULL только для этого типа данных. Если возможность иметь значения NULL явно указывается для типа данных псевдонима при создании таблицы, эта настройка имеет приоритет над возможностью по умолчанию иметь значения NULL. Дополнительные сведения см. в разделах ALTER TABLE (Transact-SQL) и CREATE TABLE (Transact-SQL).

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

Имя типа данных псевдонима должно быть уникальным в базе данных, но типы данных псевдонима с различными именами могут иметь одно определение.

Выполнение процедуры sp_addtype позволяет создать тип данных псевдонима, отображаемый в представлении каталога sys.types для конкретной базы данных. Если тип данных псевдонима должен быть доступен в новых пользовательских базах данных, добавьте его в модель. После создания типа данных псевдонима его можно использовать в инструкциях CREATE TABLE и ALTER TABLE, а также привязывать значения по умолчанию и правила к нему. Все скалярные типы данных псевдонима, созданные процедурой sp_addtype, содержатся в схеме dbo.

Типы данных псевдонима наследуют параметры сортировки базы данных по умолчанию. Параметры сортировки столбцов и переменных типов псевдонима задаются в инструкциях Transact-SQL CREATE TABLE, ALTER TABLE и DECLARE @local_variable. Изменение параметров сортировки по умолчанию базы данных применяется только к новым столбцам и переменным типа и не изменяет параметры сортировки существующих столбцов и переменных.

Примечание безопасности.
Роли public автоматически предоставляется разрешение REFERENCES для типов данных псевдонима, созданных процедурой sp_addtype, в целях обратной совместимости. Обратите внимание на то, что если типы данных псевдонима созданы инструкцией CREATE TYPE, а не процедурой sp_addtype, то это разрешение автоматически не предоставляется.

Типы данных псевдонима нельзя задавать с помощью типов данных SQL Server timestamp, table, xml, varchar(max), nvarchar(max) и varbinary(max).

Разрешения

Необходимо членство в фиксированной роли базы данных db_owner или db_ddladmin.

Примеры

А. Создание типа данных псевдонима, не поддерживающего значения NULL

В следующем примере создается тип данных псевдонима с именем ssn (номер карточки социального страхования) на основе типа данных varchar, предоставляемого SQL Server. Тип данных ssn используется для столбцов, хранящих номера карточек социального страхования, состоящих из 11 разрядов (999-99-9999). Эти столбцы не могут иметь значение NULL.

Обратите внимание на то, что тип varchar(11) заключен в одинарные кавычки, поскольку содержит знак пунктуации (скобки).

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

Б. Создание типа данных псевдонима, поддерживающего значения NULL

В следующем примере создается тип данных псевдонима (на основе datetime) с именем birthday, который поддерживает значения NULL.

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

В. Создание дополнительных типов данных

В следующем примере создается два дополнительных типа данных псевдонима, telephone и fax, служащих для внутренних и международных номеров телефонов и факсов.

USE master;
GO
EXEC sp_addtype telephone, 'varchar(24)', 'NOT NULL';
GO
EXEC sp_addtype fax, 'varchar(24)', 'NULL';
GO

См. также

Справочник

Хранимые процедуры ядра СУБД (Transact-SQL)
CREATE TYPE (Transact-SQL)
CREATE DEFAULT (Transact-SQL)
CREATE RULE (Transact-SQL)
sp_bindefault (Transact-SQL)
sp_bindrule (Transact-SQL)
sp_droptype (Transact-SQL)
sp_rename (Transact-SQL)
Хранимая процедура sp_unbindefault (Transact-SQL)
sp_unbindrule (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005