COMMENT ON

Dotyczy: Databricks SQL Databricks Runtime

Ustawia komentarz do katalogu, schematu, tabeli, kolumny, 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.

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 relation_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: Databricks SQL Databricks Runtime 16.1 i nowsze

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

  Jeśli używasz Unity Catalog, aby wykonać tę operację, musisz mieć:

  • MODIFY uprawnienia na stole.
  • Bądź OWNER widoku.

• nazwa_połączenia

  Dotyczy: Databricks SQL Databricks Runtime 13.3 LTS i nowsze 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 mieć na nim uprawnienia MANAGE.

• nazwa_relacji

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

  Jeśli używasz Unity Catalog, aby wykonać tę operację, musisz mieć:

  • MODIFY uprawnienia na stole.
  • Bądź OWNER widoku.

• share_name

  Dotyczy: Databricks SQL 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: Databricks SQL 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: Databricks SQL 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.

• nazwa wolumenu

  Dotyczy: Databricks SQL 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 VOLUME my_volume IS 'Huge volume';

Powiązane artykuły

• 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