Sdílet prostřednictvím

sp_dropextendedproperty (Transact-SQL)

platí pro:SQL Server

Zruší stávající rozšířenou nemovitost.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

[ @name = ] N'jméno'

Název nemovitosti, která má být odstraněna. @name je sysname a nemůže být NULL.

[ @level0type = ] 'level0type'

Název specifikovaného typu objektu úrovně 0. @level0type je varchar(128), s výchozím hodnotou NULL.

Platné vstupy jsou , , , , , , , PARTITION SCHEME, TRIGGERSCHEMASERVICETYPEREMOTE SERVICE BINDINGUSERROUTEa .NULLPARTITION FUNCTIONMESSAGE TYPEFILEGROUPEVENT NOTIFICATIONCONTRACTASSEMBLY

Důležité

USER a TYPE protože typy úrovně 0 budou odstraněny v budoucí verzi SQL Serveru. Vyhněte se používání těchto funkcí v nové vývojové práci a naplánujte úpravu aplikací, které tyto funkce aktuálně používají. Použijte SCHEMA jako typ úrovně 0 místo .USER Pro TYPE, použijte SCHEMA jako typ úrovně 0 a TYPE jako typ úrovně 1.

[ @level0name = ] N'level0name'

Název specifikovaného typu objektu úrovně 0. @level0name je sysname s výchozím nastavením NULL.

[ @level1type = ] 'level1type'

Typ objektu úrovně 1. @level1type je varchar(128), s výchozím hodnotou NULL.

Platné vstupy jsou , , , , , , , RULE, SYNONYMTYPEXML SCHEMA COLLECTIONTABLEVIEWTABLE_TYPEa .NULLQUEUEPROCEDURELOGICAL FILE NAMEFUNCTIONDEFAULTAGGREGATE

[ @level1name = ] N'level1name'

Název specifikovaného typu objektu úrovně 1. @level1name je sysname s výchozím nastavením NULL.

[ @level2type = ] 'level2type'

Typ objektu úrovně 2. @level2type je varchar(128), s výchozím hodnotou NULL.

Platné vstupy jsou COLUMN, CONSTRAINT, EVENT NOTIFICATION, INDEX, PARAMETER, , TRIGGERa .NULL

[ @level2name = ] N'level2name'

Název specifikovaného typu objektu úrovně 2. @level2name je sysname s výchozím nastavením NULL.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Při zadávání rozšířených vlastností se objekty v databázi SQL Serveru klasifikují do tří úrovní: 0, 1 a 2. Úroveň 0 je nejvyšší úroveň a je definována jako objekty obsažené v rozsahu databáze. Objekty úrovně 1 jsou obsaženy ve schématu nebo uživatelském rozsahu a objekty úrovně 2 jsou obsaženy v objektech úrovně 1. Rozšířené vlastnosti lze definovat pro objekty na kterékoliv z těchto úrovní. Odkazy na objekt v jedné úrovni musí být kvalifikovány typy a názvy všech objektů vyšší úrovně.

Pokud je @name daná platná vlastnost, pokud jsou všechny typy objektů a názvy NULL a vlastnost existuje v aktuální databázi, tato vlastnost se smaže. Viz příklad B, který následuje později v tomto článku.

Povolení

Členové pevných databázových rolí db_owner a db_ddladmin mohou odebrat rozšířené vlastnosti jakéhokoliv objektu s následující výjimkou: db_ddladmin nemohou přidávat vlastnosti přímo do databáze, uživatelů nebo rolí.

Uživatelé mohou přidat rozšířené vlastnosti objektům, které vlastní, nebo na kterých mají ALTERCONTROL oprávnění.

Examples

A. Vložte rozšířenou vlastnost do sloupce

Následující příklad odstraní vlastnost caption ze sloupce id v tabulce T1 obsažené ve schématu 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. Vložte rozšířenou vlastnost do databáze

Následující příklad odstraní vlastnost pojmenovanou MS_Description ze vzorkové databáze AdventureWorks2025 . Protože vlastnost je přímo v databázi, nejsou specifikovány žádné typy objektů ani názvy.

USE AdventureWorks2022;
GO

EXECUTE sp_dropextendedproperty @name = N'MS_Description';
GO

Související obsah

  • Last updated on