sp_dropextendedproperty (Transact-sql)

Makale
10/29/2012

Varolan bir genişletilmiş özellik bırakır.

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

Sözdizimi

sp_dropextendedproperty 
    [ @name = ] { 'property_name' }
      [ , [ @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'}
Özelliği kesilmesini addır. property_nameise sysname, ve boş olamaz.

[ @level0type= ]{ 'level0_object_type'}
Belirtilen düzeyi 0 nesne türü addır. 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 0 nesne türü addır. level0_object_name's 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, table_type, 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 sysnamenull 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üzeyde sınıflandırılır: 0, 1 ve 2. 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. Başvuruları için bir düzey nesne türleri ve adları tüm üst düzey nesneleri ile kalifiye olmalıdır.

Geçerli bir verilen property_name, tüm nesne türleri ve adları boş ve geçerli veritabanında bir özelliği var, özellik silinir. Bu konudaki izleyen b bkz.

İzinler

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

Kullanıcılar kendilerine ait veya alter veya Denetim izinlerini var nesneleri genişletilmiş özelliklerini düşebilir.

Örnekler

A.Bir sütun üzerinde genişletilmiş özellik siliniyor

Aşağıdaki örnek özelliği kaldırır captionsütundan idtablo T1şemada bulunan dbo.

CREATE TABLE T1 (id int , name char (20));
GO
EXEC sp_addextendedproperty 
    @name = 'caption' 
    ,@value = 'Employee ID' 
    ,@level0type = 'schema' 
    ,@level0name = dbo
    ,@level1type = 'table'
    ,@level1name = 'T1'
    ,@level2type = 'column'
    ,@level2name = id;
GO
EXEC sp_dropextendedproperty 
     @name = 'caption' 
    ,@level0type = 'schema' 
    ,@level0name = dbo
    ,@level1type = 'table'
    ,@level1name = 'T1'
    ,@level2type = 'column'
    ,@level2name = id;
GO
DROP TABLE T1;
GO

CREATE TABLE T1 (id int , name char (20));
GO
EXEC sp_addextendedproperty 
    @name = 'caption' 
    ,@value = 'Employee ID' 
    ,@level0type = 'schema' 
    ,@level0name = dbo
    ,@level1type = 'table'
    ,@level1name = 'T1'
    ,@level2type = 'column'
    ,@level2name = id;
GO
EXEC sp_dropextendedproperty 
     @name = 'caption' 
    ,@level0type = 'schema' 
    ,@level0name = dbo
    ,@level1type = 'table'
    ,@level1name = 'T1'
    ,@level2type = 'column'
    ,@level2name = id;
GO
DROP TABLE T1;
GO

B.Bir veritabanı genişletilmiş özellik siliniyor

Aşağıdaki örnek, adlı özelliği kaldırır MS_ Description dan AdventureWorks2012 örnek veritabanı. Özellik veritabanı üzerinde olduğundan, hiçbir nesne türleri ve adları belirtilir.

USE AdventureWorks2012;
GO
EXEC sp_dropextendedproperty 
@name = N'MS_Description';
GO

USE AdventureWorks2012;
GO
EXEC sp_dropextendedproperty 
@name = N'MS_Description';
GO