Power Query SDK 'sını yükleme

Hızlı Başlangıç

1. Visual Studio market 'ten Power Query SDK 'sını yükler.
2. Yeni bir veri Bağlayıcısı projesi oluşturun.
3. Bağlayıcı mantığınızı tanımlayın.
4. Uzantı dosyası üretmek için projeyi derleyin.
5. uzantı dosyasını [belgeler]/Power BI Desktop/özel bağlayıcılar içine kopyalayın.
6. Power BI Desktop ( önerilmez) seçeneği, herhangi bir uzantının doğrulama veya uyarı olmadan yüklenmesine izin ver ( dosya altında | Seçenekler ve ayarlar | Seçenekler | Güvenlik | Veri uzantıları).
7. Power BI Desktop'ı yeniden başlatın.

Veri bağlayıcıları dağıtımı

Power BI Desktop kullanıcılar uzantı dosyalarını indirebilir ve bilinen bir dizine (yukarıda açıklanan adımlar) yerleştirebilir. Power BI Desktop, yeniden başlatma sırasında uzantıları otomatik olarak yükleyecek.

Ek bağlantılar ve kaynaklar

• A kitaplığı Işlevleri
• A dili belirtimi
• Power BI Geliştirici Merkezi
• Veri Bağlayıcısı öğreticisi

Adım adım

Visual Studio yeni bir uzantı oluşturma

Visual Studio için Power Query SDK 'nın yüklenmesi Visual Studio içinde yeni bir veri bağlayıcısı proje şablonu oluşturacaktır.

Bu, aşağıdaki dosyaları içeren yeni bir proje oluşturur:

• Bağlayıcı tanım dosyası ( <connectorName> . PQ)
• Sorgu sınama dosyası ( <connectorName> . Query. PQ)
• Bir 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şlayacak. Ayrıntılar için bu belgenin ilerleyen kısımlarında bulunan veri kaynağı türü bölümüne bakın.

Visual Studio 'de test etme

Power Query SDK temel sorgu yürütme özellikleri sağlar ve bu sayede uzantınızı, Power BI Desktop geçiş yapmak zorunda kalmadan test edebilirsiniz. Daha fazla ayrıntı için bkz. sorgu dosyası .

Visual Studio oluşturma ve dağıtma

Projenizin oluşturulması. PQX Dosyanızı oluşturacaktır.

veri bağlayıcı projeleri, uzantı dosyasını [Documents] \microsoft Power BI Desktop \özel bağlayıcılar dizinine kopyalamak için özel derleme sonrası adımları desteklemez. bunu yapmak istiyorsanız, otomatik dağıtım gibi üçüncü taraf Visual Studio uzantısını kullanmak isteyebilirsiniz.

Uzantı dosyaları

Power Query uzantıları bir ZIP dosyasında paketlenmiştir ve. MEZ dosya uzantısı verilir. çalışma zamanında, Power BI Desktop uzantıları [belgeler] \microsoft Power BI Desktop \custom bağlayıcılarından yükleyecek.

Uzantı dosyası biçimi

Uzantılar bir msection belgesi içinde tanımlanır. Bölüm belgesinde, Power Query oluşturulan sorgu belgesinden biraz farklı bir biçim vardır. Power Query içeri aktardığınız kod, genellikle bir bölüm belgesine sığacak şekilde değişiklik yapılmasını gerektirir, ancak değişiklikler küçük değildir. Dikkat etmeniz gereken bölüm belge farklılıkları:

• Bunlar bir bölüm bildirimiyle başlar (örneğin, section HelloWorld; ).
• Her bir ifade noktalı virgül ile biter (örneğin, a = 1; veya b = let c = 1 + 2 in c; ).
• Tüm işlevler ve değişkenler, paylaşılan olarak işaretlenmedikçe, Bölüm belgesi için yereldir. Paylaşılan işlevler diğer sorgular/işlevler için görünür hale gelir ve uzantınızın dışarı aktarmaları olarak düşünülebilir (yani, Power Query çağrılabilir hale gelir).

Msection belgeleri hakkında daha fazla bilgi için, Mlanguage belirtiminde bulabilirsiniz.

Sorgu dosyası

Uzantı dosyasına ek olarak, veri Bağlayıcısı projelerinin bir sorgu dosyası (Name. Query. PQ) olabilir. Bu dosya, Visual Studio içinde test sorguları çalıştırmak için kullanılabilir. Sorgu değerlendirmesi,. PQX Dosyanızı kaydetmeye gerek kalmadan uzantı kodunuzu otomatik olarak ekler, böylece uzantı kodunuzda paylaşılan işlevleri çağırmanızı/test edebilirsiniz.

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