Power Query SDK'sını kullanarak bağlayıcı geliştirme
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.
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.
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 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.
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:
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.
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;
veyab = 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.
Bağlayıcınızı dağıtabileceğiniz iki yolunuz vardır:
- Kendi kendine dağıtım
- Bağlayıcı sertifikası
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.
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:
- Power BI Desktop'ta Power Query özel bağlayıcısı yükleme
- Power BI Hizmetinde özel bağlayıcıları etkinleştirme ve kullanma
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.