给SQL server数据库表字段添加注释SQL，附修改、删除注释SQL及演示

embedded/2025/2/26 4:40:35/

目录

一. 前提小知识(数据库连接，数据库，SCHEMA，Table的关系)

二. 添加备注

2.1 添加备注基本语法(sys.sp_addextendedproperty)

2.2 SQL演示

2.3?fn_listextendedproperty函数查询备注个数

2.4 开发常用添加注释语法

三. 修改备注

3.1 修改备注基本语法（sys.sp_updateextendedproperty）

3.2 需要注意的坑

3.3 添加注释与修改注释的搭配使用

四. 删除备注

4.1 删除备注基本语法

一. 前提小知识(数据库连接，数据库，SCHEMA，Table的关系)

数据库我们比较熟悉的就是数据库DataBase，然后就是数据库中的表Table；

但在它们二者中间，还有一个中间者，叫"SCHEMA"，一个数据库可以有多个"SCHEMA"，"SCHEMA"是数据库的一个逻辑结构，，用于组织数据库对象，如表、视图、存储过程等。如下图所示，

（1）数据库连接(数据库服务器)：我们知道，数据库都是一个个的链接，我们都过IP和端口去连接各个数据库服务器，所以连接是最大的一个单位；

**（2）数据库：**其次，我们就会发现，在连接的数据库服务器中，会有1~多个数据库DataBase，通常情况下一个项目会有多个数据库；

**（3）SCHEMA：**再次，在每个数据库DataBase下，还会有多个SCHEMA，每个SCHEMA都是一个独立的小单位，它们之间互相隔绝，每个SCHEMA都有自己的权限和对象，从而实现更好的数据隔离和安全性。

**（4）Table表：**最后，在每个SCHEMA之下没我们可以建立多张表，这个大家都很熟悉，就不多说了，每张表存储着不同的实体对象数据；

总结下来，一个数据库连接(数据库服务器)下可以有多个数据库(DataBase)，一个数据库下可以有多个SCHEMA，一个SCHEMA下可以建立多张数据表。所以它们的关系就是 数据库连接>数据库>SCHEMA>Table；了解了这个小知识，我们开始进入正题。

二. 添加备注
2.1 添加备注基本语法(sys.sp_addextendedproperty)

在SQL server中，使用"sys.sp_addextendedproperty"即可向表中的字段添加注释。

举例：现有一个表名叫 “MyTable”，表中有一个列的字段叫 “MyColumn”。

如下SQL，就是给字段 MyColumn 添加注释，注释即为 “MyColumn字段的描述”。

EXEC sys.sp_addextendedproperty
-- @name=N'MS_Description'添加备注的描述，固定写法@value=N'这是MyColumn字段的描述', @name=N'MS_Description',@value=''就是我们要给字段添加的备注内容                //
-- @level0type=N'SCHEMA' 指定了级别0的类型为架构，name则指架构的名称为dbo。@level0type=N'SCHEMA', @level0name=N'dbo',
-- @level0name=N'dbo' 指定了级别1的类型为表,name则指表名为MyTable。    @level1type=N'TABLE', @level1name=N'MyTable',
-- @level2type=N'COLUMN' 指定了级别2的类型为列，name指要添加注释的列名为MyColumn@level2type=N'COLUMN', @level2name=N'MyColumn';
2.2 SQL演示

**(a)**如下图所示，在本地连接 ‘local’ 中，有数据库 ‘fccbdb’ ，数据库下有 SCHEAM 叫 ‘dbo’，现在我使用上述SQL给主键ID添加注释；

**(b)**SQL如下

-- 给 log_fccb 表中的 ID 字段添加注释
EXEC sys.sp_addextendedproperty@name=N'MS_Description',                      @value=N'主键ID',@level0type=N'SCHEMA', @level0name=N'dbo',    @level1type=N'TABLE', @level1name=N'log_fccb',@level2type=N'COLUMN', @level2name=N'ID';

**©**然后运行上述 SQL 语句，我们再打开 log_fccb 表，就会看到此时的主键ID已经被添加上注释了；

**(d)**此外，fccbdb下 还有 SCHEMA 叫 guest，但并没有任何的表数据，我们一会做对比看一下，将上述SQL语句中的SCHEMA由dbo改为guest再次执行；

EXEC sys.sp_addextendedproperty@name=N'MS_Description',                      @value=N'新注释主键ID',@level0type=N'SCHEMA', @level0name=N'guest',    @level1type=N'TABLE', @level1name=N'log_fccb',@level2type=N'COLUMN', @level2name=N'ID';

**(e)**执行上述SQL语句，就会出现下方的报错信息，错误信息"guest.log_fccb.ID"不存在，这也是正常的，我们刚才说了。guest下是空的，自然没有表，也没有名叫ID的字段；所以也侧面印证了SCHEMA是表的上一级，需要在SQL语句中指定某个SCHEMA下的某张表的某个字段，才能去通过SQL为其添加注释。

2.3fn_listextendedproperty函数查询备注个数

在SQL server中，提供了fn_listextendedproperty函数，通过它可以返回某个列的备注数量，通常为0或者1，为0表示该字段没有被添加备注，为1则表示当前字段已经有备注。

**(a)**使用语法如下，其中括号内的8个参数与上面 sp_addextendedproperty 添加注释函数中的8个参数一样，但是查询不需要写"@name=N’MS_Description’, @value=N’错误信息’，所以只剩下6个参数"，还可以将前面的@xxx省略。

-- 查询log_fccb表中字段ID的备注个数
SELECT COUNT(*) 
FROM fn_listextendedproperty
('MS_Description', 'SCHEMA', 
'dbo', 'TABLE', 
'log_fccb', 'COLUMN', 'ID')

**(b)**运行上述SQL，即可得到下图所示结果，显示 field 为1，表示当前ID字段有一个注释；

**©**我们可以在换一个字段，换成当前log_fccb 表 errorMsg 字段，再次编辑执行SQL，如下图所示，得到的结果field就是0；

**(d)**然后我们打开 log_fccb 数据表结构，如下图所示，errorMsg字段确实没有被添加注释；

2.4 开发常用添加注释语法

上面说的都是琐碎的语法，我们平常自己练习的时候可以使用，但在日常开发过程中，对数据库SQL脚本的要求是比较高的，最好不要出错，或者再执行脚本前去数据库中做判断。

（1）比如创建表，首先要判断是否存在，如果存在先删除，删除之后再创建；

（2）比如添加字段，要先判断字段是否存在，若存在先删除，删除之后再重新添加新的字段类型；

同理，注释也是一样的，我们再给表中的字段添加注释之前，要先判断当前字段是否已经存在注释，若存在则不添加；

此时，我们就可以将刚才的两个函数结合使用，再搭配 IF 语句做判断；

**(a)**SQL如下所示

-- IF做判断，括号内即为 fn_listextendedproperty 函数，返回值为0或1，
-- 如果为0，说明做判断的字段没有备注，就调用 sp_addextendedproperty 
-- 函数为其添加备注，如果返回值为1不等于0，则后面的函数也不会执行，
-- 由此就达到了没有备注添加备注有备注则不做任何操作的目的
IF (SELECT COUNT(*) FROM fn_listextendedproperty('MS_Description', 'SCHEMA', 'dbo', 'TABLE', 'log_fccb', 'COLUMN', 'errorMsg')
) = 0
EXEC sp_addextendedproperty 
@name=N'MS_Description', @value=N'错误信息',
@level0type=N'SCHEMA', @level0name=N'dbo',    
@level1type=N'TABLE', @level1name=N'log_fccb',
@level2type=N'COLUMN', @level2name=N'errorMsg';

**(b)**上面也说到了，fn_listextendedproperty 函数中的8个参数前置可以省略，同理sp_addextendedproperty 也可以省略，省略完毕之后，我们的SQL就得到了极大的简化，简化后如下

IF (SELECT COUNT(*) FROM fn_listextendedproperty('MS_Description', 'SCHEMA', 'dbo', 'TABLE', 'log_fccb', 'COLUMN', 'errorMsg')
) = 0
EXEC sp_addextendedproperty
N'MS_Description', N'错误信息',
N'SCHEMA', N'dbo',
N'TABLE', N'log_fccb',
N'COLUMN', N'errorMsg';

**©**运行上述SQL，结果如下执行成功

**(d)**然后我们再打开 log_fccb 表，就可以看到 errorMsg 字段已经被我们成功添加注释；

三. 修改备注
3.1 修改备注基本语法（sys.sp_updateextendedproperty）

在SQL server中，使用"sys.sp_updateextendedproperty"即可更新表中字段的注释。和刚才的添加注释方法几乎没有区别，只是换了一个函数；

**(a)**举例：继续拿上面的 log_fccb 表举例，将刚才给ID字段添加的注释 “主键ID” 修改为 “新的备注主键ID” ，SQL如下。

--  更新log_fccb 表中字段ID的备注为 "新的备注主键ID"
EXEC sys.sp_updateextendedproperty
N'MS_Description', N'新的注释主键ID', 
N'SCHEMA', N'dbo', 
N'TABLE', N'log_fccb', 
N'COLUMN', N'ID';

**(b)**执行SQL，如下所示显示成功，

**©**然后我们打开 log_fccb 表，就可以看到主键ID的备注已经被修改为新的了；

3.2 需要注意的坑

**(a)**虽然使用sys.sp_updateextendedproperty 可以帮助我们修改字段的备注，但是特也有坑需要我们注意，如果我们要修改备注的字段根本就没有添加备注，它就会修改失败；如下图所示，显示该字段没有 “MS_Description” 属性，该属性是在给字段添加过注释之后才有的，没有添加过注释的字段是没有的，所以会报错。

**(b)**如下图所示，我给 res_text 字段修改备注为"响应文本"，但实际上该字段原本没有备注，执行SQL，就会报出如下错误；

3.3 添加注释与修改注释的搭配使用

**©**上面我们将fn_listextendedproperty 函数和sp_addextendedproperty 函数搭配使用给没有备注的字段添加注释，这里我们可以继续扩展，再搭配上sys.sp_updateextendedproperty 更新函数更新表的字段；

**(d)**SQL如下所示

-- 1. 判断 res_text 字段当前有没有注释，如果没有则为其添加注释 "响应文本666"
IF (SELECT COUNT(*) FROM fn_listextendedproperty('MS_Description', 'SCHEMA', 'dbo', 'TABLE', 'log_fccb', 'COLUMN', 'res_text')
) = 0
EXEC sp_addextendedproperty
N'MS_Description', N'响应文本666',
N'SCHEMA', N'dbo',
N'TABLE', N'log_fccb',
N'COLUMN', N'res_text'
-- 2. 判断当前res_text 字段当前有没有注释，如果有则把注释改为 "响应文本999"
else IF (SELECT COUNT(*) FROM fn_listextendedproperty('MS_Description', 'SCHEMA', 'dbo', 'TABLE', 'log_fccb', 'COLUMN', 'res_text')
) = 1
EXEC sys.sp_updateextendedproperty
N'MS_Description', N'响应文本999',
N'SCHEMA', N'dbo',
N'TABLE', N'log_fccb',
N'COLUMN', N'res_text';

**(e)**运行SQL，得到OK，说明执行成功，

**(f)**打开 log_fccb 表，可以看到 res_text 字段 注释已经被改为 "响应文本999"目的达成

四. 删除备注
4.1 删除备注基本语法

**(a)**删除其实都没什么好说的，因为开发过程中我们几乎都是去添加或者修改注释，不会去删除注释，但还是提一嘴，删除注释函数为 dorp ，然后下方8个参数不需要写注释，因为要删掉注释，当然不需要写注释内容，所以剩下7个参数，其他语法不变；示例SQL如下所示；

-- 删除 log_fccb 表中 errorMsg 字段的备注
EXEC sys.sp_dropextendedproperty @name=N'MS_Description', @level0type=N'SCHEMA', @level0name=N'dbo', @level1type=N'TABLE', @level1name=N'log_fccb', @level2type=N'COLUMN', @level2name=N'errorMsg';

**(b)**执行此SQL，如下图OK成功

**©**打开 log_fccb 表，可以看到 errorMsg 字段的注释已经被删除了；


http://www.ppmy.cn/embedded/167194.html

相关文章

单片机 Bootloade与二进制文件的生成

单片机 Bootloade与二进制文件的生成

单片机的 Bootloader 是一种特殊的程序，负责在单片机上电后初始化硬件、更新用户应用程序（固件），并将控制权移交给用户程序。以下是其运行机制和关键流程的详细说明： 1、单片机 Bootloader 的核心作用 固件更新&…
阅读更多...
【Python爬虫(37)】解锁分布式爬虫：原理与架构全解析

【Python爬虫(37)】解锁分布式爬虫：原理与架构全解析

【Python爬虫】专栏简介：本专栏是 Python 爬虫领域的集大成之作，共 100 章节。从 Python 基础语法、爬虫入门知识讲起，深入探讨反爬虫、多线程、分布式等进阶技术。以大量实例为支撑，覆盖网页、图片、音频等各类数据爬取&#xff…
阅读更多...
Docker 与 CI/CD：自动化构建和部署

Docker 与 CI/CD：自动化构建和部署

在现代软件开发中，CI/CD（持续集成/持续部署） 是一种高效的软件开发和运维方法。CI/CD 通过自动化构建、测试和部署流程，减少了人为错误，提高了软件交付的速度和质量。Docker，作为一种容器化平台&#xff0c…
阅读更多...
设计模式-创建型模式

设计模式-创建型模式

创建型模式组成 创建型设计模式关注的是对象的创建过程，旨在将对象的创建与使用分离，从而提高程序的灵活性和可复用性。以下是几种常见的创建型设计模式： 1. 单例模式（Singleton） 目的：确保一个类只有一…
阅读更多...
Linux之文件系统

Linux之文件系统

1.前言 文件 内容属性 文件分为被打开的文件（跟基础IO有关，在内存上）和没有被打开的文件(在磁盘上)。 在磁盘上找没有被打开的文件属于文件系统的工作 2.对硬件的理解 2.1 磁盘，服务器，机柜，机房 1.磁…
阅读更多...
sqli-labs-master第46关

sqli-labs-master第46关

目录 报错注入 直接注入 数据库名 数据库中的表名 users表结构： users表数据： python脚本注入 直接注入 获取数据库名 获取表名 获取表结构 获取数据 布尔盲注 获取数据库名 获取表名 获取表结构 获取数据 报错注入 直接注入 数据库名…
阅读更多...
web网络安全:SQL 注入攻击

web网络安全:SQL 注入攻击

SQL 注入攻击（SQL Injection）概述 SQL 注入（SQL Injection） 是Web应用程序中最常见的安全漏洞之一。攻击者通过在应用程序的输入字段中插入恶意SQL代码，能够操控数据库执行非预期操作，导致数据泄露、篡改甚…
阅读更多...
当前就业形势下C++方向后端开发学习指南

当前就业形势下C++方向后端开发学习指南

文章目录 1. C后端开发的职业方向1.1 C的应用领域1.2 后端开发的职业选择 2. 当前就业形势分析2.1 C开发者的市场需求2.2 C开发者的薪资水平 3. 学习路线3.1 入门阶段：掌握基础知识3.2 进阶阶段：掌握后端开发的核心技术3.2.1 数据库与C3.2.2 网络编程 3.…
阅读更多...
最新文章

Copyright @ 2022~2023