TripPin bölüm 9 - Test Bağlan ion

Bu çok bölümlü öğretici, Power Query için yeni bir veri kaynağı uzantısı oluşturmayı kapsar. Öğreticinin sırayla yapılması amaçlanır; her ders önceki derslerde oluşturulan bağlayıcı üzerinde oluşturulur ve bağlayıcınıza artımlı olarak yeni özellikler ekler.

Bu derste şunları yapacaksınız:

• Test Bağlan ion işleyicisi ekleme
• Şirket içi veri ağ geçidini yapılandırma (kişisel mod)
• Power BI hizmeti aracılığıyla zamanlanmış yenilemeyi test edin

Kişisel şirket içi veri ağ geçidinin Nisan 2018 sürümüne özel bağlayıcı desteği eklendi. Bu yeni (önizleme) işlevi, özel bağlayıcınızı kullanan raporların Zamanlanmış Yenilemesini sağlar.

Bu öğretici, bağlayıcınızı yenileme için etkinleştirme işlemini kapsar ve ağ geçidini yapılandırma adımlarına ilişkin hızlı bir kılavuz sağlar. Özellikle şunu yapacaksınız:

1. Bağlayıcınıza bir Test Bağlan ion işleyicisi ekleyin.
2. Şirket içi Veri Ağ Geçidi'ni Kişisel modda yükleyin.
3. Ağ geçidinde Özel Bağlan veya desteğini etkinleştirin.
4. PowerBI.com için bağlayıcınızı kullanan bir çalışma kitabı yayımlayın.
5. Bağlayıcınızı test etmek için zamanlanmış yenilemeyi yapılandırın.

Test Bağlan ion işleyicisi hakkında daha fazla bilgi için Ağ Geçidi Desteğini İşleme bölümüne gidin.

Background

PowerBI.com kullanarak zamanlanmış yenileme için veri kaynağını yapılandırmanın üç önkoşulu vardır:

• Veri kaynağı desteklenir: Bu, hedef ağ geçidi ortamının yenilemek istediğiniz sorguda yer alan tüm işlevlerin farkında olduğu anlamına gelir.
• Kimlik bilgileri sağlanır: Doğru kimlik bilgisi girişi iletişim kutusunu sunmak için Power BI'ın belirli bir veri kaynağı için destek kimlik doğrulama mekanizmasını bilmesi gerekir.
• Kimlik bilgileri geçerlidir: Kullanıcı kimlik bilgilerini sağladıktan sonra veri kaynağının TestConnection işleyicisi çağrılarak doğrulanır.

İlk iki öğe, bağlayıcınızı ağ geçidine kaydederek işlenir. Kullanıcı PowerBI.com zamanlanmış yenilemeyi yapılandırmaya çalıştığında, sorgu bilgileri Power BI hizmeti tarafından tanınmayan veri kaynaklarının (yani sizin oluşturduğunuz özel kaynakların) kullanılabilir olup olmadığını belirlemek için kişisel ağ geçidinize gönderilir. Üçüncü öğe, veri kaynağınız için tanımlanan Test Bağlan ion işleyicisi çağrılarak işlenir.

Test Bağlan ion işleyicisi ekleme

Test Bağlan ion işleyicisi, Veri Kaynağı Türü bildirim kaydına eklenir (desteklenen kimlik doğrulama türlerini bildirdiğiniz yer). İşleyici, function türünde anytek bir parametreye sahip olan ve bir listdöndürür. Listedeki ilk değer, bağlantıyı gerçekten test etmek için çağrılan işlevdir. Bu genellikle ana veri kaynağı işlevinizle aynıdır. Bazı durumlarda verimli bir bağlantı testi sağlamak için ayrı shared bir işlevi kullanıma sunmanız gerekebilir, ancak bu genellikle önlenmelidir.

TripPin veri kaynağı işlevinin gerekli bağımsız değişkenleri olmadığından Test Bağlan ion uygulaması oldukça basittir:

// Data Source Kind description
TripPin = [
    // TestConnection is required to enable the connector through the Gateway
    TestConnection = (dataSourcePath) => { "TripPin.Contents" },
    Authentication = [
        Anonymous = []
    ],
    Label = "TripPin Part 9 - TestConnection"
];

Not

Test Çalıştır Bağlan ion işlevi komutunu kullanarak Power Query SDK'sı içinde Test Bağlan ion uygulamanızı doğrulayabilirsiniz.

Kişisel ağ geçidinde özel bağlayıcıları etkinleştirme

Şirket içi veri ağ geçidini indirin ve yükleyin. Yükleyiciyi çalıştırdığınızda kişisel modu seçin.

Yükleme tamamlandıktan sonra ağ geçidini başlatın ve Power BI'da oturum açın. Oturum açma işlemi ağ geçidinizi otomatik olarak Power BI hizmeti kaydeder. Oturum açtıktan sonra aşağıdaki adımları uygulayın:

1. Bağlan orlar sekmesini seçin.
2. Özel veri bağlayıcıları desteğini etkinleştirmek için anahtarı seçin.
3. Özel bağlayıcıları yüklemek istediğiniz dizini seçin. Bu dizin genellikle Power BI Desktop için kullandığınız dizinle aynı olacaktır, ancak değer yapılandırılabilir.
4. Sayfa artık hedef dizininizdeki tüm uzantı dosyalarını listelemelidir.

Ağ geçidi hakkında daha fazla bilgi için çevrimiçi belgelere gidin.

Zamanlanmış yenilemeyi test etme

Power BI Desktop'ı açın ve TripPin bağlayıcısını kullanarak verileri içeri aktaran bir rapor oluşturun.

Rapor sayfanıza bir veya daha fazla görsel ekleyin (isteğe bağlı) ve ardından raporu PowerBI.com yayımlayın.

Yayımladıktan sonra PowerBI.com gidin ve yayımladığınız raporun anlam modelini bulun. Üç noktayı ve ardından Yenilemeyi Zamanla'yı seçin. Ağ geçidi bağlantısı ve Veri kaynağı kimlik bilgileri bölümlerini genişletin.

Not

Anlam modeli yapılandırma sayfasında raporun bilinmeyen veri kaynakları içerdiği belirtiliyorsa ağ geçidiniz/özel bağlayıcınız düzgün yapılandırılmamış olabilir. Kişisel ağ geçidi yapılandırma kullanıcı arabirimine gidin ve TripPin bağlayıcısının yanında hata olmadığından emin olun. En son yapılandırmayı almak için ağ geçidini yeniden başlatmanız gerekebilir (Hizmet Ayarlar sekmesinde).

Kimlik doğrulama iletişim kutusunu açmak için Kimlik bilgilerini düzenle bağlantısını seçin ve ardından oturum aç'ı seçin.

Not

Aşağıdakine benzer bir hata alırsanız ("Veri kaynağı kimlik bilgileri güncelleştirilemedi"), büyük olasılıkla Test Bağlan ion işleyicinizle ilgili bir sorunla karşılaşırsınız.

Test Bağlan ion'a yapılan başarılı bir çağrıdan sonra kimlik bilgileri kabul edilir. Artık yenileme zamanlayabilir veya semantik model üç nokta simgesini ve ardından Şimdi Yenile'yi seçebilirsiniz. Yenilemenin durumunu görüntülemek için Yenileme geçmişi bağlantısını seçebilirsiniz (bu işlemin tamamlanması genellikle birkaç dakika sürer).

Sonuç

Tebrikler! Artık Power BI hizmeti aracılığıyla otomatik yenilemeyi destekleyen üretime hazır bir özel bağlayıcınız var.

Sonraki adımlar

TripPin Bölüm 10 - SorguYu kaynağa döndürme