Aracılığıyla paylaş

COMMENT ON

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime

Katalog, şema, tablo, sütun, paylaşım, alıcı, sağlayıcı veya birim hakkında bir açıklama ayarlar.

Not

Unity Kataloğu tarafından yönetilen bir tablo veya tablo sütunu için yapay zeka tarafından oluşturulan bir açıklama eklemek istiyorsanız bkz. Unity Kataloğu nesnelerine yapay zeka tarafından oluşturulan açıklamalar ekleme.

Kataloglar, paylaşımlar, alıcılar ve sağlayıcılar yalnızca Unity Kataloğu'nda desteklenir.

Sözdizimi

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

Parametreler

  • catalog_name

    Açıklamanızın görüntülendiği kataloğun adı. Bu deyimi çalıştırmak için kataloğun sahibi olmanız veya üzerinde MANAGE ayrıcalığına sahip olmanız gerekir.

  • relation_name. sütun_adı

    Şunlar için geçerlidir: evet olarak işaretlendi Databricks SQL, evet olarak işaretlendi Databricks Runtime 16.1 ve üzeri

    Açıklama eklediğiniz sütunun tam adı. relation_name bir görünümü veya tabloyu tanımlaması gerekir. relation_name bir zamansal belirtim veyaseçenek belirtimi içermemelidir.

    Unity Kataloğu'nu kullanıyorsanız, bu deyimi çalıştırmak için aşağıdakilere sahip olmanız gerekir:

    • Tablo üzerindeki MODIFY ayrıcalığı.
    • Görünümün OWNER'si olun.

  • bağlantı_adı

    Şunlar için geçerlidir:onaylandı Databricks SQL onaylandı Databricks Runtime 13.3 LTS ve üzeri onaylandıyalnızca Unity Kataloğu

    Açıklamanızın görüntülendiği bağlantının adı. Bu deyimi çalıştırmak için bağlantının sahibi olmanız veya üzerinde MANAGE yetkisine sahip olmanız gerekir.

  • schema_name

    Açıklamanızın görüntülendiği şemanın adı.

    Unity Kataloğu'nu kullanıyorsanız, bu deyimi çalıştırmak için şemanın sahibi olmanız veya şemada ayrıcalığınız MANAGE olması gerekir.

  • ilişki_adı

    Yorum yaptığınız tablonun veya görünümün adı. Tablo adı bir zamansal belirtim veya seçenek belirtimi içermemelidir.

    Unity Kataloğu'nu kullanıyorsanız, bu deyimi çalıştırmak için aşağıdakilere sahip olmanız gerekir:

    • Tablo üzerindeki MODIFY ayrıcalığı.
    • Görünümün OWNER'si olun.

  • share_name

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

    Açıklamanızın görüntülendiği paylaşımın adı. Bu deyimi çalıştırmak için paylaşımın sahibi olmanız gerekir.

  • recipient_name

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

    Açıklamanızın görüntülendiği alıcının adı. Bu deyimi çalıştırmak için alıcının sahibi olmanız gerekir.

  • provider_name

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

    Açıklamanızın görüntülendiği sağlayıcının adı. Bu deyimi çalıştırmak için sağlayıcının sahibi olmanız gerekir.

  • hacim_adı

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

    Açıklamanızın görüntülendiği birimin adı. Bu ifadeyi çalıştırmak için birimin sahibi olmanız veya birimin üzerinde MANAGE ayrıcalığına sahip olmanız gerekir.

  • yorum

    Değişmez STRING değer veya NULL. Mevcut bir açıklamanın kaldırılacağını belirtirseniz NULL .

Örnekler

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