Aracılığıyla paylaş

Power Query Bağlan or Sertifikası

  • Makale

Not

Bu makalede, sertifika için bir Power Query özel bağlayıcısı gönderme gereksinimleri ve süreci açıklanmaktadır. Sertifikasyon işlemine başlamadan önce makalenin tamamını yakından okuyun.

Giriş

Power Query SDK'sı ile herkesin Power Query'den bir veri kaynağına bağlanmak için özel bir Power Query bağlayıcısı oluşturma yetkisi vardır. Şu anda özel bağlayıcılar yalnızca Power BI anlam modellerinde (Power BI Desktop ve Power BI hizmeti) desteklenir ve Power BI hizmeti aracılığıyla yenilemek için şirket içi veri ağ geçidi kullanılmasını gerektirir. Özel bağlayıcıların geliştirici tarafından ayrı ayrı dağıtılması gerekir.

Veri kaynakları için özel bağlayıcı geliştiren veri kaynağı sahipleri, özel bağlayıcılarını Power Query kullanıcılarına daha geniş bir şekilde dağıtmak isteyebilir. Son kullanıcılar tarafından özel bağlayıcı oluşturulduktan, kullanıldıktan ve doğrulandıktan sonra veri kaynağı sahibi bunu Microsoft sertifikası için gönderebilir.

Power Query özel bağlayıcısını onaylama, bağlayıcının Power BI anlam modellerinde (Power BI Desktop ve Power BI hizmeti), Power BI veri akışlarında ve Power BI veri akıllı makinelerinde genel kullanıma sunulmasını sağlar. Sertifikalı bağlayıcılar PowerBI.com ve Power BI Premium'un tüm sürümlerinde desteklenir.

Sertifikalı bağlayıcılar şunlardır:

  • İş ortağı geliştiricisi tarafından sürdürülür

  • İş ortağı geliştiricisi tarafından desteklenir

  • Microsoft onaylı

  • Microsoft tarafından dağıtıldı

İş ortaklarıyla birlikte çalışarak bakım desteğine sahip olduklarından emin olmak için çalışıyoruz, ancak bağlayıcının kendisiyle ilgili müşteri sorunları iş ortağı geliştiriciye yönlendirilecek.

Sertifikalı bağlayıcı ve özel bağlayıcı farklılıkları

Sertifikalı bağlayıcılar Power BI Desktop'ta kullanıma hazır olarak paketlenir ve Power BI Hizmeti, Power BI veri akışları ve Power BI veri akıllı cihazlarına dağıtılır. Özel bağlayıcılar yalnızca Power BI anlam modellerinde desteklenir ve Uzantınızı Power BI Desktop'ta yükleme bölümünde açıklandığı gibi Power BI Desktop'a yüklenmesi gerekir. Hem sertifikalı hem de özel bağlayıcılar, Test Bağlan ion uygulanarak şirket içi veri ağ geçidi kullanılarak Power BI Desktop veya Power BI Hizmeti aracılığıyla yenilenebilir. Özel bağlayıcılar için şirket içi veri ağ geçidi gereklidir.

Bir uygulama ile TestConnection Power BI Desktop'taki sertifikalı bağlayıcılar, şirket içi veri ağ geçidine gerek kalmadan buluttan (Power BI Hizmeti) uçtan uca yenilemeyi de destekler. Power BI hizmeti ortamı temelde şirket içi ağ geçidine benzer şekilde çalışan bir "bulut ağ geçidi" barındırmaktadır. Sertifikadan sonra bağlayıcınızı bu ortama dağıtarak tüm Power BI müşterilerinin kullanımına sunacağız.

Ek bileşenlere (örneğin ODBC sürücüsü) sahip hem özel hem de sertifikalı bağlayıcılar, ek bileşenin son kullanıcı makinesine yüklenmesini gerektirir ve ek bileşen Power BI buluta dağıtılmadığı sürece şirket içi veri ağ geçidini gerektirir. Şu anda Power BI bulutuna herhangi bir yeni ek bileşen onaylamıyor ve dağıtmıyoruz, bu nedenle ek bir bileşene bağımlı bağlayıcıların sertifikasyonu şirket içi veri ağ geçidi gereksinimini ortadan kaldırmaz.

Özel bağlayıcı dağıtımı

Özel bağlayıcılar sertifikasyondan önce son kullanıcılara dağıtılabilir ve dağıtılmalıdır.

M, Kimlik Doğrulamasını İşleme bölümünde görüldüğü gibi depolanan kimlik bilgileriyle etkileşim kurma kapasitesine sahip olan çok yönlü bir dil olduğundan, kullanıcılara yalnızca güvenilen bağlayıcıların çalışmasına izin vermenin bir yolunu sunmamız gerekir.

Geliştirici açısından bakıldığında, geliştiricilerin özel bağlayıcılarını kendi kendine imzalaması ve güvenli bir şekilde yüklemek için kullanıcılarına bilgileri (parmak izi) sağlaması gerekir.

Kullanıcı açısından bakıldığında, kullanıcıların özel bağlayıcıya güvenli bir şekilde güvenmek ve kullanmak üzere yüklemek için geliştiricinin parmak izini kullanması gerekir. Alternatif olarak, kullanıcılar Microsoft veya başka bir geliştirici tarafından onaylanmamış kodun yüklenmesine izin vermek için güvenlik ayarlarını düşürmeyi tercih edebilir, ancak bu seçenek önerilmez.

Sertifikasyona Genel Bakış

Önkoşullar

Müşterilerimiz için en iyi deneyimi sağlamak için yalnızca sertifikasyon için bir dizi önkoşulu karşılayan bağlayıcıları göz önünde bulundururuz:

  • Bağlayıcı ortak bir ürün için olmalıdır.

  • Bağlayıcı, ilk sürüm sürümü için kod tamamlandı olarak kabul edilmelidir. Program sık sık yinelemelere ve güncelleştirmelere izin verir. Microsoft'un teknik yardım veya özel bağlayıcı geliştirme danışmanlığı sunmadığını unutmayın. SDK belgelerimiz ve örnek depomuz gibi genel kaynaktan yararlanmanızı öneririz. Daha fazla yardıma ihtiyacınız varsa, herhangi bir Microsoft programından veya ortaklığından ayrı olarak doğrudan etkileşim kurmak isteyebileceğiniz bilinen 3. taraf sektör özel bağlayıcı geliştirme danışmanlarının listesini paylaşabiliriz. Microsoft'un bu danışmanlardan hiçbiriyle bağlantılı olmadığını ve hizmetlerini kullanmanızdan sorumlu olmadığını unutmayın. Microsoft size kolaylık sağlamak için ve herhangi bir güvence, öneri veya garanti olmadan listeyi sağlar. Daha fazla bilgi edinmek için Microsoft sertifika yetkilinize ulaşın.

  • Geliştiricinin kullanım için bir tahmin sağlaması gerekir. Çok butik ürünler için bağlayıcı geliştiricilerinin bağlayıcıyı müşteriye doğrudan sağlamak için bağlayıcı otomatik imzalama özelliklerimizi kullanmasını öneririz.

  • Bağlayıcının, kullanıcı gereksinimini veya iş senaryolarını yerine getirmek için doğrudan müşterilerin kullanımına sunulması gerekir. Bu ölçütler, tamamlanan bağlayıcıyı otomatik imzalama yoluyla doğrudan son kullanıcılara ve kuruluşlara dağıtarak Özel Önizleme programı kullanılarak karşılanabilir. Her kullanıcı veya kuruluş, bağlayıcı için bir iş gereksinimi olduğunu ve bağlayıcının iş gereksinimlerini karşılamak için başarıyla çalıştığını belirten geri bildirim ve doğrulama sağlayabilmelidir.

  • Bağlayıcının müşteriler tarafından beklenen kullanım düzeyinde başarıyla çalışması gerekir.

  • Bağlayıcıyı Power BI Desktop'ta herkese açık hale getirme talebini belirtmek için Power BI Ideas forumunda müşteriler tarafından yönlendirilecek bir iş parçacığı olmalıdır. Belirli bir katılım eşiği yoktur. Ancak ne kadar çok katılım olursa bağlayıcı için kanıtlanan talep o kadar güçlü olur.

Bu önkoşullar, sertifikasyondan geçen bağlayıcıların önemli ölçüde müşteri ve işletmenin kullanılması ve sertifikasyon sonrası desteklenmesi gerektiğinden emin olmak için mevcuttur.

İşlem ve Zaman Çizelgeleri

Sertifikalı bağlayıcılar aylık Power BI Desktop sürümleriyle yayımlandığından, her sürüm için son tarihler her Power BI Desktop yayın tarihinden itibaren çalışır. Sertifikasyon işleminin kayıttan yayına kadar beklenen süresi bağlayıcı gönderiminin kalitesine ve karmaşıklığına bağlı olarak değişir. Microsoft, bağlayıcı incelemesi ve onayıyla ilgili olarak belirli bir zaman çizelgesi garantisi sağlamaz. Her bağlayıcı incelemesi için kesin son tarihler aşağıdaki adımlarda özetlenmiştir, ancak Microsoft bu zaman çizelgelerine bağlı kalmayı garanti etmez.

  • Kayıt: Özel bağlayıcınızı onaylama amacı bildirimi. Bu kayıt, hedeflenen Power BI desktop sürümünden iki ay önce ayın 15'inde gerçekleşmelidir.

    • Örneğin, Nisan Power BI Desktop sürümü için son tarih 15 Şubat olacaktır.

  • Gönderim: Microsoft incelemesi için bağlayıcı dosyalarının gönderilmesi. Bu gönderimin hedeflenen Power BI desktop sürümünden önceki ayın 1'inde gerçekleşmesi gerekir.

    • Örneğin, Nisan Power BI Desktop sürümü için son tarih 1 Mart olacaktır.

  • Teknik Gözden Geçirme: Bağlayıcı dosyalarının sonlandırılması, Microsoft gözden geçirmesi ve sertifikasyonu geçirme. Bu incelemenin hedeflenen Power BI Desktop sürümünden önceki ayın 15'inde gerçekleşmesi gerekir.

    • Örneğin, Nisan Power BI Desktop sürümü için son tarih 15 Mart olacaktır.

Teknik incelemelerin karmaşıklığı ve olası gecikmeler, yeniden oluşturma ve test sorunları nedeniyle, ilk sürüm ve sertifikasyon için uzun bir sağlama süresi ile erken göndermenizi kesinlikle öneririz. Bağlayıcınızın minimum ek yüke sahip birkaç müşteriye teslim etmek için önemli olduğunu düşünüyorsanız, otomatik olarak imzalamanızı ve bu şekilde sağlamanızı öneririz.

Sertifikasyon Gereksinimleri

Sertifikasyon için belirli bir dizi gereksinimimiz vardır. Her geliştiricinin bu gereksinimleri karşılayamadığını biliyoruz ve geliştirici gereksinimlerini kısa bir sırada karşılayacak bir özellik kümesi sunmayı umuyoruz.

Gönderme Dosyaları (Yapıtlar)

Gönderdiğiniz bağlayıcı dosyalarının aşağıdakilerin tümünü içerdiğinden emin olun:

  • Bağlan or (.mez) dosyası

    • .mez dosyası stil standartlarına uygun olmalı ve ürün veya hizmet adına benzer şekilde adlandırılmalıdır. "Power BI", "Bağlan or" veya "API" gibi sözcükleri içermemelidir.
    • .mez dosyasını adlandırın: ProductName.mez

  • Test için Power BI Desktop (.pbix) dosyası

    • Bağlayıcınızı test etmek için örnek bir Power BI raporu (.pbix) gerekir.
    • Rapor, gezinti tablonuzdaki her öğeyi test etmek için en az bir sorgu içermelidir.
    • Ayarlanmış bir şema (örneğin veritabanları) yoksa, raporun bağlayıcının işleyebileceği her "tür" tablo için bir sorgu içermesi gerekir.

  • Hesabı veri kaynağınızda test etme

    • Bağlayıcınızı test etmek ve sorunlarını gidermek için test hesabını kullanırız.
    • Gelecekteki güncelleştirmeleri onaylamak için aynı hesabı kullanabilmemiz için kalıcı bir test hesabı sağlayın.

  • Test yönergeleri

    • Bağlayıcıyı kullanma ve işlevselliğini test etme hakkında tüm belgeleri sağlayın.

  • Dış bağımlılıklara bağlantılar (örneğin, ODBC sürücüleri)

Özellikler ve Stil

Bağlayıcının, diğer sertifikalı bağlayıcılarla tutarlı bir kullanılabilirlik standardına uyması için bir dizi özellik ve stil kuralına uyması gerekir.

  • Bağlayıcı MUST:

    • Bölüm belgesi biçimini kullanın.
    • Bölüm belgesinin üzerinde bir sürüm üst bilgisi/süslemesi içerir.
    • İşlev belgeleri meta verilerini sağlayın.
    • Test Bağlan ion işleyicisi var.
    • Adlandırma kurallarını izleyin (örneğin, DataSourceKind.FunctionName). "Power BI", "Bağlan or" veya "API" gibi sözcükleri içermemelidir.
    • İlk sürümde Beta bayrağının True olarak ayarlanmasını sağlayın.

  • FunctionName etki alanı için anlamlı olmalıdır (örneğin, "İçerik", "Tablolar", "Belge", "Veritabanları" vb.).

  • Bağlayıcı:

    • Simgeleriniz var.
    • Bir gezinti tablosu sağlayın.
    • Dizeleri bir resources.resx dosyaya yerleştirin. URL'ler ve değerler bağlayıcı kodunda sabit kodlanmalıdır ve dosyaya resources.resx yerleştirilmemelidir.

Güvenlik

Bağlayıcınızın işlemesi gereken belirli güvenlik konuları vardır.

  • Kullanılıyorsa Extension.CurrentCredentials() :

    • Kullanım gerekli mi? Öyleyse, kimlik bilgileri nereye gönderilir?
    • İsteklerin HTTPS üzerinden yapılması garanti edilir mi?
    • Kimlik bilgileri GET aracılığıyla gönderiliyorsa Web.Contents() :
      • POST'a dönüştürülebilir mi?
      • GET gerekiyorsa, bağlayıcı hassas kimlik bilgilerini geçirmek için seçenekler kaydındaki Web.Contents() kaydı kullanmalıdırCredentialQueryString.

  • Diagnostics.* işlevleri kullanılıyorsa:

    • neyin izlendiğini doğrulayın; veriler PII veya büyük miktarlarda gereksiz veri içermemelidir.
    • Geliştirme aşamasında önemli bir izleme uyguladıysanız, izlemenin açık olup olmadığını belirleyen bir değişken veya özellik bayrağı uygulamanız gerekir. Bu izleme, sertifikasyon için göndermeden önce kapatılmalıdır.

  • Kullanılıyorsa Expression.Evaluate() :

    • İfadenin nereden geldiğini ve ne olduğunu doğrulayın (yani, için dinamik olarak çağrılar Extension.CurrentCredentials() oluşturabilir vb.).
    • Expression kullanıcı tarafından sağlanmamalı veya kullanıcı girişi alınmamalıdır.
    • Expression dinamik olmamalıdır (yani, bir web çağrısından alınır).

Sertifikasyona Kaydolma

Özel bağlayıcınızın sertifikasyonunu takip etmeye ilgi duyuyorsanız senaryonuzun ve bağlayıcınızın bu makalede açıklanan önkoşulları ve gereksinimleri karşıladığından emin olun. Ekibimiz sertifikasyona geçmeden önce tüm sorunları veya tutarsızlıkları düzeltmenizi gerektireceğinden, bunun yapılmaması sertifikasyonda gecikmelere neden olur.

Bağlayıcınızın kod tamamlandığından ve hem Power BI Desktop'ta yazma hem de Power BI Hizmeti'nde yenileme ve tüketimde test edilmiş olduğundan emin olun. Şirket içi veri ağ geçidi kullanarak Power BI Hizmetinde tam uçtan uca yenilemeyi test ettiğinizden emin olun.

Başlamak için kayıt formumuzu doldurun; bir Microsoft kişisi işleme başlamak için iletişime geçer.

Sertifikasyondan Sonra

Bağlayıcınız sertifikalanıp Power BI Desktop ve Power BI hizmeti aracılığıyla yayımlandıktan sonra, üretimde dağıtılan genel kullanıma açık sertifikalı bağlayıcıyı doğru bir şekilde kullanabilmek için yapmanız gereken birkaç şey vardır.

  • Siz ve son kullanıcılar Power BI Desktop'ta bulunan sertifikalı bağlayıcı sürümünü ve şirket içi veri ağ geçidini kullanmalı ve sertifikasyondan önce kullanılan mevcut .mez veya .pqx dosyalarını (özel bağlayıcılar) kaldırmalısınız. Bunun yapılmaması, test özel bağlayıcınızın yeni sertifikalanan bağlayıcı yerine Yanlışlıkla Power Query tarafından kullanılmasına neden olabilir.
  • Özel bağlayıcılar yalnızca bağlayıcının yeni sürümlerini test etmek için kullanılmalıdır.
  • Son kullanıcılar ve müşterilerle çalışırken, sertifikasyondan önce testte kullanılan özel bağlayıcı sürümünün test tamamlandıktan ve yeni sertifikalı bağlayıcı sürümü kullanıma sunulduktan sonra kaldırılması gerektiğini anladığından emin olun.

Bir veri kaynağına bağlayıcı geliştirdikten sonra, bir şablon uygulaması oluşturarak müşterilerin hızla çalışmaya başlamalarına yardımcı olun. Şablon uygulaması, müşterilere kullanıma hazır olarak kullanabilecekleri veya gerektiğinde özelleştirebilecekleri verilerine bağlı önceden oluşturulmuş bir rapor sağlar.

Not

Şablon uygulamaları, ağ geçidi gerektiren bağlayıcıları desteklemez.