Dela via

sp_dropextendedproperty (Transact-SQL)

Gäller för:SQL Server

Tar bort en befintlig utökad fastighet.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @name = ] N'namn'

Namnet på fastigheten som ska tas bort. @name är sysname, och kan inte vara NULL.

[ @level0type = ] 'level0type'

Namnet på den angivna objekttypen nivå 0. @level0type är varchar(128), med standardvärdet NULL.

Giltiga indata är ASSEMBLY, , , EVENT NOTIFICATIONFILEGROUP, MESSAGE TYPE, , PARTITION FUNCTIONPARTITION SCHEME, REMOTE SERVICE BINDING, , ROUTE, SCHEMATYPESERVICEUSERTRIGGERoch .NULLCONTRACT

Viktigt!

USER och TYPE som nivå 0-typer kommer att tas bort i en framtida version av SQL Server. Undvik att använda de här funktionerna i det nya utvecklingsarbetet och planera att ändra program som för närvarande använder dessa funktioner. Använd SCHEMA som nivå 0-typen istället för USER. För TYPE, använd SCHEMA som nivå 0-typen och TYPE som nivå 1-typen.

[ @level0name = ] N'level0name'

Namnet på den angivna objekttypen nivå 0. @level0name är sysname med standardvärdet NULL.

[ @level1type = ] "level1type"

Typ av objekt på nivå 1. @level1type är varchar(128), med standardvärdet NULL.

Giltiga indata är , , , , , , QUEUERULE, , SYNONYM, TABLEXML SCHEMA COLLECTIONVIEWTYPETABLE_TYPEoch .NULLPROCEDURELOGICAL FILE NAMEFUNCTIONDEFAULTAGGREGATE

[ @level1name = ] N'level1name'

Namnet på den angivna objekttypen nivå 1. @level1name är sysname med standardvärdet NULL.

[ @level2type = ] 'level2type'

Typ av nivå 2-objekt. @level2type är varchar(128), med standardvärdet NULL.

Giltiga indata är , , , , INDEXPARAMETER, , TRIGGERoch NULL. EVENT NOTIFICATIONCONSTRAINTCOLUMN

[ @level2name = ] N'level2name'

Namnet på den angivna objekttypen nivå 2. @level2name är sysname med standardvärdet NULL.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

När du anger utökade egenskaper klassificeras objekten i en SQL Server-databas i tre nivåer: 0, 1 och 2. Nivå 0 är den högsta nivån och definieras som objekt som finns i databasens omfång. Nivå 1-objekt finns i ett schema eller användaromfång och objekt på nivå 2 finns i objekt på nivå 1. Utökade egenskaper kan definieras för objekt på någon av dessa nivåer. Referenser till ett objekt på en nivå måste kvalificeras med typer och namn på alla objekt på högre nivå.

Givet ett giltigt egenskapsnamn @name, om alla objekttyper och namn är NULL och en egenskap finns i den aktuella databasen, tas den egenskapen bort. Se exempel B som följer senare i denna artikel.

Permissions

Medlemmar av db_owner och db_ddladmin fasta databasroller kan ta bort utökade egenskaper för vilket objekt som helst med följande undantag: db_ddladmin kan inte lägga till egenskaper i själva databasen, eller i användare eller roller.

Användare kan släppa utökade egenskaper till objekt de äger, eller som de har ALTER eller CONTROL behörigheter på.

Examples

A. Släpp en utökad egenskap på en kolumn

Följande exempel tar bort egenskapen caption från kolumnen id i tabellen T1 som finns i schemat dbo.

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. Lägg in en utökad egenskap i en databas

Följande exempel tar bort egenskapen som heter MS_Description från AdventureWorks2025 exempeldatabasen. Eftersom egenskapen finns i själva databasen anges inga objekttyper eller namn.

USE AdventureWorks2022;
GO

EXECUTE sp_dropextendedproperty @name = N'MS_Description';
GO

Relaterat innehåll

  • Last updated on