sp_dropextendedproperty(Transact-SQL)
적용 대상: SQL Server
기존 확장 속성을 삭제합니다.
구문
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 FUNCTION
PARTITION SCHEME
, REMOTE SERVICE BINDING
, USER
ROUTE
SERVICE
TRIGGER
SCHEMA
TYPE
, 및 .NULL
Important
USER
및 TYPE
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
, PROCEDURE
QUEUE
, RULE
, SYNONYM
TABLE
, VIEW
TYPE
TABLE_TYPE
XML SCHEMA COLLECTION
및 .NULL
[ @level1name = ] N'level1name'
지정된 수준 1 개체 형식의 이름입니다. @level1name sysname이며 기본값은 .입니다NULL
.
[ @level2type = ] 'level2type'
수준 2 개체의 형식입니다. @level2type 기본값NULL
인 varchar(128)입니다.
유효한 입력은 COLUMN
,CONSTRAINT
, EVENT NOTIFICATION
, INDEX
PARAMETER
, TRIGGER
및 NULL
.
[ @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