KOMENTÁŘ K

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime

Nastaví komentář k katalogu, schématu, tabulce, sdílené složce, příjemci, poskytovateli nebo svazku.

Poznámka:

Pokud chcete přidat komentář vygenerovaný AI pro tabulku nebo sloupec tabulky spravovaný katalogem Unity, přečtěte si článek Přidání komentářů generovaných AI do tabulky.

Katalogy, sdílené složky, příjemce a poskytovatelé jsou podporovány pouze v katalogu Unity.

Pokud chcete nastavit komentář sloupce tabulky, použijte příkaz ALTER TABLE.

Syntaxe

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

Parametry

  • catalog_name

    Název katalogu, ve kterém se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem katalogu.

  • connection_name

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

    Název připojení, ve kterém se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem připojení.

  • Schema_name

    Název schématu, ve kterém se váš komentář zobrazí.

    Pokud používáte Katalog Unity ke spuštění tohoto příkazu, musíte být vlastníkem schématu.

  • Table_name

    Název tabulky, kterou okomentujete. Název nesmí obsahovat dočasnou specifikaci.

    Pokud používáte Katalog Unity ke spuštění tohoto příkazu, musíte mít MODIFY oprávnění k tabulce.

  • share_name

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

    Název sdílené složky, ve které se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem sdílené složky.

  • recipient_name

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

    Jméno příjemce, na kterém se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem příjemce.

  • provider_name

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

    Název poskytovatele, ve kterém se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem poskytovatele.

  • volume_name

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

    Název svazku, ve kterém se váš komentář zobrazí. Pokud chcete tento příkaz spustit, musíte být vlastníkem svazku.

  • Komentář

    Literál STRING nebo NULL. Pokud zadáte NULL jakýkoli existující komentář, odebere se.

Příklady

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