Amazon Redshift non supporterà più la creazione di nuovi Python UDFs a partire dalla Patch 198. Python esistente UDFs continuerà a funzionare fino al 30 giugno 2026. Per ulteriori informazioni, consulta il post del blog
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
Parameters
- 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.
