Teilen über

COMMENT ON

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Legt einen Kommentar für einen Katalog, ein Schema, eine Tabelle, eine Freigabe, einen Empfänger, einen Anbieter oder ein Volume fest.

Hinweis

Wenn Sie einen KI-generierten Kommentar für eine von Unity Catalog verwaltete Tabelle oder Tabellenspalte hinzufügen möchten, lesen Sie Hinzufügen von KI-generierten Kommentaren zu Unity Catalog-Objekten.

Kataloge, Freigaben, Empfänger und Anbieter werden nur in Unity Catalog unterstützt.

Verwenden Sie ALTER TABLE, um den Kommentar einer Tabellenspalte festzulegen.

Syntax

COMMENT ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      CONNECTION connection_name |
      PROVIDER provider_name |
      RECIPIENT recipient_name |
      { SCHEMA | DATABASE } schema_name |
      SHARE share_name |
      TABLE table_name |
      VOLUME volume_name }
    IS comment

Parameter

  • catalog_name

    Der Name des Katalogs, in dem Ihr Kommentar angezeigt wird. Um diese Anweisung ausführen zu können, müssen Sie der Besitzer des Katalogs sein oder über die Berechtigung MANAGE für den Katalog verfügen.

  • relation_name . column_name

    Gilt : Grünes Häkchen für „Ja“ Databricks SQL Grünes Häkchen für „Ja“ Databricks Runtime 16.1 und höher

    Der qualifizierte Name der Spalte, zu der Sie kommentieren. relation_name muss eine Ansicht oder eine Tabelle identifizieren. Die Angabe relation_name darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten.

    Wenn Sie Unity Catalog verwenden, müssen Sie zum Ausführen dieser Anweisung über die MODIFY-Berechtigung für die Tabelle verfügen.

  • connection_name

    Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher Häkchen gesetzt ja Nur Unity Catalog

    Der Name der Verbindung, in der Ihr Kommentar angezeigt wird. Um diese Anweisung ausführen zu können, müssen Sie der Besitzer der Verbindung sein oder über die Berechtigung MANAGE für die Verbindung verfügen.

  • schema_name

    Der Name des Schemas, in dem Ihr Kommentar angezeigt wird.

    Wenn Sie Unity Catalog verwenden, müssen Sie, um diese Anweisung auszuführen, der Besitzer des Schemas sein oder über die MANAGE-Berechtigung verfügen.

  • table_name

    Der Name der Tabelle, die Sie kommentieren. Der Name darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten.

    Wenn Sie Unity Catalog verwenden, müssen Sie zum Ausführen dieser Anweisung über die MODIFY-Berechtigung für die Tabelle verfügen.

  • share_name

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 11.3 LTS und höher

    Der Name der Freigabe, in der Ihr Kommentar erscheint. Um diese Anweisung auszuführen, müssen Sie der Eigentümer der Freigabe sein.

  • recipient_name

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 11.3 LTS und höher

    Der Name des Empfängers, bei dem Ihr Kommentar erscheint. Um diese Anweisung auszuführen, müssen Sie der Eigentümer des Empfängers sein.

  • provider_name

    Gilt für:Häkchen ja Databricks SQL Häkchen Databricks Runtime 11.3 LTS und höher

    Der Name des Anbieters, wo Ihr Kommentar angezeigt wird. Um diese Anweisung auszuführen, müssen Sie der Eigentümer des Anbieters sein.

  • volume_name

    Gilt für:Häkchen gesetzt ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 13.3 LTS und höher

    Der Name der Volume, in der Ihr Kommentar erscheint. Um diese Anweisung ausführen zu können, müssen Sie der Besitzer des Volumes sein oder über die Berechtigung MANAGE für das Volume verfügen.

  • Kommentar

    Ein STRING-Literal oder NULL. Wenn Sie NULL angeben, wird ein vorhandener Kommentar entfernt.

Beispiele

> COMMENT ON CATALOG my_catalog IS 'This is my catalog';

> COMMENT ON COLUMN my_table.c1 IS 'This is my column';

> COMMENT ON CONNECTION mysql_connection IS 'this is a mysql connection';

> COMMENT ON SCHEMA my_schema IS 'This is my schema';

> COMMENT ON TABLE my_table IS 'This is my table';

> COMMENT ON TABLE my_table IS NULL;

> COMMENT ON SHARE my_share IS 'A good share';

> COMMENT ON RECIPIENT my_recipient IS 'A good recipient';

> COMMENT ON PROVIDER my_provider IS 'A good provider';

> COMMENT ON PROVIDER my_volume IS 'Huge volume';