杰晶网络

PostgreSQL中的COMMENT用法说明
数据库 2024/11/23 佚名
3 2

PostgreSQL附带了一个命令 - COMMENT 。如果想要记录数据库中的内容，这个命令很有用。本文将介绍如何使用此命令。

随着数据库的不断发展和数据关系变得越来越复杂，跟踪数据库中添加的所有内容会变得非常困难。要记录数据的组织方式以及可能随时间添加或更改的组件，有必要添加某种文档。

例如，文档可以写在外部文件中，但这会产生一种问题，他们很快就会变为过时的文件。PostgreSQL有一个解决这个问题的方法：COMMENT命令。使用它可以向各种数据库对象添加注释，例如在需要时更新的列，索引，表和函数。

查看数据和添加注释

PostgreSQL的psql交互式shell包含许多强大的命令来查看和操作数据。\d命令会显示所有可见表，视图，物化视图，序列和外部表的列表。还有几种\d命令的组合可用于指定是否要查看索引，映射，约束等。结合+（例如\d+），该命令将为您提供对象的扩展视图，包含一个描述列，这是文档或COMMENT编写的位置。

COMMENT命令是我们将数据描述添加到数据库对象的方法。不要将COMMENT与\ * * \或 SQL中的 -- 相混淆，因为它们是在SQL文件中编写的，在数据"htmlcode"> 

postgres=# \d+
                 List of relations
 Schema |    Name    |   Type   | Owner  |  Size  | Description 
--------+------------------+---------------+----------+------------+---------------
public | commenttest   | table     | postgres | 8192 bytes |

由于commenttest是一个刚刚创建的新表，因此Description列为空。可以通过以下命令添加注释：

postgres=# COMMENT ON TABLE commenttest IS 'A table of students in different departments'; 
COMMENT

现在再次运行\d+，可以看到描述列填充了注释。

postgres=# \d+
                 List of relations
 Schema |    Name    |   Type   | Owner  |  Size  | Description 
--------+------------------+---------------+----------+------------+---------------
public | commenttest   | table     | postgres | 8192 bytes | A table of students in different departments

这是向表中添加描述信息的步骤。 接着，我们需要考虑如何向表的列中添加描述。

要查看表中每个列的描述列，可以运行类似以下命令：

postgres=# \d+ commenttest
                   Table "public.commenttest"
   Column   | Type  | Collation | Nullable | Default | Storage | Stats target | Description 
-----------------+---------+-----------+----------+---------+----------+--------------+-------------
 student_id   | integer |      |     |     | plain  |       | 
 student_name  | text  |      |     |     | extended |       | 
 student_major  | text  |      |     |     | extended |       | 
 department_id  | integer |      |     |     | plain  |       | 
 department_name | text  |      |     |     | extended |       | 
 nationality   | text  |      |     |     | extended |       |

为每列添加描述与我们在表中添加一个列的方式类似。例如：

postgres=# COMMENT ON COLUMN commenttest.student_id IS 'ID of the student';
COMMENT
postgres=# COMMENT ON COLUMN commenttest.student_name IS 'name of the student';
COMMENT
postgres=# COMMENT ON COLUMN commenttest.student_major IS 'major of the student';
COMMENT
postgres=# COMMENT ON COLUMN commenttest.department_id IS 'ID of the department';
COMMENT
postgres=# COMMENT ON COLUMN commenttest.department_name IS 'name of the department';
COMMENT
postgres=# COMMENT ON COLUMN commenttest.nationality IS 'nationality of the student';
COMMENT

添加描述后，再次查看表的描述列信息：

postgres=# \d+ commenttest
                      Table "public.commenttest"
   Column   | Type  | Collation | Nullable | Default | Storage | Stats target |    Description     
-----------------+---------+-----------+----------+---------+----------+--------------+----------------------------
 student_id   | integer |      |     |     | plain  |       | ID of the student
 student_name  | text  |      |     |     | extended |       | name of the student
 student_major  | text  |      |     |     | extended |       | major of the student
 department_id  | integer |      |     |     | plain  |       | ID of the department
 department_name | text  |      |     |     | extended |       | name of the department
 nationality   | text  |      |     |     | extended |       | nationality of the student

可以看到描述列已经添加好相应注释。这样添加过注释之后，名字复杂且难懂的列名就能让最终用户比较容易理解且不会产生歧义。

我们也可以使用类似的方式向索引中添加描述，这样在数据库使用过程中，可以防止由于索引数量的增加而导致的混淆和歧义问题。

而且如果使用pg_dump迁移PostgreSQL数据库，则使用COMMENT进行的任何注释都会存储在转储文件中。

补充：给postgresql数据库的表和列添加注释（comment）

postgresql 数据库国内用的人并不是很多，而一些老项目采用了这个数据库。维护起来特别麻烦，因为国内用的人比较少，相关资料也很少。

另外还有一些函数，postgresql 也没有对应的提供。还有对于表分区，低版本的 postgresql 数据库根本都没有这个功能，不支持。需要自己自动的创建表进行分区。

总之 postgresql 数据库用起来实在是太过麻烦，本文总结了一些给 postgresql 数据库的表和列添加注释的方法，方便已经采用 postgresql 数据库而不得不用的程序员。

首先说给表添加注释：

comment on table xttblog is '业余草';

其中 xttblog 是表名，添加的注释是“业余草”。

给列添加注释的方法如下：

create table xttblog(id int not null, url_id int); 
comment on column xttblog.id is '主键ID，自增';

注意创建表的时候，不能再列后面加 comment 。添加后执行会报错，因为这是 MySQL，Oracle的用法，不是 Postgresql 的用法。

下面再说说如何查询表中的注释。sql 语句如下：

select description from pg_descriptionjoin pg_class on pg_description.objoid = pg_class.oid where relname = 'xttblog'

其中以 pg_ 开头的表都是 Postgresql 数据库的系统表。系统表中存储着很多与表和配置相关的信息。

PostgreSQL 获取数据表的注释信息和表中字段的注释信息和上面的 SQL 类似。

和表相关的信息都在 pg_description 这个表中，查 pg_description 这个系统表，里面有存表和字段的备注。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持。如有错误或未考虑完全的地方，望不吝赐教。

标签：
PostgreSQL,COMMENT
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
评论“PostgreSQL中的COMMENT用法说明”
暂无“PostgreSQL中的COMMENT用法说明”评论...
www.imxmx.com 杰晶网络
8,675无损音乐
1,324高清电影
213破解软件
120,141站长资源
一句话新闻
苹果官宣WWDC 2024！预计会有大批AI功能 - 2024/11/23

3月27日消息，苹果宣布2024年全球开发者大会（WWDC）将于6月10日至6月14日举行，巧合的是，这次大会与端午假期重合。

苹果官方表示：

在线参加 Apple 每年规模最大的开发者盛会。亲眼见证 Apple 最新平台、技术和工具的发布。了解如何创建和改进你的 App 和游戏。与 Apple 设计师和工程师互动交流，与全球开发者社区建立联系。以上活动均免费在线举行。

探索各种新的工具、框架和功能，助力你打造出理想的 App 和游戏。通过视频讲座学习新技能，与 Apple 专家进行一对一会面，以推进你的项目，完善你的构思。

Swift Student Challenge 旨在支持和鼓舞下一代开发者、创作者和企业家。太平洋时间 3 月 28 日，我们将公布今年的获奖者名单。获奖者将有资格参加在 Apple Park 举办的特别活动。我们还会选出 50 名杰出获胜者，他们将受邀前往库比提诺，获得为期三天的非凡体验，包括参加 Apple Park 的特别活动。

RTX 5090要首发 性能要翻倍！三星展示GDDR7显存

三星在GTC上展示了专为下一代游戏GPU设计的GDDR7内存。

首次推出的GDDR7内存模块密度为16GB，每个模块容量为2GB。其速度预设为32 Gbps（PAM3），但也可以降至28 Gbps，以提高产量和初始阶段的整体性能和成本效益。

据三星表示，GDDR7内存的能效将提高20%，同时工作电压仅为1.1V，低于标准的1.2V。通过采用更新的封装材料和优化的电路设计，使得在高速运行时的发热量降低，GDDR7的热阻比GDDR6降低了70%。

更新动态

友情链接

杰晶网络 DDR爱好者之家 南强小屋 黑松山资源网 白云城资源网