Riešenie problémov s pripojením koncového bodu XMLATroubleshoot XMLA endpoint connectivity

Prístup koncových bodov XMLA k množinám údajov služby Power BI v službe Power BI Premium závisí od natívneho komunikačného protokolu služby Analysis Services.XMLA endpoints in Power BI Premium rely on the native Analysis Services communication protocol for access to Power BI datasets. Z tohto dôvodu je riešenie problémov s koncovými bodmi XMLA približne rovnaké ako riešenie problémov s typickým pripojením služby Analysis Services.Because of this, XMLA endpoint troubleshooting is much the same as troubleshooting a typical Analysis Services connection. Existujú však určité rozdiely v závislostiach špecifických pre službu Power BI.However, some differences around Power BI-specific dependencies apply.

Skôr než začneteBefore you begin

Predtým než začnete so scenárom riešenia problémov s koncovým bodom XMLA, uistite sa, že ste sa oboznámili so základnými informáciami uvedenými v téme Prepojenie množiny údajov s koncovým bodom XMLA.Before troubleshooting an XMLA endpoint scenario, be sure to review the basics covered in Dataset connectivity with the XMLA endpoint. Uvádzajú sa v nej najbežnejšie prípady použitia koncového bodu XMLA.Most common XMLA endpoint use cases are covered there. Užitočné môžu byť aj ďalšie príručky na riešenie problémov v službe Power BI, napríklad Riešenie problémov s bránami – Power BI a Riešenie problémov s analyzovaním v Exceli.Other Power BI troubleshooting guides, such as Troubleshoot gateways - Power BI and Troubleshooting Analyze in Excel, can also be helpful.

Povolenie koncového bodu XMLAEnabling the XMLA endpoint

Koncový bod XMLA je možné povoliť v kapacitách Power BI Premium aj Power BI Embedded.The XMLA endpoint can be enabled on both Power BI Premium and Power BI Embedded capacities. Pri menších kapacitách, ako je napríklad kapacita A1 s veľkosťou pamäte iba 2,5 GB, sa môžu vyskytnúť chyby v časti Nastavenia kapacity, keď sa budete pokúšať nastaviť koncový bod XMLA na čítanie a zápis a následne vyberiete položku Použiť.On smaller capacities, such as an A1 capacity with only 2.5 GB of memory, you might encounter an error in Capacity settings when trying to set the XMLA Endpoint to Read/Write and then selecting Apply. V chybe sa uvádza: „Vyskytol sa problém s nastavením vyťaženia.The error states "There was an issue with your workload settings. Skúste to znova o chvíľu.“Try again in a little while.".

Môžete vyskúšať niektorý z týchto postupov:Here are a couple things to try:

  • Obmedzte spotrebu pamäte iných služieb v kapacite, ako napríklad Toky údajov, na hodnotu 40 % alebo menej, alebo niektorú nepotrebnú službu úplne zakážte.Limit the memory consumption of other services on the capacity, such as Dataflows, to 40% or less, or disable an unnecessary service completely.
  • Inovujte kapacitu na väčšiu skladovú jednotku SKU.Upgrade the capacity to a larger SKU. Inovácia kapacity z A1 na A3 napríklad vyrieši tento problém s konfiguráciou bez potreby zakázať Toky údajov.For example, upgrading from an A1 to an A3 capacity solves this configuration issue without having to disable Dataflows.

Nezabudnite, že tiež treba povoliť nastavenie Exportovať údaje na úrovni nájomníka na portáli na správu služby Power BI.Keep in-mind, you must also enable the tenant-level Export data setting in the Power BI Admin Portal. Toto nastavenie sa vyžaduje aj pre funkciu Analyzovať v Exceli.This setting is also required for the Analyze in Excel feature.

Vytvorenie spojenia s klientomEstablishing a client connection

Po povolení koncového bodu XMLA je vhodné otestovať pripojiteľnosť k pracovnému priestoru v kapacite.After enabling the XMLA endpoint, it's a good idea to test connectivity to a workspace on the capacity. Ak chcete získať ďalšie informácie, pozrite si tému Pripojenie k pracovnému priestoru Premium.To learn more, see Connecting to a Premium workspace. Nezabudnite si tiež prečítať časť Požiadavky na pripojenie, kde získate užitočné tipy a informácie o aktuálnych obmedzeniach pripojiteľnosti XMLA.Also, be sure to read the section Connection requirements for helpful tips and information about current XMLA connectivity limitations.

Pripojenie k objektu službyConnecting with a service principal

Ak ste už povolili v nastaveniach nájomníka, aby objekty služieb mohli používať rozhrania API služby Power BI, ako je to popísané v časti Povolenie objektov služby, môžete sa pripojiť pomocou objektu služby ku koncovému bodu XMLA.If you've enabled tenant settings to allow service principals to use Power BI APIs, as described in Enable service principals, you can connect to an XMLA endpoint by using a service principal. Nezabudnite, že objekt služby si vyžaduje tú istú úroveň povolení prístupu na úrovni pracovného priestoru alebo množiny údajov ako bežní používatelia.Keep in mind the service principal requires the same level of access permissions at the workspace or dataset level as regular users.

Ak chcete použiť objekt služby, nezabudnite do reťazca pripojenia zadať informácie o identite aplikácie:To use a service principal, be sure to specify the application identity information in the connection string as:

  • User ID=<app:appid@tenantid>
  • Password=<application secret>

Príklad:For example:

Data Source=powerbi://api.powerbi.com/v1.0/myorg/Contoso;Initial Catalog=PowerBI_Dataset;User ID=app:91ab91bb-6b32-4f6d-8bbc-97a0f9f8906b@19373176-316e-4dc7-834c-328902628ad4;Password=6drX...;

Ak sa zobrazí nasledujúca chyba:If you receive the following error:

„Nie je možné pripojiť sa k množine údajov pre neúplné informácie o konte."We cannot connect to the dataset due to incomplete account information. Pri objektoch služby sa uistite, že ste zadali ID nájomníka spolu s ID aplikácie s použitím naformátovanej aplikácie: <appId>@<tenantId>, a skúste to znova.“For service principals, make sure you specify the tenant ID together with the app ID using the format app:<appId>@<tenantId>, then try again."

Uistite sa, že ste zadali ID nájomníka spolu s ID aplikácie a s použitím správneho formátu.Make sure you specify the tenant ID together with the app ID using the correct format.

Vhodné je tiež zadať ID aplikácie bez ID nájomníka.It's also valid to specify the app ID without the tenant ID. V tomto prípade však musíte nahradiť alias myorg v URL adrese zdroja údajov skutočným ID nájomníka.However, in this case, you must replace the myorg alias in the data source URL with the actual tenant ID. Služba Power BI môže potom vyhľadať objekt služby v správnom nájomníkovi.Power BI can then locate the service principal in the correct tenant. Najvhodnejším postupom je použiť alias myorg a zadať ID nájomníka spolu s ID aplikácie v parametri ID používateľa.But, as a best practice, use the myorg alias and specify the tenant ID together with the app ID in the User ID parameter.

Prepojenie s Azure Active Directory B2BConnecting with Azure Active Directory B2B

Vďaka podpore pre Azure Active Directory (Azure AD) Business-to-business (B2B) v službe Power BI, môžete externým hosťovským používateľom umožniť prístup k množinám údajov v koncovom bode XMLA.With support for Azure Active Directory (Azure AD) business-to-business (B2B) in Power BI, you can provide external guest users with access to datasets over the XMLA endpoint. Uistite sa, že nastavenie Zdieľanie obsahu s externými používateľmi je na portáli na správu služby Power BI povolené.Make sure the Share content with external users setting is enabled in the Power BI Admin portal. Ak chcete získať ďalšie informácie, pozrite si tému Distribúcia obsahu služby Power BI externým hosťom s Azure AD B2B.To learn more, see Distribute Power BI content to external guest users with Azure AD B2B.

Nasadenie množiny údajovDeploying a dataset

Projekt tabuľkového modelu vo Visual Studio (SSDT) môžete nasadiť do pracovného priestoru Power BI Premium v podstate rovnako ako do služby Azure Analysis Services.You can deploy a tabular model project in Visual Studio (SSDT) to a Power BI Premium workspace much the same as to Azure Analysis Services. Pri nasadzovaní do pracovného priestoru Power BI Premium však musíte zvážiť aj ďalšie dôležité aspekty.However, when deploying to a Power BI Premium workspace, there are some additional considerations. Nezabudnite si prečítať časť Nasadenie projektov modelu z Visual Studia (SSDT) v článku Prepojenie množiny údajov s koncovým bodom XMLA.Be sure to review the section Deploy model projects from Visual Studio (SSDT) in the Dataset connectivity with the XMLA endpoint article.

Nasadenie nového modeluDeploying a new model

V predvolenej konfigurácii sa Visual Studio pokúša spracovať model ako súčasť operácie nasadenia a načítať údaje zo zdrojov údajov do množiny údajov.In the default configuration, Visual Studio attempts to process the model as part of the deployment operation to load data into the dataset from the data sources. Ako je to popísané v časti Nasadenie projektov modelu z Visual Studia (SSDT), táto operácia môže zlyhať, pretože prihlasovacie údaje zdroja údajov nie je možné zadať ako súčasť operácie nasadenia.As described in Deploy model projects from Visual Studio (SSDT), this operation can fail because data source credentials cannot be specified as part of the deployment operation. Naopak, ak prihlasovacie údaje pre váš zdroj údajov ešte nie sú definované pre žiadnu z existujúcich množín údajov, musíte zadať prihlasovacie údaje zdroja údajov do nastavení množiny údajov pomocou používateľského rozhrania služby Power BI (Množiny údajov > Nastavenia > Poverenia zdroja údajov > Upraviť poverenia).Instead, if credentials for your data source aren't already defined for any of your existing datasets, you must specify the data source credentials in the dataset settings using the Power BI user interface (Datasets > Settings > Data source credentials > Edit credentials). Po definovaní prihlasovacích údajov zdroja údajov môže potom Power BI automaticky použiť tieto prihlasovacie údaje pre daný zdroj údajov pre akúkoľvek novú množinu údajov v prípade úspešného nasadenia metaúdajov a vytvorenia množiny údajov.Having defined the data source credentials, Power BI can then apply the credentials to this data source automatically for any new dataset, after metadata deployment has succeeded and the dataset has been created.

Ak služba Power BI nedokáže previazať vašu novú množinu údajov s prihlasovacími údajmi zdroja údajov, zobrazí sa chyba s informáciou: „Databázu nie je možné spracovať.If Power BI cannot bind your new dataset to data source credentials, you will receive an error stating "Cannot process database. Dôvod: Úpravy sa nepodarilo uložiť na serveri.“Reason: Failed to save modifications to the server." s kódom chyby „DMTS_DatasourceHasNoCredentialError“ ako je zobrazené nižšie:with the error code "DMTS_DatasourceHasNoCredentialError", as shown below:

Chyba nasadenia modelu

Ak sa chcete vyhnúť zlyhaniu spracovania, nastavte Možnosti nasadenia > Možnosti spracovania na Nespracovať, ako je znázornené na nasledujúcom obrázku.To avoid the processing failure, set the Deployment Options > Processing Options to Do not Process, as shown in the following image. Visual Studio potom nasadí iba metaúdaje.Visual Studio then deploys only metadata. Následne môžete v používateľskom rozhraní služby Power BI nakonfigurovať prihlasovacie údaje zdroja údajov a kliknúť na položku Obnoviť pre množinu údajov.You can then configure the data source credentials, and click on Refresh now for the dataset in the Power BI user interface. Informácie o riešení problémov pri spracovávaní údajov nájdete neskôr v tomto článku v časti Obnovenie množiny údajov.For information about troubleshooting processing issues, see the section Refreshing a dataset later in this article.

Možnosť Nespracovať

Nový projekt z existujúcej množiny údajovNew project from an existing dataset

Vytvorenie nového tabuľkového projektu vo Visual Studiu importovaním metaúdajov z existujúcej množiny údajov v pracovnom priestore Power BI Premium sa nepodporuje.Creating a new tabular project in Visual Studio by importing the metadata from an existing dataset on a Power BI Premium workspace is not supported. Môžete sa však pripojiť k množine údajov pomocou nástroja SQL Server Management Studio, skriptovať metaúdaje a znova ich použiť v iných tabuľkových projektoch.However, you can connect to the dataset by using SQL Server Management Studio, script out the metadata, and reuse it in other tabular projects.

Migrácia množiny údajov do služby Power BIMigrating a dataset to Power BI

Pre tabuľkové modely sa odporúča zadať úroveň kompatibility 1 500 (alebo vyššiu).It's recommended you specify the 1500 (or higher) compatibility level for tabular models. Táto úroveň kompatibility podporuje väčšinu funkcií a typov zdrojov údajov.This compatibility level supports the most capabilities and data source types. Ďalšie úrovne kompatibility sú spätne kompatibilné s predchádzajúcimi úrovňami.Later compatibility levels are backwards compatible with earlier levels.

Podporovaní poskytovatelia údajovSupported data providers

Na úrovni kompatibility 1 500 podporuje služba Power BI nasledujúce typy zdrojov údajov:At the 1500 compatibility level, Power BI supports the following data source types:

  • Zdroje údajov poskytovateľa (staršia verzia s reťazcom pripojenia v metaúdajoch modelu).Provider data sources (legacy with a connection string in the model metadata).
  • Štruktúrované zdroje údajov (zavedené s úrovňou kompatibility 1 400).Structured data sources (introduced with the 1400 compatibility level).
  • Vnorené M deklarácie zdrojov údajov (ako ich deklaruje aplikácia Power BI Desktop).Inline M declarations of data sources (as Power BI Desktop declares them).

Odporúča sa používať štruktúrované zdroje údajov, ktoré Visual Studio predvolene vytvorí pri prechode cez tok údajov importu.It's recommended you use structured data sources, which Visual Studio creates by default when going through the Import data flow. Ak však plánujete migrovať do služby Power BI existujúci model, ktorý používa zdroj údajov poskytovateľa, uistite sa, či zdroj údajov závisí od podporovaného poskytovateľa údajov.However, if you are planning to migrate an existing model to Power BI that uses a provider data source, make sure the provider data source relies on a supported data provider. Konkrétne ide o ovládač Microsoft OLE DB pre server SQL Server a ostatné ovládače ODBC tretích strán.Specifically, the Microsoft OLE DB Driver for SQL Server and any third-party ODBC drivers. V prípade ovládača OLE DB pre server SQL Server musíte prepnúť definíciu zdroja údajov na poskytovateľa údajov rozhrania .Net Framework pre SQL Server.For OLE DB Driver for SQL Server, you must switch the data source definition to the .NET Framework Data Provider for SQL Server. Naopak, v prípade ovládačov ODBC tretích strán, ktoré môžu byť v službe Power BI nedostupné, musíte prepnúť na definíciu štruktúrovaného zdroja údajov.For third-party ODBC drivers that might be unavailable in the Power BI service, you must switch to a structured data source definition instead.

Rovnako sa odporúča v definíciách zdroja údajov servera SQL Server nahradiť zastaraný ovládač Microsoft OLE DB pre server SQL Server (SQLNCLI11) poskytovateľom údajov rozhrania .NET Framework pre SQL Server.It's also recommended you replace the outdated Microsoft OLE DB Driver for SQL Server (SQLNCLI11) in your SQL Server data source definitions with the .NET Framework Data Provider for SQL Server.

Nasledujúca tabuľka zobrazuje príklad toho, ako reťazec pripojenia poskytovateľa údajov rozhrania .NET Framework pre server SQL Server nahrádza zodpovedajúci reťazec pripojenia pre OLE DB pre server SQL Server.The following table provides an example of a .NET Framework Data Provider for SQL Server connection string replacing a corresponding connection string for the OLE DB Driver for SQL Server.

Ovládač OLE DB pre server SQL ServerOLE DB Driver for SQL Server Poskytovateľ údajov rozhrania .NET Framework pre server SQL Server.NET Framework Data Provider for SQL Server
Provider=SQLNCLI11;Data Source=sqldb.database.windows.net;Initial Catalog=AdventureWorksDW;Trusted_Connection=yes; Data Source=sqldb.database.windows.net;Initial Catalog=AdventureWorksDW2016;Integrated Security=SSPI;Encrypt=true;TrustServerCertificate=false

Krížové odkazy na zdroje oblastíCross-referencing partition sources

Rovnako ako existuje viacero typov zdroja údajov, existuje tiež viacero typov zdrojov oblastí, ktoré dokáže tabuľkový model zahrnúť pri importovaní údajov do tabuľky.Just as there are multiple data source types, there are also multiple partition source types a tabular model can include to import data into a table. Konkrétne môže oblasť použiť zdroj oblasti dotazu alebo zdroj oblasti M.Specifically, a partition can use a query partition source or an M partition source. Tieto typy zdroja oblasti môžu zasa odkazovať na zdroje údajov poskytovateľa alebo štruktúrované zdroje údajov.These partition source types, in turn, can reference provider data sources or structured data sources. Zatiaľ čo tabuľkové modely v službe Azure Analysis Services podporujú krížové odkazovanie na tieto rôzne zdroje údajov a typy oblastí, služba Power BI vynucuje prísnejší vzťah.While tabular models in Azure Analysis Services support cross-referencing these various data source and partition types, Power BI enforces a more strict relationship. Zdroje oblastí dotazu musia odkazovať na zdroje údajov poskytovateľa a zdroje oblastí M musia odkazovať na štruktúrované zdroje údajov.Query partition sources must reference provider data sources, and M partition sources must reference structured data sources. Iné kombinácie služba Power BI nepodporuje.Other combinations are not supported in Power BI. Ak chcete migrovať množinu údajov s krížovým odkazovaním, nasledujúca tabuľka popisuje podporované konfigurácie:If you want to migrate a cross-referencing dataset, the following table describes supported configurations:

Zdroj údajovData source Zdroj oblastiPartition source KomentáreComments Podporované v službe Power BI Premium s koncovým bodom XMLASupported in Power BI Premium with XMLA endpoint
Zdroj údajov poskytovateľaProvider data source Zdroj oblasti dotazuQuery partition source Nástroj AS používa na prístup k zdroju údajov zásobník na pripojenie vychádzajúci z kazety.The AS engine uses the cartridge-based connectivity stack to access the data source. ÁnoYes
Zdroj údajov poskytovateľaProvider data source Zdroj oblasti MM partition source Nástroj AS preloží zdroj údajov poskytovateľa do všeobecného štruktúrovaného zdroja údajov a následne použije nástroj Mashup na importovanie údajov.The AS engine translates the provider data source into a generic structured data source and then uses the Mashup engine to import the data. NieNo
Štruktúrovaný zdroj údajovStructured data source Zdroj oblasti dotazuQuery partition source Nástroj AS zalomí natívny dotaz v zdroji oblasti do výrazu M a následne použije nástroj Mashup na importovanie údajov.The AS engine wraps the native query on the partition source into an M expression and then uses the Mashup engine to import the data. NieNo
Štruktúrovaný zdroj údajovStructured data source Zdroj oblasti MM partition source Nástroj AS využíva nástroj Mashup na importovanie údajov.The AS engine uses the Mashup engine to import the data. ÁnoYes

Obnovenie množiny údajovRefreshing a dataset

Koncové body XMLA vám umožňujú vykonávať operácie obnovenia v tabuľkových modeloch, ako aj množinách údajov vytvorených v aplikácii Power BI Desktop.XMLA endpoints enable you to perform refresh operations against tabular models as well as datasets created in Power BI Desktop. Ak chcete dané množiny podporiť, uistite sa, že ste zadali nastavenie formátu rozšíreného ukladacieho priestoru.To support the latter, make sure you specify the Enhanced storage format setting. Toto nastavenie sa vyžaduje, ak chcete vykonať operácie spracovania alebo iné operácie čítania a zapisovania pomocou koncového bodu XMLA.This setting is required if you want to perform processing or other read/write operations by using the XMLA endpoint. Dané nastavenie nájdete v aplikácii Power BI Desktop v časti Funkcie verzie Preview.You can find the setting in Power BI Desktop under Preview features. Po nastavení znova publikujte svoje riešenie PBIX do pracovného priestoru Power BI Premium.After setting, publish your PBIX solution again to your Power BI Premium workspace.

Ak ste vykonali obnovenie prostredníctvom koncového bodu XMLA v modeli bez rozšírených metaúdajov, služba Power BI vráti nasledujúcu chybu: „Operácia je podporovaná iba v modeli s vlastnosťou DefaultPowerBIDataSourceVersion, ktorá je v službe Power BI Premium nastavená na hodnotu PowerBI_V3.“Power BI returns the following error if you perform a refresh via the XMLA endpoint against a model without enhanced metadata: "The operation is only supported on model with property 'DefaultPowerBIDataSourceVersion' set to 'PowerBI_V3' in Power BI Premium."

Zdroje údajov a zosobnenieData sources and impersonation

Nastavenia zosobnenia, ktoré môžete definovať pre zdroje údajov poskytovateľa, nie sú pre službu Power BI relevantné.Impersonation settings you can define for provider data sources are not relevant for Power BI. Služba Power BI používa na spravovanie prihlasovacích údajov zdroja údajov mechanizmus, ktorý je založený na nastaveniach množiny údajov.Power BI uses a different mechanism based on dataset settings to manage data source credentials. Ak vytvárate Zdroj údajov poskytovateľa, mali by ste sa uistiť, že vyberiete možnosť Konto služby.For this reason, make sure you select Service Account if you are creating a Provider Data Source.

Zosobnenie konta služby

Podrobné spracovanieFine-grained processing

Keď v službe Power BI spustíte plánované obnovenie alebo obnovenie na požiadanie, služba Power BI zvyčajne obnoví celú množinu údajov.When triggering a scheduled refresh or on-demand refresh in Power BI, Power BI typically refreshes the entire dataset. V mnohých prípadoch je oveľa efektívnejšie obnovenia selektovať.In many cases, it's more efficient to perform refreshes more selectively. V nástroji SQL Server Management Studio (SSMS) môžete vykonávať úlohy podrobného spracovania tak, ako je znázornené nižšie, alebo pomocou nástrojov či skriptov tretích strán.You can perform fine-grained processing tasks in SQL Server Management Studio (SSMS) as shown below, or by using third-party tools or scripts.

Spracovanie tabuliek v nástroji SSMS

Prepísania v príkaze Obnoviť TMSLOverrides in Refresh TMSL command

Prepísania v príkaze Obnoviť (TMSL) umožňujú používateľom vybrať inú definíciu dotazu na oblasť alebo definíciu zdroja údajov pre operáciu obnovenia.Overrides in Refresh command (TMSL) allow users choosing a different partition query definition or data source definition for the refresh operation. V súčasnosti sa prepísania nepodporujú v službe Power BI Premium.Currently, overrides are not supported in Power BI Premium. Vráti sa chyba Presahujúca väzba nie je v službe Power BI Premium povolená.An error, "Out-of-line binding is not allowed in Power BI Premium. Ďalšie informácie nájdete v dokumentácii produktu v časti XMLA – podpora na čítanieFor additional information, see 'XMLA read/write support' in the product documentation." a zapisovanie.is returned.

Pozri tiežSee also

Prepojenie množiny údajov s koncovým bodom XMLA Dataset connectivity with the XMLA endpoint
Automatizácia úloh pracovného priestoru a množiny údajov Premium pomocou objektov služby Automate Premium workspace and dataset tasks with service principals
Riešenie problémov s funkciou Analyzovať v Exceli Troubleshooting Analyze in Excel
Nasadenie riešenia tabuľkového modeluTabular model solution deployment