Condividi tramite

COMMENT ON

  • Articolo

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

Imposta un commento su un catalog, schema, table, una condivisione, un destinatario, un fornitore o un volume.

Nota

Per aggiungere un commento generato dall'intelligenza artificiale a un table o a un tablecolumn gestito da Unity Catalog, consultare Aggiungere commenti generati dall'intelligenza artificiale agli oggetti Unity Catalog.

Catalogs, shares, recipientse providers sono supportati solo in Unity Catalog.

Per set il commento di un tablecolumn, usa ALTER TABLE.

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 table_name |
      VOLUME volume_name }
    IS comment

Parameters

  • catalog_name

    Viene visualizzato il nome del catalogwhere commento. Per eseguire questa istruzione, è necessario essere il proprietario del catalog o avere il privilegio di MANAGE su di esso.

  • relation_name . nome_colonna

    Si applica a: con il segno di spunta sì Databricks Runtime 16.1 e versioni successive

    Nome qualificato del column su cui hai commentato. relation_name deve identificare una vista o un table. Il relation_name non deve includere una specifica temporale o una specifica delle opzioni.

    Se usi Unity Catalog, per eseguire questo comando, è necessario avere il privilegio MODIFY su table.

  • connection_name

    Si applica a:contrassegnato con un segno di spunta Databricks SQL contrassegnato con un segno di spunta Databricks Runtime 13.3 LTS e versioni successive contrassegnato con un segno di spunta solo Unity Catalog

    Il nome della connessione where appare nel tuo commento. Per eseguire questa istruzione, è necessario essere il proprietario della connessione o avere il privilegio MANAGE su di esso.

  • schema_name

    Viene visualizzato il nome del tuo schemawhere commento.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario essere il proprietario del schema o avere il privilegio MANAGE su di esso.

  • table_name

    Il nome del table su cui commenti. Il nome non deve includere una specifica temporale o una specifica delle opzioni.

    Se si usa Unity Catalog, per eseguire questa istruzione, è necessario avere MODIFY privilegio su table.

  • share_name

    Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

    Il nome della condivisione where in cui appare il tuo 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

    Il nome del destinatario where appare nel tuo 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

    Il nome del provider where 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

    Il nome del volume where in cui appare il tuo commento. Per eseguire questa istruzione, è necessario essere il proprietario del volume o avere il privilegio MANAGE su di esso.

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