sp_dropextendedproperty (Transact-SQL)sp_dropextendedproperty (Transact-SQL)

Gilt für: JaSQL Server NeinAzure SQL-Datenbank NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Löscht eine vorhandene erweiterte Eigenschaft.Drops an existing extended property.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

  
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' }   
                ]   
            ]   
        ]   
    ]   

ArgumenteArguments

[ @name=] {'Property_name'}[ @name= ]{ 'property_name'}
Der Name der zu löschenden Eigenschaft.Is the name of the property to be dropped. Property_name ist Sysname und darf nicht NULL sein.property_name is sysname and cannot be NULL.

[ @level0type=] {'level0_object_type'}[ @level0type= ]{ 'level0_object_type'}
Der Name des angegebenen Objekttyps der Ebene 0.Is the name of the level 0 object type specified. level0_object_type ist varchar(128) , hat den Standardwert NULL.level0_object_type is varchar(128), with a default of NULL.

Gültige Eingabewerte sind ASSEMBLY, CONTRACT, EVENT NOTIFICATION, FILEGROUP, MESSAGE TYPE, PARTITION FUNCTION, PARTITION SCHEME, REMOTE SERVICE BINDING, ROUTE, SCHEMA, SERVICE, USER, TRIGGER, TYPE und NULL.Valid inputs are ASSEMBLY, CONTRACT, EVENT NOTIFICATION, FILEGROUP, MESSAGE TYPE, PARTITION FUNCTION, PARTITION SCHEME, REMOTE SERVICE BINDING, ROUTE, SCHEMA, SERVICE, USER, TRIGGER, TYPE, and NULL.

Wichtig

USER und TYPE als Typen der Ebene 0 werden in einer zukünftigen Version von SQL ServerSQL Server nicht mehr unterstützt.USER and TYPE as level-0 types will be removed in a future version of SQL ServerSQL Server. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktionen zurzeit verwenden.Avoid using these features in new development work, and plan to modify applications that currently use these features. Verwenden Sie SCHEMA anstelle von USER als Typ der Ebene 0.Use SCHEMA as the level 0 type instead of USER. Verwenden Sie für TYPE als Typ der Ebene 0 SCHEMA und TYPE als Typ der Ebene 1.For TYPE, use SCHEMA as the level 0 type and TYPE as the level 1 type.

[ @level0name=] {'level0_object_name'}[ @level0name= ]{ 'level0_object_name'}
Der Name des angegebenen Objekttyps der Ebene 0.Is the name of the level 0 object type specified. level0_object_name ist Sysname hat den Standardwert NULL.level0_object_name is sysname with a default of NULL.

[ @level1type=] {'level1_object_type'}[ @level1type= ]{ 'level1_object_type'}
Der Typ des Objekts der Ebene 1.Is the type of level 1 object. level1_object_type ist varchar(128) hat den Standardwert NULL.level1_object_type is varchar(128) with a default of NULL. Gültige Eingabewerte sind AGGREGATE, DEFAULT, FUNCTION, LOGICAL FILE NAME, PROCEDURE, QUEUE, RULE, SYNONYM, TABLE, TABLE_TYPE, TYPE, VIEW, XML SCHEMA COLLECTION und NULL.Valid inputs are AGGREGATE, DEFAULT, FUNCTION, LOGICAL FILE NAME, PROCEDURE, QUEUE, RULE, SYNONYM, TABLE, TABLE_TYPE, TYPE, VIEW, XML SCHEMA COLLECTION, and NULL.

[ @level1name=] {'level1_object_name'}[ @level1name= ]{ 'level1_object_name'}
Der Name des angegebenen Objekttyps der Ebene 1.Is the name of the level 1 object type specified. level1_object_name ist Sysname hat den Standardwert NULL.level1_object_name is sysname with a default of NULL.

[ @level2type=] {'level2_object_type'}[ @level2type= ]{ 'level2_object_type'}
Der Typ des Objekts der Ebene 2.Is the type of level 2 object. level2_object_type ist varchar(128) hat den Standardwert NULL.level2_object_type is varchar(128) with a default of NULL. Gültige Eingabewerte sind COLUMN, CONSTRAINT, EVENT NOTIFICATION, INDEX, PARAMETER, TRIGGER und NULL.Valid inputs are COLUMN, CONSTRAINT, EVENT NOTIFICATION, INDEX, PARAMETER, TRIGGER, and NULL.

[ @level2name=] {'level2_object_name'}[ @level2name= ]{ 'level2_object_name'}
Der Name des angegebenen Objekttyps der Ebene 2.Is the name of the level 2 object type specified. level2_object_name ist Sysname hat den Standardwert NULL.level2_object_name is sysname with a default of NULL.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

Für das Angeben erweiterter Eigenschaften werden die Objekte in einem SQL ServerSQL Server -Datenbank in drei Ebenen unterteilt: 0, 1 und 2.For the purpose of specifying extended properties, the objects in a SQL ServerSQL Server database are classified into three levels: 0, 1, and 2. Die Ebene 0 ist die höchste Ebene und ist definiert als Objekte, die im Datenbankbereich enthalten sind.Level 0 is the highest level and is defined as objects contained at the database scope. Objekte der Ebene 1 sind in einem Schema- oder Benutzerbereich enthalten, und Objekte der Ebene 2 sind in Objekten der Ebene 1 enthalten.Level 1 objects are contained in a schema or user scope, and level 2 objects are contained by level 1 objects. Erweiterte Eigenschaften können für Objekte auf einer dieser Ebenen definiert werden.Extended properties can be defined for objects at any of these levels. Verweise auf ein Objekt einer Ebene müssen mit den Typen und Namen aller Objekte der höheren Ebenen gekennzeichnet werden.References to an object in one level must be qualified with the types and names of all higher level objects.

Wenn bei einem gültigen Property_name, wenn alle Objekttypen und-Namen null sind und eine Eigenschaft, die in der aktuellen Datenbank vorhanden ist, diese Eigenschaft gelöscht.Given a valid property_name, if all object types and names are null and a property exists on the current database, that property is deleted. Weitere Informationen finden Sie im Beispiel B, weiter unten in diesem Thema.See example B that follows later in this topic.

BerechtigungenPermissions

Mitglieder der festen Datenbankrollen db_owner und db_ddladmin können erweiterte Eigenschaften beliebiger Objekte mit folgender Ausnahme löschen: db_ddladmin kann weder der Datenbank noch Benutzern oder Rollen Eigenschaften hinzufügen.Members of the db_owner and db_ddladmin fixed database roles may drop extended properties of any object with the following exception: db_ddladmin may not add properties to the database itself, or to users or roles.

Benutzer können erweiterte Eigenschaften von Objekten löschen, die sie besitzen, oder für die sie über die ALTER- oder CONTROL-Berechtigung verfügen.Users may drop extended properties to objects they own or on which they have ALTER or CONTROL permissions.

BeispieleExamples

A.A. Löschen der erweiterten Eigenschaft einer SpalteDropping an extended property on a column

Im folgenden Beispiel wird die caption-Eigenschaft aus der id-Spalte in der T1-Tabelle entfernt, die im dbo-Schema enthalten ist.The following example removes the property caption from column id in table T1 contained in the schema 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.B. Löschen der erweiterten Eigenschaft einer DatenbankDropping an extended property on a database

Im folgenden Beispiel wird die Eigenschaft mit dem Namen MS_Description aus der AdventureWorks2012AdventureWorks2012 -Beispieldatenbank.The following example removes the property named MS_Description from the AdventureWorks2012AdventureWorks2012 sample database. Da die Eigenschaft zur Datenbank selbst gehört, werden keine Objekttypen und -namen angegeben.Because the property is on the database itself, no object types and names are specified.

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

Siehe auchSee Also

Datenbank-Engine gespeicherten Prozeduren (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sys.fn_listextendedproperty (Transact-SQL) sys.fn_listextendedproperty (Transact-SQL)
sp_addextendedproperty (Transact-SQL) sp_addextendedproperty (Transact-SQL)
Sp_updateextendedproperty (Transact-SQL) sp_updateextendedproperty (Transact-SQL)
sys.extended_properties (Transact-SQL)sys.extended_properties (Transact-SQL)