sp_updateextendedproperty (Transact-SQL)

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 özellik adıdır.property_nameİş sysname, ve null.

• [ @value= ]{ 'value'}
  ' % S'özelliği özellikile ilişkili değerdir.valueİş sql_variant, varsayılan değer null.Boyutunu value olmayabilir çok 7.500 bayt.

• [ @level0type= ]{ 'level0_object_type'}
  Kullanıcı veya kullanıcı tanımlı türolan.level0_object_typeİş varchar(128), varsayılan değer null.Geçerli DERLEME, sözleşme, olay bildirimi, dosya grubu, 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 null sinyalidir.

  Önemli
  Kullanıcı ve düzeytürü-0 türleri, gelecekteki bir sürüm kaldırılır SQL Server.Yeni geliştirme çalışması bu özellikleri kullanmaktan kaçının ve şu anda bu özellikleri kullanan uygulamaları değiştirmek plan.Şema, kullanıcı yerine düzey 0 türü kullanın.YAZIDA, düzey 1 türünde şema düzey 0 türü ve türü kullanın.

• [ @level0name= ]{ 'level0_object_name'}
  Belirtilen düzey 1 nesne türünün adıdır.level0_object_nameİş sysname Varsayılan değer null.

• [ @level1type= ]{ 'level1_object_type'}
  düzey 1 nesne türüdür.level1_object_typeİş varchar(128) Varsayılan değer null.Geçerli toplam, varsayılan, işlevi, MANTIKSAL dosya adını, yordam, SIRA, kural, eş, tablo, türü, görünüm, xml şema KOLEKSİYONU ve null sinyalidir.

• [ @level1name= ]{ 'level1_object_name'}
  Belirtilen düzey 1 nesne türünün adıdır.level1_object_nameİş sysname Varsayılan değer null.

• [ @level2type= ]{ 'level2_object_type'}
  düzey 2 nesne türüdür.level2_object_typeİş varchar(128) Varsayılan değer null.Geçerli sütun kısıtlaması, olay bildirimi, dizin, parametre, TETİK ve null sinyalidir.

• [ @level2name= ]{ 'level2_object_name'}
  Belirtilen düzey 2 nesne türünün adıdır.level2_object_nameİş sysname, varsayılan değer null.

Dönüş Kodu Değerleri

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

Açıklamalar

Nesneleri genişletilmiş özelliklerini belirtmek amacıyla, bir SQL Server veritabanı üç düzeylerine (0, 1 ve 2) sınıflandırılmış.Düzey 0 en yüksek düzey ve veritabanı kapsamiçerdiği nesneleri olarak tanımlanır.Düzey 1 nesneleri bir şema veya kullanıcı kapsamiçinde yer alır ve düzey 2 nesne düzey 1 nesneler tarafından yer alır.Genişletilmiş özellikler, bu düzeyleri en nesneler için tanımlanabilir.Bir düzey bir nesneye başvuru sahibi veya bunları içeren daha yüksek düzey nesnelere adlarıyla uygun olmalıdır.Nesneleri ve bunların geçerli düzey 0, 1 ve 2 türlerinin tam listesi için bkz: Veritabanı nesneleri genişletilmiş özelliklerini kullanma.

Geçerli bir verilen property_name ve value, izliyorsanız tüm nesne türleri ve adları null özellik güncelleştirildi ait geçerli bir veritabanı.

İzinler

Üyeleri db_owner ve db_ddladmin sabit veritabanı rolleri yalnız 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.

Kullanıcılar, genişletilmiş özellikleri güncelleştirmek nesnelere sahip oldukları veya üzerinde sahip oldukları alter veya Denetim izinlerini.Gerekli izinleri tam listesi için bkz: Veritabanı nesneleri genişletilmiş özelliklerini kullanma.

Örnekler

A.sütunbir genişletilmiş özellik güncelleştiriliyor

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

B.Bir veritabanını bir genişletilmiş özellik güncelleştiriliyor

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

Ayrıca bkz.

Başvuru

Kavramlar