Udostępnij za pośrednictwem

COMMENT ON

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Ustawia komentarz do katalogu, schematu, tabeli, udziału, adresata, dostawcy lub woluminu.

Uwaga

Jeśli chcesz dodać komentarz AI dla tabeli lub kolumny tabeli zarządzanej przez Unity Catalog, zobacz Dodawanie komentarzy AI do obiektów Unity Catalog.

Katalogi, udziały, odbiorcy i dostawcy są obsługiwane wyłącznie w Unity Catalog.

Aby ustawić komentarz kolumny tabeli, użyj ALTER TABLE.

Składnia

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

    Nazwa katalogu, w którym pojawia się komentarz. Aby uruchomić to polecenie, musisz być właścicielem katalogu lub mieć na nim uprawnienia MANAGE.

  • relation_name . nazwa_kolumny

    Dotyczy: jest zaznaczone na tak Databricks SQL jest zaznaczone na tak Databricks Runtime 16.1 i nowsze

    Kwalifikowana nazwa kolumny, nad którą skomentujesz. relation_name musi identyfikować widok lub tabelę. relation_name nie może zawierać specyfikacji czasowej ani specyfikacji opcji.

    Jeśli używasz Unity Catalog, aby uruchomić to polecenie, musisz mieć uprawnienia MODIFY na tabeli.

  • connection_name

    Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 13.3 LTS i nowsze zaznaczone jako tak tylko Unity Catalog

    Nazwa połączenia, w którym pojawia się komentarz. Aby uruchomić tę instrukcję, musisz być właścicielem połączenia lub mieć na nim uprawnienia MANAGE.

  • schema_name

    Nazwa schematu, w którym pojawia się komentarz.

    Jeśli używasz Unity Catalog, aby uruchomić tę instrukcję, musisz być właścicielem schematu lub posiadać na nim przywileje MANAGE.

  • table_name

    Nazwa tabeli, nad którą skomentujesz. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji.

    Jeśli używasz Unity Catalog, aby uruchomić to polecenie, musisz mieć uprawnienia MODIFY na tabeli.

  • share_name

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    Nazwa zasobu, w którym pojawia się komentarz. Aby uruchomić tę instrukcję, musisz być właścicielem udziału.

  • recipient_name

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    Nazwa adresata, przy której pojawia się komentarz. Aby uruchomić tę instrukcję, musisz być właścicielem adresata.

  • provider_name

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    Nazwa dostawcy, w którym pojawia się komentarz. Aby uruchomić tę instrukcję, musisz być właścicielem dostawcy.

  • volume_name

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

    Nazwa woluminu, w którym pojawia się komentarz. Aby uruchomić tę instrukcję, musisz być właścicielem woluminu lub mieć na nim uprawnienia MANAGE.

  • komentarz

    Literał STRING lub NULL. Jeśli określisz NULL istniejący komentarz, zostanie usunięty.

Przykłady

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