COMMENT ON

Platí pro: Databricks SQL 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 Přidání komentářů vygenerovaných AI do objektů katalogu Unity.

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

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

Syntaxe

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

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 nebo mít k němu oprávnění MANAGE.

• relation_name . column_name

  Platí pro: Databricks SQL Databricks Runtime 16.1 a vyšší.

  Kvalifikovaný název sloupce, na který komentář zakomentujete. relation_name musí identifikovat zobrazení nebo tabulku. relation_name nesmí obsahovat specifikaci času ani specifikaci možností.

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

• connection_name

  platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší, Unity Catalog.

  Název připojení, ve kterém se váš komentář zobrazí. Chcete-li spustit tento příkaz, musíte být vlastníkem připojení nebo mít k němu oprávnění MANAGE..

• schema_name

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

  Pokud používáte katalog Unity pro spuštění tohoto příkazu, musíte být vlastníkem schématu nebo mít oprávnění MANAGE na něm.

• table_name

  Název tabulky, kterou okomentujete. Název nesmí obsahovat dočasnou specifikaci ani specifikaci možností.

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

• share_name

  Platí pro: Databricks SQL 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: Databricks SQL 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: Databricks SQL 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: Databricks SQL 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 nebo mít k němu oprávnění MANAGE..

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

Související články

• CREATE CATALOG
• DESCRIBE CATALOG
• DROP CATALOG
• ALTER SCHEMA
• CREATE SCHEMA
• DESCRIBE SCHEMA
• DROP SCHEMA
• ALTER TABLE
• CREATE TABLE
• DESCRIBE TABLE
• DROP TABLE
• ALTER SHARE
• CREATE SHARE
• DESCRIBE SHARE
• DROP SHARE
• ALTER RECIPIENT
• CREATE RECIPIENT
• DESCRIBE RECIPIENT
• DROP RECIPIENT
• ALTER PROVIDER
• DESCRIBE PROVIDER
• DROP PROVIDER
• ALTER VOLUME
• DESCRIBE VOLUME
• DROP VOLUME