Dela via

COMMENT ON

  • Artikel

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

Anger en kommentar på en catalog, schema, table, resurs, mottagare, tjänsteleverantör eller volym.

Kommentar

Om du vill lägga till en AI-genererad kommentar för en table eller tablecolumn som styrs av Unity Catalog, se Lägga till AI-genererade kommentarer till Unity Catalog-objekt.

Catalogs, shares, recipientsoch providers stöds endast i Unity Catalog.

Om du vill set kommentaren för en tablecolumnanvä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

Parameters

  • catalog_name

    Namnet på kommentaren catalogwhere visas. För att köra det här uttrycket måste du vara ägare till catalog eller ha MANAGE-behörighet till det.

  • relation_name . kolumnnamn

    Gäller för: Markerad: Ja Databricks Runtime 16.1 och senare

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

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

  • connection_name

    gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 13.3 LTS och senare markerad som ja Unity Catalog

    Namnet på anslutningen where där din kommentar 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 där din schemawhere kommentar visas.

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

  • table_name

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

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

  • share_name

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

    Namnet på aktien where 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 where 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 where 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 where 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';