Delen via

COMMENT ON

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Hiermee stelt u een opmerking in voor een catalogus, schema, tabel, share, ontvanger, provider of volume.

Notitie

Als u een door AI gegenereerde opmerking wilt toevoegen voor een tabel- of tabelkolom die wordt beheerd door Unity Catalog, raadpleegt u Door AI gegenereerde opmerkingen toevoegen aan Unity Catalog-objecten.

Catalogi, shares, ontvangers en providers worden alleen ondersteund in Unity Catalog.

Als u de opmerking van een tabelkolom wilt instellen, gebruikt u ALTER TABLE.

Syntaxis

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

Parameterwaarden

  • catalog_name

    De naam van de catalogus waarin uw opmerking wordt weergegeven. Om deze opdracht uit te voeren, moet u de eigenaar van de catalogus zijn of de MANAGE bevoegdheid erop hebben.

  • relation_name . column_name

    Van toepassing op: controle gemarkeerd als ja Databricks SQL controle gemarkeerd als ja Databricks Runtime 16.1 en hoger

    De gekwalificeerde naam van de kolom waarop u een opmerking plaatst. relation_name moet een weergave of tabel identificeren. De relation_name mag geen specificatie voor tijd of opties bevatten.

    Als u Unity Catalog gebruikt om deze instructie uit te voeren, moet u bevoegd zijn MODIFY voor de tabel.

  • connection_name

    Van toepassing op:gemarkeerd met ja Databricks SQL gemarkeerd met ja Databricks Runtime 13.3 LTS en hoger gemarkeerd met ja Unity Catalog alleen

    De naam van de verbinding waarin uw opmerking wordt weergegeven. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de verbinding zijn of de MANAGE-privilege hebben.

  • schema_name

    De naam van het schema waarin uw opmerking wordt weergegeven.

    Als u Unity Catalog gebruikt om deze instructie uit te voeren, moet u de eigenaar van het schema zijn of de MANAGE bevoegdheid hebben.

  • table_name

    De naam van de tabel waarop u een opmerking plaatst. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten.

    Als u Unity Catalog gebruikt om deze instructie uit te voeren, moet u bevoegd zijn MODIFY voor de tabel.

  • share_name

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    De naam van de share waar uw opmerking wordt weergegeven. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de share zijn.

  • recipient_name

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    De naam van de geadresseerde waar uw opmerking wordt weergegeven. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de ontvanger zijn.

  • provider_name

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    De naam van de provider waarin uw opmerking wordt weergegeven. Als u deze instructie wilt uitvoeren, moet u de eigenaar van de provider zijn.

  • volume_name

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

    De naam van het volume waarin de opmerking wordt weergegeven. Om deze instructie uit te voeren, moet u de eigenaar van het volume zijn of het MANAGE-privilege hebben.

  • commentaar

    Een STRING letterlijke of NULL. Als u een bestaande opmerking opgeeft NULL , wordt verwijderd.

Voorbeelden

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