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 tabella di streaming, una vista o una vista materializzata. Il relation_name non deve includere una specifica temporale o una specifica delle opzioni.

    Nota

    Se si modifica un commento di colonna in una vista definita WITH SCHEMA EVOLUTION, il commento verrà popolato nuovamente dalla query di visualizzazione sul riferimento successivo alla vista.

    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, della tabella di streaming, della vista o della vista materializzata commentata. 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.

    Richiede un segno di spunta contrassegnato con sì Databricks Runtime 16.3 e versioni successive per impostare un commento su una vista materializzata.

  • 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