다음을 통해 공유


sp_dropextendedproperty(Transact-SQL)

적용 대상: SQL Server

기존 확장 속성을 삭제합니다.

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @name = ] N'name'

삭제할 속성의 이름입니다. @name sysname이며 사용할 수 없습니다NULL.

[ @level0type = ] 'level0type'

지정된 수준 0 개체 형식의 이름입니다. @level0type 기본값NULL인 varchar(128)입니다.

유효한 입력은 ASSEMBLY, ,CONTRACT, EVENT NOTIFICATION, FILEGROUP, MESSAGE TYPE, PARTITION FUNCTIONPARTITION SCHEME, REMOTE SERVICE BINDING, USERROUTESERVICETRIGGERSCHEMATYPE, 및 .NULL

Important

USERTYPE level-0 형식은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 말고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. 대신 수준 0 형식USER으로 사용합니다SCHEMA. 의 경우 TYPE수준 0 형식 및 TYPE 수준 1 형식으로 사용합니다SCHEMA.

[ @level0name = ] N'level0name'

지정된 수준 0 개체 형식의 이름입니다. @level0name sysname이며 기본값은 .입니다NULL.

[ @level1type = ] 'level1type'

수준 1 개체의 형식입니다. @level1type 기본값NULL인 varchar(128)입니다.

유효한 입력은 AGGREGATE, ,DEFAULT, FUNCTION, LOGICAL FILE NAME, PROCEDUREQUEUE, RULE, SYNONYMTABLE, VIEWTYPETABLE_TYPEXML SCHEMA COLLECTION및 .NULL

[ @level1name = ] N'level1name'

지정된 수준 1 개체 형식의 이름입니다. @level1name sysname이며 기본값은 .입니다NULL.

[ @level2type = ] 'level2type'

수준 2 개체의 형식입니다. @level2type 기본값NULL인 varchar(128)입니다.

유효한 입력은 COLUMN,CONSTRAINT, EVENT NOTIFICATION, INDEXPARAMETER, TRIGGERNULL.

[ @level2name = ] N'level2name'

지정된 수준 2 개체 형식의 이름입니다. @level2name sysname이며 기본값은 .입니다NULL.

반환 코드 값

0(성공) 또는 1(실패).

설명

확장 속성을 지정하면 SQL Server 데이터베이스의 개체는 0, 1, 2의 세 가지 수준으로 분류됩니다. 수준 0은 가장 높은 수준이며 데이터베이스 범위에 포함된 개체로 정의됩니다. 수준 1 개체는 스키마 또는 사용자 범위에 포함되고 수준 2 개체는 수준 1 개체에 포함됩니다. 이러한 수준의 개체에 대해 확장 속성을 정의할 수 있습니다. 한 수준에 있는 개체를 참조할 때는 모든 상위 수준 개체의 유형과 이름으로 한정해야 합니다.

유효한 속성 이름 @name 지정된 경우 모든 개체 형식과 이름이 있고 NULL 현재 데이터베이스에 속성이 있으면 해당 속성이 삭제됩니다. 이 문서의 뒷부분에 있는 예제 B를 참조하세요.

사용 권한

db_owner 및 db_ddladmin 고정 데이터베이스 역할의 멤버는 다음 예외 를 제외하고 모든 개체의 확장 속성을 삭제할 수 있습니다. db_ddladmin 데이터베이스 자체 또는 사용자 또는 역할에 속성을 추가할 수 없습니다.

사용자는 자신의 소유 또는 사용 권한이 있는 개체에 확장 속성을 삭제할 ALTER CONTROL 수 있습니다.

예제

A. 열에 확장 속성 삭제

다음 예제에서는 스키마dbo에 포함된 테이블 T1 의 열 id 에서 속성을 caption 제거합니다.

CREATE TABLE T1 (id INT, name CHAR(20));
GO

EXEC sp_addextendedproperty @name = 'caption',
    @value = 'Employee ID',
    @level0type = 'SCHEMA',
    @level0name = N'dbo',
    @level1type = 'TABLE',
    @level1name = N'T1',
    @level2type = 'COLUMN',
    @level2name = N'id';
GO

EXEC 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. 데이터베이스에 확장 속성 삭제

다음 예제에서는 샘플 데이터베이스에서 AdventureWorks2022 명명된 MS_Description 속성을 제거합니다. 속성이 데이터베이스 자체에 있으므로 개체 형식 및 이름이 지정되지 않습니다.

USE AdventureWorks2022;
GO

EXEC sp_dropextendedproperty @name = N'MS_Description';
GO