Freigeben über

COMMENT ON

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

Legt einen Kommentar für einen Katalog, ein Schema, eine Tabelle, eine Spalte, einen Share, 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 KI-generierte Kommentare zu Unity Catalog Objekten hinzufügen.

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

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 relation_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 das MANAGE-Recht darauf haben.

  • relation_name . Spaltenname

    Gilt für: Häkchen für „Ja“ Databricks SQL 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 Tabelle, eine Ansicht oder eine materialisierte Ansicht identifizieren. Der relation_name darf keine Zeitangabe oder Optionsangabe enthalten.

    Wenn Sie den Unity-Katalog verwenden, müssen Sie für das Ausführen dieser Anweisung folgende Voraussetzungen erfüllen:

    • MODIFY-Berechtigung auf der Tabelle
    • sei das OWNER der Ansicht.

  • connection_name

    Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „Ja“ Databricks Runtime 13.3 LTS und höher Häkchen für „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 das Recht MANAGE verfügen.

  • schema_name

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

    Wenn Sie Unity-Katalog verwenden, müssen Sie zum Ausführen dieser Anweisung der Besitzer des Schemas sein oder über die MANAGE Berechtigung verfügen.

  • relation_name

    Der Name der Tabelle oder Ansicht, zu der Sie kommentieren. Der Tabellenname darf keine zeitliche Spezifikation oder Optionsspezifikation enthalten.

    Wenn Sie den Unity-Katalog verwenden, müssen Sie für das Ausführen dieser Anweisung folgende Voraussetzungen erfüllen:

    • MODIFY-Berechtigung auf der Tabelle
    • sei das OWNER der Ansicht.

  • share_name

    Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „Ja“ 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 für „Ja“ Databricks SQL Häkchen für „Ja“ 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 für „Ja“ Databricks SQL Häkchen für „Ja“ 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.

  • Volumenname

    Gilt für:Häkchen für „Ja“ Databricks SQL Häkchen für „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 auf dem 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 VOLUME my_volume IS 'Huge volume';
  • Last updated on