sp_dropextendedproperty (języka Transact-SQL)
Spadnie, istniejące właściwośćrozszerzone.
Składnia
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' }
]
]
]
]
Argumenty
[ @name= ]{ 'property_name'}
Jest nazwą właściwość ma być przerwane.property_namejest sysname i nie może być NULL.[ @level0type= ]{ 'level0_object_type'}
Jest nazwą typu obiektu poziom 0 określonego.level0_object_typejest varchar(128), domyślna wartość NULL.Prawidłowe dane wejściowe są zestawu, umowy, powiadomienie o zdarzeniu, grupa plików, typ wiadomości, funkcja PARTYCJI, schemat PARTYCJI, powiązania usługi zdalnego, trasy, SCHEMATU, usługi, użytkownika, WYZWALACZ, typ i NULL.
Ważne: Użytkownik i typ jako poziom-0 typy zostaną usunięte w przyszłej wersja programu SQL Server.Unikaj używania tych funkcji w nowych prac rozwojowych i plan do modyfikowania aplikacji, które obecnie korzystają z tych funkcji.Użyj SCHEMATU jako typ poziom 0 w użytkownika.Dla typu należy użyć SCHEMATU jako typ poziom 0 i typ jako typ poziom 1.
[ @level0name= ]{ 'level0_object_name'}
Jest nazwą typu obiektu poziom 0 określonego. level0_object_name jest sysname Domyślna wartość NULL.[ @level1type= ]{ 'level1_object_type'}
Jest to typ obiektu poziom 1.level1_object_typejest varchar(128) Domyślna wartość NULL.Nieprawidłowe dane wejściowe są agregacji, domyślny, funkcja, nazwa pliku LOGICZNEGO, procedury, kolejki, reguły, SYNONIM, tabeli, TABLE_TYPE, typu, WIDOKU, KOLEKCJI SCHEMATU XML i NULL.[ @level1name= ]{ 'level1_object_name'}
Jest nazwą typu obiektu poziom 1 określonego.level1_object_namejest sysname Domyślna wartość NULL.[ @level2type= ]{ 'level2_object_type'}
Jest to typ obiektu poziom 2.level2_object_typejest varchar(128) Domyślna wartość NULL.Prawidłowe dane wejściowe są kolumny, ograniczenie, powiadomienie o zdarzeniu, indeks, PARAMETR, WYZWALACZ i wartości NULL.[ @level2name= ]{ 'level2_object_name'}
Jest nazwą typu obiektu poziom 2 określonego.level2_object_namejest sysname Domyślna wartość NULL.
Wartości kodów powrotnych
0 (sukces) lub 1 (błąd)
Uwagi
O określenie właściwości rozszerzone, obiekty w SQL Server bazy danych dzieli się na trzy poziomy: 0, 1 i 2.Poziom 0 jest najwyższy poziom i jest definiowana jako obiekty zawarte w bazie danych zakres.Obiekty poziomu 1 są zawarte w schematu lub użytkownika zakresi poziom 2 obiekty są zawarte przez obiekty poziom 1.Właściwości rozszerzone można zdefiniować dla obiektów w dowolnym z tych poziomów.Musi być kwalifikowany odwołania do obiektu w poziom jeden z typów i nazw wszystkich obiektów wyższy poziom .
Biorąc pod uwagę prawidłowego property_name, null są wszystkie typy obiektów i nazwy właściwość istnieje w bieżącej bazie danych, ta właściwość jest usuwany.Zobacz przykład B, znajdujący się w dalszej części tego tematu.
Uprawnienia
Członkowie db_owner i db_ddladmin ról stałej bazy danych mogą przerywać rozszerzone właściwości dowolnego obiektu, z następującym wyjątkiem: db_ddladminnie można dodać właściwości do samej bazy danych lub do użytkowników lub role.
Użytkownicy mogą przerywać właściwości rozszerzone do obiektów właścicielem lub w którym mają oni uprawnienia ALTER lub FORMANTU.Aby uzyskać pełną listę wymaganych uprawnień, zobacz Używanie rozszerzonych właociwooci obiektów bazy danych.
Przykłady
A.Upuszczanie rozszerzonych właściwość kolumna
W następującym przykładzie usunięto właściwość caption z kolumna id w tabela T1 zawartych w schemacie 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
B.Upuszczanie rozszerzonych właściwość bazy danych
W następującym przykładzie usunięto właściwość o nazwie MS_Description z AdventureWorks2008R2 przykładowej bazy danych.Ponieważ właściwość znajduje się na samej bazy danych, są określone nie typy obiektów i nazwy.
USE AdventureWorks2008R2;
GO
EXEC sp_dropextendedproperty
@name = N'MS_Description';
GO
Zobacz także