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şlem 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 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.
  • USE CATALOG ve USE SCHEMA üst katalog ve şemada.
• 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'a tıklayarak Katalog Gezgini'ni açın.

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

   Veriler ve yapay zeka nesneleri Katalog bölmesinde listelenir ve aranabilir. Paylaşımlar, depolama kimlik bilgileri, dış konumlar ve bağlantılar, dişli simgesine 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çıklamasını 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.
   • Yapay zeka tarafından oluşturulan açıklamaları kullanarak tablo sütununa açıklama eklemek için sütun listesinin üzerindeki yapay zeka oluştur 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 sütun satırında açıklama ekle simgesine tıklayın.
   • 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. 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 Kataloğu'ndaki herhangi bir güvenli hale getirilebilir nesneye ve eski Hive meta veri deposunda yönetilen tablolara açıklama olarak bir dize değişmez değeri eklemek için SQL komutunu 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 var olan güvenli hale getirilebilir herhangi bir nesne için açıklama eklemek veya güncelleştirmek için komutunu kullanın COMMENT ON . 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 tablo için sütun açıklaması eklemek veya güncelleştirmek için komutunu yan tümcesiyle ALTER COLUMN ve COMMENT sütundaki seçeneğiyle birlikte kullanınALTER TABLE. Bkz. ALTER TABLE ve ALTER TABLE ... COLUMN yan tümcesi.

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