COMMENTO SU

Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime

Imposta un commento su un catalogo, uno schema, una tabella, una condivisione, un destinatario, un provider o un volume.

Nota

Per aggiungere un commento generato dall'intelligenza artificiale per una tabella o una colonna di tabella gestita da Unity Catalog, vedere Aggiungere commenti generati dall'intelligenza artificiale a una tabella.

I cataloghi, le condivisioni, i destinatari e i provider sono supportati solo in Unity Catalog.

Per impostare il commento di una colonna di tabella, utilizzare ALTER TABLE.

Sintassi

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

Parametri

  • catalog_name

    Nome del catalogo in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del catalogo.

  • connection_name

    Si applica a:check marked yes solo Databricks SQL check marked yes Databricks Runtime 13.1 e versioni successive check marked yes

    Nome della connessione in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario della connessione.

  • schema_name

    Nome dello schema in cui viene visualizzato il commento.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario essere il proprietario dello schema.

  • table_name

    Nome della tabella su cui si commenta. Il nome non deve includere una specifica temporale.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario disporre MODIFY dei privilegi per la tabella.

  • share_name

    Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime 11.1 e versioni successive

    Nome della condivisione in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario della condivisione.

  • recipient_name

    Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime 11.1 e versioni successive

    Nome del destinatario in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del destinatario.

  • provider_name

    Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime 11.1 e versioni successive

    Nome del provider in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del provider.

  • volume_name

    Si applica a:check marked yes Databricks SQL check marked yes Databricks Runtime 13.2 e versioni successive

    Nome del volume in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del volume.

  • comment

    Valore STRING letterale o NULL. Se si specifica NULL un commento esistente viene rimosso.

Esempi

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