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 tabeli.

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 |
      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.

  • connection_name

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks 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.

  • Schema_name

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

    Jeśli używasz wykazu aparatu Unity, aby uruchomić tę instrukcję, musisz być właścicielem schematu.

  • Nazwa_tabeli

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

    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.

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