Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Plugin-programmet dax_request kör en DAX-fråga (Data Analysis Expressions) mot en Power BI semantisk modell och returnerar resultatet som en tabell. Bearbeta den returnerade tabellen med KQL-standardoperatorer (Kusto Query Language). Anropa plugin-programmet med utvärdera-operatorn.
Plugin-programmet använder api:et Power BI Kör DAX-frågor, vilket returnerar resultat i Apache Arrow-format. Plugin-programmet bevarar kolumntyper som stöds när svaret konverteras till en KQL-tabell.
Note
Plugin-programmet dax_request är i förhandsversion.
Prerequisites
- Semantikmodellen måste finnas i en arbetsyta som tilldelats en Fabric eller Power BI Premium-kapacitet.
- Rest-API:et För datauppsättningen Kör frågor, Tillåt XMLA-slutpunkter och Analysera i Excel med lokala semantiska modeller måste klientinställningarna vara aktiverade.
- Du måste ha behörighet att skapa och läsa för den semantiska modellen.
-
Klustrets pratbubblans princip måste tillåta
daxpratbubblar tillapi.powerbi.com. Om du vill ändra den här principen behöverAllDatabasesAdmindu ellerOpsbehörigheter.
Syntax
evaluate
dax_request
(
ConnectionString,DaxQuery) [:OutputSchema]
Läs mer om syntaxkonventioner i syntaxkonventionerna för referensdokumentation.
Parameters
| Name | Type | Obligatoriskt | Description |
|---|---|---|---|
| Anslutningssträng | string |
Yes | Url:en för den semantiska modellen följt av ;Impersonate. De URL-format som stöds finns i Anslutningssträng. |
| DaxQuery | string |
Yes | DAX-frågan som ska köras mot den semantiska modellen. |
| OutputSchema | - | - | Namn och typer av förväntade utdatakolumner. Använd syntaxen (ColumnName:ColumnType [, ...]). |
Note
Du rekommenderas att ange OutputSchema . Det gör att Kusto kan fastställa plugin-programmets utdatakolumner och typer utan att skicka DAX-frågan till Power BI under schemaidentifieringen. Den Power BI begäran skjuts i stället upp till frågekörning, tillsammans med resten av KQL-frågan. Plugin-programmet returnerar ett fel om det returnerade schemat inte är kompatibelt med det deklarerade schemat.
Anslutningssträng
Connection string består av url:en för semantikmodellen och autentiseringsdirektivet;Impersonate. Använd ett av följande format:
Semantisk modell på en arbetsyta:
https://api.powerbi.com/v1.0/myorg/groups/WorkspaceId/datasets/SemanticModelId;ImpersonateSemantisk modell i Min arbetsyta:
https://api.powerbi.com/v1.0/myorg/datasets/SemanticModelId;Impersonate
Sökvägssegmentet myorg är literalt.
*WorkspaceId* och *SemanticModelId* måste vara globalt unika identifierare (GUID). Inkludera inte en frågesträng, fragment eller avslutande sökväg efter SemanticModelId.
Autentisering och auktorisering
Plugin-programmet använder Microsoft Entra för autentisering. Motorn hämtar en token för den begärande användaren och skickar DAX-frågan i användarens säkerhetskontext. Användaren måste ha behörighet att skapa och läsa för semantikmodellen. Säkerhet på radnivå eller säkerhet på objektnivå som konfigurerats för användaren gäller för frågan.
Använd ;Impersonate som autentiseringsdirektiv. Hanterad identitet, tjänstens huvudnamn och programnyckelautentisering stöds inte.
Important
Använd en fördunklat strängliteral för alla strängar som innehåller konfidentiell information. Fördunklade värden visas inte i Kusto-spårning.
Konfigurera och pratbubblans princip
Plugin-programmet gör ett externt anrop till Power BI. Eftersom standardpolicyn för pratbubblan blockerar dax pratbubblar måste en klusteradministratör uttryckligen tillåta Power BI slutpunkten.
Följande kommando sammanfogar en restriktiv dax regel i den befintliga klusterpolicyn för pratbubblan:
.alter-merge cluster policy callout @'[{
"CalloutType": "dax",
"CalloutUriRegex": "api\\.powerbi\\.com.*",
"CanCall": true
}]'
Verifiera principen:
.show cluster policy callout
Returns
Plugin-programmet returnerar DAX-frågeresultatet som en KQL-tabell. Den bevarar pildatatyper som stöds. Till exempel mappas värdena Arrow , , och till Kusto long, real, stringrespektive datetime.date-timeutf8doubleint64
Power BI returnerar hakparenteserade kolumnnamn, till exempel [Category]. I KQL refererar du till dessa namn med syntaxen ['...'] , till exempel ['[Category]'].
Varning
Plugin-programmet använder standardradgränsen för Power BI Köra DAX-fråge-API (resultSetRowCountLimit). Om DAX-frågan genererar fler rader än den här gränsen kan den returnerade tabellen vara ofullständig utan ett fel. Filtrera eller aggregera data i DAX-frågan för att hålla resultatet inom gränsen. Filtrering eller aggregering efteråt i KQL återställer inte utelämnade rader.
Examples
Returnera alla rader från en tabell
Följande exempel frågar tabellen Sales . Det returnerade resultatet omfattas av API:ets standardgräns för rad.
evaluate dax_request(
'https://api.powerbi.com/v1.0/myorg/groups/<workspace-id>/datasets/<semantic-model-id>;Impersonate',
'EVALUATE Sales')
Bearbeta DAX-resultat med Kusto
I följande exempel väljs två kolumner i DAX, resultatet sammanfattas i KQL och filtreras efter kategori:
evaluate dax_request(
'https://api.powerbi.com/v1.0/myorg/groups/<workspace-id>/datasets/<semantic-model-id>;Impersonate',
'EVALUATE SELECTCOLUMNS(Sales, "Category", Sales[Category], "Amount", Sales[Amount])')
| summarize TotalAmount = sum(['[Amount]']) by ['[Category]']
| where ['[Category]'] == 'Electronics'
Tip
Filtrera och aggregera data i DAX när det är möjligt för att minska mängden data som returneras till Kusto.
Ange ett utdataschema
I följande exempel deklareras det förväntade utdataschemat så att Kusto kan fastställa schemat utan att kontakta Power BI under frågeanalysen. Det deklarerade schemat måste matcha liveresultatschemat.
evaluate dax_request(
'https://api.powerbi.com/v1.0/myorg/groups/<workspace-id>/datasets/<semantic-model-id>;Impersonate',
'EVALUATE ROW("cnt", COUNTROWS(Sales), "sumAmt", SUM(Sales[Amount]))')
: (['[cnt]']:long, ['[sumAmt]']:real)
Troubleshooting
| Error | Orsak och lösning |
|---|---|
| Ogiltigt reťazec pripojenia | Bekräfta att URL:en använder ett format som stöds, att arbetsytan och semantiska modell-ID:erna är giltiga GUID:er och att strängen slutar med ;Impersonate. |
| Pratbubblan är inte tillåten | Konfigurera klustrets pratbubblans princip för att tillåta dax anrop till api.powerbi.com. |
| Autentiserings- eller auktoriseringsfel | Bekräfta att de nödvändiga klientinställningarna är aktiverade och att den begärande användaren har behörigheten Skapa och läsa för semantikmodellen. |
| HTTP-förfrågningsfel | Se till att služba Power BI tillgänglighet, slutpunktstillgänglighet och url för semantisk modell. |