Aracılığıyla paylaş

Meta veri taramayı çalıştırma

  • Makale

Aşağıdaki kısa kılavuzda, kuruluşunuzun Doku öğelerinden meta verileri almak için tarayıcı API'lerinin nasıl kullanılacağı gösterilmektedir. Bir Doku yöneticisinin kuruluşunuzda meta veri taramayı ayarladığını varsayar.

Meta veri taramanın döndürdüğü yapıt ve alt işlem meta verilerinin listesi için Admin - WorkspaceInfo GetScanResult API belgelerine bakın.

Tarayıcı API'leri aşağıdadır. Hem genel hem de bağımsız bulutları destekler.

Önemli

Tarama için geliştirdiğiniz uygulama, standart bir yönetici temsilcisi erişim belirteci veya hizmet sorumlusu kullanarak kimlik doğrulaması yapabilir. İki kimlik doğrulama yolu birbirini dışlar. Hizmet sorumlusu altında çalışırken, uygulamanızda Power BI yöneticisine gereken izinler ayarlı olmamalıdır. Daha fazla bilgi için bkz . Salt okunur yönetici API'leri için hizmet sorumlusu kimlik doğrulamasını etkinleştirme.

1. Adım: Tam tarama gerçekleştirme

Kiracıdaki çalışma alanı kimliklerinin tam listesini almak için modifiedSince parametresi olmadan çalışma alanlarını/değiştirilenleri çağırın. Bu tarama, kişisel çalışma alanları ve paylaşılan çalışma alanları dahil olmak üzere kiracıdaki tüm çalışma alanlarını alır. Kişisel çalışma alanlarını taramanın dışında tutmak istiyorsanız workspaces/modified excludePersonalWorkspaces parametresini kullanın.

Listeyi en fazla 100 çalışma alanının öbeklerine bölün.

100 çalışma alanının her öbeği için:

Bu 100 çalışma alanı için tarama çağrısı tetikleme için çalışma alanlarını/getInfo'ları çağır. Sonraki adımlarda kullanmak üzere yanıtta scanId değerini alırsınız. Konum üst bilgisinde, bir sonraki adım için çağrı yapmak üzere Tekdüzen Kaynak Tanımlayıcısı'nı (URI) da alırsınız.

Not

Aynı anda 16'dan fazla arama yapılamaz. Çağıranın başka bir çağrı çağırmadan önce scanStatus API'sinden tarama başarılı/başarısız yanıtını beklemesi gerekir.

Almayı beklediğiniz bazı meta veriler döndürülmezse, tüm ilgili yönetici anahtarlarını etkinleştirdiklerinden emin olmak için Doku yöneticinize başvurun.

Çalışma alanlarını/getInfo çağrısından aldığınız konum üst bilgisinden URI'yi kullanın ve döndürülen durum "Başarılı" olana kadar çalışma alanları/scanStatus/{scan_id} üzerinde yoklama yapın. Bu durum, tarama sonucunun hazır olduğu anlamına gelir. 30-60 saniyelik bir yoklama aralığı kullanılması önerilir. Konum üst bilgisinde, bir sonraki adımda çağrılacak URI'yi de alırsınız. Bunu yalnızca "Başarılı" durumundan sonra kullanın.

Workspaces/scanStatus/{scan-id} çağrısından aldığınız konum üst bilgisinden URI'yi kullanın ve workspaces/scanResult/{scan_id} kullanarak verileri okuyun. Veriler çalışma alanları/getInfo çağrısına geçirilen parametrelere göre çalışma alanlarının listesini, öğe bilgilerini ve diğer meta verileri içerir.

2. Adım: Artımlı tarama gerçekleştirme

Artık tüm çalışma alanlarına ve varlıklarının meta verilerine ve kökenine sahip olduğunuz için, yalnızca yaptığınız önceki taramaya başvuran artımlı taramalar yapmanız önerilir.

Değiştirilen ve bu nedenle başka bir tarama gerektiren çalışma alanlarını almak için son taramanın başlangıç zamanına ayarlanmış modifiedSince parametresiyle değiştirilen çalışma alanlarını çağırın. modifiedSince parametresi son 30 gün içindeki bir tarih için ayarlanmalıdır.

Bu listeyi en fazla 100 çalışma alanı öbeklerine bölün ve 1. Adımda açıklandığı gibi üç API çağrısı, çalışma alanı/getInfo, çalışma alanları/scanStatus/{scan_id}ve workspaces/scanResult/{scan_id} kullanarak bu değiştirilen çalışma alanlarının verilerini alın.

Dikkat edilecekler ve sınırlamalar

  • yenilenmeyen veya yeniden yayımlanmamış anlamsal modeller API yanıtlarında döndürülür, ancak bunların alt bilgileri ve ifadeleri olmadan döndürülür. Örneğin, semantik model adı ve kökeni yanıta dahil edilir, ancak semantik modelin tablo ve sütun adları dahil değildir.
  • yalnızca DirectQuery tablolarını içeren anlamsal modeller, yalnızca semantik model üzerinde bir tür eylem yapılmışsa (örneğin, üzerinde bir rapor oluşturan biri, raporu temel alan bir raporu görüntüleyen biri vb.) subartifact meta verilerini döndürür.
  • Gerçek zamanlı veri kümeleri, nesne düzeyinde güvenlik içeren anlam modelleri, AS-Azure ve AS şirket içi canlı bağlantısı olan anlamsal modeller ve Excel tam uygunluk veri kümeleri, alt verilerde desteklenmez. Desteklenmeyen veri kümeleri için yanıt, veri kümesinden subartifact meta verilerini almama nedenini döndürür. SchemaRetrievalError adlı bir alanda bulunur; örneğin schemaRetrievalError: Desteklenmeyen istek. RealTime veri kümesi desteklenmez.
  • API, paylaşılan çalışma alanlarında 1 GB'tan büyük anlamsal modeller için subartifact meta verilerini döndürmez. Premium çalışma alanlarında anlamsal modellerde boyut sınırlaması yoktur.

Lisanslama

Meta veri tarama için özel lisans gerekmez. Premium olmayan çalışma alanlarında bulunan öğeler dahil olmak üzere kiracınızın tüm meta verileri için çalışır.

İlgili içerik