dax_request plugin-program

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 dax pratbubblar till api.powerbi.com. Om du vill ändra den här principen behöver AllDatabasesAdmin du eller Ops behö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;Impersonate

  • Semantisk 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.