Dela via

KOMMENTERA

  • 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 |
      CONNECTION connection_name |
      PROVIDER provider_name |
      RECIPIENT recipient_name |
      { SCHEMA | DATABASE } schema_name |
      SHARE share_name |
      TABLE table_name |
      VOLUME volume_name }
    IS comment

Parametrar

  • catalog_name

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

  • connection_name

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

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

  • schema_name

    Namnet på schemat där kommentaren visas.

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

  • table_name

    Namnet på tabellen som du kommenterar. Namnet får inte innehålla någon temporal specifikation.

    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å resursen där kommentaren 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 instruktionen måste du vara ägare till volymen.

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