如何在SQL Server中通过扩展属性为视图添加中文注释

大磊吖_7526

大磊吖_7526

2026-09-24

151人浏览

原创

sql server视图的中文注释必须通过sp_addextendedproperty添加,因create view中的--注释不被系统识别为元数据;需确保视图已存在、用户有alter权限,且中文字符串须加n前缀,参数@level1type必须为'view',验证用fn_listextendedproperty。

如何在sql server中通过扩展属性为视图添加中文注释

SQL Server 视图加中文注释必须用 sp_addextendedproperty

SQL Server 不支持在 CREATE VIEW 语句里直接写中文注释(比如 -- 这是订单汇总视图),这类注释不会被系统识别为元数据。真正能被 SSMS、文档工具或下游系统读取的“正式注释”,只能通过扩展属性(Extended Property)添加,核心就是调用系统存储过程 sp_addextendedproperty。

执行前必须确认视图已存在且权限足够

如果视图还没创建,先运行 CREATE VIEW;如果已存在但你没权限修改元数据,会报错 Msg 15173, Level 16, State 1: Cannot add extended property to object 'xxx' because it does not exist or you do not have permission.。常见权限要求包括:ALTER 权限在视图上,或 db_ddladmin 数据库角色成员身份。

  • 检查视图是否存在:SELECT * FROM sys.views WHERE name = 'YourViewName'
  • 确认当前用户有权限:SELECT HAS_PERMS_BY_NAME('YourViewName', 'OBJECT', 'ALTER') — 返回 1 才能继续
  • 中文注释必须用 Unicode 字符串,即前面加 N 前缀,否则可能乱码或截断

sp_addextendedproperty 的关键参数不能错

这个存储过程有 7 个参数,但日常只用前 5 个,后 2 个可省略(默认为 NULL)。最容易出错的是第 4 和第 5 个参数 —— 它们定义“注释挂在哪一级对象上”:

  • @name:固定用 N'MS_Description',这是 SQL Server 约定的描述属性名
  • @value:你的中文注释内容,必须带 N 前缀,如 N'按客户统计的月度销售总额'
  • @level0type:顶层对象类型,视图属于数据库对象,所以填 'SCHEMA'
  • @level0name:顶层对象名,即视图所属 schema,通常是 'dbo'
  • @level1type:下一层类型,填 'VIEW'(注意不是 'VIEWS' 或小写)
  • @level1name:视图名,如 'v_CustomerSales'

完整示例:

稿定AI
稿定AI

一款融合AI图像生成与智能编辑能力的在线设计工具,可辅助完成图片重绘、线稿处理和人物视觉优化等创作任务。

下载
EXEC sys.sp_addextendedproperty 
    @name = N'MS_Description', 
    @value = N'按客户统计的月度销售总额',
    @level0type = N'SCHEMA', @level0name = N'dbo',
    @level1type = N'VIEW', @level1name = N'v_CustomerSales';

注释是否生效?用 fn_listextendedproperty 验证

执行完 sp_addextendedproperty 后别急着关窗口,马上查一遍。SSMS 的“属性”对话框有时缓存不刷新,而 fn_listextendedproperty 是实时读取系统表的最可靠方式:

  • 查整个视图的注释:SELECT * FROM fn_listextendedproperty(NULL, 'SCHEMA', 'dbo', 'VIEW', 'v_CustomerSales', NULL, NULL)
  • 只查描述字段:SELECT value FROM fn_listextendedproperty(N'MS_Description', 'SCHEMA', 'dbo', 'VIEW', 'v_CustomerSales', NULL, NULL)
  • 如果返回空结果集,说明没加成功 —— 多半是 @level0name 或 @level1name 拼错了,或视图不在 dbo 下(比如在 sales schema 下就得改 @level0name)

另外,SSMS 中右键视图 → “属性” → “扩展属性” 页签,也能看到,但需刷新整个对象资源管理器(F5)才一定更新。

扩展属性是唯一被 SQL Server 官方认可、且能在生成脚本、部署工具、BI 元数据扫描中保留的注释机制。手写在 CREATE VIEW 里的注释,导出脚本时可能丢,Power BI 也读不到 —— 别图省事跳过这步。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

4451

4

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

2285

3

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2023.08.14

3621

10

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

2023.08.31

2431

3

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.05

827

5

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

2207

5

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

2023.10.16

2227

4

vb连接access数据库的方法
vb连接access数据库的方法

vb连接access数据库方法:1、使用ADO连接,首先导入System.Data.OleDb模块,然后定义一个连接字符串,接着创建一个OleDbConnection对象并使用Open() 方法打开连接;2、使用DAO连接,首先导入 Microsoft.Jet.OLEDB模块,然后定义一个连接字符串,接着创建一个JetConnection对象并使用Open()方法打开连接即可。

2023.10.16

2773

3

vb连接数据库的方法
vb连接数据库的方法

vb连接数据库的方法有使用ADO对象库、使用OLEDB数据提供程序、使用ODBC数据源等。详细介绍:1、使用ADO对象库方法,ADO是一种用于访问数据库的COM组件,可以通过ADO连接数据库并执行SQL语句。可以使用ADODB.Connection对象来建立与数据库的连接,然后使用ADODB.Recordset对象来执行查询和操作数据;2、使用OLEDB数据提供程序方法等等。

2023.10.19

2041

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.2万人学习