Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
COMMENT
Crea o modifica un commento su un oggetto di database.
Sintassi
COMMENT ON { TABLE object_name | COLUMN object_name.column_name | CONSTRAINT constraint_name ON table_name | DATABASE object_name | VIEW object_name } IS 'text' | NULL
Parametri
- object_name
-
Nome dell'oggetto del database che viene commentato. Puoi aggiungere un commento ai seguenti oggetti:
-
TABLE
-
COLUMN (prende anche un column_name).
-
CONSTRAINT (prende anche un constraint_name e un table_name).
-
DATABASE
-
VIEW
-
SCHEMA
-
- IS 'text' | NULL
-
Il testo del commento che si desidera aggiungere o sostituire per l'oggetto specificato. La stringa text ha un tipo di dati TEXT. Racchiudi il commento tra virgolette singole. Impostare il valore su NULL per rimuovere il testo del commento.
- column_name
-
Nome della colonna che viene commentata. Parametro di COLUMN. Segue una tabella specificata in
object_name. - constraint_name
-
Nome del vincolo che viene commentato. Parametro di CONSTRAINT.
- table_name
-
Nome della tabella contenente il vincolo. Parametro di CONSTRAINT.
Note per l'utilizzo
Per aggiungere o aggiornare un commento, si deve essere un superuser o il proprietario di un oggetto di database.
I commenti sui database possono essere applicati solo al database corrente. Viene visualizzato un messaggio di avviso se tenti di commentare un database diverso. Lo stesso avviso viene visualizzato per i commenti su database che non esistono.
I commenti su tabelle esterne, colonne esterne e colonne di viste con associazione tardiva non sono supportati.
Esempi
Nell'esempio seguente viene aggiunto un commento alla tabella SALES.
COMMENT ON TABLE sales IS 'This table stores tickets sales data';
Nell'esempio seguente viene visualizzato il commento nella tabella SALES.
select obj_description('public.sales'::regclass); obj_description ------------------------------------- This table stores tickets sales data
Nell'esempio seguente viene rimosso un commento dalla tabella SALES.
COMMENT ON TABLE sales IS NULL;
Nell'esempio seguente viene aggiunto un commento alla colonna EVENTID della tabella SALES.
COMMENT ON COLUMN sales.eventid IS 'Foreign-key reference to the EVENT table.';
Nell'esempio seguente viene visualizzato un commento nella colonna EVENTID (colonna numero 5) della tabella SALES.
select col_description( 'public.sales'::regclass, 5::integer ); col_description ----------------------------------------- Foreign-key reference to the EVENT table.
Nell'esempio seguente viene aggiunto un commento descrittivo alla tabella EVENT.
comment on table event is 'Contains listings of individual events.';
Per visualizzare i commenti, eseguire una query sul catalogo di sistema PG_DESCRIPTION. L'esempio seguente restituisce la descrizione per la tabella EVENT.
select * from pg_catalog.pg_description where objoid = (select oid from pg_class where relname = 'event' and relnamespace = (select oid from pg_catalog.pg_namespace where nspname = 'public') ); objoid | classoid | objsubid | description -------+----------+----------+---------------------------------------- 116658 | 1259 | 0 | Contains listings of individual events.
