Aracılığıyla paylaş

sp_dropextendedproperty (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Mevcut genişletilmiş bir mülkü kaldırır.

Transact-SQL söz dizimi kuralları

Sözdizimi

sp_dropextendedproperty
    [ @name = ] N'name'
    [ , [ @level0type = ] 'level0type' ]
    [ , [ @level0name = ] N'level0name' ]
    [ , [ @level1type = ] 'level1type' ]
    [ , [ @level1name = ] N'level1name' ]
    [ , [ @level2type = ] 'level2type' ]
    [ , [ @level2name = ] N'level2name' ]
[ ; ]

Arguments

[ @name = ] ‘name’

Çıkarılacak mülkün adı. @namesysname'dir ve olamaz NULL.

[ @level0type = ] 'level0type'

Belirtilen seviye 0 nesne türünün adı. @level0typevarchar(128)'dir ve varsayılan olarak NULL.

Geçerli girdiler ASSEMBLY, CONTRACT, EVENT NOTIFICATION, FILEGROUPMESSAGE TYPE, , PARTITION FUNCTION, REMOTE SERVICE BINDINGSCHEMAROUTEPARTITION SCHEMEUSERTRIGGERSERVICETYPE, ve .NULL

Önemli

USER ve TYPE seviye-0 tipleri SQL Server'ın gelecekteki bir sürümünde kaldırılacaktır. Bu özellikleri yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özellikleri kullanan uygulamaları değiştirmeyi planlayın. SCHEMA Seviye 0 türü olarak kullanın, yerine USER. Için TYPE, seviye 0 tipi olarak ve TYPE seviye 1 tipi olarak kullanınSCHEMA.

[ @level0name = ] N'level0name'

Belirtilen seviye 0 nesne türünün adı. @level0namesysname'dir, varsayılan NULLolarak .

[ @level1type = ] 'level1type'

Seviye 1 nesnenin türü. @level1typevarchar(128)'dir ve varsayılan olarak .NULL

Geçerli girdiler AGGREGATE, DEFAULT, FUNCTION, LOGICAL FILE NAMEPROCEDURE, , QUEUE, RULESYNONYM, TABLETYPEVIEWTABLE_TYPEXML SCHEMA COLLECTION, ve .NULL

[ @level1name = ] N'level1name'

Belirtilen seviye 1 nesne türünün adı. @level1namesysname'dir ve varsayılan olarak .NULL

[ @level2type = ] 'level2type'

Seviye 2 nesne türü. @level2typevarchar(128)'dir ve varsayılan olarak .NULL

Geçerli girdiler COLUMN, CONSTRAINT, EVENT NOTIFICATION, INDEXPARAMETER, TRIGGER, , , ve NULL.

[ @level2name = ] N'level2name'

Belirtilen seviye 2 nesne türünün adı. @level2namesysname'dir ve varsayılan olarak .NULL

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Açıklamalar

Genişletilmiş özellikler belirttiğinizde, SQL Server veritabanındaki nesneler üç düzeye ayrılır: 0, 1 ve 2. Seviye 0 en yüksek seviyedir ve veritabanı kapsamında bulunan nesneler olarak tanımlanır. Seviye 1 nesneler bir şema veya kullanıcı kapsamı içinde, seviye 2 nesneler ise seviye 1 nesneler tarafından tutulur. Bu seviyelerden herhangi birinde nesneler için genişletilmiş özellikler tanımlanabilir. Bir seviyedeki nesneye yapılan referanslar, tüm üst düzey nesnelerin türleri ve isimleriyle nitelendirilmelidir.

Geçerli bir özellik adı verildiğinde @name, tüm nesne türleri ve adları varsa NULL ve mevcut veritabanında bir özellik varsa, o özellik silinir. Bu makalenin ilerleyen bölümlerinde yer alan Örnek B'ye bakınız.

Permissions

db_owner ve db_ddladmin sabit veritabanı rollerinin üyeleri, aşağıdaki istisna dışında herhangi bir nesnenin genişletilmiş özelliklerini kaldırabilir: db_ddladmin veritabanının kendisine, kullanıcılara veya rollere özellikler ekleyemez.

Kullanıcılar, sahip oldukları veya ALTER üzerinde izinleri CONTROL olan nesnelere genişletilmiş özellikler bırakabilirler.

Örnekler

A. Bir sütuna genişletilmiş bir özellik bırakın

Aşağıdaki örnek, şemadaki dbotablodaki T1 sütundan id özelliği caption kaldırır.

CREATE TABLE T1
(
    id INT,
    name CHAR (20)
);
GO

EXECUTE sp_addextendedproperty
    @name = 'caption',
    @value = 'Employee ID',
    @level0type = 'SCHEMA',
    @level0name = N'dbo',
    @level1type = 'TABLE',
    @level1name = N'T1',
    @level2type = 'COLUMN',
    @level2name = N'id';
GO

EXECUTE sp_dropextendedproperty
    @name = 'caption',
    @level0type = 'SCHEMA',
    @level0name = N'dbo',
    @level1type = 'TABLE',
    @level1name = N'T1',
    @level2type = 'COLUMN',
    @level2name = N'id';
GO

DROP TABLE T1;
GO

B. Genişletilmiş bir özelliği veritabanına bırakın

Aşağıdaki örnek, örnek veritabanından adlandırılmış MS_DescriptionAdventureWorks2025 özelliği kaldırır. Özellik veritabanında olduğu için herhangi bir nesne türü ve adı belirtilmez.

USE AdventureWorks2022;
GO

EXECUTE sp_dropextendedproperty @name = N'MS_Description';
GO

İlgili içerik

  • Last updated on