Aracılığıyla paylaş


Eklenmiş uygulamanızın sorunlarını giderme

Bu makalede, Power BI'dan içerik eklenirken ortaya çıkabilecek bazı yaygın sorunlar ele alınmaktadır.

Sorun giderme araçları

Fiddler İzleme

Fiddler, Telerik'in HTTP trafiğini izleyen ücretsiz bir aracıdır. İstemci makinesinden Power BI API'leriyle trafiği görebilirsiniz. Bu araç hataları ve diğer ilgili bilgileri gösterebilir.

Power BI API HTTP trafiğini gösteren Fiddler aracı çıkış penceresinin ekran görüntüsü.

Ön uç hata ayıklaması için Tarayıcıda F12

F12 anahtarı, tarayıcınızda geliştirici penceresini başlatır. Bu araç, ağ trafiğine bakmanızı ve diğer değerli bilgileri görmenizi sağlar.

Web tarayıcısı geliştirici penceresinin ağ trafiğini gösteren Ağ sekmesinin ekran görüntüsü.

Power BI yanıtından hata ayrıntılarını ayıklama

Bu kod parçacığı, bir HTTP özel durumdan hata ayrıntılarını ayıklamayı gösterir:

public static string GetExceptionText(this HttpOperationException exc)
{
    var errorText = string.Format("Request: {0}\r\nStatus: {1} ({2})\r\nResponse: {3}",
    exc.Request.Content, exc.Response.StatusCode, (int)exc.Response.StatusCode, exc.Response.Content);
    if (exc.Response.Headers.ContainsKey("RequestId"))
    {
        var requestId = exc.Response.Headers["RequestId"].FirstOrDefault();
        errorText += string.Format("\r\nRequestId: {0}", requestId);
    }

    return errorText;
}

Öneririz ki İstek Kimliğini (ve sorun giderme için hata ayrıntılarını) kaydetmenizi. Microsoft desteğine yaklaşırken İstek Kimliğini belirtin.

Uygulama kaydı

Uygulama kaydı hatası

Azure portalında veya Power BI uygulama kaydı sayfasında hata iletileri, uygulamanızı kaydetmek için yeterli ayrıcalığınız yoksa sizi bilgilendirir. Bir uygulamayı kaydetmek için Microsoft Entra kiracısında yönetici olmanız veya yönetici olmayan kullanıcılar için uygulama kayıtlarının etkinleştirilmesi gerekir.

Yeni bir uygulama kaydederken Power BI hizmeti Azure portalında görünmüyor

Power BI'a en az bir kullanıcının kaydolması gerekir. API listesinde Power BI hizmeti listelendiğini görmüyorsanız, hiçbir kullanıcı Power BI'a kaydolmaz.

Uygulama nesne kimliği ile asıl nesne kimliği arasındaki fark nedir?

Bir Microsoft Entra uygulamasını kaydettiğinizde, nesne kimliğiadlı iki parametre vardır. Bu bölümde her parametrenin amacı ve nasıl edinilen açıklanır.

Uygulama nesne kimliği

nesne kimliği olarak da bilinen uygulama nesnesi kimliği, Microsoft Entra uygulama nesnenizin benzersiz kimliğidir.

Uygulama nesne kimliğini almak için Microsoft Entra uygulamanıza gidin ve Genel Bakış'ndan kopyalayın.

Microsoft Entra uygulamasının Genel Bakış dikey penceresinde nesne kimliğini gösteren Azure portalı penceresinin ekran görüntüsü.

Asıl nesne kimliği

nesne kimliği olarak da bilinen asıl nesne kimliği, Microsoft Entra uygulamanızla ilişkili hizmet sorumlusu nesnesinin benzersiz kimliğidir.

Asıl nesne kimliğinizi almak için Microsoft Entra uygulamanıza gidin ve Genel Bakışbölümünden yerel dizinde yönetilen uygulamauygulama bağlantısını seçin.

Microsoft Entra uygulamasının Genel Bakış dikey penceresindeki Yerel dizinde Yönetilen uygulama seçeneğini gösteren Azure portal penceresinin ekran görüntüsü.

Özellikleri bölümünden Nesne Kimliğikopyalayın.

Microsoft Entra uygulamasının Genel Bakış dikey penceresindeki özellikler bölümünde asıl nesne kimliğini gösteren Azure portalı penceresinin ekran görüntüsü.

Kimlik doğrulama

Kimlik doğrulaması AADSTS70002 veya AADSTS50053 ile başarısız oldu

(AADSTS70002: Kimlik bilgileri doğrulanırken hata oluştu. AADSTS50053: Yanlış kullanıcı kimliği veya parolayla çok fazla oturum açmayı denediniz)

Power BI Embedded ve Microsoft Entra doğrudan kimlik doğrulamasını kullanıyorsanız, doğrudan kimlik doğrulaması etkinleştirilmediğinden oturum açmaya çalıştığınızda önceki iletiye benzer bir ileti alabilirsiniz.

Microsoft Entra ilkesini ya da hizmet sorumlusunukuruluş kapsamında kullanarak doğrudan kimlik doğrulamasını tekrar etkinleştirebilirsiniz.

Bu ilkeyi yalnızca uygulama bazında etkinleştirmenizi öneririz.

Bu ilkeyi oluşturmak için, ilkeyi oluşturup atadığınız dizin için Genel Yönetici olmanız gerekir. İlkeyi oluşturmak ve bu uygulama için SP'ye atamak için örnek bir betik aşağıda verilmiştir:

  1. Microsoft Graph PowerShell SDK'sınıyükleyin.

  2. Aşağıdaki PowerShell komutlarını satır satır çalıştırın ($sp değişkeninin sonuç olarak birden fazla uygulama olmadığından emin olun).

    Connect-MgGraph -Scopes "Directory.Read.All","Policy.ReadWrite.ApplicationConfiguration"
    
    $sp = Get-MgServicePrincipal -Filter "DisplayName eq 'Name_Of_Application'"
    
    $policy = New-MgBetaPolicyActivityBasedTimeoutPolicy -Definition @("{`"AllowCloudPasswordValidation`":true}") `
       -DisplayName EnableDirectAuth -IsOrganizationDefault:$false
    
    $params = @{
       "@odata.id" = "https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies/$policy.Id"
    }
    New-MgBetaServicePrincipalClaimMappingPolicyByRef -ServicePrincipalId $sp.Id `
       -BodyParameter $params
    

İlkeyi atadıktan sonra, test etmeden önce yayma için yaklaşık 15-20 saniye bekleyin.

Etkin kimlik sağlanırken belirteç oluşturma işlemi başarısız oluyor

GenerateToken birkaç farklı nedenden dolayı sağlanan geçerli kimlikle başarısız olabilir:

  • Anlam modeli etkin kimliği desteklemez.
  • Kullanıcı adı sağlanmadı.
  • Bir rol verilmedi.
  • DatasetId sağlanmadı.
  • Kullanıcının doğru izinleri yok.

Sorunu belirlemek için aşağıdaki adımları deneyin:

  • komutunu çalıştırarak veri kümesi'i al. Özellik IsEffectiveIdentityRequired doğru mu?
  • herhangi bir EffectiveIdentityiçin kullanıcı adı gereklidir.
  • Eğer IsEffectiveIdentityRolesRequired doğruysa, Rol gereklidir.
  • EffectiveIdentityiçin DatasetId gereklidir.
  • Analysis Services için ana kullanıcının ağ geçidi yöneticisi olması gerekir.

AADSTS90094: Yetki vermek için yönetici izni gerekiyor

Belirtileri:

Yönetici olmayan bir kullanıcı onay verirken bir uygulamada ilk kez oturum açmaya çalıştığında aşağıdaki hatalardan birini alır:

  •   ConsentTest needs permission to access resources in your organization that only an admin can grant. Ask an admin to grant permission to this app before you can use it.
    
  •   AADSTS90094: The grant requires admin permission.
    

    Onay Testi izin hatasını gösteren Azure portalı penceresi oturum açma iletişim kutusunun ekran görüntüsü.

Yönetici kullanıcı başarıyla oturum açabilir ve onay verebilir.

Kök nedeni:

Kiracı için kullanıcı onayı devre dışı bırakıldı.

Çeşitli düzeltmeler mümkündür:

  • Kiracının tamamı için kullanıcı onayını etkinleştirin (tüm kullanıcılar, tüm uygulamalar):
  1. Azure portalında Microsoft Entra ID>Kullanıcılar ve gruplar>Kullanıcı ayarlarıgidin.
  2. Kullanıcıların şirket verilerine kendi adlarına erişmesine izin ayarını etkinleştirin ve değişiklikleri kaydedin.

Azure portalının ekran görüntüsü.

  • Yönetici uygulamaya kiracının tamamı veya belirli bir kullanıcı için izin verebilir.

CS1061 hatası

Aşağıdaki hatayla karşılaşırsanız Microsoft.IdentityModel.Clients.ActiveDirectory indirin:

'AuthenticationContext' does not contain a definition for 'AcquireToken' and no accessible 'AcquireToken' accepting a first argument of type 'AuthenticationContext' could be found (are you missing a using directive or an assembly reference?)

Farklı bir kiracı için Microsoft Entra belirteci (konuk kullanıcı)

kuruluşunuz için eklemeMicrosoft Entra konuk kullanıcılarının içeriğinize erişmesine izin vermek için, authorityUri parametresinde kiracı kimliğini belirtmeniz gerekir.

  • Kuruluşunuzun kiracısında kimlik doğrulaması url'si:

    https://login.microsoftonline.com/common/v2.0

  • Konuk Microsoft Entra kullanıcısını kimlik doğrulaması için URL:

    https://login.microsoftonline.com/<tenant ID>

Kiracı kimliğinizi bulmak için Microsoft Entra kiracı kimliğini ve birincil etki alanı adını bulmaiçindeki yönergeleri kullanabilirsiniz.

Daha fazla bilgi için Uygulamanızı çok kiracılı hale getirmekonulu belgeye bakın.

Veri kaynakları

ISV, aynı veri kaynağı için farklı kimlik bilgilerine sahip olmak istiyor

Bir veri kaynağı, tek bir ana kullanıcı için tek bir kimlik bilgileri kümesine sahip olabilir. Farklı kimlik bilgileri kullanmanız gerekiyorsa daha fazla ana kullanıcı oluşturun. Ardından, ana kullanıcıların bağlamlarının her birine farklı kimlik bilgilerini atayın ve bu kullanıcının Microsoft Entra belirtecini kullanarak ekleyin.

IError nesnesiyle eklenmiş uygulamanızın sorunlarını giderme

Uygulamanızda hata ayıklamak ve hatalarınızın nedenini daha iyi anlamak için JavaScript SDK hata olayı tarafından döndürülen IError nesnesini kullanın.

IError nesnesini aldıktan sonra, kullandığınız ekleme türüne uyan uygun yaygın hatalar tablosuna bakmanız gerekir. IError özelliklerini tablodaki özelliklerle karşılaştırın ve hatanın olası nedenlerini bulun.

Power BI kullanıcıları için ekleme sırasında oluşan tipik hatalar

İleti Ayrıntılı İleti Hata Kodu Olası nedenler
Jeton Süresi Doldu Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin 403 Süresi dolan belirteç
PowerBIEntityNotFound - Power BI Varlığı Bulunamadı Rapor alma başarısız oldu 404
  • Yanlış Rapor Kimliği
  • Rapor yok
  • Geçersiz parametreler powerbiToken parametresi belirtilmedi Uygulanamaz
  • Erişim belirteci sağlanmadı
  • Rapor Kimliği verilmedi
  • Rapor Yüklemesi Başarısız Başlatılamadı - Küme çözülemedi 403
  • Hatalı erişim belirteci
  • Ekleme türü belirteç türüyle eşleşmiyor
  • PowerBİ Yetkilendirilmemiş İstisnası Rapor alınamadı 401
  • Yanlış grup kimliği
  • Yetkisiz grup
  • Token Süresi Doldu Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin. Başlıklı bir rapor görseli işlenemedi: görsel başlığı YOK
  • Sorgu verileri
  • Süresi dolan belirteç
  • OpenConnectionError Görsel görüntülenemez. Başlıklı bir rapor görseli işlenemedi: görsel başlığı YOK Kapasiteyle ilgili bir rapor oturumda açıkken kapasite askıya alındı veya silindi
    KeşifKonteyner_ModelYüklenemedi_VarsayılanDetaylar Bu raporla ilişkilendirilmiş model şeması yüklenemedi. Sunucuyla bağlantınız olduğundan emin olun ve yeniden deneyin. Mevcut Değil
  • Kapasite duraklatıldı
  • Kapasite silindi
  • Power BI kullanıcısı olmayan kullanıcılar için ekleme sırasında oluşan tipik hatalar (Ekleme Belirteci kullanılarak)

    İleti Ayrıntılı İleti Hata Kodu Olası nedenler
    Token Süresi Doldu Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin 403 Süresi dolan belirteç
    Rapor Yüklenemedi Rapor alma işlemi başarısız oldu 404
  • Yanlış Rapor Kimliği
  • Rapor yok
  • Rapor yüklenemedi Rapor alınamadı 403 Rapor Kimliği belirteçle eşleşmiyor
    Rapor Yüklenemedi Rapor alınması başarısız oldu 500 Sağlanan rapor kimliği bir GUID değil
    Geçersiz parametreler powerbiToken parametresi belirtilmedi Uygun Değil
  • Erişim belirteci sağlanmadı
  • Rapor Kimliği sağlanmadı
  • Rapor Yükleme Başarısız Başlatma başarısız oldu - Küme çözümlenmesi başarısız oldu 403 Yanlış belirteç tipi veya geçersiz belirteç
    PowerBINotAuthorizedException Rapor alınamadı 401 Yanlış/yetkisiz grup kimliği
    Token Süresi Doldu Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin. adlı bir rapor görseli oluşturulamadı: görsel başlığı YOK
  • Sorgu verileri
  • Süresi dolan belirteç
  • OpenConnectionError Görsel görüntülenemez. Başlıklı bir rapor görseli işlenemedi: görsel başlığı YOK Oturumda kapasiteyle ilgili bir rapor açıkken kapasite duraklatıldı veya silindi.
    ModelYüklemeHatası_Konteyner_KullanımaHazırDeğil_Detaylar Bu raporla ilişkilendirilmiş model şeması yüklenemedi. Sunucuyla bağlantınız olduğundan emin olun ve yeniden deneyin. Uygulanamaz
  • Kapasite duraklatıldı
  • Kapasite silindi
  • Rapor alma başarısız - hata 401 - kendiliğinden çözülecekler

    kullanıcının verileri sahip olduğu senaryosunda, bazen kullanıcılar Power BI portalına eriştikten sonra kendiliğinden düzelen bir 401 hatası alabilir. 401 hatası meydana geldiğinde, uygulamada Kullanıcı izinlerini güncelleyinkısmında açıklandığı gibi RefreshUser İzinleri çağrısını ekleyin.

    Anlamsal modeller

    Kullanıcılarınızın verilerin hangi bölümünü görebileceğini yönetme

    Anlam modeli için okuma izinlerine sahip olan tüm kullanıcılar şemanın tamamını (tablolar, sütunlar ve ölçüler) ve tüm verileri görebilir. Aynı anlam modelinde ham ve toplanmış verilere yönelik görüntüleme izinlerini ayrı ayrı denetleyemezsiniz.

    Kullanıcılarınızın verilerin hangi bölümünü görüntüleyebileceğini yönetmek için aşağıdaki yöntemlerden birini kullanın:

    • Power BIsatır düzeyi güvenlik (RLS) kullanarak satır düzeyi filtreleme.

    • nesne düzeyi güvenlik (OLS) .

    • Verileri farklı anlamsal modellere ayırın. Örneğin, yalnızca toplanan verileri içeren bir anlam modeli oluşturabilir ve kullanıcılarınıza yalnızca bu anlam modeline erişim verebilirsiniz.

    İçerik işleme

    Eklenmiş Power BI öğelerindeki (raporlar ve panolar gibi) işleme sorunlarını çözmek için bu bölümü gözden geçirin.

    Power BI öğesinin Power BI hizmetinde yüklendiğini doğrulayın

    Uygulama veyaekleme API'leri ile ilgili sorunları elemek için öğenin Power BI hizmetinde görüntülenebildiğini doğrulayın (powerbi.com).

    Power BI ekli analiz oyun alanında Power BI öğesinin yüklendiğini doğrulayın

    Uygulamanızla ilgili sorunları elemek için Power BI öğesinin Power BI tümleşik analiz oyun alanında görüntülenebildiğini doğrulayın.

    Erişim belirtecinizin süresinin dolmadığını doğrulayın

    Güvenlik amacıyla erişim belirteçlerinin (Microsoft Entra belirteci veya ekleme belirteci) kullanım ömrü sınırlıdır. Erişim belirtecinizi sürekli izlemeli ve gerekirse yenilemelisiniz. Daha fazla bilgi için bkz. Erişim belirtecini yenileme.

    Performans

    En iyi performansa sahip ekli içeriği elde etmek için Power BI tümleşik analiz en iyi yöntemlerini izlemenizi öneririz.

    Power BI Embedded Sık Sorulan Sorular

    Başka sorularınız mı var? Power BI Topluluğu'na sorun