Condividi tramite

COMMENT ON

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Imposta un commento su un catalogo, uno schema, una tabella, una colonna, 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 agli oggetti del catalogo unity.

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

Sintassi

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

Parametri

  • catalog_name

    Nome del catalogo in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del catalogo o avere il privilegio MANAGE su di esso.

  • relation_name . nome_colonna

    Si applica a: segnato come sì Databricks SQL segnato come sì Databricks Runtime 16.1 e versioni successive

    Nome completo della colonna che commenti. relation_name deve identificare una tabella, una vista o una vista materializzata. Il relation_name non deve includere una specifica temporale o una specifica delle opzioni.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario disporre di:

    • MODIFY privilegio sulla tabella.
    • essere l'oggetto OWNER della visualizzazione.

  • nome_connessione

    Si applica a:contrassegnato come sì Databricks SQL contrassegnato come sì Databricks Runtime 13.3 LTS e versioni successive contrassegnato come sì solo Catalogo Unity

    Nome della connessione in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario della connessione o avere il privilegio MANAGE su di esso.

  • 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 o disporre del MANAGE privilegio.

  • relation_name

    Nome della tabella, o vista, su cui si commenta. Il nome della tabella non deve includere una specifica temporale o una specifica delle opzioni.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario disporre di:

    • MODIFY privilegio sulla tabella.
    • essere l'oggetto OWNER della visualizzazione.

  • share_name

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS 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:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS 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:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS 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:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive

    Nome del volume in cui viene visualizzato il commento. Per eseguire questa istruzione, è necessario essere il proprietario del volume o avere il privilegio MANAGE su di esso.

  • commento

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