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 einer Tabelle.

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

Verwenden Sie ALTER TABLE, um den Kommentar für eine Tabellenspalte anzulegen.

Syntax

COMMENT ON
    { CATALOG catalog_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 auszuführen, müssen Sie der Eigentümer des Katalogs sein. sein.

  • 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 für Unity Catalog

    Der Name der Verbindung, in der Ihr Kommentar angezeigt wird. Um diese Anweisung auszuführen, müssen Sie Besitzer der Verbindung sein.

  • schema_name

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

    Wenn Sie Unity Catalog verwenden, müssen Sie zum Ausführen dieser Anweisung der Eigentümer des Schemas sein.

  • table_name

    Der Name der Tabelle, die Sie kommentieren. Der Name darf keine temporale Spezifikation 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 ab Version 13.3 LTS

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

  • 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 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';