Datasets - Execute Queries In Group

Esegue query DAX (Data Analysis Expressions) sul set di dati specificato.

Gli errori di query DAX generano:

• Errore di risposta, ad esempio DAX query failure.
• Codice di stato HTTP non riuscito (400).

Una query che richiede più di una tabella o più del numero consentito di righe di tabella genererà:

• Dati limitati restituiti.
• Errore di risposta, ad esempio More than one result table in a query o More than {allowed number} rows in a query result.
• Codice di stato HTTP riuscito (200).

Le colonne complete nella query verranno restituite con un nome completo, ad esempio MyTable[MyColumn]. Le colonne rinominate o create nella query verranno restituite tra parentesi quadre, [MyNewColumn]ad esempio .

Autorizzazioni

L'impostazione del tenant Dataset Execute Queries REST API (Set di dati Esegui query) disponibile in Impostazioni di integrazione deve essere abilitata.

L'utente deve avere accesso all'area di lavoro e le autorizzazioni di lettura e compilazione del set di dati. Per altre informazioni, vedere Gestire le autorizzazioni di accesso ai set di dati.

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

Limitazioni

• I set di dati ospitati in Azure Analysis Services o che hanno una connessione dinamica a un modello di Azure Analysis Services locale non sono supportati.
• Una query per ogni chiamata API.
• Una richiesta di tabella per query.
• Massimo 100.000 righe o 1.000.000 valori per ogni query (a qualsiasi hit first). Ad esempio, se si esegue una query per 5 colonne, è possibile ottenere un massimo di 100.000 righe. Se si esegue una query per 20 colonne, è possibile ottenere un massimo di 50.000 righe (1 milione diviso per 20).
• Massimo 15 MB di dati per query. Dopo il superamento di 15 MB, la riga corrente verrà completata, ma non verranno scritte righe aggiuntive.
• Esiste un limite di 120 richieste di query al minuto per utente, indipendentemente dal set di dati su cui viene eseguita una query.
• Per usare le entità servizio, assicurarsi che l'impostazione del tenant amministratore Consenti alle entità servizio di usare le API di Power BI in Impostazioni sviluppatore sia abilitata. Tuttavia, indipendentemente dall'impostazione del tenant amministratore, le entità servizio non sono supportate per i set di dati con la sicurezza a livello di riga per RLS limitazioni o set di dati con SSO abilitato.
• Attualmente sono supportate solo le query DAX. Le query MDX e DMV non sono supportate.
  
  

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

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Execute queries example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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"
            }
          ]
        }
      ]
    }
  ]
}

Definizioni

DatasetExecuteQueriesError

Dettagli di un errore, se presente.

DatasetExecuteQueriesInformationProtectionLabel

Dettagli dell'etichetta di protezione delle informazioni, se presente, associata al set di dati.

DatasetExecuteQueriesQuery

Query del set di dati

DatasetExecuteQueriesQueryResult

Risultati di una singola query del set di dati

DatasetExecuteQueriesRequest

Richiesta di esecuzione di query su un set di dati

DatasetExecuteQueriesResponse

La risposta a un set di dati esegue una richiesta di query

DatasetExecuteQueriesSerializationSettings

Impostazioni di serializzazione per i risultati di una query del set di dati

DatasetExecuteQueriesTableResult

Tabella di dati