Datasets - Execute Queries

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Provádí dotazy DAX (Data Analysis Expressions) na zadanou datovou sadu. Datová sada se musí nacházet v pracovním prostoru nebo jiném pracovním prostoru.

Chyby dotazu DAX budou mít za následek:

Chyba odpovědi, například DAX query failure.
Chybový stavový kód HTTP (400).

Dotaz, který požaduje více než jednu tabulku nebo více než povolený počet řádků tabulky, bude mít za následek:

Vrací se omezená data.
Chyba odpovědi, například More than one result table in a query nebo More than {allowed number} rows in a query result.
Úspěšný stavový kód HTTP (200).

Sloupce, které jsou v dotazu plně kvalifikované, se vrátí s plně kvalifikovaným názvem, MyTable[MyColumn]například . Sloupce, které se přejmenují nebo vytvoří v dotazu, se vrátí do hranaté závorky, [MyNewColumn]například .

Oprávnění

Musí být povolené rozhraní REST API pro spouštění dotazů datové sady, které najdete v části Nastavení integrace.

Uživatel musí mít oprávnění ke čtení a sestavení datové sady. Další informace najdete v tématu Správa přístupových oprávnění k datové sadě.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

Omezení

Datové sady hostované v Azure Analysis Services nebo s živým připojením k místnímu modelu Azure Analysis Services se nepodporují.
Jeden dotaz na každé volání rozhraní API
Jeden požadavek na tabulku na dotaz.
Maximálně 100 000 řádků nebo 1 000 000 hodnot na dotaz (podle toho, co nastane dříve). Pokud například zadáte dotaz na 5 sloupců, můžete získat zpět maximálně 100 000 řádků. Pokud se dotazujete na 20 sloupců, můžete získat zpět maximálně 50 000 řádků (1 milion děleno 20).
Maximálně 15 MB dat na dotaz. Po překročení 15 MB se aktuální řádek dokončí, ale nebudou zapsány žádné další řádky.
Platí limit 120 žádostí o dotazy za minutu na uživatele bez ohledu na datovou sadu, na kterou se dotazuje.
Pokud chcete používat instanční objekty, ujistěte se, že je povolené nastavení tenanta správce Povolit instančním objektům používat rozhraní API Power BI v nastavení vývojáře . Bez ohledu na nastavení tenanta správce se ale instanční objekty nepodporují pro datové sady s omezeními zabezpečení na úrovni řádků na úrovni řádků nebo datové sady s povoleným jednotným přihlašováním.
V tuto chvíli jsou podporovány pouze dotazy DAX. Dotazy MDX a DMV se nepodporují.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady

Text požadavku

Name	Vyžadováno	Typ	Description
queries	True	DatasetExecuteQueriesQuery[]	Seznam dotazů datových sad, které se mají spustit
impersonatedUserName		string	Hlavní název uživatele (UPN) uživatele, který má být zosobněn. Pokud model není povolený na úrovni řádků, bude ignorován.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Nastavení serializace pro sadu výsledků

Odpovědi

Name	Typ	Description
200 OK	DatasetExecuteQueriesResponse	OK

Příklady

Execute queries example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/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"
            }
          ]
        }
      ]
    }
  ]
}

Definice

Name	Description
DatasetExecuteQueriesError	Podrobnosti o chybě, pokud jsou k dispozici.
DatasetExecuteQueriesInformationProtectionLabel	Podrobnosti popisku ochrany informací, pokud existuje, přidruženého k datové sadě.
DatasetExecuteQueriesQuery	Dotaz na datovou sadu
DatasetExecuteQueriesQueryResult	Výsledky z dotazu na jednu datovou sadu
DatasetExecuteQueriesRequest	Požadavek na spuštění dotazů na datovou sadu
DatasetExecuteQueriesResponse	Odpověď na datovou sadu spustí požadavek na dotazy.
DatasetExecuteQueriesSerializationSettings	Nastavení serializace výsledků dotazu na datovou sadu
DatasetExecuteQueriesTableResult	Tabulka dat

DatasetExecuteQueriesError

Podrobnosti o chybě, pokud jsou k dispozici.

Name	Typ	Description
code	string	Kód přidružený k chybě
message	string	Zpráva o chybě. Pokud tu není, najdete tyto informace také v podrobnostech objektu vnořeného pod objektem error.

DatasetExecuteQueriesInformationProtectionLabel

Podrobnosti popisku ochrany informací, pokud existuje, přidruženého k datové sadě.

Name	Typ	Description
id	string	Identifikátor (guid) popisku ochrany informací
name	string	Zobrazovaný název popisku ochrany informací

DatasetExecuteQueriesQuery

Dotaz na datovou sadu

Name	Typ	Description
query	string	Dotaz DAX, který se má spustit

DatasetExecuteQueriesQueryResult

Výsledky z dotazu na jednu datovou sadu

Name	Typ	Description
error	DatasetExecuteQueriesError	Podrobnosti o chybě, pokud jsou k dispozici.
tables	DatasetExecuteQueriesTableResult[]	Seznam dat tabulek pro dotaz

DatasetExecuteQueriesRequest

Požadavek na spuštění dotazů na datovou sadu

Name	Typ	Description
impersonatedUserName	string	Hlavní název uživatele (UPN) uživatele, který má být zosobněn. Pokud model není povolený na úrovni řádků, bude ignorován.
queries	DatasetExecuteQueriesQuery[]	Seznam dotazů datových sad, které se mají spustit
serializerSettings	DatasetExecuteQueriesSerializationSettings	Nastavení serializace pro sadu výsledků

DatasetExecuteQueriesResponse

Odpověď na datovou sadu spustí požadavek na dotazy.

Name	Typ	Description
error	DatasetExecuteQueriesError	Podrobnosti o chybě, pokud jsou k dispozici.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Podrobnosti popisku ochrany informací, pokud existuje, přidruženého k datové sadě.
results	DatasetExecuteQueriesQueryResult[]	Seznam výsledků, jeden na vstupní dotaz.

DatasetExecuteQueriesSerializationSettings

Nastavení serializace výsledků dotazu na datovou sadu

Name	Typ	Description
includeNulls	boolean	Určuje, jestli mají být do sady výsledků zahrnuty hodnoty null (prázdné). Pokud není zadáno, výchozí hodnota je `false`.

DatasetExecuteQueriesTableResult

Tabulka dat

Name	Typ	Description
error	DatasetExecuteQueriesError	Podrobnosti o chybě, pokud jsou k dispozici.
rows	object[]	Seznam řádků