Datasets - Execute Queries In Group

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Spustí dotazy DAX (Data Analysis Expressions) na zadanou datovou sadu.

Chyby dotazů 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í v hranaté závorce, [MyNewColumn]například .

Oprávnění

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

Uživatel musí mít přístup k pracovnímu prostoru a 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 nejsou podporované.
Jeden dotaz na 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 maximálně 100 000 řádků. Pokud zadáte dotaz 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 žádné další řádky se nezapíšou.
Platí limit 120 žádostí o dotazy za minutu na uživatele bez ohledu na dotazovanou datovou sadu.
Pokud chcete používat instanční objekty, ujistěte se, že je v nastavení pro vývojáře povolené nastavení tenanta správce Povolit instančním objektům používat rozhraní API Power BI. 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ů ani pro 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/groups/{groupId}/datasets/{datasetId}/executeQueries

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
groupId	path	True	string uuid	ID pracovního prostoru

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, který má být zosobněn. Pokud model nemá povolené zabezpečení na úrovni řádků, bude toto nastavení ignorováno.
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/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"
            }
          ]
        }
      ]
    }
  ]
}

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 datové sady
DatasetExecuteQueriesQueryResult	Výsledky dotazu na jednu datovou sadu
DatasetExecuteQueriesRequest	Žádost o provedení dotazů na datovou sadu
DatasetExecuteQueriesResponse	Odpověď na žádost o provedení dotazů datové sady
DatasetExecuteQueriesSerializationSettings	Nastavení serializace výsledků dotazu datové sady
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 nejsou, najdete tyto informace také v podrobnostech o objektu vnořeném 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 datové sady

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

DatasetExecuteQueriesQueryResult

Výsledky dotazu na jednu datovou sadu

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

DatasetExecuteQueriesRequest

Žádost o provedení dotazů na datovou sadu

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

DatasetExecuteQueriesResponse

Odpověď na žádost o provedení dotazů datové sady

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 pro každý vstupní dotaz

DatasetExecuteQueriesSerializationSettings

Nastavení serializace výsledků dotazu datové sady

Name	Typ	Description
includeNulls	boolean	Určuje, jestli mají být do sady výsledků zahrnuté hodnoty null (prázdné hodnoty). 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ů

Share via