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.

Güvenliği sağlanabilir bir nesneye açıklama ekledikten sonra, ayrıcalıkları olan BROWSE tüm kullanıcılar açıklamaları görüntüleyebilir. Bu, kataloğunuzda veri bulunabilirliğini artırır.

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

Önemli

Açıklamaların kaydedilmesi, Azure Databricks işlem hatlarını ve işlerini kesintiye uğratabilecek bir ALTER SQL komutunu tetikler.

1. Çalışma alanı kenar çubuğunda Katalog gezginini açmak için katalog.

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, 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çinAçı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 Sü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 .

Katalog Gezgini kullanıcı arabiriminde açıklamaları biçimlendirmek için temel Markdown'ı kullanabilirsiniz. DESCRIBE ifadeleri tarafından döndürüldüğünde Markdown stili işlenmez. Resimler dışında tüm temel söz dizimi Katalog Gezgini'nde desteklenir. 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). SQL ALTER <object> komutu için başvuru makalesine 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. Bkz ALTER TABLE . ve ALTER TABLE ... COLUMN yan tümcesi.

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