.\" auto-generated by docbook2man-spec $Revision: 1.1 $
.TH "COMMENT" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
.SH NAME
COMMENT \- 定義或者改變一個對象的評註

.SH SYNOPSIS
.sp
.nf
COMMENT ON
{
  TABLE \fIobject_name\fR |
  COLUMN \fItable_name\fR.\fIcolumn_name\fR |
  AGGREGATE \fIagg_name\fR (\fIagg_type\fR) |
  CONSTRAINT \fIconstraint_name\fR ON \fItable_name\fR |
  DATABASE \fIobject_name\fR |
  DOMAIN \fIobject_name\fR |
  FUNCTION \fIfunc_name\fR (\fIarg1_type\fR, \fIarg2_type\fR, ...) |
  INDEX \fIobject_name\fR |
  OPERATOR \fIop\fR (\fIleftoperand_type\fR, \fIrightoperand_type\fR) |
  RULE \fIrule_name\fR ON \fItable_name\fR |
  SCHEMA \fIobject_name\fR |
  SEQUENCE \fIobject_name\fR |
  TRIGGER \fItrigger_name\fR ON \fItable_name\fR |
  TYPE \fIobject_name\fR |
  VIEW \fIobject_name\fR
} IS \fI'text'\fR
.sp
.fi
.SH "DESCRIPTION 描述"
.PP
\fBCOMMENT\fR 存儲一個數據庫對象的評註， 這個評註可以很容易用 psql 的 \fB\\dd\fR, \fB\\d+\fR, 和 \fB\\l+\fR 命令檢索出來。 其它檢索評註的用戶接口可以建設在 psql 所用地同樣地內部函數的基礎上， 也就是 obj_description() 和 col_description()。
.PP
 要修改一個評註，爲同一個對象發出一條新的 COMMENT 命令即可。每個對象只存儲一條評註。 要刪除評註，在文本字串的位置寫上 NULL。 當刪除對象時，評註自動被刪除掉。
.SH "PARAMETERS 參數"
.TP
\fB\fIobject_name\fB\fR
.TP
\fB\fItable_name.column_name\fB\fR
.TP
\fB\fIaggname\fB\fR
.TP
\fB\fIconstraint_name\fB\fR
.TP
\fB\fIfunc_name\fB\fR
.TP
\fB\fIop\fB\fR
.TP
\fB\fIrule_name\fB\fR
.TP
\fB\fItrigger_name\fB\fR
 要加入評註的對象名稱。表，索引，序列，視圖，類型，域，函數， 聚集和操作符的名字可以是模式修飾的。
.TP
agg_type
聚集函數的參數類型，如果函數接受任意數據類型，那麼是 *。 
.TP
large_object_oid
大對象的 OID。 
.TP
PROCEDURAL
這個字無用。 
.TP
sourcetype
類型轉換的源數據類型名字。 
.TP
targettype
類型轉換的目的數據類型名字。 
.TP
\fB\fItext\fB\fR
新的評註。
.SH "NOTES 注意"
.PP
 一個數據庫裏的評註只能在改數據庫裏創建，並且只有在那個數據庫裏可見，其它庫裏不可見。
 
 需要說明的是目前評註沒有安全機制：任何聯接到某數據庫上的用戶都可以看到所有該數據庫對象的評註 （儘管只有超級用戶可以修改不屬於他的對象的評註）。因此，不要在評註裏放安全性敏感地信息。
.SH "EXAMPLES 例子"
.PP
 給表mytable 加評註：
.sp
.nf
COMMENT ON TABLE mytable IS 'This is my table.';
.sp
.fi
 再刪除它：
.sp
.nf
COMMENT ON TABLE mytable IS NULL;
.sp
.fi
.PP
 一些例子：
.sp
.nf
COMMENT ON AGGREGATE my_aggregate (double precision) IS 'Computes sample variance';
COMMENT ON COLUMN my_table.my_column IS 'Employee ID number';
COMMENT ON DATABASE my_database IS 'Development Database';
COMMENT ON DOMAIN my_domain IS 'Email Address Domain';
COMMENT ON FUNCTION my_function (timestamp) IS 'Returns Roman Numeral';
COMMENT ON INDEX my_index IS 'Enforces uniqueness on employee ID';
COMMENT ON OPERATOR ^ (text, text) IS 'Performs intersection of two texts';
COMMENT ON OPERATOR ^ (NONE, text) IS 'This is a prefix operator on text';
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 TABLE my_schema.my_table IS 'Employee Information';
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';
.sp
.fi
.SH "COMPATIBILITY 兼容性"
.PP
SQL 標準裏沒有COMMENT。
.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR