# 评论
COMMENT — 定义或更改对象的注释
# 概要
COMMENT ON
{
ACCESS METHOD object_name |
AGGREGATE aggregate_name ( aggregate_signature ) |
CAST (source_type AS target_type) |
COLLATION object_name |
COLUMN relation_name.column_name |
CONSTRAINT constraint_name ON table_name |
CONSTRAINT constraint_name ON DOMAIN domain_name |
CONVERSION object_name |
DATABASE object_name |
DOMAIN object_name |
EXTENSION object_name |
EVENT TRIGGER object_name |
FOREIGN DATA WRAPPER object_name |
FOREIGN TABLE object_name |
FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
INDEX object_name |
LARGE OBJECT large_object_oid |
MATERIALIZED VIEW object_name |
OPERATOR operator_name (left_type, right_type) |
OPERATOR CLASS object_name USING index_method |
OPERATOR FAMILY object_name USING index_method |
POLICY policy_name ON table_name |
[ PROCEDURAL ] LANGUAGE object_name |
PROCEDURE procedure_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
PUBLICATION object_name |
ROLE object_name |
ROUTINE routine_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] |
RULE rule_name ON table_name |
SCHEMA object_name |
SEQUENCE object_name |
SERVER object_name |
STATISTICS object_name |
SUBSCRIPTION object_name |
TABLE object_name |
TABLESPACE object_name |
TEXT SEARCH CONFIGURATION object_name |
TEXT SEARCH DICTIONARY object_name |
TEXT SEARCH PARSER object_name |
TEXT SEARCH TEMPLATE object_name |
TRANSFORM FOR type_name LANGUAGE lang_name |
TRIGGER trigger_name ON table_name |
TYPE object_name |
VIEW object_name
} IS 'text'
where aggregate_signature is:
* |
[ argmode ] [ argname ] argtype [ , ... ] |
[ [ argmode ] [ argname ] argtype [ , ... ] ] ORDER BY [ argmode ] [ argname ] argtype [ , ... ]
# 描述
评论
存储有关数据库对象的注释。
每个对象只存储一个注释字符串,因此要修改注释,请发出新的评论
同一对象的命令。要删除评论,请写空值
代替文本字符串。删除对象时会自动删除注释。
一种共享更新独家
在要评论的对象上获取锁。
对于大多数类型的对象,只有对象的所有者才能设置注释。角色没有所有者,因此规则为角色评论
是您必须是超级用户才能评论超级用户角色,或者拥有创造者
评论非超级用户角色的特权。同样,访问方法也没有所有者。您必须是超级用户才能评论访问方法。当然,超级用户可以评论任何内容。
可以使用 psql 的查看评论\d
命令族。其他检索评论的用户界面可以建立在 psql 使用的相同内置函数之上,即对象描述
,col_description
, 和shobj_description
(看表 9.75)。
# 参数
对象名
关系名称
.列名
聚合名称
约束名
函数名
操作员名称
政策名称
过程名称
例程名称
规则名称
触发器名称
要评论的对象的名称。驻留在模式(表、函数等)中的对象的名称可以是模式限定的。在评论专栏时,*关系名称
*必须引用表、视图、复合类型或外部表。
表名
域名
在为约束、触发器、规则或策略创建注释时,这些参数指定定义该对象的表或域的名称。
源类型
转换的源数据类型的名称。
目标类型
转换的目标数据类型的名称。
参数模式
函数、过程或聚合参数的模式:在
,出去
,进出
, 或者杂音
.如果省略,则默认为在
.注意评论
实际上并没有注意出去
参数,因为只需要输入参数来确定函数的身份。所以列出来就足够了在
,进出
, 和杂音
论据。
参数名称
函数、过程或聚合参数的名称。注意评论
实际上并不关注参数名称,因为只需要参数数据类型来确定函数的身份。
参数类型
函数、过程或聚合参数的数据类型。
large_object_oid
大对象的 OID。
left_type
right_type
运算符参数的数据类型(可选模式限定)。写没有
对于前缀运算符的缺失参数。
程序
这是一个噪音词。
类型名称
转换的数据类型的名称。
语言名
转换的语言名称。
文本
新注释,写为字符串文字;要么空值
删除评论。
# 笔记
目前没有用于查看评论的安全机制:任何连接到数据库的用户都可以查看该数据库中对象的所有评论。对于数据库、角色和表空间等共享对象,注释是全局存储的,因此连接到集群中任何数据库的任何用户都可以看到共享对象的所有注释。因此,不要将安全关键信息放在评论中。
# 例子
将评论附加到表格我的表
:
COMMENT ON TABLE mytable IS 'This is my table.';
再次删除它:
COMMENT ON TABLE mytable IS NULL;
更多示例:
COMMENT ON ACCESS METHOD gin IS 'GIN index access method';
COMMENT ON AGGREGATE my_aggregate (double precision) IS 'Computes sample variance';
COMMENT ON CAST (text AS int4) IS 'Allow casts from text to int4';
COMMENT ON COLLATION "fr_CA" IS 'Canadian French';
COMMENT ON COLUMN my_table.my_column IS 'Employee ID number';
COMMENT ON CONVERSION my_conv IS 'Conversion to UTF8';
COMMENT ON CONSTRAINT bar_col_cons ON bar IS 'Constrains column col';
COMMENT ON CONSTRAINT dom_col_constr ON DOMAIN dom IS 'Constrains col of domain';
COMMENT ON DATABASE my_database IS 'Development Database';
COMMENT ON DOMAIN my_domain IS 'Email Address Domain';
COMMENT ON EVENT TRIGGER abort_ddl IS 'Aborts all DDL commands';
COMMENT ON EXTENSION hstore IS 'implements the hstore data type';
COMMENT ON FOREIGN DATA WRAPPER mywrapper IS 'my foreign data wrapper';
COMMENT ON FOREIGN TABLE my_foreign_table IS 'Employee Information in other database';
COMMENT ON FUNCTION my_function (timestamp) IS 'Returns Roman Numeral';
COMMENT ON INDEX my_index IS 'Enforces uniqueness on employee ID';
COMMENT ON LANGUAGE plpython IS 'Python support for stored procedures';
COMMENT ON LARGE OBJECT 346344 IS 'Planning document';
COMMENT ON MATERIALIZED VIEW my_matview IS 'Summary of order history';
COMMENT ON OPERATOR ^ (text, text) IS 'Performs intersection of two texts';
COMMENT ON OPERATOR - (NONE, integer) IS 'Unary minus';
COMMENT ON OPERATOR CLASS int4ops USING btree IS '4 byte integer operators for btrees';
COMMENT ON OPERATOR FAMILY integer_ops USING btree IS 'all integer operators for btrees';
COMMENT ON POLICY my_policy ON mytable IS 'Filter rows by users';
COMMENT ON PROCEDURE my_proc (integer, integer) IS 'Runs a report';
COMMENT ON PUBLICATION alltables IS 'Publishes all operations on all tables';
COMMENT ON ROLE my_role IS 'Administration group for finance tables';
COMMENT ON ROUTINE my_routine (integer, integer) IS 'Runs a routine (which is a function or procedure)';
COMMENT ON RULE my_rule ON my_table IS 'Logs updates of employee records';
COMMENT ON SCHEMA my_schema IS 'Departmental data';
COMMENT ON SEQUENCE my_sequence IS 'Used to generate primary keys';
COMMENT ON SERVER myserver IS 'my foreign server';
COMMENT ON STATISTICS my_statistics IS 'Improves planner row estimations';
COMMENT ON SUBSCRIPTION alltables IS 'Subscription for all operations on all tables';
COMMENT ON TABLE my_schema.my_table IS 'Employee Information';
COMMENT ON TABLESPACE my_tablespace IS 'Tablespace for indexes';
COMMENT ON TEXT SEARCH CONFIGURATION my_config IS 'Special word filtering';
COMMENT ON TEXT SEARCH DICTIONARY swedish IS 'Snowball stemmer for Swedish language';
COMMENT ON TEXT SEARCH PARSER my_parser IS 'Splits text into words';
COMMENT ON TEXT SEARCH TEMPLATE snowball IS 'Snowball stemmer';
COMMENT ON TRANSFORM FOR hstore LANGUAGE plpythonu IS 'Transform between hstore and Python dict';
COMMENT ON TRIGGER my_trigger ON my_table IS 'Used for RI';
COMMENT ON TYPE complex IS 'Complex number data type';
COMMENT ON VIEW my_view IS 'View of departmental costs';
# 兼容性
没有评论
SQL 标准中的命令。