Dela via

COMMENT ON

  • Artikel

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Anger en kommentar till en katalog, ett schema, en tabell, en resurs, en mottagare, en provider eller en volym.

Kommentar

Om du vill lägga till en AI-genererad kommentar för en tabell- eller tabellkolumn som hanteras av Unity Catalog kan du läsa Lägga till AI-genererade kommentarer till Unity Catalog-objekt.

Kataloger, resurser, mottagare och leverantörer stöds endast i Unity Catalog.

Om du vill ange kommentaren för en tabellkolumn använder du ALTER TABLE.

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

Parameterar

  • catalog_name

    Namnet på katalogen där kommentaren visas. För att köra det här uttrycket måste du vara ägare till katalogen eller ha behörigheten MANAGE på den.

  • relation_name . kolumnnamn

    Gäller för: markeras som ja Databricks SQL markeras som ja Databricks Runtime 16.1 och senare

    Det kvalificerade namnet på kolumnen som du kommenterar. relation_name måste identifiera en vy eller en tabell. relation_name får inte innehålla en temporal specifikation eller alternativspecifikation.

    Om du använder Unity Catalog måste du ha MODIFY behörighet i tabellen för att kunna köra den här instruktionen.

  • connection_name

    gäller för:markerat med ja Databricks SQL markerat med ja Databricks Runtime 13.3 LTS och senare markerat med ja endast Unity Catalog

    Namnet på anslutningen där kommentaren visas. För att köra detta uttalande måste du vara ägare till anslutningen eller ha MANAGE-behörighet på den.

  • schema_name

    Namnet på schemat där kommentaren visas.

    Om du använder Unity Catalog måste du vara ägare till schemat eller ha MANAGE behörighet för den för att kunna köra den här instruktionen.

  • table_name

    Namnet på tabellen som du kommenterar. Namnet får inte innehålla en temporal specifikation eller alternativspecifikation.

    Om du använder Unity Catalog måste du ha MODIFY behörighet i tabellen för att kunna köra den här instruktionen.

  • share_name

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    Namnet på delningen där din kommentar visas. Om du vill köra den här instruktionen måste du vara resursens ägare.

  • recipient_name

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    Namnet på mottagaren där kommentaren visas. Om du vill köra den här instruktionen måste du vara mottagarens ägare.

  • provider_name

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    Namnet på providern där kommentaren visas. Om du vill köra den här instruktionen måste du vara providerns ägare.

  • volume_name

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

    Namnet på volymen där kommentaren visas. Om du vill köra den här satsen måste du vara ägare till volymen eller ha MANAGE-behörighet på den.

  • kommentar

    En STRING literal eller NULL. Om du anger NULL att en befintlig kommentar tas bort.

Exempel

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