Статья
04/01/2012

sp_updateextendedproperty (Transact-SQL)

Обновляет значение существующего расширенного свойства.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sp_updateextendedproperty
    [ @name = ]{ 'property_name' } 
    [ , [ @value = ]{ 'value' }
        [, [ @level0type = ]{ 'level0_object_type' }
                  , [ @level0name = ]{ 'level0_object_name' }
              [, [ @level1type = ]{ 'level1_object_type' }
                              , [ @level1name = ]{ 'level1_object_name' }
                     [, [ @level2type = ]{ 'level2_object_type' }
                                            , [ @level2name = ]{ 'level2_object_name' }
                     ]
              ]
        ]
    ]

Аргументы

[ @name = ]{ 'property_name'}
Имя обновляемого свойства. Аргумент property_name имеет тип sysname и не может принимать значение NULL.
[ @value = ]{ 'value'}
Значение, связанное со свойством. Аргумент value имеет тип sql_variant и значение по умолчанию NULL. Размер аргумента value не может превышать 7 500 байт.

[ @level0type = ]{ 'level0_object_type'}
Пользователь или определяемый пользователем тип. Аргумент level0_object_type имеет тип varchar(128) и значение по умолчанию NULL. Допустимые входные данные: ASSEMBLY, CONTRACT, EVENT NOTIFICATION, FILEGROUP, MESSAGE TYPE, PARTITION FUNCTION, PARTITION SCHEME, REMOTE SERVICE BINDING, ROUTE, SCHEMA, SERVICE, USER, TRIGGER, TYPE и NULL.

Важно!
Типы USER и TYPE уровня 0 будут удалены в будущих версиях SQL Server. Старайтесь не использовать эти элементы в новых разработках и предусмотрите соответствующие изменения в приложениях, которые используют эти типы в настоящее время. Тип SCHEMA следует использовать в качестве типа уровня 0 вместо USER. В значении аргумента TYPE следует указывать тип SCHEMA в качестве типа уровня 0 и TYPE в качестве типа уровня 1.

Типы USER и TYPE уровня 0 будут удалены в будущих версиях SQL Server. Старайтесь не использовать эти элементы в новых разработках и предусмотрите соответствующие изменения в приложениях, которые используют эти типы в настоящее время. Тип SCHEMA следует использовать в качестве типа уровня 0 вместо USER. В значении аргумента TYPE следует указывать тип SCHEMA в качестве типа уровня 0 и TYPE в качестве типа уровня 1.

[ @level0name = ]{ 'level0_object_name'}
Имя указанного типа объекта уровня 1. Аргумент level0_object_name имеет тип sysname и значение по умолчанию NULL.
[ @level1type = ]{ 'level1_object_type'}
Тип объекта уровня 1. Аргумент level1_object_type имеет тип varchar(128) и значение по умолчанию NULL. Допустимые входные значения: AGGREGATE, DEFAULT, FUNCTION, LOGICAL FILE NAME, PROCEDURE, QUEUE, RULE, SYNONYM, TABLE, TYPE, VIEW, XML SCHEMA COLLECTION и NULL.
[ @level1name = ]{ 'level1_object_name'}
Имя указанного типа объекта уровня 1. Аргумент level1_object_name имеет тип sysname и значение по умолчанию NULL.
[ @level2type = ]{ 'level2_object_type'}
Тип объекта уровня 2. Аргумент level2_object_type имеет тип varchar(128) и значение по умолчанию NULL. Допустимые входные данные: COLUMN, CONSTRAINT, EVENT NOTIFICATION, INDEX, PARAMETER, TRIGGER и NULL.
[ @level2name = ]{ 'level2_object_name'}
Имя указанного типа объекта уровня 2. Аргумент level2_object_name имеет тип sysname и значение по умолчанию NULL.

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

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

Замечания

С целью указания расширенных свойств объекты в базе данных SQL Server распределены по трем уровням (0, 1 и 2). Уровень 0 является высшим уровнем и определяется как «объекты в области базы данных». Объекты уровня 1 содержатся в схеме и в пользовательской области, а объекты уровня 2 содержатся в объектах уровня 1. Расширенные свойства могут быть определены для объектов на любом из этих уровней. Ссылки на объект определенного уровня должны быть уточнены именами объектов более высокого уровня, в которых они содержатся или которым они принадлежат. Полный список объектов и их допустимых типов уровня 0, 1 и 2 см. в разделе Использование расширенных свойств с объектами базы данных.

Если аргументы property_name и value принимают допустимые значения и все типы и имена объектов имеют значение NULL, то обновляемое свойство принадлежит текущей базе данных.

Разрешения

Члены предопределенных ролей базы данных db_owner и db_ddladmin могут обновлять расширенные свойства любого объекта за одним исключением: члены роли db_ddladmin не могут добавлять свойства к самой базе данных, пользователям или ролям.

Пользователи могут обновлять расширенные свойства принадлежащих им объектов, а также свойства, для которых у этих пользователей есть разрешения ALTER или CONTROL. Полный список необходимых разрешений см. в разделе Использование расширенных свойств с объектами базы данных.

Примеры

А. Обновление расширенного свойства столбца

В следующем примере обновляется значение свойства Caption столбца ID в таблице T1.

USE AdventureWorks2008R2;
GO
CREATE TABLE T1 (id int , name char (20));
GO
EXEC sp_addextendedproperty 
    @name = N'Caption'
    ,@value = N'Employee ID'
    ,@level0type = N'Schema', @level0name = dbo
    ,@level1type = N'Table',  @level1name = T1
    ,@level2type = N'Column', @level2name = id;
GO
--Update the extended property.
EXEC sp_updateextendedproperty 
    @name = N'Caption'
    ,@value = 'Employee ID must be unique.'
    ,@level0type = N'Schema', @level0name = dbo
    ,@level1type = N'Table',  @level1name = T1
    ,@level2type = N'Column', @level2name = id;
GO

Б. Обновление расширенного свойства базы данных

В следующем примере расширенное свойство образца базы данных База данных AdventureWorks2008R2 создается, затем обновляется.

USE AdventureWorks2008R2;
GO
EXEC sp_addextendedproperty 
@name = N'NewCaption', @value = 'AdventureWorks2008R2 Sample OLTP Database';
GO
USE AdventureWorks2008R2;
GO
EXEC sp_updateextendedproperty 
@name = N'NewCaption', @value = 'AdventureWorks2008R2 Sample Database';
GO