Aracılığıyla paylaş

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.

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 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ı iki 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 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:

  • Last updated on