Unity Catalog wikileri

Important

Bu özellik Beta sürümündedir. Hesap yöneticileri bu özelliğe erişimi hesap konsolu Önizlemeler sayfasından yönetebilir. Bkz. Hesap düzeyinde önizlemeleri yönetme.

Bir wiki, ekibinizin bir tablonun anlamını, amacını ve kaynaklarını belgelemesine ve ardından bu bilgiler üzerinde iş birliği yapmasına olanak tanır. Veri sahipleri ve yöneticileri, bir tabloya ait olan iş bağlamını, örneğin tanımlar ve bilinen uyarılar gibi, yakalamak için wiki hazırlayır ve yayımlar. Tablonun meta verilerini görebilen herkes yayımlanmış bir wiki okuyabilir, yorum yapabilir, düzenlemeler önerebilir ve tepki verebilir.

Bir wiki bir tabloyu belgeler. Bir Page, birçok varlığı kapsayabilen bir iş kavramını tanımlar. Belirli bir tablo hakkında bağlam için bir wiki kullanın ve paylaşılan tanım için bir Sayfa kullanın.

Vikiler, tablodaki mevcut açıklamayla birlikte çalışır. Wiki'lere ve tablo yorumlarına bakınız.

Wiki'de neler var

Bir wiki aşağıdaki alanları içerir:

Alan Description
Description Tablonun tek satırlık özeti, wiki'nin en üstünde gösterilmiştir.
Sayfa gövdesi Unity Catalog güvenli nesneleri ve çalışma alanı nesnelerine yönelik başlıkları, bağlantıları, görselleri ve satır içi referansları destekleyen zengin metin dokümantasyonu.
Sources Wiki içeriğinin dayandığı sayfalara veya dış kaynaklara bağlantılar.

Catalog Explorer'daki bir tablonun Genel Bakış sekmesinde yayımlanmış bir wiki, açıklama, sayfa gövde bölümleri ve Kaynaklar bağlantısı ile

Permissions

Bir wiki, güvenliği sağlanabilir bir nesne değildir. Bu, tablosunun meta verilerindedir, bu yüzden tablodaki mevcut Unity Kataloğu ayrıcalıklarınız wiki'siyle neler yapabileceğinizi belirler. Unity Kataloğu ayrıcalıkları hakkında arka plan için bkz. Unity Kataloğu izinleri model kavramları.

Aşağıdaki ayrıcalıklar tablosu, üst nesnelerdeki kullanım ayrıcalıkları ifadesini, , READ_METADATA veya sahipliğin yürürlüğe girmesi için gereken MANAGE anlamında kullanır. Nesneye bağlıdır:

  • Tablo: USE SCHEMA üst şemada ve USE CATALOG üst katalogda.
  • Şema: USE CATALOG üst katalogda.
  • Katalog: Yok.
Action Gerekli ayrıcalıklar
Yayınlanmış wikileri görüntüleyin ve iş birliği yapın: yayımlanmış wikileri görüntüleyin, kendi yorumlarınızı ekleyin, düzenleyin veya silin, düzenlemeler önerin ve tepkiler ekleyin Aşağıdakilerden biri:
  • SELECT masada, USE SCHEMA şemada ve USE CATALOG katalogda
  • BROWSE ana katalogda
  • READ_METADATA tablo, şema, katalog veya metastore üzerinde, ana nesnelerde kullanım ayrıcalıklarıyla
  • MANAGE tablo, şema veya katalog üzerinde, ana nesneler üzerinde kullanım ayrıcalıklarına sahip
  • Ana nesneler üzerinde kullanım ayrıcalıklarına sahip olan tablonun, üst şemanın veya üst kataloğun sahibi
  • Meta veri deposu yöneticisi
Taslak wikileri görüntüleyin Aşağıdakilerden biri:
  • READ_METADATA tablo, şema, katalog veya metastore üzerinde, ana nesnelerde kullanım ayrıcalıklarıyla
  • MANAGE tablo, şema veya katalog üzerinde; üst nesnelerde kullanım ayrıcalıklarıyla
  • Tablonun, üst şemanın veya üst kataloğun sahibi; üst nesneler üzerinde kullanım ayrıcalıklarına sahip olan
  • Meta veri deposu yöneticisi
Wikileri ve yorumları yönetin: wiki oluşturun, düzenleyin, yayınlayın veya yayından kaldırın, önerilen düzenlemeleri kabul edin veya reddedin ve herhangi bir yorumu silin Aşağıdakilerden biri:
  • MANAGE tablo, şema veya katalog üzerinde, üst nesnelerde kullanım ayrıcalıklarıyla
  • Ana nesneler üzerinde kullanım ayrıcalıklarına sahip tablo sahibi, ana şema sahibi veya ana katalog sahibi
  • Meta veri deposu yöneticisi

Bir wiki oluşturun

Bir wiki oluşturmak için, tablodaki wikileri yönetme ayrıcalıklarına sahip olmanız gerekir. Bkz. İzinler.

Bir wiki'yi manuel olarak yazabilir veya Genie Code ile bir tane taslağını hazırlayabilirsiniz.

Warning

Wiki verileri, Microsoft tarafından yönetilen anahtarlarla bekleme durumunda şifrelenmiştir. Wiki'ler müşteri tarafından yönetilen anahtar (CMK) şifrelemesini desteklemez. Wiki açıklamalarında veya sayfa gövdelerinde kişisel bilgiler, düzenlemeye tabi veriler veya diğer hassas bilgileri dahil etmeyin.

  1. Katalog Gezgin'de tabloyu açın.

  2. Genel Bakış sekmesinde, Wiki Oluştur seçeneğine tıklayın. Eğer Wiki oluştur afişini kapattıysanız, sayfanın sağ üst köşesindeki üç nokta menüsü simgesine tıklayın ve bunun yerine Wiki oluştur'u seçin. Tabloda mevcut bir yorum varsa, wiki sayfasının gövdesini bununla başlatır.

    Genel Bakış sekmesinde bir tablonun açıklamasının üzerindeki Wiki Oluştur başlığı

  3. Wiki içeriğini ekleyin:

    • Elle oluşturmak için Açıklama ve Sayfa gövdesini doldurun ve herhangi bir Kaynak ekleyin.
    • Genie Code ile taslak oluşturmak için wiki editöründeki Genie Code panelini kullanın. Genie Code'un çalışması için dosyaları veya başka bağlamı ekleyin. Bkz . Genie Code.
  4. Wiki üzerinde çalışmaya devam etmek için Taslak olarak kaydet'e tıklayın veya tablonun meta verilerini görebilen herkese görünür hale getirmek için Yayınla'ya tıklayın.

Bir wiki yayınladıktan sonra, tablonun Genel Bakış sekmesinin üstünde görünür ve tablonun AçıklamasıDetaylar sekmesine taşınır.

Wikileri düzenle ve yayınla

Bir wikiyi düzenlemek, yayımlamak veya yayından kaldırmak için tablodaki wikileri yönetme ayrıcalıklarına sahip olmanız gerekir. Bkz. İzinler.

  1. Katalog Gezgin'de tabloyu açın.

  2. Wiki'de Düzenle düğmesine tıklayın.

  3. Değişikliklerinizi yapın, sonra bunları kaydetmek için Kaydet'e tıklayın ya da bir taslak wiki'yi görünür hale getirmek için Yayımla'ya tıklayın.

    Düzenleme modunda, İptal, Kaydet ve Yayımlama butonlarıyla bir taslak wiki

Yayınlanmış bir wiki'yi içeriğini kaybetmeden gizlemek için Düzenle'ye tıklayın, kebap menüsüne tıklayın ve ardından Yayınlamayı Kaldır'a tıklayın. Viki, yalnızca taslakları görebilen kullanıcıların görebileceği bir taslağa geri dönüyor. Wiki yeniden yayımlanana kadar, tablonun AçıklamasıGenel Bakış sekmesinin üstünde görünür.

Düzenleme modundaki yayımlanmış bir wiki'nin üç nokta menüsündeki Yayından Kaldır seçeneği

Bir wiki üzerinde iş birliği yapın

Yayınlanmış bir wiki'yi görebilen herkes bunun üzerinde iş birliği yapabilir. Bkz. İzinler.

  • Yorum: Sorular sorun veya bağlam ekleyin. Kendi yorumlarınızı düzenleyebilir veya silebilirsiniz.
  • Düzenleme öner: Wiki'nin sayfa gövdesinde değişiklik öner. Öner seçeneğine tıklayın, sayfa gövdesini düzenleyin ve Kaydet düğmesine tıklayın. Wiki'yi yönetme ayrıcalığına sahip bir kullanıcı öneriyi kabul eder veya reddeder.
  • React: Wiki'ye olumlu ya da olumsuz oy vererek faydalı olup olmadığını gösterin.

Wiki'ler ve tablo yorumları

Bir wiki, tablodaki yorumun yerini almaz, bu yüzden yorumları okuyan veya yazan mevcut pipeline’lar çalışmaya devam eder:

  • Yorumu hâlâ COMMENT ON TABLE veya ALTER TABLE ile ayarlayabilirsiniz. Yorum hâlâ içinde ve Catalog Explorer'daki information_schema alanında yer almaktadır.
  • Bir wiki oluşturduğunuzda, tablonun mevcut yorumu wiki sayfasının içeriğini oluşturur. Ondan sonra, wiki ve yorum bağımsızdır. Birindeki değişiklikler diğerini güncellemez.

Tablo yorumları hakkında daha fazla bilgi için, Verilere ve AI varlıklarına yorum ekle sayfasına bakabilirsiniz.

Limitations

  • Wikiler yalnızca tablolarda kullanılabilir. Sütunlar, şemalar, kataloglar ve diğer güvenliği sağlanabilir nesnelerle ilgili wiki'ler desteklenmiyor.
  • Her tabloda bir wiki olabilir.
  • Wiki'ler Azure Kamu, Azure China veya FedRAMP bölgelerinde mevcut değildir.