sp_updateextendedproperty (Transact-sql)

Makale
10/29/2012

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

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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'}
Güncelleştirilecek özelliği adıdır. property_nameise sysname, ve boş olamaz.
[ @value= ]{ 'value'}
Özelliği ile ilişkili değerdir. valueise sql_variant, null varsayılan. Boyutunu value7,500 bayttan fazla olmayabilir.

[ @level0type= ]{ 'level0_object_type'}
Kullanıcı ya da kullanıcı tanımlı türü olduğunu. level0_object_typeise varchar(128), null varsayılan. Geçerli girişleri, derleme, sözleşme, olay bildirimi, FILEGROUP, ileti türü, Bölüm işlevi, bölüm düzeni, uzak hizmet bağlama, yol, şema, hizmet, kullanıcı, tetikleyici, türü ve boş bulunmaktadır.

Önemli
KULLANICI ve tip seviye-0 türleri olarak, gelecekteki bir sürümüne kaldırılacak SQL Server. Yeni geliştirme çalışmalarında bu özellikleri kullanmaktan kaçının ve şu anda bu özellikleri kullanan uygulamaları değiştirmek planlıyoruz. ŞEMA düzeyi 0 yerine kullanıcı türünü kullanın. TÜRÜ için şema türü ve düzey 0 türü Düzey 1 türünde kullanın.

[ @level0name= ]{ 'level0_object_name'}
Belirtilen düzeyi 1 nesne türü addır. level0_object_nameise sysnamenull varsayılan.
[ @level1type= ]{ 'level1_object_type'}
Düzey 1 nesne türüdür. level1_object_typeise varchar(128)null varsayılan. Geçerli girişleri, toplama, varsayılan, işlevi, mantıksal dosya adını, yordam, sıra, kural, eşanlamlı, tablo, türü, görünüm, xml şema koleksiyonu ve null vardır.
[ @level1name= ]{ 'level1_object_name'}
Belirtilen düzeyi 1 nesne türü addır. level1_object_nameise sysnamenull varsayılan.
[ @level2type= ]{ 'level2_object_type'}
Düzey 2 nesne türüdür. level2_object_typeise varchar(128)null varsayılan. Geçerli girişleri, sütun, KISITLAMA, olay bildirimi, dizin, parametre, tetik ve null vardır.
[ @level2name= ]{ 'level2_object_name'}
Belirtilen düzeyi 2 nesne türü addır. level2_object_nameise sysname, null varsayılan.

Dönüş Kodu Değerleri

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

Açıklamalar

Genişletilmiş özellikleri, nesneleri belirleme amacı bir SQL Serververitabanı üç düzeylerine (0, 1 ve 2) sınıflandırılır. Düzey 0 en üst düzeyde olduğunu ve veritabanı kapsamında bulunan nesneler olarak tanımlanır. Düzey 1 nesneleri bir şema veya kullanıcı kapsamında bulunan ve düzey 2 nesne düzeyi 1 nesneler tarafından bulunur. Genişletilmiş özellikler, herhangi bir bu düzeyleri nesneler için tanımlanabilir. Bir düzey nesne başvurularını kendi ya da bunları içeren yüksek düzey nesnelerin isimleri ile kalifiye olmalıdır.

Geçerli bir verilen property_name ve value, tüm nesne türleri ve adları null ise, updated özelliğinin geçerli veritabanına ait.

İzinler

Üyeleri db_ownerve db_ddladminsabit veritabanı rolleri aşağıdaki özel durum ile herhangi bir nesnenin Genişletilmiş özellikleri güncelleştirmek: db_ddladminÖzellikleri veritabanına veya kullanıcılar veya roller için ekleyebilir değil.

Genişletilmiş özellikler güncellemelerini nesnelere sahip oldukları ya da alter veya Denetim izinlerini olmaları.

Örnekler

A.Bir sütunda bir genişletilmiş özellik güncelleştiriliyor

Aşağıdaki örnek özelliğinin değerini güncelleştirir Captionsütun IDtablo T1.

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

USE AdventureWorks2012;
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.Veritabanı genişletilmiş özellik güncelleştiriliyor

Aşağıdaki örnekte, genişletilmiş özellik üzerinde ilk oluşturur AdventureWorks2012 örnek veritabanı ve o özelliğin değerini güncelleştirir.

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

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