Aracılığıyla paylaş


Verilere ve yapay zeka varlıklarına açıklama ekleme

Bu makalede veriler ve yapay zeka varlıkları için açıklamalar ve bunların nasıl ekleneceği açıklanmaktadır. Açıklamalar, sizin ve diğer kullanıcıların ihtiyacınız olan verileri ve yapay zeka varlıklarını bulup yönetmenize yardımcı olabilir.

Açıklamalar, güvenli hale getirilebilen nesnelerinize açıklama eklemek için bir meta veri alanı sağlar. Unity Kataloğu'nda kataloglar, şemalar, tablolar, birimler, yapay zeka modelleri ve daha fazlası gibi güvenli hale getirilebilir herhangi bir nesneye açıklama ekleyebilirsiniz. Tablo sütunlarına açıklama da ekleyebilirsiniz.

Açıklamaları el ile ekleyebilir veya Databricks'in sizin için yapay zeka tarafından oluşturulan açıklamalar oluşturmasına izin vekleyebilirsiniz. Tablolar ve tablo sütunları için yapay zeka tarafından oluşturulan açıklamalar (yapay zeka tarafından oluşturulan belgeler olarak da bilinir) kullanılabilir. bkz. Unity Kataloğu nesnelerine yapay zeka tarafından oluşturulan açıklamalar ekleme.

Unity Kataloğu tablosunun açıklamalarını (veya eski Hive meta deposundaki bir Delta Lake tablosunu) değiştirdiğinizde, tablo geçmişindeki bir SET TBLPROPERTIES işlemi, tablo açıklamasını tanımlamak için kullanılan SQL sorgusunu kaydeder.

Başlamadan önce

Açıklama eklemek veya düzenlemek için aşağıdaki gereksinimleri karşılamanız gerekir:

  • Katalog, şema, birim, model, paylaşım, alıcı, sağlayıcı, depolama kimlik bilgileri, dış konum veya bağlantıda açıklama eklemek veya düzenlemek için nesnenin sahibi olmanız veya nesne üzerinde MANAGE ayrıcalığına sahip olmanız gerekir.
  • Tablo veya sütuna açıklama eklemek veya bunları düzenlemek için sahibi olmanız veya aşağıdaki ayrıcalıklara sahip olmanız gerekir:
    • MODIFY ve SELECT masada.
    • Üst katalog ve şemada USE CATALOG ve USE SCHEMA.
  • Unity Kataloğu'nu (paylaşılan veya tek kullanıcılı işlem) destekleyen bir SQL ambarı veya başka bir işlem kullanmanız gerekir.
  • Yapay zeka tarafından oluşturulan açıklamaları kullanmak için, yapay zeka destekli özellikler için çalışma alanınızın etkinleştirilmesi gerekir. bkz. Unity Kataloğu nesnelerine yapay zeka tarafından oluşturulan açıklamalar ekleme.

Açıklama ekleme ve düzenleme

Güvenliği sağlanabilir nesnelere açıklama ekleyebilir veya SQL komutlarını veya Katalog Gezgini'ne kullanarak bunları düzenleyebilirsiniz.

Katalog Gezgini

  1. Çalışma alanı kenar çubuğunda, Katalog Gezgini'ni açmak için Katalog simgesi Katalog üzerine tıklayın.

  2. Açıklama eklemek istediğiniz nesneyi arayın ve seçin.

    Veriler ve yapay zeka nesneleri, Kataloğu bölmesinde listelenir ve aranabilir. paylaşımlar, depolama kimlik bilgileri, dış konumlar ve bağlantılar, dişli simgesi dişli simgesi ne tıkladığınızda açılan menü kullanılarak erişilebilir.

  3. Açıklama ekleyin veya var olan bir açıklamayı düzenleyin.

    • yapay zeka tarafından oluşturulan açıklamaları kullanarak tabloya açıklama eklemek için, Genel Bakış sekmesinin sağ bölmesinde Yapay Zeka Önerilen Açıklama görüntüleyin. Görüntülenmesi birkaç saniye sürebilir. Olduğu gibi kabul edin veya Düzenle'yi seçin ve kaydedin.
    • Tablo sütununa açıklama eklemek için,yapay zeka tarafından oluşturulan açıklamaları kullanarak, sütun listesinin üzerindeki yapay zeka oluşturma düğmesine tıklayın. Databricks her sütun için açıklamalar oluşturur. Bunları olduğu gibi kabul edin veya düzenleyin. Açıklamayı kaydetmek için onay işaretine tıklayın.
    • Yapay zeka tarafından oluşturulan açıklamaları desteklemeyen bir nesneye açıklama eklemek için Açıklama ekle'ye tıklayarak açıklama ekleyin.
    • yapay zeka tarafından oluşturulan açıklamaları kullanmadan tablo sütununa açıklama eklemek için Simgesi'ne tıklayarak sütun etiketi veya açıklama ekleyinSütun satırına açıklama ekle simgesi ekleyin.
    • Bir açıklama zaten varsa, genel bakış sekmesindeki sağ bölmede veya nesne adının altında görünür. Yapay zeka tarafından oluşturulmadıysa düzenlemek için düzenle simgesine tıklayın Düzenle simgesi .

Katalog Gezgini kullanıcı arabiriminde açıklamaları biçimlendirmek için temel Markdown'ı kullanabilirsiniz. Deyimler tarafından DESCRIBE döndürülen Markdown stili işlenmez. Katalog Gezgini'nde resimler dışında tüm temel söz dizimi desteklenir ve yalnızca iki başlık düzeyi işlenir. Daha fazla bilgi için bkz . Temel Söz Dizimi.

Yapay zeka tarafından oluşturulan açıklamalar hakkında daha fazla bilgi için bkz. Unity Kataloğu nesnelerine yapay zeka tarafından oluşturulan açıklamalar ekleme.

SQL

Unity Catalog'daki herhangi bir güvenli nesneye veya eski Hive metastore'da yönetilen tablolara yorum olarak bir metin eklemek için bir SQL komutu kullanabilirsiniz. Kullandığınız SQL komutu, açıklamasını eklemek veya düzenlemek istediğiniz nesneye bağlıdır:

  • Tablo sütunları dışında mevcut güvenli hale getirilebilir herhangi bir nesne için açıklama eklemek veya güncelleştirmek için COMMENT ON komutunu kullanın. Bkz. COMMENT ON.

    Nesnesinin COMMENT komutuyla ALTER <object> seçeneğini de kullanabilirsiniz (örneğin, ALTER TABLE). Komut için SQL başvuru makalesine ALTER <object> bakın.

  • Var olan bir tablonun sütun açıklamasını eklemek veya güncelleştirmek için ALTER TABLE komutunu ALTER COLUMN yan tümcesi ve sütundaki COMMENT seçeneğiyle kullanın. Bakınız ALTER TABLE ve ALTER TABLE … COLUMN maddesi.

  • Nesne oluştururken açıklama eklemek için komutunu kullanarak seçeneğini COMMENT kullanınCREATE <object>. Kullanmak istediğiniz komut için CREATE <object> SQL başvuru makalesine bakın.