Power BI ve OData sorgularını kullanarak verilerle Bağlan

  • Makale
  • Okumak için 6 dakika

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

OData sorgularının kullanılması, Power BI veri çekme için önerilen yaklaşımdır. OData (açık veri Protokolü), REST API 'Leri oluşturmak ve kullanmak için en iyi yöntemleri tanımlayan bir ISO/ıEC onaylanır. Daha fazla bilgi için bkz. OData belgeleri.

Hızlıca kullanmaya başlamak için OData sorguları kullanan örnek raporlara genel bakışkonusuna bakın. diğer yaklaşımlar hakkında daha fazla bilgi için bkz. Power BI tümleştirmeye genel bakış.

Power BI, Power BI filtrelenmiş veya toplanmış bir veri kümesi döndürebilen OData sorgularını çalıştırabilir. OData sorgularının iki avantajı vardır:

  • Tüm filtrelemeleri sunucu tarafında yapılır. Yalnızca ihtiyacınız olan veriler döndürülür, bu da daha kısa yenileme sürelerine yol açar.
  • Veri sunucusu tarafında ön araya getirebilirsiniz. OData sorgusu, iş öğesi toplaması ve derleme hatası ücretleri gibi toplamaları gerçekleştirebilir. Toplamalar sunucu tarafında gerçekleştirilir ve yalnızca toplama değerleri Power BI döndürülür. Ön toplama sayesinde, tüm ayrıntı verilerini Power BI 'e çekmeye gerek kalmadan, büyük veri kümelerinde toplamaları gerçekleştirebilirsiniz.

Bu makalede şunları öğreneceksiniz:

  • OData sorgularını yazın ve test edin.
  • Power BI bir OData sorgusu çalıştırın.

Önkoşullar

  • Temel erişim veya daha yüksek bir proje üyesi olmanız gerekir. Proje üyesi olarak eklenmediyse Şimdi eklenirsiniz. Proje erişimi olan, paydaşlar hariç, analiz görünümlerini görüntüleyebilen herkes.
  • Analiz verilerinin kullanılabilmesi için ilgili hizmetin etkinleştirilmiş olması gerekir. örneğin, iş izleme verilerini sorgulamak için Boards etkinleştirilmesi gerekir. Devre dışıysa analiz görünümleri gösterilmez. bir hizmeti yeniden etkinleştirmek için bkz. bir Azure DevOps hizmetini açma veya kapatma
  • Analiz görünümlerinikullanmak için, tek tek kullanıcılar veya kuruluş Için analiz görünümleri önizleme özelliğini etkinleştirin .
  • Ayrıca, *Görünüm Analizi Izninizin izin verolarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz. analiz hizmetine erişim Izinleri verme.
  • Azure DevOps için Power BI kullanmak veya analiz için bir OData sorgusu yapmak üzere, görünüm analizi izninizin izin verolarak ayarlanmış olması gerekir. Varsayılan olarak, temel erişime sahip tüm katkıda bulunanlar erişim izni verilir. Paylaşılan analiz görünümlerinidüzenlemek için *paylaşılan analiz görünümlerini Düzenle izninizin izin verolarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz. analiz hizmetine erişim Izinleri verme.
  • Temel erişim veya daha yüksek bir proje üyesi olmanız gerekir. Proje üyesi olarak eklenmediyse Şimdi eklenirsiniz. Proje erişimi olan, paydaşlar hariç, analiz görünümlerini görüntüleyebilen herkes.
  • Analizler ' in yüklü olduğundan emin olun ve bunu etkinleştirin. uzantı eklemek veya hizmeti etkinleştirmek için bir hesap sahibi veya Project koleksiyonu yönetici grubunun bir üyesi olmanız gerekir.
  • Analiz verilerinin kullanılabilmesi için ilgili hizmetin etkinleştirilmiş olması gerekir. örneğin, iş izleme verilerini sorgulamak için Boards etkinleştirilmesi gerekir. Devre dışıysa analiz görünümleri gösterilmez. bir hizmeti yeniden etkinleştirmek için bkz. bir Azure DevOps hizmetini açma veya kapatma
  • Analiz görünümlerinikullanmak için, tek tek kullanıcılar veya kuruluş Için analiz görünümleri önizleme özelliğini etkinleştirin .
  • Ayrıca, *Görünüm Analizi Izninizin izin verolarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz. analiz hizmetine erişim Izinleri verme.
  • Azure DevOps için Power BI kullanmak veya analiz için bir OData sorgusu yapmak üzere, görünüm analizi izninizin izin verolarak ayarlanmış olması gerekir. Varsayılan olarak, temel erişime sahip tüm katkıda bulunanlar erişim izni verilir. Paylaşılan analiz görünümlerinidüzenlemek için, paylaşılan analiz görünümlerini Düzenle izninizin izin verolarak ayarlanmış olması gerekir. Daha fazla bilgi için bkz. analiz hizmetine erişim Izinleri verme.

OData sorgularını yazmak ve test etmek için Visual Studio Code kullanma

odata 'i yazmak ve test etmek için en kolay yol odata uzantısıylaVisual Studio Code kullanmaktır. Visual Studio Code, Windows, Mac ve Linux 'ta kullanılabilen ücretsiz bir kod düzenleyicisidir. OData uzantısı, sorgu yazma ve test etme için kullanışlı olan sözdizimi vurgulaması ve diğer işlevler sağlar.

Visual Studio Code’u yükleme

Visual Studio Code indirmek ve yüklemek için Visual Studio Code indirme sayfasınagidin.

OData uzantısını yükler

Visual Studio Code açın, uzantılar' ı seçin ve sonra odataiçin arama yapın. Sonuçlar listesinde, vscode-OData' i seçin ve ardından bunu yükler.

. OData dosyası oluşturma

Visual Studio Code ' de, filename. odataadlı bir dosya oluşturun ve kaydedin. İstediğiniz şekilde adlandırabilirsiniz, ancak OData uzantı işlevini etkinleştirmek için bir . OData uzantısı olmalıdır.

OData sorgusunu yazma

OData sorgusunu yazın. Örneğin sorgular, OData sorguları kullanarak örnek raporların genel bakışınıgözden geçirin.

Aşağıdaki sorgu, belirli bir alan yolu altında ilk 10 iş öğesini döndürür. {Organization}, {Project} ve {Area Path} değerlerini değerlerinizle değiştirin.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $select=WorkItemId,Title,WorkItemType,State,CreatedDate
    &$filter=startswith(Area/AreaPath,'{area path}')
    &$orderby=CreatedDate desc
    &$top=10

Projeler genelinde sorgulama yapmak için /{project} tamamen atlayın.

Analiz için OData sorguları yazma hakkında daha fazla bilgi için bkz. OData sorgu hızlı başvurusu.

sorguyu Visual Studio Code yazdıktan sonra, söz dizimi vurgulamasını görmeniz gerekir:

Visual Studio Code OData uzantısı-söz dizimi vurgulama

OData sorgusunu test etme

OData sorgusunu test etmek için imlecinizi sorgu metninde herhangi bir yere yerleştirin ve komut paletinigörüntüle ' yi seçin. Tüm OData komutlarını açmak için arama kutusuna OData yazın:

Visual Studio Code OData uzantısı-komut paleti

OData: Openöğesini seçin. Bu eylem, çok satırlı sorguyu tek satırlık bir URL olarak birleştirir ve varsayılan tarayıcınızda açar.

OData sorgu sonuç kümesi JSON biçimindedir. Sonuçları görüntülemek için tarayıcınıza yönelik JSON biçimlendirici uzantısını yüklersiniz. Hem Chrome hem de Microsoft Edge için çeşitli seçenekler mevcuttur.

Visual Studio Code OData uzantısı-JSON çıkışı

Sorguda bir hata varsa, analiz hizmeti JSON biçiminde bir hata döndürür. Örneğin, bu hata sorgunun mevcut olmayan bir alanı seçtiği belirtilir:

Visual Studio Code OData uzantısı-JSON hatası

Sorgunun düzgün çalıştığını doğruladıktan sonra, Power BI ' den çalıştırabilirsiniz.

Power BI OData sorgusunu çalıştırın

Çok satırlı OData sorgusunu tek satırlık bir sorguda birleştirme

sorguyu Power BI ' de kullanmadan önce, çok satırlı OData sorgusunu tek satırlık bir sorguya dönüştürmeniz gerekir. bunu yapmanın en kolay yolu odata uzantısıylaVisual Studio Code kullanmak ve odata: birleştir komutunu kullanmaktır.

Not

Filename. OData dosyanızda, önce çok satırlı sorgu metninin bir kopyasını oluşturmak ve ardından OData: Copy üzerinde birleştirme çalıştırmak isteyebilirsiniz. Tek satır sorguyu okunabilir bir çok satırlı sorguya geri dönüştürmenin bir yolu olmadığından bunu yapabilirsiniz.

Visual Studio Code, sorgunuzu sorgu metninde herhangi bir yere yerleştirin ve ardından komut paletinigörüntüle ' yi seçin. Arama kutusuna OData yazın ve ardından sonuçlar listesinde OData: Birleştir' i seçin.

Çok satırlı sorgu tek satırlık bir sorguya dönüştürülür.

Visual Studio Code OData uzantısı-tek satırlık sorguya birleştirme

Sonraki bölümde kullanılmak üzere tüm satırı Kopyala.

Sorguyu Power BI Çalıştır

Power BI açın, veri al' ı seçin ve ardından OData akış bağlayıcısını seçin. daha fazla bilgi için bkz. OData sorgusuyla Power BI rapor oluşturma.

Power BI-

OData akışı penceresinde, URL kutusunda, önceki bölümde kopyaladığınız OData sorgusunu yapıştırın ve Tamam' ı seçin.

Power BI-OData akışı-sorguya yapıştır

Power BI bir önizleme sayfası görüntüler:

Power BI-OData akışı-Power BI veri önizleme

Sorgu seçeneklerini belirtin

Önizleme sayfasında, Power Query düzenleyicisini açmak için Düzenle ' yi seçin.

Power BI-OData akışı-Power Query düzenleyicisi

Şeritte Gelişmiş Düzenleyici' yi seçin.

Power BI-OData akışı-Gelişmiş Düzenleyici seçin

Sorgu bölmesinde, parametreyi görüntülemek için yatay kaydırın .

Power BI-OData akışı-Gelişmiş Düzenleyici-sağa kaydır

[Implementation="2.0"]Şu dizeyle değiştirin:

[Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

Dizeyi değiştirin.

Not

Aşağıdaki eylemler, bu önleyici ölçünün sağlanmasına yardımcı olur:

Azaltma hatalarını önleyin. Power Query, karşılaştığı her null değer için ek bir sorgu oluşturarak null değerleri hata olarak çözümlemeye çalışır. Bu, kullanım eşikinizi hızlı bir şekilde aşacak şekilde Kullanıcı hesabınızın kısıtlandığı binlerce sorgu oluşmasına neden olabilir.

Bu sorunu engellemek için:

  • Power BI OData v4 'e başvuracak şekilde yönlendirir.
  • Analiz hizmetine, sorgu performansını artıran null değeri yok saymasını bildirin.

Not

Power BI bir OData sorgusunun Azure DevOps Analytics hizmetinde başarıyla çalıştırılması için aşağıdaki eylem gerekir.

Gelişmiş Düzenleyici kapatmak için tamam ' ı seçin ve Power BI Power Query düzenleyicisine geri dönün. Bu isteğe bağlı eylemleri gerçekleştirmek için Power Query düzenleyicisini kullanabilirsiniz:

  • "Sorgu1" sorgusunu daha belirgin bir şekilde yeniden adlandırın.
  • Sütunları belirli bir türe Dönüştür. Power BI, türü otomatik olarak algılar, ancak sütunu belirli bir veri türüne dönüştürmek isteyebilirsiniz.
  • Hesaplanan sütunlar ekleyin.
  • Sütunları kaldırın.
  • Sütunları belirli alanlara genişlet.

Verileri kullanarak rapor oluşturma

Ayarlarınızı kaydetmek ve verileri Power BI çekmek için uygulamayı kapat ' ı seçin. Veriler yenilendikten sonra, Power BI normal olarak bir rapor oluşturabilirsiniz.

Power BI