Aracılığıyla paylaş

Power Query SDK'sını kullanarak bağlayıcı geliştirme

  • Makale

Power Query SDK'sı, Power Query bağlayıcıları oluşturmanıza yardımcı olmak için tasarlanmış bir araç kümesidir. Bu bağlayıcılar genellikle özel bağlayıcılar veya Power Query uzantıları olarak adlandırılır.

Özel bağlayıcılar yeni veri kaynakları oluşturmanıza veya var olan bir kaynağı özelleştirmenize ve genişletmenize olanak sağlar. Yaygın kullanım örnekleri şunlardır:

  • REST API için iş analisti dostu bir görünüm oluşturma.
  • Power Query'nin desteklediği bir kaynak için mevcut bir bağlayıcıyla (OData hizmeti veya ODBC sürücüsü gibi) markalama sağlama.
  • SaaS teklifi için OAuth v2 kimlik doğrulama akışı uygulama.
  • Kullanılabilirliği artırmak için veri kaynağınız üzerinde sınırlı veya filtrelenmiş bir görünümü ortaya çıkarma.
  • ODBC sürücüsü kullanarak veri kaynağı için DirectQuery'yi etkinleştirme.

Power Query SDK'sını yükleme

Visual Studio Market'in Visual Studio Code bölümünden Visual Studio Code Power Query SDK'sını yükleyin. SDK'yi yüklemek için Yükle'yi seçin.

Bağlayıcı geliştirme işlemi

Aşağıdaki bölümlerde, SDK'yı kullanarak Power Query bağlayıcısı oluşturmaya yönelik en yaygın işlem üst düzeyde açıklanmaktadır.

Yeni uzantı oluşturma

Yeni bir çalışma alanı (Visual Studio Code Power Query SDK'sı) oluştururken aşağıdaki temel dosyalarla başlarsınız:

  • Bağlayıcı tanım dosyası (<connectorName.pq>)
  • Sorgu dosyası (<connectorName.query.pq>)
  • Dize kaynak dosyası (resources.resx)
  • Simgeler oluşturmak için kullanılan çeşitli boyutlardaKI PNG dosyaları

Bağlayıcı tanım dosyanız boş bir veri kaynağı açıklamasıyla başlar. Veri erişimini işleme makalesinden Power Query SDK'sı bağlamında bir veri kaynağı hakkında daha fazla bilgi edinebilirsiniz.

Test Etme

Power Query SDK'sı, farklı bir istemci uygulamasına geçmek zorunda kalmadan uzantınızı test etmenizi sağlayan temel sorgu yürütme özellikleri sağlar. Bağlayıcınızı aşağıdakiler gibi bir uygulamada daha fazla test edebilirsiniz:

Sorgu test dosyası

Veri Bağlayıcısı projelerinde uzantı dosyasına ek olarak bir sorgu dosyası (name.query.pq) bulunabilir. Bu dosya Visual Studio Code içinde test sorguları çalıştırmak için kullanılabilir. Sorgu değerlendirmesi, .pqx dosyanızı kaydetmenize gerek kalmadan uzantı kodunuzu otomatik olarak içerir ve uzantı kodunuzda paylaşılan işlevleri çağırmanıza veya test etmenize olanak sağlar.

Sorgu dosyası tek bir ifade (örneğin, HelloWorld.Contents()), bir let ifade (Power Query'nin oluşturacağı gibi) veya bir bölüm belgesi içerebilir.

Derleme ve dağıtma

Projenizi oluşturmak .mez dosyanızı veya uzantı dosyanızı oluşturur. Power Query uzantıları bir ZIP dosyasında paketlenir ve .mez dosya uzantısı verilir.

Uzantılar bir M bölümü belgesi içinde tanımlanır. Bölüm belgesi, Power Query'de oluşturulan sorgu belgelerinden biraz farklı bir biçime sahiptir. Power Query'den içeri aktardığınız kodlar genellikle bölüm belgesine sığacak şekilde değişiklik yapılmasını gerektirir, ancak değişiklikler küçük olur. Bilmeniz gereken bölüm belgesi farklılıkları şunlardır:

  • Bölüm bildirimiyle başlarlar (örneğin, section HelloWorld;).
  • Her ifade noktalı virgülle (örneğin, a = 1; veya b = let c = 1 + 2 in c;) biter.
  • Paylaşılan olarak işaretlenmedikleri sürece tüm işlevler ve değişkenler bölüm belgesinde yereldir. Paylaşılan işlevler diğer sorgular/işlevler tarafından görülebilir hale gelir ve uzantınızın dışarı aktarmaları olarak düşünülebilir (yani, Power Query'den çağrılabilir hale gelir).

M bölümü belgeleri hakkında daha fazla bilgi M Dili belirtiminde bulunabilir.

Power Query bağlayıcılarının dağıtımı

Bağlayıcınızı dağıtabileceğiniz iki yolunuz vardır:

  • Kendi kendine dağıtım
  • Bağlayıcı sertifikası

Kendi kendine dağıtım

Geçerli ürün deneyimlerinde Power Query özel bağlayıcılarını uygulayabileceğiniz bir self servis mekanizması

Bağlayıcınız oluşturulduktan sonra, bu dosyayı kullanıcılarınıza istediğiniz gibi gönderebilirsiniz ve bağlayıcıyı Microsoft Power BI gibi geçerli ürün deneyimlerinde kullanabilirler.

Microsoft Power BI

Bulutta yenileme ve bağlantı için Microsoft Power BI Desktop ve Anlam modelleri için Microsoft Power BI Hizmeti'nde kendi özel bağlayıcınızı kullanabilirsiniz.

Power Query bağlayıcıları üç deneyime yüklenebilir:

  • Şirket İçi Veri Ağ Geçidi: Bağlayıcınız Microsoft Fabric ve Microsoft Power BI hizmeti'lerinde kullanılmak üzere ağ geçidi üzerinden yüklenebilir
  • Power Query Online: Power BI Datamarts, Fabric Dataflow 2. Nesil ve diğerleri gibi deneyimler içinde
  • Power Query Desktop: Power BI Desktop gibi deneyimler içinde.

Aşağıdaki makaleleri kullanarak kendi kendine dağıtım için özel bağlayıcınızı kullanma hakkında daha fazla bilgi edinebilirsiniz:

Bağlayıcı Sertifikası

Data Factory bağlayıcısı sertifika programı, bağlayıcınızı, Microsoft'un geçerli ürünler ve deneyimler için hem Microsoft Fabric hem de Microsoft Power BI'da yayımlama ve dağıtma işlemleriyle ilgilendiği sertifikasyon için Microsoft'a göndermenize olanak tanır:

  • Power Query Desktop: Microsoft Power BI Desktop.
  • Power Query Online: Microsoft Fabric Veri Akışı 2. Nesil, Microsoft Fabric Ambarı, Microsoft Power BI Datamarts, Microsoft Power BI Veri Akışı 1. Nesil ve diğerleri
  • Şirket içi Veri Ağ Geçidi: Hem Microsoft Fabric hem de kimliği doğrulanmış yenileme veya bağlantı için bir ağ geçidi kullanan Microsoft Power BI için.

Data Factory Bağlayıcısı Sertifikasyon programı hakkında daha fazla bilgi edinin.