Udostępnij za pośrednictwem

KOMENTARZ NA TEMAT

  • 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 wygenerowany przez sztuczną inteligencję dla tabeli lub kolumny tabeli zarządzanej przez wykaz aparatu Unity, zobacz Dodawanie komentarzy wygenerowanych przez sztuczną inteligencję do obiektów wykazu aparatu Unity.

Wykazy, udziały, adresaci i dostawcy są obsługiwane tylko w wykazie aparatu Unity.

Aby ustawić komentarz kolumny tabeli, użyj polecenia 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ć tę instrukcję, musisz być właścicielem wykazu lub mieć na nim uprawnienia MANAGE.

  • relation_name . nazwa_kolumny

    Dotyczy: zaznaczyć tak Databricks Runtime 16.1 i nowszych

    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 wykazu aparatu Unity, aby uruchomić tę instrukcję, musisz mieć MODIFY uprawnienia w tabeli.

  • connection_name

    Dotyczy:zaznacz pole wyboru oznaczone jako takDatabricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

    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 wykonać to polecenie, musisz być właścicielem schematu lub mieć na nim uprawnienia MANAGE.

  • table_name

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

    Jeśli używasz wykazu aparatu Unity, aby uruchomić tę instrukcję, musisz mieć MODIFY uprawnienia w 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 udziału, 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, w którym 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';