Datasets - Execute Dax Queries

Führt Dax-Abfragen (Data Analysis Expressions) für das bereitgestellte Dataset aus. Das Dataset muss sich im Arbeitsbereich "Mein Arbeitsbereich" befinden. Die Antwort wird im Apache Arrow-Format zurückgegeben.

Berechtigungen oder Abfragefehler führen zu:

• Ein Antwortfehler, z XMLA endpoint feature is disabled. Turn on the tenant setting 'Allow XMLA endpoints and Analyze in Excel with on-premises semantic models' to enable this feature.. B. .
• Ein erfolgreicher HTTP-Statuscode (200) mit einem Datensatzbatch, der die Fehlerdetails enthält.

Erlaubnisse

Die REST-API zum Ausführen von Datasetausführungsabfragen, die unter "Integrationseinstellungen" zu finden ist, muss aktiviert sein.

Der Benutzer muss über Lese- und Buildberechtigungen für Datasets verfügen. Weitere Informationen finden Sie unter Verwalten von Zugriffsberechtigungen für Datasets.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Limitations

• Diese API wird nur von semantischen Modellen unterstützt, die mit der modernen Power BI-Dienst Infrastruktur kompatibel sind. Nicht unterstützte Kategorien umfassen:
  • Semantische Modelle im Administratorüberwachungsarbeitsbereich und Nutzungsmetrikenmodelle.
  • Semantische Modelle, die weiterhin die Kompatibilitätsstufe 1103 verwenden.
  • Semantische Modelle, die veraltete Features wie Pushsemantikmodelle, Modelle verwenden, die in der Power BI-Dienst aus CSV-Dateien oder Inhaltspaketen erstellt wurden.
• Datasets, die in Azure Analysis Services gehostet werden oder über eine Liveverbindung mit einem lokalen Azure Analysis Services-Modell verfügen, werden nicht unterstützt.
• Abfragebeschränkungen:
  • Eine Abfrage pro API-Aufruf, die Abfrage kann jedoch mehrere Auswertungsanweisungen aufweisen.
  • Die folgenden Grenzwerte gelten unabhängig vom abgefragten Semantikmodell:
    • Der globale Grenzwert beträgt 120 Abfrageanforderungen pro Minute pro Benutzer.
    • Power BI Pro und Premium Per User (PPU) sind auf 40 Abfrageanforderungen pro Minute pro Benutzer beschränkt.
  • Derzeit werden nur DAX-Abfragen und INFO-Funktionen unterstützt. MDX- und DMV-Abfragen werden nicht unterstützt.
• Einschränkungen für Dienstprinzipal und Identitätswechsel:
  • Um Dienstprinzipale zu verwenden, stellen Sie sicher, dass die Administratormandanteneinstellung "Dienstprinzipale zulassen" die Verwendung von Power BI-APIs unter "Entwicklereinstellungen " aktiviert ist. Weitere Informationen zu semantischen Modellen mit RLS finden Sie unter RLS-Einschränkungen.
  • Die effectiveUsername Eigenschaft kann nur von Benutzern verwendet werden, die Administratoren des Arbeitsbereichs sind, der das semantische Modell enthält.
  • Die roles Eigenschaft kann von Benutzern nur verwendet werden, wenn sie Mitglieder der angegebenen Rolle oder Administratoren des Arbeitsbereichs sind, der das semantische Modell enthält.
  • Dienstprinzipale können keine Rollenmitglieder sein. Ein Dienstprinzipal kann nur verwendet werden roles , wenn es sich um einen Administrator des Arbeitsbereichs handelt, der das semantische Modell enthält.

Antwortformat

Der Antworttext enthält mindestens einen verketteten Apache Arrow-IPC-Datenstrom. Jeder Datenstrom ist eigenständig mit eigenen Schema- und Datensatzbatches. Verwenden Sie zum Verarbeiten der Antwort eine Apache Arrow-Clientbibliothek .

Die Antwort kann die folgenden Rowsettypen enthalten, die durch Metadaten auf Schemaebene identifiziert werden (Schlüsselwertpaare im Pfeilschema):

• Daten-Rowset: Enthält Abfrageergebnisse. Keine speziellen Metadatenschlüssel. Spaltennamen und -typen werden von der DAX-Abfrage bestimmt.
• Fehler-Rowset: Identifiziert anhand IsError = true von Schemametadaten. Enthält Spalten: ErrorCode, , ErrorMessageErrorDescription, und Quellspeicherortfelder. Die Schemametadaten enthalten FaultCode auch (Hex-Fehlercode) und FaultString (Fehlermeldung).

Aufzeichnen von Batches in der Antwort verwenden LZ4_FRAME Komprimierung. Die Pyarrow-Bibliothek behandelt dies automatisch. Installieren Sie für .NET das Apache.Arrow.Compression NuGet-Paket.

Das folgende Python Beispiel zeigt, wie Daten mithilfe von pyarrow0 gelesen und auf Fehler überprüft werden:

import io
import pyarrow as pa

# response = requests.post(url, headers=headers, json=request_body)
stream = io.BytesIO(response.content)
results = []

while stream.tell() < len(response.content):
    try:
        reader = pa.ipc.open_stream(stream)
        table = reader.read_all()
        metadata = {
            k.decode(): v.decode()
            for k, v in (reader.schema.metadata or {}).items()
        }
        if metadata.get("IsError") == "true":
            raise RuntimeError(
                f"Query error [{metadata.get('FaultCode')}]: "
                f"{metadata.get('FaultString')}"
            )
        else:
            results.append(table)
    except pa.ArrowInvalid:
        break

print(results[0].to_pandas())

Verwenden Sie für .NET die klasse DaxQueryArrowResponseReader in diesem SDK, die die Datenstromanalyse, Fehlererkennung und LZ4-Dekomprimierung behandelt.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/executeDaxQueries

URI-Parameter

Anforderungstext

Antworten

Beispiele

Execute query with culture

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeDaxQueries

{
  "query": "EVALUATE ROW(\"Formatted Date\", FORMAT(DATE(2024, 12, 31), \"Long Date\"))",
  "culture": "en-US"
}

Execute query with custom data

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeDaxQueries

{
  "query": "EVALUATE FILTER('Sales', 'Sales'[Region] = CUSTOMDATA())",
  "customData": "North America"
}

Execute query with effective username

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeDaxQueries

{
  "query": "EVALUATE SUMMARIZECOLUMNS('Sales'[Region], \"Total\", SUM('Sales'[Amount]))",
  "effectiveUsername": "user@contoso.com",
  "roles": [
    "SalesRole"
  ],
  "queryTimeout": 300
}

Execute simple DAX query

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeDaxQueries

{
  "query": "EVALUATE VALUES('Product'[Category])",
  "queryTimeout": 600,
  "schemaOnly": false,
  "resultSetRowCountLimit": 100000
}

Definitionen

DatasetExecuteDaxQueriesRequest

Eine Anforderung zum Ausführen von Abfragen für ein Dataset