postgresql/src/include/commands
Bruce Momjian 7acc237744 This patch implements ORACLE's COMMENT SQL command.
>From the ORACLE 7 SQL Language Reference Manual:
-----------------------------------------------------
COMMENT

Purpose:

To add a comment about a table, view, snapshot, or
column into the data dictionary.

Prerequisites:

The table, view, or snapshot must be in your own
schema
or you must have COMMENT ANY TABLE system privilege.

Syntax:

COMMENT ON [ TABLE table ] |
           [ COLUMN table.column] IS 'text'

You can effectively drop a comment from the database
by setting it to the empty string ''.
-----------------------------------------------------

Example:

COMMENT ON TABLE workorders IS
   'Maintains base records for workorder information';

COMMENT ON COLUMN workorders.hours IS
   'Number of hours the engineer worked on the task';

to drop a comment:

COMMENT ON COLUMN workorders.hours IS '';

The current patch will simply perform the insert into
pg_description, as per the TODO. And, of course, when
the table is dropped, any comments relating to it
or any of its attributes are also dropped. I haven't
looked at the ODBC source yet, but I do know from
an ODBC client standpoint that the standard does
support the notion of table and column comments.
Hopefully the ODBC driver is already fetching these
values from pg_description, but if not, it should be
trivial.

Hope this makes the grade,

Mike Mascari
(mascarim@yahoo.com)
1999-10-15 01:49:49 +00:00
..
async.h Cleanup of /include #include's, for 6.6 only. 1999-07-14 01:20:30 +00:00
cluster.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00
command.h Change #include's to use <> and "" as appropriate. 1999-07-15 23:04:24 +00:00
copy.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00
creatinh.h This patch implements ORACLE's COMMENT SQL command. 1999-10-15 01:49:49 +00:00
dbcommands.h Clean up #include in /include directory. Add scripts for checking includes. 1999-07-15 15:21:54 +00:00
defrem.h More cleanup 1999-07-16 17:07:40 +00:00
explain.h More cleanup 1999-07-16 17:07:40 +00:00
proclang.h Change #include's to use <> and "" as appropriate. 1999-07-15 23:04:24 +00:00
rename.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00
sequence.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00
trigger.h This is part #1 for of the DEFERRED CONSTRAINT TRIGGER support. 1999-09-29 16:06:40 +00:00
user.h Cleanup of /include #include's, for 6.6 only. 1999-07-14 01:20:30 +00:00
vacuum.h Add new vpl_num_allocated_pages member to VPageListData. 1999-08-25 12:18:31 +00:00
variable.h Make functions static or ifdef NOT_USED. Prevent pg_version creation. 1998-10-08 18:30:52 +00:00
version.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00
view.h Change my-function-name-- to my_function_name, and optimizer renames. 1999-02-13 23:22:53 +00:00