Datasets - Execute Queries

Reference

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Spustí dotazy DAX (Data Analysis Expressions) na zadanou datovou sadu. Datová sada se musí nacházet v Můj pracovní prostor nebo v jiném pracovním prostoru.

Chyby dotazu DAX způsobí:

Chyba odpovědi, například DAX query failure.
Stavový kód HTTP selhání (400).

Výsledkem dotazu, který požaduje více než jednu tabulku nebo více než povolený počet řádků tabulky, bude:

Vrácená 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 plně kvalifikované v dotazu, budou vráceny s plně kvalifikovaným názvem, například MyTable[MyColumn]. Sloupce, které jsou přejmenovány nebo vytvořeny v dotazu budou vráceny v hranaté závorce, například [MyNewColumn].

Dovolení

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

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í datové sady.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

Omezení

Datové sady hostované ve službě Azure Analysis Services nebo živé připojení k místnímu modelu služby Azure Analysis Services se nepodporují.
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 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.
Počet požadavků na dotazy na uživatele je omezený na 120 minut bez ohledu na datovou sadu, na kterou se dotazuje.
Pokud chcete použít instanční objekty, ujistěte se, že nastavení tenanta správce Povolit instančním objektům používat rozhraní API Power BI v části Nastavení pro vývojáře je povolená. Bez ohledu na nastavení tenanta správce se instanční objekty nepodporují u datových sad s RLS na omezení zabezpečení na úrovni řádků nebo datových sad s povoleným jednotným přihlašováním.
V tuto chvíli se podporují jenom dotazy DAX. Dotazy MDX, INFO 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ů na datovou sadu, které se mají provést
impersonatedUserName		string	Hlavní název uživatele, který má být zosobněn. Pokud model není povolený na úrovni řádků, bude ignorován.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Nastavení serializace sady výsledků

Odpovědi

Name	Typ	Description
200 OK	DatasetExecuteQueriesResponse	OK

Příklady

Execute queries example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

Text požadavku

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

Ukázková odpověď

Stavový kód:: 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 je k dispozici.
DatasetExecuteQueriesInformationProtectionLabel	Podrobnosti popisku ochrany informací, pokud existuje, přidruženého k datové sadě.
DatasetExecuteQueriesQuery	Dotaz na datovou sadu
DatasetExecuteQueriesQueryResult	Výsledky dotazu na jednu datovou sadu
DatasetExecuteQueriesRequest	Žádost o provedení dotazů na datovou sadu
DatasetExecuteQueriesResponse	Odpověď na žádost o provedení dotazů na datovou sadu
DatasetExecuteQueriesSerializationSettings	Nastavení serializace pro výsledky dotazu datové sady
DatasetExecuteQueriesTableResult	Tabulka dat

DatasetExecuteQueriesError

Object

Podrobnosti o chybě, pokud je k dispozici.

Name	Typ	Description
code	string	Kód přidružený k chybě
message	string	Zpráva o chybě. Pokud tu nejsou, tyto informace se také nacházejí v objektu podrobností vnořeném pod objektem chyby.

DatasetExecuteQueriesInformationProtectionLabel

Object

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

Object

Dotaz na datovou sadu

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

DatasetExecuteQueriesQueryResult

Object

Výsledky dotazu na jednu datovou sadu

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

DatasetExecuteQueriesRequest

Object

Žá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 není povolený na úrovni řádků, bude ignorován.
queries	DatasetExecuteQueriesQuery[]	Seznam dotazů na datovou sadu, které se mají provést
serializerSettings	DatasetExecuteQueriesSerializationSettings	Nastavení serializace sady výsledků

DatasetExecuteQueriesResponse

Object

Odpověď na žádost o provedení dotazů na datovou sadu

Name	Typ	Description
error	DatasetExecuteQueriesError	Podrobnosti o chybě, pokud je 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

Object

Nastavení serializace pro výsledky dotazu datové sady

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

DatasetExecuteQueriesTableResult

Object

Tabulka dat

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

Sdílet prostřednictvím

Datasets - Execute Queries

Dovolení

Požadovaný obor

Omezení

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

Execute queries example

Ukázkový požadavek

Ukázková odpověď

Definice

DatasetExecuteQueriesError

DatasetExecuteQueriesInformationProtectionLabel

DatasetExecuteQueriesQuery

DatasetExecuteQueriesQueryResult

DatasetExecuteQueriesRequest

DatasetExecuteQueriesResponse

DatasetExecuteQueriesSerializationSettings

DatasetExecuteQueriesTableResult

Další materiály