將新擴(kuò)展屬性添加到數(shù)據(jù)庫對象中。如果屬性已經(jīng)存在,則過程失敗。
sp_addextendedproperty
[ @name = ] { 'property_name'
}
[ , [ @value = ] { 'value'
}
[ , [ @level0type = ] { 'level0_object_type'
}
, [ @level0name = ] { 'level0_object_name'
}
[ , [ @level1type = ] { 'level1_object_type'
}
, [ @level1name = ] { 'level1_object_name'
}
[ , [ @level2type = ] { 'level2_object_type'
}
, [ @level2name = ] { 'level2_object_name'
}
]
]
]
]
[ @name = ] { 'property_name' }
要添加的屬性名稱。property_name 的數(shù)據(jù)類型為 sysname,它不能是 NULL。名稱可能還包括空白或非字母數(shù)字字符串和二進(jìn)制值。
[ @value = ] { 'value' }
將要與屬性相關(guān)聯(lián)的值。value 的數(shù)據(jù)類型為 sql_variant,帶有默認(rèn)設(shè)置 NULL。value 的大小不能超過 7,500 字節(jié);否則 SQL Server 會產(chǎn)生錯誤。
[ @level0type = ] { 'level0_object_type' }
用戶或用戶定義類型。level0_object_type 的數(shù)據(jù)類型為 varchar(128),其默認(rèn)值為 NULL。有效的輸入是 USER、TYPE 和 NULL。
[ @level0name = ] { 'level0_object_name' }
指定的 0 級對象類型的名稱。level0_object_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[ @level1type = ] { 'level1_object_type' }
1 級對象的類型。level1_object_type 的數(shù)據(jù)類型為 varchar(128),其默認(rèn)值為 NULL。有效的輸入是 TABLE、VIEW、PROCEDURE、FUNCTION、DEFAULT、RULE 和 NULL。
[ @level1name = ] { 'level1_object_name' }
指定的 1 級對象類型的名稱。level1_object_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[ @level2type = ] { 'level2_object_type' }
2 級對象的類型。level2_object_type 的數(shù)據(jù)類型為 varchar(128),其默認(rèn)值為 NULL。有效的輸入是 COLUMN、PARAMETER、INDEX、CONSTRAINT、TRIGGER 和 NULL。
[ @level2name = ] { 'level2_object_name' }
指定的 2 級對象類型的名稱。level2_object_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
0(成功)或 1(失?。?/P>
系統(tǒng)對象不允許有擴(kuò)展屬性。
對象是按級別區(qū)分的,0 級為最高,2 級為最低。當(dāng)用戶添加、更新或刪除擴(kuò)展屬性時,必須指定所有更高級別的對象。例如,如果用戶要向 1 級對象添加擴(kuò)展屬性,就必須指定所有 0 級信息。如果用戶要向 2 級對象添加擴(kuò)展屬性,則必須提供關(guān)于 0 級和 1 級的所有信息。
在每個級別上,對象類型和對象名可唯一地標(biāo)識對象。如果指定了一個對中的任一方,則必須指定另一方。
給定了有效 property_name 和 value,如果沒有任何對象類型和名稱,則屬性屬于當(dāng)前數(shù)據(jù)庫。如果指定對象類型和名稱,則還必須指定父對象和類型。否則,SQL Server 會產(chǎn)生錯誤。
db_owner 和 db_ddladmin 固定數(shù)據(jù)庫角色的成員可以將擴(kuò)展屬性添加到任何對象中。用戶可以為他們所擁有的對象添加擴(kuò)展屬性。然而,只有 db_owner 可以將屬性添加到用戶名稱中。
下面的示例將屬性 ('caption,' 'Employee ID') 添加到表"T1"的"ID"列中。
CREATE table T1 (id int , name char (20))
GO
EXEC sp_addextendedproperty 'caption', 'Employee ID', 'user', dbo, 'table', T1, 'column', id
相關(guān)文章