Freigeben über


Datasets - Execute Queries

Führt DAX-Abfragen (Data Analysis Expressions) für das bereitgestellte Dataset aus. Das Dataset muss sich in "Mein Arbeitsbereich" oder in einem anderen Arbeitsbereich befinden.

DAX-Abfragefehler führen zu:

  • Ein Antwortfehler, z DAX query failure. B. .
  • Ein HTTP-Fehler status Code (400).

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

  • Eingeschränkte Daten, die zurückgegeben werden.
  • 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, z. B MyTable[MyColumn]. . 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 über Lese- und Buildberechtigungen für Datasets verfügen. 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) erhalten.
  • Maximal 15 MB Daten pro Abfrage. Sobald 15 MB überschritten sind, wird die aktuelle Zeile abgeschlossen, aber es werden keine weiteren Zeilen geschrieben.
  • Es gibt einen Grenzwert 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 Administratormandanteneinstellung werden Dienstprinzipale jedoch nicht für Datasets mit RLS-Einschränkungen pro RLS 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/datasets/{datasetId}/executeQueries

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
path True

string

Die Dataset-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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries
{
  "queries": [
    {
      "query": "EVALUATE VALUES(MyTable)"
    }
  ],
  "serializerSettings": {
    "includeNulls": true
  },
  "impersonatedUserName": "someuser@mycompany.com"
}

Sample Response

{
  "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 Information Protection-Bezeichnung, sofern vorhanden, die dem Dataset zugeordnet ist.

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 Abfrageanforderung zum Ausführen eines Datasets

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. Falls hier nicht vorhanden, finden Sie diese Informationen auch im Detailobjekt, das unter dem Fehlerobjekt geschachtelt ist.

DatasetExecuteQueriesInformationProtectionLabel

Die Details der Information Protection-Bezeichnung, sofern vorhanden, die dem Dataset zugeordnet ist.

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 der 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 Abfrageanforderung zum Ausführen eines Datasets

Name Typ Beschreibung
error

DatasetExecuteQueriesError

Die Details eines Fehlers, falls vorhanden.

informationProtectionLabel

DatasetExecuteQueriesInformationProtectionLabel

Die Details der Information Protection-Bezeichnung, sofern vorhanden, die dem Dataset zugeordnet ist.

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 in das Resultset eingeschlossen werden 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