COMMENT ON-Anweisung

Die COMMENT ON-Anweisung erlaubt das Hinzufügen von Metadaten zu Katalogeinträgen (Tabellen, Spalten usw.). Sie folgt der PostgreSQL-Syntax.

Beispiele

Einen Kommentar zu einer TABLE anlegen:

COMMENT ON TABLE test_table IS 'very nice table';

Einen Kommentar zu einer COLUMN anlegen:

COMMENT ON COLUMN test_table.test_table_column IS 'very nice column';

Einen Kommentar zu einer VIEW anlegen:

COMMENT ON VIEW test_view IS 'very nice view';

Einen Kommentar zu einem INDEX anlegen:

COMMENT ON INDEX test_index IS 'very nice index';

Einen Kommentar zu einer SEQUENCE anlegen:

COMMENT ON SEQUENCE test_sequence IS 'very nice sequence';

Einen Kommentar zu einem TYPE anlegen:

COMMENT ON TYPE test_type IS 'very nice type';

Einen Kommentar zu einem MACRO anlegen:

COMMENT ON MACRO test_macro IS 'very nice macro';

Einen Kommentar zu einem MACRO TABLE anlegen:

COMMENT ON MACRO TABLE test_table_macro IS 'very nice table macro';

Um einen Kommentar zu entfernen, setzen Sie ihn auf NULL, z. B.:

COMMENT ON TABLE test_table IS NULL;

Kommentare können gelesen werden, indem Sie die Spalte comment der jeweiligen Metadatenfunktionen abfragen:

Kommentare zu TABLEs auflisten:

SELECT comment FROM duckdb_tables();

Kommentare zu COLUMNs auflisten:

SELECT comment FROM duckdb_columns();

Kommentare zu VIEWs auflisten:

SELECT comment FROM duckdb_views();

Kommentare zu INDEXs auflisten:

SELECT comment FROM duckdb_indexes();

Kommentare zu SEQUENCEs auflisten:

SELECT comment FROM duckdb_sequences();

Kommentare zu TYPEs auflisten:

SELECT comment FROM duckdb_types();

Kommentare zu MACROs auflisten:

SELECT comment FROM duckdb_functions();

Kommentare zu MACRO TABLEs auflisten:

SELECT comment FROM duckdb_functions();

Die COMMENT ON-Anweisung hat derzeit die folgenden Einschränkungen:

Es ist nicht möglich, Schemas oder Datenbanken zu kommentieren.
Es ist nicht möglich, Dinge zu kommentieren, die eine Abhängigkeit haben (z. B. eine Tabelle mit einem Index).