COMMENT — オブジェクトのコメントを定義する、または変更する
COMMENT ON { ACCESS METHODobject_name
| AGGREGATEaggregate_name
(aggregate_signature
) | CAST (source_type
AStarget_type
) | COLLATIONobject_name
| COLUMNrelation_name
.column_name
| CONSTRAINTconstraint_name
ONtable_name
| CONSTRAINTconstraint_name
ON DOMAINdomain_name
| CONVERSIONobject_name
| DATABASEobject_name
| DOMAINobject_name
| EXTENSIONobject_name
| EVENT TRIGGERobject_name
| FOREIGN DATA WRAPPERobject_name
| FOREIGN TABLEobject_name
| FUNCTIONfunction_name
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] | INDEXobject_name
| LARGE OBJECTlarge_object_oid
| MATERIALIZED VIEWobject_name
| OPERATORoperator_name
(left_type
,right_type
) | OPERATOR CLASSobject_name
USINGindex_method
| OPERATOR FAMILYobject_name
USINGindex_method
| POLICYpolicy_name
ONtable_name
| [ PROCEDURAL ] LANGUAGEobject_name
| PROCEDUREprocedure_name
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] | PUBLICATIONobject_name
| ROLEobject_name
| ROUTINEroutine_name
[ ( [ [argmode
] [argname
]argtype
[, ...] ] ) ] | RULErule_name
ONtable_name
| SCHEMAobject_name
| SEQUENCEobject_name
| SERVERobject_name
| STATISTICSobject_name
| SUBSCRIPTIONobject_name
| TABLEobject_name
| TABLESPACEobject_name
| TEXT SEARCH CONFIGURATIONobject_name
| TEXT SEARCH DICTIONARYobject_name
| TEXT SEARCH PARSERobject_name
| TEXT SEARCH TEMPLATEobject_name
| TRANSFORM FORtype_name
LANGUAGElang_name
| TRIGGERtrigger_name
ONtable_name
| TYPEobject_name
| VIEWobject_name
} IS {string_literal
| NULL } ここでaggregate_signature
は以下の通りです。 * | [argmode
] [argname
]argtype
[ , ... ] | [ [argmode
] [argname
]argtype
[ , ... ] ] ORDER BY [argmode
] [argname
]argtype
[ , ... ]
COMMENT
は、データベースオブジェクトに関するコメントを保存します。
各オブジェクトに保存できるコメント文字列は1つだけです。
ですので、コメントを編集するためには、同一オブジェクトに対して新しくCOMMENT
コマンドを発行してください。
コメントを削除するには、テキスト文字列の部分にNULL
を記述してください。
オブジェクトが削除された時、コメントは自動的に削除されます。
コメントを付加するオブジェクトでは、SHARE UPDATE EXCLUSIVE
ロックが獲得されます。
ほとんどの種類のオブジェクトでは、オブジェクトの所有者のみがコメントを設定できます。
ロールには所有者がありませんので、COMMENT ON ROLE
における規則は、スーパーユーザロールに対するコメント付けはスーパーユーザでなければならない、または、CREATEROLE
権限を持ち、対象のロールに対してADMIN OPTION
を付与されていなければならないとなります。
同様に、アクセスメソッドには所有者がいないため、アクセスメソッドにコメントをつけるにはスーパーユーザでなければなりません。
当然ながらスーパーユーザは何にでもコメントを付けることができます。
コメントは、psqlの\d
系のコマンドで表示できます。
obj_description()
、col_description()
、shobj_description
という名前の、psqlが使用する組み込み関数を使うように構築することで、他のユーザインタフェースを使ってコメントを取り出せるようになります
(表 9.78を参照してください)。
object_name
relation_name
.column_name
aggregate_name
constraint_name
function_name
operator_name
policy_name
procedure_name
routine_name
rule_name
trigger_name
コメントを付加するオブジェクトの名前です。
スキーマの中にあるオブジェクト(テーブル、関数など)の名前はスキーマ修飾可能です。
列にコメントを付与する場合、relation_name
はテーブル、ビュー、複合型、外部テーブルを参照するものでなければなりません。
table_name
domain_name
制約、トリガー、ルール、ポリシーにコメントを作成する場合、これらのパラメータはオブジェクトが定義されているテーブルまたはドメインの名前を指定します。
source_type
キャストの変換元データ型の名前です。
target_type
キャストの変換先のデータ型の名前です。
argmode
関数、プロシージャまたは集約の引数のモードで、IN
、OUT
、INOUT
、VARIADIC
のいずれかです。
省略時のデフォルトはIN
です。
関数を識別するには入力引数のみが必要ですので、COMMENT
が実際にはOUT
引数を無視することに注意してください。
したがって、IN
、INOUT
およびVARIADIC
引数を列挙することで十分です。
argname
関数、プロシージャまたは集約の引数の名前です。
関数の識別には引数データ型のみが必要ですので、COMMENT
が実際には引数の名前を無視することに注意してください。
argtype
関数、プロシージャまたは集約の引数のデータ型です。
large_object_oid
ラージオブジェクトのOIDです。
left_type
right_type
演算子の引数のデータ型(スキーマ修飾も可)です。
前置演算子における存在しない引数についてはNONE
と記述してください。
PROCEDURAL
これには意味はありません。
type_name
変換のデータ型の名前です。
lang_name
変換の言語の名前です。
string_literal
新しいコメントの内容です。文字列リテラルとして記述します。
NULL
コメントを削除するにはNULL
と記述します。
現在、コメントの閲覧に関するセキュリティ機構は存在しません。 データベースに接続したユーザは誰でも、そのデータベース内のオブジェクトのコメントを参照することができます。 データベース、ロール、テーブル空間などの共有オブジェクトに対するコメントは大域的に格納され、クラスタ内の任意のデータベースに接続した任意のユーザが共有オブジェクトに対するコメントをすべて見ることができます。 そのため、コメントにはセキュリティ的に重大な情報を記載してはいけません。
テーブルmytable
にコメントを付けます。
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 plpython3u 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にはCOMMENT
はありません。