Datasets - Execute Queries In Group

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Führt DAX-Abfragen (Data Analysis Expressions) für das bereitgestellte Dataset aus.

DAX-Abfragefehler führen zu:

Ein Antwortfehler, z. B DAX query failure. .
Fehler http status Code (400).

Eine Abfrage, die mehr als eine Tabelle oder mehr als die zulässige Anzahl von Tabellenzeilen anfordert, führt zu folgendem Ergebnis:

Es werden begrenzte Daten zurückgegeben.
Ein Antwortfehler, z More than one result table in a query . B. oder More than {allowed number} rows in a query result.
Ein erfolgreicher HTTP-status-Code (200).

Spalten, die in der Abfrage voll qualifiziert sind, werden mit einem vollqualifizierten Namen zurückgegeben, MyTable[MyColumn]z. B. . Spalten, die in der Abfrage umbenannt oder erstellt werden, werden in eckigen Klammern zurückgegeben, [MyNewColumn]z. B. .

Berechtigungen

Die REST-API für die Mandanteneinstellung Datasetausführungsabfragen, die sich unter Integrationseinstellungen befindet, muss aktiviert sein.

Der Benutzer muss Zugriff auf den Arbeitsbereich sowie Lese- und Buildberechtigungen für Datasets haben. Weitere Informationen finden Sie unter Verwalten von Zugriffsberechtigungen auf Datasets.

Erforderlicher Bereich

Dataset.ReadWrite.All oder Dataset.Read.All

Einschränkungen

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.
Eine Abfrage pro API-Aufruf.
Eine Tabellenanforderung pro Abfrage.
Maximal 100.000 Zeilen oder 1.000.000 Werte pro Abfrage (je nachdem, was zuerst erreicht wird). Wenn Sie beispielsweise fünf Spalten abfragen, können Sie maximal 100.000 Zeilen abrufen. Wenn Sie 20 Spalten abfragen, können Sie maximal 50.000 Zeilen (1 Million geteilt durch 20) zurückerhalten.
Maximal 15 MB Daten pro Abfrage. Sobald 15 MB überschritten sind, wird die aktuelle Zeile abgeschlossen, aber es werden keine zusätzlichen Zeilen geschrieben.
Es gibt ein Limit von 120 Abfrageanforderungen pro Minute und Benutzer, unabhängig vom Dataset, das abgefragt wird.
Um Dienstprinzipale zu verwenden, stellen Sie sicher, dass die Administratormandanteneinstellung Dienstprinzipale die Verwendung von Power BI-APIs zulassen unter Entwicklereinstellungen aktiviert ist. Unabhängig von der Einstellung des Administratormandanten werden Dienstprinzipale jedoch nicht für Datasets mit RLS-Einschränkungen oder Datasets mit aktiviertem einmaligem Anmelden unterstützt.
Derzeit werden nur DAX-Abfragen unterstützt. MDX- und DMV-Abfragen werden nicht unterstützt.

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/executeQueries

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
datasetId	path	True	string	Die Dataset-ID
groupId	path	True	string uuid	Arbeitsbereich-ID

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
queries	True	DatasetExecuteQueriesQuery[]	Die Liste der auszuführenden Datasetabfragen
impersonatedUserName		string	Der UPN eines Benutzers, der identitätswechselt werden soll. Wenn das Modell nicht RLS aktiviert ist, wird dies ignoriert.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Die Serialisierungseinstellungen für das Resultset

Antworten

Name	Typ	Beschreibung
200 OK	DatasetExecuteQueriesResponse	OK

Beispiele

Execute queries example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

Request Body

{
  "queries": [
    {
      "query": "EVALUATE VALUES(MyTable)"
    }
  ],
  "serializerSettings": {
    "includeNulls": true
  },
  "impersonatedUserName": "someuser@mycompany.com"
}

Sample Response

Status code:: 200

{
  "results": [
    {
      "tables": [
        {
          "rows": [
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q1"
            },
            {
              "MyTable[Year]": 2010,
              "MyTable[Quarter]": "Q2"
            },
            {
              "MyTable[Year]": 2011,
              "MyTable[Quarter]": "Q1"
            }
          ]
        }
      ]
    }
  ]
}

Definitionen

Name	Beschreibung
DatasetExecuteQueriesError	Die Details eines Fehlers, falls vorhanden.
DatasetExecuteQueriesInformationProtectionLabel	Die Details der Dem Dataset zugeordneten Bezeichnung für den Informationsschutz, falls vorhanden.
DatasetExecuteQueriesQuery	Eine Datasetabfrage
DatasetExecuteQueriesQueryResult	Die Ergebnisse einer einzelnen Datasetabfrage
DatasetExecuteQueriesRequest	Eine Anforderung zum Ausführen von Abfragen für ein Dataset
DatasetExecuteQueriesResponse	Die Antwort auf eine Datasetausführungsabfrageanforderung
DatasetExecuteQueriesSerializationSettings	Die Serialisierungseinstellungen für die Ergebnisse einer Datasetabfrage
DatasetExecuteQueriesTableResult	Eine Tabelle mit Daten

DatasetExecuteQueriesError

Die Details eines Fehlers, falls vorhanden.

Name	Typ	Beschreibung
code	string	Der dem Fehler zugeordnete Code.
message	string	Die Meldung des Fehlers. Wenn hier nicht vorhanden, finden Sie diese Informationen auch im Detailobjekt geschachtelt unter dem Fehlerobjekt.

DatasetExecuteQueriesInformationProtectionLabel

Die Details der Dem Dataset zugeordneten Bezeichnung für den Informationsschutz, falls vorhanden.

Name	Typ	Beschreibung
id	string	Der Bezeichner (GUID) der Informationsschutzbezeichnung
name	string	Der Anzeigename der Informationsschutzbezeichnung

DatasetExecuteQueriesQuery

Eine Datasetabfrage

Name	Typ	Beschreibung
query	string	Die auszuführende DAX-Abfrage

DatasetExecuteQueriesQueryResult

Die Ergebnisse einer einzelnen Datasetabfrage

Name	Typ	Beschreibung
error	DatasetExecuteQueriesError	Die Details eines Fehlers, falls vorhanden.
tables	DatasetExecuteQueriesTableResult[]	Eine Liste mit Tabellendaten für eine Abfrage

DatasetExecuteQueriesRequest

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

Name	Typ	Beschreibung
impersonatedUserName	string	Der UPN eines Benutzers, der identitätswechselt werden soll. Wenn das Modell nicht RLS aktiviert ist, wird dies ignoriert.
queries	DatasetExecuteQueriesQuery[]	Die Liste der auszuführenden Datasetabfragen
serializerSettings	DatasetExecuteQueriesSerializationSettings	Die Serialisierungseinstellungen für das Resultset

DatasetExecuteQueriesResponse

Die Antwort auf eine Datasetausführungsabfrageanforderung

Name	Typ	Beschreibung
error	DatasetExecuteQueriesError	Die Details eines Fehlers, falls vorhanden.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Die Details der Dem Dataset zugeordneten Bezeichnung für den Informationsschutz, falls vorhanden.
results	DatasetExecuteQueriesQueryResult[]	Die Liste der Ergebnisse, eins pro Eingabeabfrage.

DatasetExecuteQueriesSerializationSettings

Die Serialisierungseinstellungen für die Ergebnisse einer Datasetabfrage

Name	Typ	Beschreibung
includeNulls	boolean	Gibt an, ob null (leere) Werte im Resultset enthalten sein sollen. Wenn nichts angegeben wird, beträgt der Standardwert `false`.

DatasetExecuteQueriesTableResult

Eine Tabelle mit Daten

Name	Typ	Beschreibung
error	DatasetExecuteQueriesError	Die Details eines Fehlers, falls vorhanden.
rows	object[]	Eine Liste von Zeilen