Power Query SDK'ya Genel Bakış

Bu makalenin amacı, Visual Studio Code için Power Query SDK'sının içinde bulunan genel özelliklere ve geliştirme deneyimine genel bir bakış sağlamaktır.

Yeni proje oluşturma

Visual Studio Code'a girdikten sonra, Visual Studio Code'un ana Gezgin bölmesinde Power Query SDK'sı adlı bir bölüm vardır. Bu bölümde, Uzantı projesi oluşturma bölümünü okuyan tek bir düğme vardır. Bu düğmeyi seçin.

Bu düğme, Visual Studio Code arabiriminin üst kısmında bir giriş alanı açar. Yeni uzantı projenizin adını girin ve enter tuşuna basın.

Birkaç saniye sonra Visual Studio Code pencereniz, bağlayıcı mantığınızı içeren uzantı projenizin ana *.pq dosyasını açar. Power Query SDK'sı, çalışma alanınızın kurulumunu tamamlamak için gerekli bazı görevleri otomatik olarak çalıştırır. Bu görevleri Visual Studio Code'daki çıkış konsolunda de kontrol edebilirsiniz.

Power Query SDK'sı otomatik olarak aşağıdaki dosya kümesini oluşturur:

• Çalışma alanı düzeyinizde çalışmak üzere belirli ayarları dikte eden bir settings.json dosyası.
• Uzantıyı . mez dosyası olarak oluşturur ve yeni bir bin\AnyCPU\Debug klasöründe depolar.
• .png dosyaları olarak bağlayıcı simgeleri kümesi.
• Uzantıda kullanılan dizeler için ana depolama görevi görecek resources.resx dosyası.
• Uzantınızın veya bağlayıcınızın ana mantığını barındıran bir .pq dosyası.
• Ana amacı daha sonra değerlendirebileceğiniz test sorguları oluşturmanın bir yolu olarak kullanılacak bir .query.pq dosyası.
• Uzantı projesi hakkında bilgi tutan bir .proj dosyası.

Bir uzantı projesi Visual Studio Code tarafından tanındıktan sonra Power Query SDK'sının bölümü görünümünü değiştirir ve şimdi yeni uzantı projenizde çalıştırabileceğiniz görevlerin listesini görüntüler.

Referans

Power Query SDK'sı, uzantı projenizden kimlik bilgilerini ayarlamanıza, listelemenize ve silmenize olanak sağlamak için kullanıcı arabirimi aracılığıyla birden çok görev sunar.

Kimlik bilgilerini ayarlama

Power Query SDK'sı öncelikli olarak birden çok giriş noktası aracılığıyla tetiklenebilen görevler tarafından yönlendirilir. Kimlik bilgisi ayarlama işlemi iki yolla yapılabilir (diğer kimlik bilgisi görevleri aynı şekilde yapılabilir).

• Gezgin bölmesindeki Power Query SDK'sı bölümündeki giriş aracılığıyla.

  

• Görevi Çalıştır seçeneğini ve ardından Kimlik bilgilerini ayarla görevini seçerek Terminal aracılığıyla.

  

Bu görevi çalıştırdığınızda, Visual Studio Code kimlik bilgilerini ayarlamanıza izin vermek için bir dizi istemde size yol gösterir. Bu dizi istem tahmin edilebilir ve her zaman aynı aşamalardan oluşur:

1. Veri kaynağı türünü seçin.
2. Bağlayıcı dosyasını seçin.
3. Kimlik doğrulama yöntemini seçin.

Mevcut uzantı projesi için , kullanılabilir kimlik doğrulama yöntemi anonimdir. Kimlik doğrulaması ayarlandıktan sonra, pencerenin sağ alt köşesinde kimlik bilgilerinin başarıyla oluşturulduğunu onaylayan bir ileti görüntülenir.

Kimlik bilgilerini listeleme

Kimlik bilgisi ayarlamaya benzer şekilde, kimlik bilgilerini listeleme görevinin de aynı yerlerde iki giriş noktası vardır: Gezgin bölmesindeki ve Terminal menüsünün içindeki Power Query SDK'sı bölümü.

Bu görev yürütülürken, çıkış terminalinde kullanılabilir kimlik bilgilerini gösterir.

TÜM kimlik bilgilerini temizleme

Önceki iki göreve benzer şekilde, tüm kimlik bilgilerini temizleme görevinin aynı yerlerde iki giriş noktası vardır: Gezgin bölmesindeki ve Terminal menüsünün içindeki Power Query SDK'sı bölümü.

Bu görev, sorgularınızı değerlendirmek için yeni bir kimlik bilgisi ayarlamanız gerektiğinde geçerli oturumunuzdan tüm kimlik bilgilerini temizlemenin bir yolu olarak görev görür.

Bu görevin bilgilendiren iletileri çıkış konsolunda da gösterilir.

Sorguyu ve sonuçlar panelini değerlendirme

Test sorgularını değerlendirebilmeniz için önce bir kimlik bilgisi ayarlanmalıdır. Önceki bölümde oluşturulan bağlayıcıyı kullanarak, test sorgu dosyanız olarak hizmet veren dosyayı açabilirsiniz *.query.pq .

Proje adının MyConnector olduğu bu özel bağlayıcı için kod aşağıdaki gibi görünür:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents()
in
    result

Sorguyu değerlendirmeden önce kodu aşağıdaki gibi değiştirelim:

// Use this file to write queries to test your data connector
let
    result = MyConnector.Contents("Hello World")
in
    result

Kodunu değiştirdikten sonra dosyayı kaydettiğinizden emin olun.

Bu sorguyu değerlendirmek için üç seçeneğiniz vardır:

• Sağ tarafta kullanımda olan dosyayı seçin ve Geçerli power query dosyasını değerlendir seçeneğini belirleyin.

• Terminal menüsüne gidin ve Geçerli dosyayı değerlendir görevini seçin.

• Visual Studio Code'daki yerel Çalıştır ve Hata Ayıkla seçeneğini kullanın, bir launch.json dosyası oluşturmak için köprüyü seçin ve dosyayı değerlendirin.

Sorgu değerlendirildikten sonra sonuçlar pencerenin alt kısmındaki konsolda ve sağ taraftaki sonuç paneli adlı yeni bir panelde görüntülenir.

Sonuç panelinde üç sekme bulunur:

• Çıkış sekmesi: Değerlendirilen sorgunun veri önizlemesini görüntüler. Veriler bir tabloysa kılavuz olarak görüntülenir.

  

• Özet: Değerlendirmeleri çalıştıran etkinliğin özetini ve bu etkinlikle ilişkili istatistikleri görüntüler.

  

• DataSource: Değerlendirme için kullanılan veri kaynağı hakkındaki genel bilgileri görüntüler.

  

Farklı bir sorguyu değerlendirmek için *.query.pq dosyasını değiştirmeniz, kaydetmeniz ve ardından değerlendirme görevini üç yöntemden herhangi biriyle yeniden çalıştırmanız gerekir.

Eski bir uzantı projesini yeni SDK'ya getirme

Bu bölüm, eski Visual Studio tabanlı Power Query SDK'sı ile oluşturulmuş uzantı projeleri olan bağlayıcı geliştiricilerine yardımcı olur.

Bunu takip etmek için TripPin örneği için DataConnectors depomuzda bulunan bağlayıcı projelerini, özellikle de örnek 9-TestConnection'ı indirmenizi öneririz.

Eski uzantı projesini yeni SDK'ya getirmek için şu adımları izleyin:

1. Visual Studio Code'da Dosya>Aç klasörünü seçin ve uzantı projenizin bulunduğu klasöre gidin.

2. Aşağıdaki iki yöntemden birini kullanarak mevcut klasörü ve içeriğini kullanarak bir çalışma alanı ayarlayın:

   • Power Query SDK'sı, klasörünüzün içeriğini tanımaya yönelik bir mekanizmaya sahiptir ve yeni bir Power Query SDK çalışma alanına dönüştürmeyi etkinleştirmenizi önerir.

     

   • Terminal menüsünden Kurulum çalışma alanını ve Derleme Görevi'ni çalıştırın. Bunlar etkili bir şekilde .mez dosyasını ve çalışma alanı için gereken settings.json dosyalarını oluşturur.

İki yeni klasör ve dosya eklenmesi, geçerli çalışma alanını yeni bir Power Query SDK çalışma alanına dönüştürür.

Çalışma alanını ayarlama

Çalışma alanını ayarla görevinin yaptığı, değerlendirmeler ve genel ayarlar söz konusu olduğunda çalışma alanınız için kullanılacak bazı değişkenleri dikte eden bir settings.json dosyası oluşturmaktır.

Uzantı dosyası oluşturma

Derleme görevi, uzantınız için isteğe bağlı olarak .mez dosyasını oluşturmanıza olanak tanır.

TestConnection işlevini çalıştırma

TestConnection, bağlayıcınızın Power BI gibi hizmetler aracılığıyla Microsoft Bulut'ta yenilenmesini sağlayan bir işlevdir. Bu, bağlayıcı veri kaynağı kaydınızın içinde uygulanan bir kayıttır. Test bağlantısı için sağlanan örnekten TestConnection işleyicisinin uygulanması hakkında daha fazla bilgi edinebilirsiniz.

TestConnection'ı çalıştırma görevi, bu işleyiciyi Microsoft Bulut'ta el ile denemek zorunda kalmadan işleyiciyi Power Query SDK'sı içinde test etmenizi sağlar.

Bu görevi çalıştırmak için önce bağlayıcınız için bir kimlik bilgisi ayarlayın ve ardından görevi Gezgin'deki Power Query SDK'sı bölümünden veya terminal menüsündeki görev listesi aracılığıyla çalıştırın.

Bu görevin sonucu, pencerenin alt kısmındaki çıkış terminalinde görüntülenir.

Geri bildirim ve hatalar

Özel bağlayıcınızı geliştirme konusunda yardıma ihtiyacınız varsa veya bildirmek istediğiniz geri bildirimleriniz, önerileriniz veya hatalarınız varsa GitHub'daki resmi genel depomuzu ziyaret edin.

Power Query, M dili ve özel bağlayıcı geliştirmeyle ilgili genel sorular göndermek için Power BI Topluluğu forumunu da kullanabilirsiniz.