col_description()
是一个系统函数,返回表列的注释。
col_description()
添加于 PostgreSQL 7.2。
用法
col_description ( table oid, column integer ) → text
col_description()
需要表名作为 OID(这可以通过将表名转换为 regclass
来轻松获得),以及列号,它不一定是列的顺序号;列号对应于 pg_attribute
的 attnum
列中的值。
col_description()
如果指定的表列没有注释,或者指定的表或列不存在,则返回 NULL
。
如果通过 regclass
转换指定表,则如果找不到表,将引发错误。
修改历史
- PostgreSQL 7.2
- 添加 (提交 bf56f075)
示例
col_description()
的基本用法示例
postgres=# COMMENT ON COLUMN foo.id IS 'Thingy number'; COMMENT postgres=# SELECT col_description('foo'::regclass, 1); col_description ----------------- Thingy number (1 row) postgres=# COMMENT ON COLUMN foo.id IS NULL; COMMENT postgres=# SELECT col_description('foo'::regclass, 1); col_description ----------------- (1 row)
尝试获取不存在表的列描述
postgres=# SELECT col_description(9999, 1); col_description ----------------- (1 row) postgres=# SELECT col_description('not_a_table'::regclass, 1); ERROR: relation "not_a_table" does not exist LINE 1: SELECT col_description('not_a_table'::regclass, 1);
尝试获取不存在列的列描述
postgres=# SELECT col_description('foo'::regclass, 999); col_description ----------------- (1 row)
参考文献
- PostgreSQL 文档: 注释信息函数