Udostępnij za pośrednictwem

  • Artykuł

sp_dropextendedproperty (języka Transact-SQL)

Spadnie, istniejące właściwośćrozszerzone.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

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żna informacjaWaż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