पावर बीआई एंबेडेड: आपके एप्लिकेशन में एनालिटिक्स जोड़ना

प्रत्येक SaaS एप्लिकेशन को अंततः विश्लेषण की आवश्यकता होती है। उपयोगकर्ता अपने उपयोग पैटर्न, प्रदर्शन मेट्रिक्स और व्यावसायिक परिणाम दिखाने वाले डैशबोर्ड चाहते हैं। स्क्रैच से एक कस्टम एनालिटिक्स परत का निर्माण - चार्टिंग लाइब्रेरी, डेटा पाइपलाइन, कैशिंग, निर्यात कार्यक्षमता, ड्रिल-डाउन इंटरैक्शन - 6-12 महीने का इंजीनियरिंग प्रयास और निरंतर रखरखाव लगता है। पावर बीआई एंबेडेड एक विकल्प प्रदान करता है: एंटरप्राइज़-ग्रेड एनालिटिक्स क्षमताएं सीधे आपके एप्लिकेशन में एम्बेडेड होती हैं, जो माइक्रोसॉफ्ट के बुनियादी ढांचे द्वारा समर्थित है।

पावर बीआई एंबेडेड का अर्थ केवल "किसी पृष्ठ पर एक आईफ्रेम डालना" नहीं है। यह आपके अपने एप्लिकेशन के यूआई के भीतर इंटरैक्टिव, सुरक्षित, मल्टी-टेनेंट एनालिटिक्स अनुभव प्रदान करने के लिए एक पूर्ण मंच है। जब आप पावर बीआई के परिपक्व विज़ुअलाइज़ेशन इंजन, DAX गणना परत और डेटा कनेक्टिविटी बुनियादी ढांचे का लाभ उठाते हैं, तो आपके ग्राहक आपके उत्पाद के मूल दिखने और महसूस करने वाले एनालिटिक्स के साथ बातचीत करते हैं।

यह मार्गदर्शिका आपके एप्लिकेशन में पावर बीआई को एम्बेड करने के लिए आर्किटेक्चर, प्रमाणीकरण मॉडल, बहु-किरायेदार सुरक्षा, क्षमता योजना, एसडीके एकीकरण और मूल्य निर्धारण संबंधी विचारों को शामिल करती है। यदि आप एम्बेडेड एनालिटिक्स कार्यान्वयन की योजना बना रहे हैं, तो आर्किटेक्चर मार्गदर्शन और विकास सहायता के लिए हमारी [पावर बीआई एम्बेडेड एनालिटिक्स सेवाएं] (/services/powerbi/embedded-analytics) देखें।

मुख्य बातें

• पावर बीआई एंबेडेड दो परिदृश्यों का समर्थन करता है: "आपके ग्राहकों के लिए एम्बेड करें" (ऐप डेटा का मालिक है) और "आपके संगठन के लिए एम्बेड करें" (उपयोगकर्ता डेटा का मालिक है)
• बहु-किरायेदार SaaS अनुप्रयोगों के लिए सेवा प्रिंसिपल प्रमाणीकरण की अनुशंसा की जाती है; मास्टर उपयोगकर्ता खाते सरल होते हैं लेकिन विफलता के एकल बिंदु बनाते हैं
• पंक्ति-स्तरीय सुरक्षा (आरएलएस) साझा डेटासेट में किरायेदार डेटा अलगाव सुनिश्चित करने के लिए प्राथमिक तंत्र है
• फैब्रिक एफ एसकेयू एम्बेडेड परिदृश्यों के लिए सबसे अधिक लागत प्रभावी क्षमता प्रदान करते हैं, जो विकास के लिए एफ2 से शुरू होती है
• जावास्क्रिप्ट एसडीके गहरे प्रोग्रामेटिक नियंत्रण को सक्षम बनाता है: फ़िल्टर लागू करना, घटनाओं को कैप्चर करना, नेविगेशन को नियंत्रित करना और थीम को अनुकूलित करना
• क्षमता का आकार समवर्ती उपयोगकर्ताओं, क्वेरी जटिलता और डेटा मात्रा पर निर्भर करता है --- न कि केवल कुल उपयोगकर्ता संख्या पर
• कस्टम थीम और छिपा हुआ क्रोम एम्बेडेड रिपोर्ट को आपके एप्लिकेशन का मूल अनुभव कराता है

---

एम्बेडिंग परिदृश्य: ग्राहक बनाम संगठन

आपके ग्राहकों के लिए एम्बेड करें (ऐप के पास डेटा है)

"ऐप डेटा का स्वामी है" परिदृश्य SaaS अनुप्रयोगों के लिए प्राथमिक उपयोग का मामला है। आपका एप्लिकेशन एक सेवा प्रिंसिपल या मास्टर उपयोगकर्ता खाते का उपयोग करके पावर बीआई के साथ प्रमाणित करता है, एक एम्बेड टोकन उत्पन्न करता है, और आपके अंतिम उपयोगकर्ताओं को एम्बेडेड रिपोर्ट प्रदान करता है। आपके ग्राहक कभी भी Power BI के साथ सीधे संपर्क नहीं करते हैं और उन्हें Power BI लाइसेंस की आवश्यकता नहीं है।

वास्तुकला प्रवाह:

1. आपका ग्राहक आपके प्रमाणीकरण सिस्टम का उपयोग करके आपके एप्लिकेशन में लॉग इन करता है।
2. आपका एप्लिकेशन बैकएंड उस ग्राहक के लिए विशिष्ट रिपोर्ट, डेटासेट और आरएलएस भूमिका के दायरे में एक एम्बेड टोकन उत्पन्न करने के लिए पावर बीआई रेस्ट एपीआई को कॉल करता है।
3. बैकएंड एंबेड टोकन और एंबेड यूआरएल को फ्रंटएंड पर लौटाता है।
4. फ्रंटएंड एम्बेड टोकन के साथ पावर बीआई जावास्क्रिप्ट एसडीके को आरंभ करता है और एक निर्दिष्ट कंटेनर तत्व में रिपोर्ट प्रस्तुत करता है।
5. एम्बेड टोकन एक कॉन्फ़िगर करने योग्य अवधि (डिफ़ॉल्ट 1 घंटा) के बाद समाप्त हो जाता है, और आपका एप्लिकेशन इसे पारदर्शी रूप से ताज़ा करता है।

मुख्य विशेषताएं:

• ग्राहकों को पावर बीआई प्रो या प्रीमियम प्रति उपयोगकर्ता लाइसेंस की आवश्यकता नहीं है
• सभी क्षमता लागत फैब्रिक/एंबेडेड एसकेयू के माध्यम से आपके (एप्लिकेशन प्रदाता) द्वारा वहन की जाती है
• आरएलएस और प्रोग्रामेटिक फ़िल्टरिंग के माध्यम से उपयोगकर्ता क्या देखते हैं, इस पर आपका पूरा नियंत्रण है
• प्रमाणीकरण पूरी तरह से आपके एप्लिकेशन की प्रमाणीकरण प्रणाली के अंतर्गत है
• एंबेड टोकन विशिष्ट कलाकृतियों तक सीमित, समय-सीमित पहुंच प्रदान करते हैं

यह ISV, SaaS प्लेटफ़ॉर्म और आंतरिक पोर्टल द्वारा उपयोग किया जाने वाला मॉडल है, जहां एनालिटिक्स उपभोक्ता को पता नहीं होना चाहिए या इसकी परवाह नहीं करनी चाहिए कि Power BI अंतर्निहित तकनीक है।

आपके संगठन के लिए एम्बेड करें (उपयोगकर्ता डेटा का स्वामी है)

"उपयोगकर्ता डेटा का मालिक है" परिदृश्य आंतरिक अनुप्रयोगों के भीतर पावर बीआई सामग्री को एम्बेड करने के लिए है जहां उपयोगकर्ताओं के पास पहले से ही पावर बीआई लाइसेंस (प्रो या पीपीयू) है। एम्बेडेड अनुभव उपयोगकर्ता की अपनी Power BI पहचान और अनुमतियों का उपयोग करता है।

वास्तुकला प्रवाह:

1. उपयोगकर्ता आपके एप्लिकेशन के माध्यम से Azure AD से प्रमाणित करता है।
2. आपका एप्लिकेशन प्रवाह की ओर से OAuth 2.0 का उपयोग करके उपयोगकर्ता की ओर से एक एक्सेस टोकन प्राप्त करता है।
3. एप्लिकेशन एम्बेड कॉन्फ़िगरेशन प्राप्त करने के लिए उपयोगकर्ता के टोकन के साथ Power BI REST API को कॉल करता है।
4. रिपोर्ट उपयोगकर्ता की पूर्ण Power BI अनुमतियों के साथ प्रस्तुत होती है।

मुख्य विशेषताएं:

• प्रत्येक उपयोगकर्ता के पास पावर बीआई प्रो या प्रीमियम प्रति उपयोगकर्ता लाइसेंस होना चाहिए
• उपयोगकर्ता अपनी स्वयं की Power BI अनुमतियों और RLS असाइनमेंट के आधार पर सामग्री देखते हैं
• किसी अतिरिक्त फैब्रिक/एम्बेडेड क्षमता की आवश्यकता नहीं है (उपयोगकर्ता के प्रो/पीपीयू लाइसेंस आवंटन का उपयोग करता है)
• एप्लिकेशन डेवलपर के लिए कम नियंत्रण, उपयोगकर्ता के लिए अधिक स्वायत्तता
• सरल वास्तुकला लेकिन प्रति-उपयोगकर्ता लाइसेंसिंग लागत अधिक

इस मॉडल का उपयोग आमतौर पर इंट्रानेट पोर्टल्स, SharePoint एकीकरण और आंतरिक अनुप्रयोगों के लिए किया जाता है जहां उपयोगकर्ताओं के पास पहले से ही Power BI लाइसेंस हैं और उन्हें अपनी मौजूदा एक्सेस अनुमतियां बरकरार रखनी चाहिए।

परिदृश्यों के बीच चयन करना

बाहरी ग्राहकों को लक्षित करने वाले अधिकांश SaaS अनुप्रयोगों के लिए, "ऐप के पास डेटा है" सही विकल्प है। इस गाइड का शेष भाग मुख्य रूप से इसी परिदृश्य पर केंद्रित है।

---

प्रमाणीकरण: सेवा प्रिंसिपल बनाम मास्टर उपयोगकर्ता

सेवा प्रिंसिपल प्रमाणीकरण

एक सेवा प्रिंसिपल एक Azure AD एप्लिकेशन पहचान है जिस पर Power BI संसाधनों को प्रोग्रामेटिक रूप से एक्सेस करने के लिए भरोसा करता है। यह एम्बेडेड अनुप्रयोगों के उत्पादन के लिए अनुशंसित प्रमाणीकरण विधि है।

सेटअप आवश्यकताएँ:

1. Azure AD में एक एप्लिकेशन पंजीकृत करें।
2. एप्लिकेशन के लिए क्लाइंट सीक्रेट या प्रमाणपत्र बनाएं।
3. एक Azure AD सुरक्षा समूह बनाएं और उसमें सेवा प्रिंसिपल जोड़ें।
4. पावर बीआई एडमिन पोर्टल में, टेनेंट सेटिंग्स > डेवलपर सेटिंग्स के तहत सुरक्षा समूह के लिए सर्विस प्रिंसिपल एक्सेस सक्षम करें।
5. सेवा को अपनी एम्बेडेड सामग्री वाले विशिष्ट पावर बीआई कार्यस्थानों तक पहुंच प्रदान करें।

फायदे:

• किसी विशिष्ट उपयोगकर्ता खाते पर कोई निर्भरता नहीं (विफलता के एकल बिंदु को समाप्त करता है)
• ग्राहक रहस्यों और प्रमाणपत्रों को सेवा में रुकावट के बिना घुमाया जा सकता है
• सेवा प्राचार्यों को विशिष्ट कार्यस्थानों तक सीमित किया जा सकता है (न्यूनतम विशेषाधिकार)
• Azure द्वारा होस्ट किए गए अनुप्रयोगों में Azure AD प्रबंधित पहचान के साथ काम करता है
• उच्च सुरक्षा के लिए प्रमाणपत्र-आधारित प्रमाणीकरण का समर्थन करता है

सीमाएँ:

• "मेरा कार्यक्षेत्र" (व्यक्तिगत कार्यस्थान) तक नहीं पहुंच सकता
• कुछ एडमिन एपीआई को कॉल नहीं किया जा सकता
• कुछ उन्नत सुविधाओं के लिए Azure AD प्रीमियम की आवश्यकता है
• प्रारंभिक सेटअप मास्टर उपयोगकर्ता की तुलना में अधिक जटिल है

मास्टर उपयोगकर्ता प्रमाणीकरण

मास्टर उपयोगकर्ता Power BI Pro या PPU लाइसेंस वाला एक नियमित Azure AD उपयोगकर्ता खाता है जिसका उपयोग आपका एप्लिकेशन Power BI के साथ प्रमाणित करने के लिए करता है। एम्बेड टोकन उत्पन्न करने के लिए एप्लिकेशन इस उपयोगकर्ता के रूप में लॉग इन करता है।

फायदे:

• सरल प्रारंभिक सेटअप (एक उपयोगकर्ता बनाएं, लाइसेंस आवंटित करें, कार्यक्षेत्र तक पहुंच प्रदान करें)
• एडमिन एपीआई सहित सभी पावर बीआई सुविधाओं तक पहुंच सकते हैं
• कोई Azure AD एप्लिकेशन पंजीकरण की आवश्यकता नहीं है

नुकसान:

• विफलता का एकल बिंदु: यदि उपयोगकर्ता खाता लॉक हो जाता है, पासवर्ड समाप्त हो जाता है, या एमएफए ट्रिगर हो जाता है, तो आपका एप्लिकेशन एनालिटिक्स तक पहुंच खो देता है
• सशर्त पहुंच नीतियों का उपयोग नहीं किया जा सकता जिनके लिए इंटरैक्टिव साइन-इन की आवश्यकता होती है
• पासवर्ड रोटेशन के लिए एप्लिकेशन अपडेट की आवश्यकता होती है
• मशीन प्रक्रियाओं के लिए मानव खातों का उपयोग न करने की सुरक्षा की सर्वोत्तम प्रथा का उल्लंघन करता है
• उपयोगकर्ता खाते के लिए लाइसेंस लागत

सिफारिश: सभी उत्पादन परिनियोजन के लिए सेवा प्रमुख प्रमाणीकरण का उपयोग करें। मास्टर उपयोगकर्ता खाते अवधारणा के प्रमाण और विकास परिवेश के लिए स्वीकार्य हैं जहां सादगी विश्वसनीयता से अधिक मायने रखती है।

टोकन जनरेशन और प्रबंधन

प्रमाणीकरण विधि के बावजूद, आपका एप्लिकेशन Power BI REST API के माध्यम से एम्बेड टोकन उत्पन्न करता है। टोकन एम्बेडेड सत्र के लिए अनुमतियों को समाहित करता है।

टोकन संबंधी विचार एम्बेड करें:

• टोकन जीवनकाल: डिफ़ॉल्ट 1 घंटा है, 24 घंटे तक कॉन्फ़िगर किया जा सकता है। छोटा जीवनकाल अधिक सुरक्षित होता है लेकिन अधिक बार ताज़ा करने की आवश्यकता होती है।
• टोकन का दायरा: प्रत्येक टोकन का दायरा विशिष्ट रिपोर्ट, डेटासेट और कार्यस्थानों तक होता है। यथासंभव न्यूनतम दायरा उत्पन्न करें.
• आरएलएस पहचान: पंक्ति-स्तरीय सुरक्षा का उपयोग करते समय, आरएलएस पहचान (उपयोगकर्ता नाम और भूमिकाएं) टोकन में एम्बेडेड होती है। इस प्रकार आप किरायेदार अलगाव सुनिश्चित करते हैं।
• टोकन ताज़ा करें: आपके फ्रंटएंड को टोकन समाप्ति की निगरानी करनी चाहिए और समाप्त होने से पहले एक नए टोकन का अनुरोध करना चाहिए। जावास्क्रिप्ट एसडीके इसके लिए इवेंट प्रदान करता है।

टोकन पीढ़ी उदाहरण प्रवाह:

POST https://api.powerbi.com/v1.0/myorg/GenerateToken
{
    "datasets": [{"id": "dataset-guid"}],
    "reports": [{"id": "report-guid"}],
    "identities": [{
        "username": "[email protected]",
        "roles": ["TenantRole"],
        "datasets": ["dataset-guid"]
    }]
}

प्रतिक्रिया में एक एम्बेड टोकन और समाप्ति टाइमस्टैम्प शामिल है। आपका बैकएंड इस टोकन को कैश करता है (समाप्ति का सम्मान करते हुए) और इसे प्रमाणित फ्रंटएंड अनुरोधों पर परोसता है।

---

बहु-किरायेदार पंक्ति-स्तरीय सुरक्षा

एंबेडेड के लिए आरएलएस महत्वपूर्ण क्यों है

बहु-किरायेदार SaaS एप्लिकेशन में, एकाधिक ग्राहकों का डेटा अक्सर एक ही Power BI डेटासेट में रहता है। पंक्ति-स्तरीय सुरक्षा के बिना, एक एम्बेड टोकन डेटासेट में सभी डेटा तक पहुंच प्रदान करता है। आरएलएस यह सुनिश्चित करता है कि प्रत्येक ग्राहक केवल अपना डेटा ही देखे, भले ही अंतर्निहित डेटासेट साझा किया गया हो।

बहु-किरायेदार एम्बेडेड परिदृश्यों के लिए आरएलएस वैकल्पिक नहीं है। किरायेदार अलगाव में विफलता एक डेटा उल्लंघन है। आरएलएस को एक मूलभूत सुरक्षा नियंत्रण के रूप में डिज़ाइन करें, बाद में नहीं।

स्टेटिक आरएलएस

स्टेटिक आरएलएस पावर बीआई डेस्कटॉप में DAX एक्सप्रेशन का उपयोग करके निश्चित फ़िल्टर नियमों को परिभाषित करता है। प्रत्येक भूमिका में तालिका फ़िल्टर का एक सेट होता है जो प्रतिबंधित करता है कि कौन सी पंक्तियाँ दिखाई दे रही हैं।

उदाहरण:

ग्राहक तालिका पर इस फ़िल्टर के साथ एक "किरायेदार भूमिका":

[TenantId] = USERNAME()

एम्बेड टोकन बनाते समय, आपका एप्लिकेशन वर्तमान किरायेदार के पहचानकर्ता के लिए USERNAME() मान सेट करता है। DAX फ़िल्टर सभी क्वेरीज़ को उन पंक्तियों तक सीमित करता है जहाँ TenantId मेल खाता है।

सीधे किरायेदार अलगाव के लिए स्टेटिक आरएलएस सरल और प्रभावी है। यह तब अच्छा काम करता है जब:

• किरायेदार अलगाव एक एकल कॉलम (टेनेंटआईडी) पर आधारित है जो रिश्तों के माध्यम से फैलता है
• सभी किरायेदारों को समान रिपोर्ट संरचना दिखाई देती है, बस उनके डेटा को फ़िल्टर किया जाता है
• आरएलएस भूमिकाओं की संख्या छोटी और स्थिर है

गतिशील आरएलएस

डायनेमिक आरएलएस DAX अभिव्यक्तियों का उपयोग करता है जो उपयोगकर्ता की पहचान के आधार पर क्वेरी समय पर मूल्यांकन करता है। यह प्रत्येक किरायेदार के लिए अलग-अलग भूमिकाएँ बनाए बिना अधिक जटिल सुरक्षा परिदृश्यों को सक्षम बनाता है।

सामान्य गतिशील आरएलएस पैटर्न:

उपयोगकर्ताप्रिंसिपलनाम() पैटर्न:

[Email] = USERPRINCIPALNAME()

एंबेड टोकन उपयोगकर्ता के ईमेल पर प्रभावी पहचान का उपयोगकर्ता नाम सेट करता है। फ़िल्टर सुरक्षा मैपिंग तालिका में ईमेल कॉलम से मेल खाता है।

सुरक्षा तालिका पैटर्न: एक समर्पित सुरक्षा तालिका बनाएं जो उपयोगकर्ताओं को उस डेटा तक मैप कर सके जिस तक वे पहुंच सकते हैं:

आरएलएस फ़िल्टर लागू करें जो इस सुरक्षा तालिका को रिश्तों के माध्यम से आपकी तथ्य तालिकाओं में जोड़ते हैं। यह पैटर्न किरायेदार के भीतर उपयोगकर्ता-स्तरीय अनुमतियों का समर्थन करता है, न कि केवल किरायेदार-स्तरीय अलगाव का।

आरएलएस परीक्षण और सत्यापन

तैनाती-पूर्व परीक्षण:

1. पावर बीआई डेस्कटॉप में, नमूना उपयोगकर्ता नाम के साथ प्रत्येक आरएलएस भूमिका का परीक्षण करने के लिए "इस रूप में देखें" का उपयोग करें।
2. सत्यापित करें कि तालिकाओं के बीच क्रॉस-फ़िल्टरिंग आरएलएस सीमाओं का सम्मान करती है।
3. परीक्षण किनारे के मामले: बिना मिलान वाली पंक्तियों वाले उपयोगकर्ता (खाली रिपोर्ट देखनी चाहिए, त्रुटियां नहीं), एकाधिक भूमिकाओं वाले उपयोगकर्ता, और फ़िल्टर कॉलम में शून्य मान।
4. सत्यापित करें कि ALL() या REMOVEFILTERS() का उपयोग करके DAX माप RLS को बायपास नहीं करते हैं (उन्हें ऐसा नहीं करना चाहिए, लेकिन सत्यापित करें)।

उत्पादन सत्यापन:

• अपनी तैनाती पाइपलाइन के हिस्से के रूप में आरएलएस परीक्षण को स्वचालित करें
• किरायेदार की पहचान का परीक्षण करने के लिए एंबेड टोकन जेनरेट करें और सत्यापित करें कि क्वेरी परिणाम अपेक्षित डेटा से मेल खाते हैं
• क्षमता मेट्रिक्स में आरएलएस बाईपास प्रयासों की निगरानी करें (असामान्य क्वेरी पैटर्न, अप्रत्याशित डेटा वॉल्यूम)
• आरएलएस कॉन्फ़िगरेशन की त्रैमासिक सुरक्षा समीक्षा आयोजित करें

---

क्षमता आकार और कपड़ा SKU

समझने की क्षमता

पावर बीआई एंबेडेड को समर्पित क्षमता की आवश्यकता होती है --- आपके एम्बेडेड वर्कलोड के लिए आरक्षित संसाधनों की गणना करें। क्षमता को क्षमता इकाइयों (सीयू) में मापा जाता है, जो रिपोर्ट प्रस्तुत करने, क्वेरी निष्पादित करने और डेटासेट को ताज़ा करने के लिए उपलब्ध प्रसंस्करण शक्ति निर्धारित करती है।

क्षमता प्रति उपयोगकर्ता नहीं है. यह गणना का एक साझा पूल है जिससे आपके सभी एम्बेडेड सत्र प्राप्त होते हैं। इसका मतलब यह है कि मूल्य निर्धारण समवर्तीता और क्वेरी जटिलता के आधार पर होता है, न कि कुल उपयोगकर्ता संख्या के साथ।

फैब्रिक एफ एसकेयू विकल्प

माइक्रोसॉफ्ट फैब्रिक एफ एसकेयू पावर बीआई एंबेडेड क्षमता के लिए वर्तमान मूल्य निर्धारण मॉडल है। उन्होंने पुराने A SKU को अधिक लचीले, रुकने-सक्षम मॉडल से बदल दिया।

महत्वपूर्ण नोट्स:

• समवर्ती उपयोगकर्ताओं का मतलब कुल उपयोगकर्ता नहीं है। इसका मतलब है कि उपयोगकर्ता उसी समय सक्रिय रूप से क्वेरी कर रहे हैं। एक सामान्य अनुपात किसी भी समय कुल उपयोगकर्ताओं का 5-10% समवर्ती होता है।
• ये अनुमानित मार्गदर्शन संख्याएँ हैं। वास्तविक क्षमता क्वेरी जटिलता, मॉडल आकार और प्रति रिपोर्ट विज़ुअलाइज़ेशन गणना पर बहुत अधिक निर्भर करती है।
• उपयोग में न होने पर F SKU को रोका जा सकता है (लीगेसी P SKU के विपरीत), जो विकास और मौसमी कार्यभार के लिए मूल्यवान है।
• F64 और इसके बाद के संस्करण में बिना किसी अतिरिक्त लाइसेंस लागत के Power BI प्रीमियम सुविधाएँ (पृष्ठांकित रिपोर्ट, AI, परिनियोजन पाइपलाइन) शामिल हैं।

क्षमता आकार पद्धति

चरण 1: समवर्ती उपयोगकर्ताओं का अनुमान लगाएं।

समवर्ती उपयोगकर्ता = कुल उपयोगकर्ता x शिखर समवर्ती अनुपात

व्यावसायिक घंटों के दौरान एक्सेस किए गए SaaS एनालिटिक्स डैशबोर्ड के लिए: 5-10% समवर्ती अनुपात। दिन भर में बार-बार जांचे जाने वाले परिचालन डैशबोर्ड के लिए: 15-25% समवर्ती अनुपात। इवेंट-संचालित डैशबोर्ड (वास्तविक समय की निगरानी, ​​अलर्ट) के लिए: 30-50% समवर्ती अनुपात।

चरण 2: क्वेरी जटिलता का आकलन करें।

सरल रिपोर्ट (5-10 दृश्य, बुनियादी एकत्रीकरण, एकल तथ्य तालिका): 1x बेसलाइन। मध्यम रिपोर्ट (10-20 दृश्य, समय खुफिया, एकाधिक तथ्य तालिकाएँ): 2-3x बेसलाइन। जटिल रिपोर्ट (20+ विज़ुअल, जटिल DAX, बड़े डेटासेट, क्रॉस-सोर्स क्वेरीज़): 4-6x बेसलाइन।

चरण 3: आवश्यक क्षमता की गणना करें।

उस SKU से प्रारंभ करें जो उपरोक्त तालिका से आपके समवर्ती उपयोगकर्ता अनुमान से मेल खाता हो। अपने जटिलता कारक से गुणा करें। यदि परिणाम SKU की समवर्ती क्वेरी क्षमता से अधिक है, तो अगले स्तर पर जाएँ।

चरण 4: लोड परीक्षण के साथ सत्यापन करें।

सैद्धांतिक आकार निर्धारण एक प्रारंभिक बिंदु है। उत्पादन लॉन्च से पहले, यथार्थवादी डेटा वॉल्यूम, क्वेरी पैटर्न और समवर्ती स्तरों के साथ लोड परीक्षण करें। Microsoft इस उद्देश्य के लिए एक Power BI एंबेडेड क्षमता लोड परीक्षण उपकरण प्रदान करता है।

चरण 5: विकास की योजना बनाएं।

अगले 6-12 महीनों में विकास को समायोजित करने के लिए अपने वर्तमान शिखर से 30-50% हेडरूम जोड़ें। एफ एसकेयू को बिना डाउनटाइम के अपग्रेड किया जा सकता है, ताकि आप क्रमिक रूप से सही आकार दे सकें।

लागत अनुकूलन रणनीतियाँ

• गैर-कार्य घंटों के दौरान विकास क्षमताओं को रोकें। सक्रिय होने पर F SKU प्रति सेकंड बिल किया जाता है, रुकने पर निःशुल्क। Azure ऑटोमेशन या लॉजिक ऐप्स के साथ पॉज़/रेज़्यूमे को स्वचालित करने से विकास लागत 60-70% तक कम हो सकती है।

• क्षमता बढ़ाने से पहले मॉडल को अनुकूलित करें। F8 पर एक अच्छी तरह से अनुकूलित मॉडल अक्सर F32 पर एक खराब अनुकूलित मॉडल से बेहतर प्रदर्शन करता है। प्रदर्शन संबंधी समस्याओं पर ध्यान देने से पहले मॉडल अनुकूलन में निवेश करें।

• बड़े डेटासेट के लिए एकत्रीकरण तालिकाओं का उपयोग करें। सामान्य ग्रैन्युलैरिटी (दैनिक, साप्ताहिक, मासिक) पर डेटा को पूर्व-एकत्रित करने से विवरण के लिए ड्रिल-डाउन क्षमता को संरक्षित करते हुए सारांश-स्तर के दृश्यों के लिए क्वेरी प्रोसेसिंग को 80-90% तक कम कर दिया जाता है।

• पावर बीआई रेस्ट एपीआई के माध्यम से रिपोर्ट-स्तरीय कैशिंग लागू करें। कम डेटा अपडेट वाले डैशबोर्ड के लिए, कैश्ड परिणाम प्रति उपयोगकर्ता सत्र क्षमता खपत को कम करते हैं।

• विभिन्न कार्यभार के लिए अलग-अलग क्षमताओं पर विचार करें। इंटरएक्टिव क्वेरीज़ से रिफ्रेश ऑपरेशंस को अलग करना रिफ्रेश स्पाइक्स को उपयोगकर्ता अनुभव को खराब होने से रोकता है। यह विशेष रूप से महत्वपूर्ण है यदि आपके पास बड़े डेटासेट हैं जो व्यावसायिक घंटों के दौरान ताज़ा होते हैं।

---

जावास्क्रिप्ट एसडीके एकीकरण

बेसिक एंबेडिंग

Power BI JavaScript SDK (powerbi-client) आपके वेब एप्लिकेशन में Power BI सामग्री को एम्बेड करने और नियंत्रित करने के लिए प्रोग्रामेटिक इंटरफ़ेस प्रदान करता है।

स्थापना:

npm install powerbi-client

मूल एम्बेड प्रवाह:

import * as pbi from 'powerbi-client';

const powerbi = new pbi.service.Service(
    pbi.factories.hpmFactory,
    pbi.factories.wpmpFactory,
    pbi.factories.routerFactory
);

const embedConfig = {
    type: 'report',
    id: reportId,
    embedUrl: embedUrl,
    accessToken: embedToken,
    tokenType: pbi.models.TokenType.Embed,
    settings: {
        panes: {
            filters: { visible: false },
            pageNavigation: { visible: true }
        },
        background: pbi.models.BackgroundType.Transparent,
        layoutType: pbi.models.LayoutType.Custom,
        customLayout: {
            displayOption: pbi.models.DisplayOption.FitToWidth
        }
    }
};

const reportContainer = document.getElementById('report-container');
const report = powerbi.embed(reportContainer, embedConfig);

प्रोग्रामेटिक नियंत्रण

एसडीके एम्बेडेड रिपोर्ट पर व्यापक प्रोग्रामेटिक नियंत्रण को उजागर करता है:

फ़िल्टर लागू करना:

const filter = {
    $schema: "http://powerbi.com/product/schema#basic",
    target: {
        table: "Sales",
        column: "Region"
    },
    operator: "In",
    values: ["North", "South"],
    filterType: pbi.models.FilterType.BasicFilter
};

await report.setFilters([filter]);

घटनाओं को कैप्चर करना:

report.on('loaded', function() {
    console.log('Report loaded successfully');
});

report.on('dataSelected', function(event) {
    const data = event.detail;
    // Handle user selection — navigate to detail page, update other UI, etc.
});

report.on('pageChanged', function(event) {
    const pageName = event.detail.newPage.displayName;
    // Track page navigation in your analytics
});

टोकन ताज़ा करें:

report.on('tokenExpired', async function() {
    const newToken = await fetchNewEmbedToken();
    await report.setAccessToken(newToken);
});

नेविगेशन नियंत्रण:

// Navigate to a specific page
const pages = await report.getPages();
const targetPage = pages.find(p => p.displayName === 'Revenue Analysis');
await targetPage.setActive();

// Set a specific slicer value
const visuals = await targetPage.getVisuals();
const slicer = visuals.find(v => v.type === 'slicer');
await slicer.setSlicerState({
    filters: [{
        $schema: "http://powerbi.com/product/schema#basic",
        target: { table: "Date", column: "Year" },
        operator: "In",
        values: [2026],
        filterType: pbi.models.FilterType.BasicFilter
    }]
});

प्रदर्शन के लिए चरणबद्ध प्रतिपादन

कई दृश्यों वाली जटिल रिपोर्टों के लिए, चरणबद्ध रेंडरिंग पहले तह के ऊपर की सामग्री को रेंडर करके कथित प्रदर्शन में सुधार करती है:

const embedConfig = {
    // ... standard config
    settings: {
        // ... other settings
        commands: [{
            visualRendered: {
                phase: 1,
                visualNames: ['revenue-kpi', 'trend-chart', 'summary-table']
            }
        }]
    }
};

report.on('visualRendered', function(event) {
    if (event.detail.phase === 1) {
        // Hide loading spinner, show report
        document.getElementById('loading').style.display = 'none';
    }
});

---

कस्टम थीम और ब्रांडिंग

कस्टम थीम क्यों मायने रखती हैं

डिफ़ॉल्ट Power BI विज़ुअल Microsoft के रंग पैलेट और स्टाइल का उपयोग करते हैं। एम्बेडेड संदर्भ में, यह आपके एप्लिकेशन के साथ दृश्य असंगतता पैदा करता है। कस्टम थीम आपके उत्पाद के डिज़ाइन सिस्टम के साथ एम्बेडेड एनालिटिक्स को संरेखित करती हैं, जिससे अनुभव सीमित होने के बजाय देशी लगता है।

थीम JSON संरचना

पावर बीआई थीम को रंग, फ़ॉन्ट, विज़ुअल डिफ़ॉल्ट और तत्व स्टाइल पर नियंत्रण के साथ JSON फ़ाइलों के रूप में परिभाषित किया गया है:

{
    "name": "MyApp Theme",
    "dataColors": [
        "#2563EB", "#7C3AED", "#059669", "#D97706",
        "#DC2626", "#0891B2", "#4F46E5", "#65A30D"
    ],
    "background": "#FFFFFF",
    "foreground": "#1E293B",
    "tableAccent": "#2563EB",
    "textClasses": {
        "callout": {
            "fontSize": 28,
            "fontFace": "Inter, sans-serif",
            "color": "#0F172A"
        },
        "title": {
            "fontSize": 14,
            "fontFace": "Inter, sans-serif",
            "color": "#1E293B"
        },
        "header": {
            "fontSize": 12,
            "fontFace": "Inter, sans-serif",
            "color": "#475569"
        },
        "label": {
            "fontSize": 11,
            "fontFace": "Inter, sans-serif",
            "color": "#64748B"
        }
    },
    "visualStyles": {
        "*": {
            "*": {
                "border": [{
                    "color": {"solid": {"color": "#E2E8F0"}},
                    "radius": 8
                }],
                "background": [{
                    "color": {"solid": {"color": "#FFFFFF"}},
                    "transparency": 0
                }]
            }
        }
    }
}

थीम्स को प्रोग्रामेटिक रूप से लागू करना

थीम को एम्बेड समय पर लागू किया जा सकता है या गतिशील रूप से स्विच किया जा सकता है (डार्क मोड समर्थन के लिए उपयोगी):

// Apply theme at embed time
const embedConfig = {
    // ... standard config
    theme: { themeJson: customThemeJson }
};

// Switch theme dynamically (e.g., light/dark mode toggle)
await report.applyTheme({ themeJson: darkThemeJson });

पावर बीआई क्रोम छिपाना

पूरी तरह से मूल स्वरूप के लिए, Power BI के अंतर्निहित UI तत्वों को छिपाएँ और उन्हें अपने स्वयं के एप्लिकेशन नियंत्रणों से बदलें:

const settings = {
    panes: {
        filters: { visible: false },      // Hide filter pane
        pageNavigation: { visible: false } // Hide page tabs
    },
    bars: {
        actionBar: { visible: false },     // Hide action bar
        statusBar: { visible: false }      // Hide status bar
    },
    background: pbi.models.BackgroundType.Transparent,
    visualRenderedEvents: true
};

फिर अपने एप्लिकेशन के यूआई फ्रेमवर्क में कस्टम नेविगेशन, फ़िल्टरिंग और निर्यात नियंत्रण बनाएं। जब उपयोगकर्ता आपके कस्टम नियंत्रणों के साथ इंटरैक्ट करते हैं तो प्रोग्रामेटिक रूप से फ़िल्टर लागू करने, पेज बदलने और निर्यात को ट्रिगर करने के लिए जावास्क्रिप्ट एसडीके का उपयोग करें।

इस दृष्टिकोण के लिए अधिक विकास प्रयास की आवश्यकता होती है लेकिन यह एक सहज अनुभव उत्पन्न करता है जहां उपयोगकर्ता आपके एप्लिकेशन की मूल सुविधाओं और एम्बेडेड पावर बीआई सामग्री के बीच अंतर नहीं कर सकते हैं।

---

एंबेडेड के लिए प्रदर्शन अनुकूलन

फ्रंटएंड प्रदर्शन

• एसडीके को लोड करने में लापरवाही। पावर बीआई जावास्क्रिप्ट एसडीके लगभग 300KB है। इसे एसिंक्रोनस रूप से लोड करें और केवल तभी लोड करें जब उपयोगकर्ता किसी एनालिटिक्स पेज पर नेविगेट करता है।
• एम्बेड टोकन प्रीलोड करें। उपयोगकर्ता द्वारा रिपोर्ट का अनुरोध करने से पहले एम्बेड टोकन जेनरेट करें। यदि आपका एप्लिकेशन जानता है कि उपयोगकर्ता एनालिटिक्स (नेविगेशन पैटर्न के आधार पर) देखेगा, तो पेज ट्रांज़िशन के दौरान टोकन प्रीलोड करें।
• बूटस्ट्रैप एम्बेडिंग का उपयोग करें। एसडीके एक बूटस्ट्रैप पैटर्न का समर्थन करता है जो एम्बेड टोकन उपलब्ध होने से पहले आईफ्रेम को प्रारंभ करता है, जिससे कथित लोड समय 200-500ms तक कम हो जाता है।

// Bootstrap first (fast — creates iframe immediately)
const report = powerbi.bootstrap(container, { type: 'report' });

// Load later when token is available
const embedConfig = { /* full config */ };
report.load(embedConfig);

• रिपोर्ट कैशिंग लागू करें। एक बार रिपोर्ट लोड होने के बाद, आईफ्रेम इसे मेमोरी में बनाए रखता है। यदि उपयोगकर्ता दूर चला जाता है और वापस लौटता है, तो पुनः एम्बेड करने के बजाय मौजूदा आईफ्रेम का पुन: उपयोग करें। इससे एक ही सत्र के भीतर वापसी विज़िट के लिए लोड समय पूरी तरह समाप्त हो जाता है।

बैकएंड प्रदर्शन

• कैश एंबेड टोकन। एंबेड टोकन अपने पूरे जीवनकाल (डिफ़ॉल्ट 1 घंटे) के लिए वैध हैं। उन्हें रेडिस या इन-मेमोरी में कैश करें और समान रिपोर्ट/पहचान संयोजन के लिए अनुरोधों में पुन: उपयोग करें।
• बैच टोकन जेनरेशन। यदि किसी उपयोगकर्ता के डैशबोर्ड में कई एम्बेडेड रिपोर्ट हैं, तो जेनरेटटोकन एंडपॉइंट की बहु-संसाधन क्षमता का उपयोग करके एक ही एपीआई कॉल में सभी एम्बेड टोकन जेनरेट करें।
• एपीआई दर सीमा की निगरानी करें। पावर बीआई रेस्ट एपीआई में प्रति सेवा प्रिंसिपल दर सीमा है। 429 प्रतिक्रियाओं की निगरानी करें और घातीय बैकऑफ़ लागू करें। उच्च-स्तरीय अनुप्रयोगों के लिए, कई सेवा प्रिंसिपलों में लोड वितरित करें।

एंबेडेड के लिए रिपोर्ट डिज़ाइन

एम्बेडेड उपभोग के लिए डिज़ाइन की गई रिपोर्ट में दृश्य जटिलता पर प्रदर्शन को प्राथमिकता दी जानी चाहिए:

• दृश्यों को प्रति पृष्ठ 8-12 तक सीमित करें (प्रत्येक दृश्य एक अलग क्वेरी उत्पन्न करता है)
• जब संभव हो तो DirectQuery के बजाय आयात मोड का उपयोग करें (10-100x तेज़)
• उचित ग्रैन्युलैरिटी पर डेटा को पूर्व-एकत्रित करें
• लैंडिंग पृष्ठों पर जटिल DAX उपायों से बचें (ड्रिल-थ्रू विवरण के लिए उन्हें सहेजें)
• गतिशील गणनाओं के बजाय पूर्व-गणना किए गए दृश्यों के लिए बुकमार्क का उपयोग करें
• परीक्षण रिपोर्ट लोड समय आपके अपेक्षित समवर्ती स्तर पर, न कि केवल एकल-उपयोगकर्ता पर

एम्बेडेड एनालिटिक्स को लागू करने वाले संगठनों के लिए, ECOSIRE पहले दिन से इष्टतम प्रदर्शन सुनिश्चित करने के लिए [आर्किटेक्चर परामर्श और विकास सेवाएं] (/services/powerbi/embedded-analytics) प्रदान करता है।

---

एंबेडेड के लिए सुरक्षा संबंधी विचार

टोकन सुरक्षा

एंबेड टोकन Power BI सामग्री तक पहुंच प्रदान करते हैं। उन्हें संवेदनशील क्रेडेंशियल्स के रूप में मानें:

• क्लाइंट-साइड सोर्स कोड या यूआरएल पैरामीटर में एम्बेड टोकन को कभी भी उजागर न करें
• टोकन सर्वर-साइड जेनरेट करें और उन्हें प्रमाणित एपीआई एंडपॉइंट के माध्यम से वितरित करें
• सबसे कम व्यावहारिक टोकन जीवनकाल का उपयोग करें (अधिकांश अनुप्रयोगों के लिए डिफ़ॉल्ट 1 घंटा उचित है)
• लंबे समय तक चलने वाले टोकन उत्पन्न करने के बजाय टोकन ताज़ा तर्क लागू करें
• विसंगतियों के लिए टोकन जेनरेशन पैटर्न की निगरानी करें (असामान्य मात्रा, अप्रत्याशित रिपोर्ट आईडी)

किरायेदार अलगाव सत्यापन

बहु-किरायेदार अनुप्रयोगों के लिए, किरायेदार अलगाव को लगातार मान्य करें:

• स्वचालित परीक्षण जो किरायेदार ए के लिए एम्बेड टोकन उत्पन्न करते हैं और सत्यापित करते हैं कि किरायेदार बी का डेटा पहुंच योग्य नहीं है
• क्रॉस-टेनेंट डेटा एक्सेस प्रयासों का पता लगाने के लिए क्वेरी लॉगिंग
• नियमित आरएलएस कॉन्फ़िगरेशन ऑडिट (आरएलएस भूमिकाओं को पावर बीआई डेस्कटॉप में संशोधित किया जा सकता है और गलती से कमजोर किया जा सकता है)
• आरएलएस फ़िल्टर त्रुटियों पर चेतावनी (जो गलत कॉन्फ़िगरेशन का संकेत दे सकती है)

नेटवर्क सुरक्षा

• Azure AD कंडीशनल एक्सेस का उपयोग करके ज्ञात IP श्रेणियों तक Power BI REST API एक्सेस को प्रतिबंधित करें
• ऑन-प्रिमाइसेस डेटा स्रोतों के गेटवे कनेक्शन के लिए निजी एंडपॉइंट का उपयोग करें
• सभी एपीआई कॉल को ट्रैक करने और टोकन जेनरेशन को एम्बेड करने के लिए पावर बीआई एडमिन पोर्टल में ऑडिट लॉगिंग सक्षम करें
• अपने एप्लिकेशन के डोमेन पर आईफ्रेम एम्बेडिंग को प्रतिबंधित करने के लिए सामग्री सुरक्षा नीति हेडर लागू करें

---

अक्सर पूछे जाने वाले प्रश्न

10,000 उपयोगकर्ताओं वाले SaaS एप्लिकेशन के लिए Power BI एंबेडेड की लागत कितनी है?

लागत समवर्ती उपयोगकर्ताओं पर निर्भर करती है, न कि कुल उपयोगकर्ताओं पर। यदि आपके 10,000 उपयोगकर्ताओं में से 5% चरम पर समवर्ती (500 समवर्ती उपयोगकर्ता) हैं, तो आपको लगभग $8,200 प्रति माह (जैसे-जैसे भुगतान करें) पर लगभग F32 क्षमता की आवश्यकता होगी। आरक्षण (1-वर्ष की प्रतिबद्धता) के साथ, यह घटकर लगभग $5,500 प्रति माह हो जाता है। रिपोर्ट की जटिलता, डेटासेट आकार और उपयोग पैटर्न के आधार पर आपकी वास्तविक लागत अधिक या कम हो सकती है। पायलट के लिए F8 से प्रारंभ करें, यथार्थवादी संगामिति के साथ लोड परीक्षण और वास्तविक माप के आधार पर स्केल करें।

क्या मैं Azure के बिना Power BI एंबेडेड का उपयोग कर सकता हूँ?

पावर बीआई एंबेडेड को प्रमाणीकरण के लिए Azure AD की आवश्यकता होती है और Azure के माध्यम से फ़ैब्रिक/एंबेडेड क्षमता का प्रावधान किया जाता है। आपका एप्लिकेशन स्वयं कहीं भी होस्ट किया जा सकता है (AWS, GCP, ऑन-प्रिमाइसेस), लेकिन Power BI संसाधन Azure में होने चाहिए। सेवा प्रिंसिपल या मास्टर उपयोगकर्ता खाता Azure AD में होना चाहिए, और क्षमता Azure संसाधन होनी चाहिए। ऐसे संगठनों के लिए जिनके पास कोई मौजूदा Azure फ़ुटप्रिंट नहीं है, सेटअप लगभग 2-4 घंटे का Azure कॉन्फ़िगरेशन कार्य और क्षमता से परे न्यूनतम चल रहा Azure प्रबंधन जोड़ता है।

पावर बीआई एंबेडेड ए एसकेयू, ईएम एसकेयू और फैब्रिक एफ एसकेयू के बीच क्या अंतर है?

SKU मूल Power BI एंबेडेड क्षमता थी, जिसे Azure के माध्यम से प्रावधानित किया गया था। EM SKU, Office 365 के साथ आंतरिक एम्बेडिंग के लिए एक लाइसेंसिंग विकल्प थे। दोनों को फैब्रिक F SKU द्वारा प्रतिस्थापित किया गया है, जो सभी पावर BI और फैब्रिक वर्कलोड के लिए एक एकीकृत क्षमता मॉडल प्रदान करते हैं। एफ एसकेयू प्रति सेकंड बिलिंग, रोकें/फिर से शुरू करने की क्षमता और एक सरल मूल्य निर्धारण संरचना प्रदान करते हैं। नए कार्यान्वयन के लिए, विशेष रूप से F SKU का उपयोग करें। मौजूदा ए एसकेयू ग्राहकों को बेहतर मूल्य निर्धारण और क्षमताओं के लिए एफ एसकेयू में प्रवास की योजना बनानी चाहिए।

क्या उपयोगकर्ता एम्बेडेड रिपोर्ट से डेटा निर्यात कर सकते हैं?

हां, लेकिन आप इसे एम्बेड सेटिंग्स के माध्यम से नियंत्रित करते हैं। जावास्क्रिप्ट एसडीके आपको प्रति रिपोर्ट निर्यात क्षमताओं (एक्सेल, पीडीएफ, पावरपॉइंट पर निर्यात) को सक्षम या अक्षम करने की अनुमति देता है। आप एक्सपोर्ट एपीआई के माध्यम से कस्टम निर्यात कार्यक्षमता को भी लागू कर सकते हैं, जो आपको प्रारूप, लागू फ़िल्टर और ऑडिट लॉगिंग पर अधिक नियंत्रण देता है। संवेदनशील डेटा के लिए, अंतर्निहित निर्यात अक्षम करें और अपना स्वयं का निर्यात तंत्र प्रदान करें जो अतिरिक्त प्राधिकरण जांच और वॉटरमार्किंग लागू करता है।

मैं एम्बेडेड परिदृश्य में रिपोर्ट विकास को कैसे प्रबंधित करूं?

रिपोर्ट विकास मानक पावर बीआई वर्कफ़्लो का पालन करता है: पावर बीआई डेस्कटॉप में रिपोर्ट बनाएं, विकास कार्यक्षेत्र में प्रकाशित करें, नमूना एम्बेड टोकन के साथ परीक्षण करें, तैनाती पाइपलाइनों के माध्यम से उत्पादन को बढ़ावा दें। मुख्य अंतर यह है कि एम्बेडेड रिपोर्टों को आरएलएस व्यवहार, समवर्ती के तहत प्रदर्शन, स्क्रीन आकारों में उत्तरदायी लेआउट और आपके एप्लिकेशन के यूआई के साथ इंटरैक्शन के लिए अतिरिक्त परीक्षण की आवश्यकता होती है। एक सीआई/सीडी पाइपलाइन स्थापित करें जिसमें प्रत्येक रिपोर्ट परिनियोजन के हिस्से के रूप में स्वचालित आरएलएस सत्यापन और प्रदर्शन प्रतिगमन परीक्षण शामिल हो।