Datasets - Execute Queries

Wykonuje zapytania języka DAX (Data Analysis Expressions) względem podanego zestawu danych. Zestaw danych musi znajdować się w Mój obszar roboczy lub inny obszar roboczy.

Błędy zapytań języka DAX spowodują:

• Błąd odpowiedzi, taki jak DAX query failure.
• Kod stanu HTTP błędu (400).

Zapytanie, które żąda więcej niż jednej tabeli lub więcej niż dozwolona liczba wierszy tabeli, spowoduje:

• Zwracane są ograniczone dane.
• Błąd odpowiedzi, taki jak More than one result table in a query lub More than {allowed number} rows in a query result.
• Pomyślny kod stanu HTTP (200).

Kolumny, które są w pełni kwalifikowane w zapytaniu, zostaną zwrócone z w pełni kwalifikowaną nazwą, na przykład MyTable[MyColumn]. Kolumny, które zostały zmienione lub utworzone w zapytaniu, zostaną zwrócone w nawiasie kwadratowym, na przykład [MyNewColumn].

Uprawnienia

Należy włączyć ustawienie dzierżawy Zestaw danych Wykonywanie zapytań interfejsu API RESTw obszarze ustawienia integracji.

Użytkownik musi mieć uprawnienia do odczytu i kompilacji zestawu danych. Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami dostępu do zestawu danych.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

• Zestawy danych, które są hostowane w usługach Azure Analysis Services lub które mają połączenie na żywo z lokalnym modelem usług Azure Analysis Services, nie są obsługiwane.
• Jedno zapytanie na wywołanie interfejsu API.
• Jedno żądanie tabeli na zapytanie.
• Maksymalnie 100 000 wierszy lub 1000 000 wartości na zapytanie (w zależności od tego, co zostanie trafione jako pierwsze). Jeśli na przykład wykonasz zapytanie dotyczące 5 kolumn, możesz wrócić do maksymalnie 100 000 wierszy. Jeśli wykonasz zapytanie dotyczące 20 kolumn, możesz wrócić do maksymalnie 50 000 wierszy (1 milion podzielonych przez 20).
• Maksymalnie 15 MB danych na zapytanie. Po przekroczeniu 15 MB bieżący wiersz zostanie ukończony, ale nie zostaną zapisane żadne dodatkowe wiersze.
• Istnieje limit 120 żądań zapytań na minutę na użytkownika, niezależnie od zestawu danych, którego dotyczy zapytanie.
• Aby użyć jednostek usługi, upewnij się, że ustawienie dzierżawy administratora Zezwalaj jednostkom usługi na używanie interfejsów API usługi Power BI w obszarze Ustawienia dewelopera jest włączone. Jednak niezależnie od ustawienia dzierżawy administratora jednostki usługi nie są obsługiwane w przypadku zestawów danych z zabezpieczeniami na poziomie wiersza na ograniczenia zabezpieczeń na poziomie wiersza lub zestawów danych z włączonym logowaniem jednokrotnym.
• Obecnie obsługiwane są tylko zapytania języka DAX. Funkcje MDX, funkcje INFO i zapytania DMV nie są obsługiwane.
  
  

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

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Execute queries example

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"
}

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

Definicje

DatasetExecuteQueriesError

Szczegóły błędu, jeśli istnieją.

DatasetExecuteQueriesInformationProtectionLabel

Szczegóły etykiety ochrony informacji, jeśli istnieją, skojarzone z zestawem danych.

DatasetExecuteQueriesQuery

Zapytanie dotyczące zestawu danych

DatasetExecuteQueriesQueryResult

Wyniki z pojedynczego zapytania zestawu danych

DatasetExecuteQueriesRequest

Żądanie wykonywania zapytań względem zestawu danych

DatasetExecuteQueriesResponse

Odpowiedź na zestaw danych wykonuje żądanie zapytań

DatasetExecuteQueriesSerializationSettings

Ustawienia serializacji wyników zapytania zestawu danych

DatasetExecuteQueriesTableResult

Tabela danych