Share via

  • Makale

sp_updateextendedproperty (Transact-SQL)

Varolan bir genişletilmiş özellik değerini güncelleştirir.

Topic link iconTransact-SQL sözdizimi kuralları

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' }
                     ]
              ]
        ]
    ]

Bağımsız değişkenler

  • [ @name= ]{ 'property_name'}
    Is the name of the property to be updated.property_name is sysname, and cannot be NULL.

  • [ @value= ]{ 'value'}
    Is the value associated with the property.value is sql_variant, with a default of NULL.Boyutu value 7.500 bayttan fazla olabilir.

  • [ @level0type= ]{ 'level0_object_type'}
    Is the user or user-defined type.level0_object_type is varchar(128), with a default of NULL.derleme, SÖZLEşMEDEN, geçerli girişleri olan olay bildirim, dosya grubu, TÜR, PARTITION işlev, PARTITION DÜZENI REMOTE SERVICE BAĞLAMASı, yol, SCHEMA, HIZMET, KULLANıCı, TRIGGER, TÜR, ILETI ve NULL.

    Important noteImportant Note:

    KULLANıCı ve düzey 0 türleri olarak TÜRÜ, gelecekteki bir sürümüne kaldırılacaktır. SQL Server. Bu özellikler, yeni iş geliştirme kullanmaktan kaçının ve bu özellikleri kullanan uygulamalar değiştirmek planlama.Düzey 0 türü yerine, KULLANıCı SCHEMA kullanın.Düzey 1 türünde TÜRÜ için SCHEMA TÜRÜ ve 0 düzey türü kullanın.

  • [ @level0name= ]{ 'level0_object_name'}
    Is the name of the level 1 object type specified.level0_object_name is sysname with a default of NULL.

  • [ @level1type= ]{ 'level1_object_type'}
    Is the type of level 1 object.level1_object_type is varchar(128) with a default of NULL.Geçerli girişleri toplamak, VARSAYıLAN, işlev, LOGICAL FILE NAME, PROCEDURE, QUEUE, RULE, SYNONYM, tablo, TÜR, VIEW, XML SCHEMA koleksiyon ve NULL'dır.

  • [ @level1name= ]{ 'level1_object_name'}
    Is the name of the level 1 object type specified.level1_object_name is sysname with a default of NULL.

  • [ @level2type= ]{ 'level2_object_type'}
    Is the type of level 2 object.level2_object_type is varchar(128) with a default of NULL.Geçerli girişleri SÜTUN CONSTRAINT, OLAY UYARıSı, INDIS, PARAMETER, TRIGGER ve NULL ' dir.

  • [ @level2name= ]{ 'level2_object_name'}
    Is the name of the level 2 object type specified.level2_object_name is sysname, with a default of NULL.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Remarks

Genişletilmiş özellikler, nesneleri belirtmek amacıyla, bir SQL Server Veritabanı üç düzeylerine (0, 1 ve 2) sınıflandırması. Düzey 0 en yüksek düzeyidir ve bu veritabanında yer alan nesneler olarak tanımlanan kapsam.Düzey 1 nesneler, şema ya da kullanıcı bir kapsamda bulunan ve düzey 2 nesneleri düzey 1 nesneler tarafından içerilir.Genişletilmiş özellikler, bu düzeyleri en nesneler için tanımlanabilir.Bir düzey bir nesneye başvuru nesnelerin sahibi veya bunları içeren daha yüksek düzey adlarıyla nitelenmiş olmalıdır.1 Ve 2 türleri, nesneleri ve bunların geçerli düzey 0 tam listesi için bkz: Veritabanı nesneleri üzerinde genişletilmiş özellikleri'ni kullanma.

Geçerli bir verilen property_name ve value, güncelleştirilmiş özellik, tüm nesne türlerini ve adları null, geçerli veritabanına ait.

İzinler

Üyeleri db_owner and db_ddladmin veritabanı rollerini sabit genişletilmiş herhangi bir nesnenin özelliklerini aşağıdaki durumla güncelleştirebilir: db_ddladmin özellikleri veritabanına veya kullanıcılar veya roller ekleme değil.

Kullanıcılar, genişletilmiş özellikler güncelleştirebilir ya da, ALTER veya DENETIM izinlere sahip oldukları nesnelerine sahip.Gerekli izinleri tam listesi için bkz: Veritabanı nesneleri üzerinde genişletilmiş özellikleri'ni kullanma.

Örnekler

C.Güncelleştirme bir Genişletilmiş özellik bir sütunda

Aşağıdaki örnek özelliğinin değeri güncelleştirir. Caption sütun ID Tablo T1.

USE AdventureWorks;
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

b.Genişletilmiş bir özellik üzerinde bir veritabanı güncelleştiriliyor

Aşağıdaki örnek, bir genişletilmiş özellik üzerinde ilk oluşturur AdventureWorks Örnek veritabanını ve ardından bu özelliğin değeri) güncelleştirir.

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