Datasets - Execute Queries In Group

Référence

Service:: Power BI REST APIs

Version d'API:: v1.0

Exécute des requêtes DAX (Data Analysis Expressions) sur le jeu de données fourni.

Les erreurs de requête DAX aboutissent à :

Erreur de réponse, telle que DAX query failure.
Code d’état HTTP d’échec (400).

Une requête qui demande plusieurs tables, ou plus que le nombre autorisé de lignes de table, entraîne :

Données limitées retournées.
Erreur de réponse, telle que More than one result table in a query ou More than {allowed number} rows in a query result.
Code d’état HTTP réussi (200).

Les colonnes qui sont complètes dans la requête sont retournées avec un nom complet, par exemple, MyTable[MyColumn]. Les colonnes renommées ou créées dans la requête sont retournées entre crochets, par exemple, [MyNewColumn].

Autorisations

Le paramètre de locataire 'API REST d’exécution de jeux de données, trouvé sous paramètres d’intégration, doit être activé.

L’utilisateur doit avoir accès à l’espace de travail, ainsi qu’aux autorisations de lecture et de génération du jeu de données. Pour plus d’informations, consultez Gérer les autorisations d’accès au jeu de données.

Étendue requise

Dataset.ReadWrite.All ou Dataset.Read.All

Limitations

Les jeux de données hébergés dans Azure Analysis Services ou qui ont une connexion active à un modèle Azure Analysis Services local ne sont pas pris en charge.
Une requête par appel d’API.
Une requête de table par requête.
Maximum de 100 000 lignes ou 1 000 000 valeurs par requête (le cas où l’accès est atteint en premier). Par exemple, si vous interrogez 5 colonnes, vous pouvez récupérer au maximum 100 000 lignes. Si vous interrogez 20 colonnes, vous pouvez récupérer au maximum 50 000 lignes (1 million divisé par 20).
Maximum de 15 Mo de données par requête. Une fois que 15 Mo sont dépassés, la ligne actuelle est terminée, mais aucune ligne supplémentaire n’est écrite.
Il existe une limite de 120 requêtes par minute par utilisateur, quel que soit le jeu de données interrogé.
Pour utiliser des principaux de service, vérifiez que le paramètre client administrateur Autoriser les principaux de service à utiliser les API Power BI sous paramètres du développeur est activé. Toutefois, quel que soit le paramètre de locataire administrateur, les principaux de service ne sont pas pris en charge pour les jeux de données avec des RLS par limitations RLS ou des jeux de données avec l’authentification unique activée.
Seules les requêtes DAX sont prises en charge pour l’instant. Les fonctions MDX, les fonctions INFO et les requêtes DMV ne sont pas prises en charge.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string	ID du jeu de données
groupId	path	True	string uuid	ID de l’espace de travail

Corps de la demande

Nom	Obligatoire	Type	Description
queries	True	DatasetExecuteQueriesQuery[]	Liste des requêtes de jeu de données à exécuter
impersonatedUserName		string	UPN d’un utilisateur à emprunter l’identité. Si le modèle n’est pas activé, cela sera ignoré.
serializerSettings		DatasetExecuteQueriesSerializationSettings	Paramètres de sérialisation du jeu de résultats

Réponses

Nom	Type	Description
200 OK	DatasetExecuteQueriesResponse	D’ACCORD

Exemples

Execute queries example

Exemple de requête

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/executeQueries

Corps de la demande

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

Exemple de réponse

Code d’état:: 200

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

Définitions

Nom	Description
DatasetExecuteQueriesError	Détails d’une erreur, le cas échéant.
DatasetExecuteQueriesInformationProtectionLabel	Détails de l’étiquette de protection des informations, le cas échéant, associées au jeu de données.
DatasetExecuteQueriesQuery	Requête de jeu de données
DatasetExecuteQueriesQueryResult	Résultats d’une requête de jeu de données unique
DatasetExecuteQueriesRequest	Demande d’exécution de requêtes sur un jeu de données
DatasetExecuteQueriesResponse	Réponse à une demande d’exécution de requêtes de jeu de données
DatasetExecuteQueriesSerializationSettings	Paramètres de sérialisation pour les résultats d’une requête de jeu de données
DatasetExecuteQueriesTableResult	Table des données

DatasetExecuteQueriesError

Détails d’une erreur, le cas échéant.

Nom	Type	Description
code	string	Code associé à l’erreur
message	string	Message de l’erreur. S’il n’est pas présent ici, ces informations sont également disponibles dans l’objet détails imbriqué sous l’objet d’erreur.

DatasetExecuteQueriesInformationProtectionLabel

Détails de l’étiquette de protection des informations, le cas échéant, associées au jeu de données.

Nom	Type	Description
id	string	Identificateur (guid) de l’étiquette de protection des informations
name	string	Nom complet de l’étiquette de protection des informations

DatasetExecuteQueriesQuery

Requête de jeu de données

Nom	Type	Description
query	string	Requête DAX à exécuter

DatasetExecuteQueriesQueryResult

Résultats d’une requête de jeu de données unique

Nom	Type	Description
error	DatasetExecuteQueriesError	Détails d’une erreur, le cas échéant.
tables	DatasetExecuteQueriesTableResult[]	Liste des données de tables pour une requête

DatasetExecuteQueriesRequest

Demande d’exécution de requêtes sur un jeu de données

Nom	Type	Description
impersonatedUserName	string	UPN d’un utilisateur à emprunter l’identité. Si le modèle n’est pas activé, cela sera ignoré.
queries	DatasetExecuteQueriesQuery[]	Liste des requêtes de jeu de données à exécuter
serializerSettings	DatasetExecuteQueriesSerializationSettings	Paramètres de sérialisation du jeu de résultats

DatasetExecuteQueriesResponse

Réponse à une demande d’exécution de requêtes de jeu de données

Nom	Type	Description
error	DatasetExecuteQueriesError	Détails d’une erreur, le cas échéant.
informationProtectionLabel	DatasetExecuteQueriesInformationProtectionLabel	Détails de l’étiquette de protection des informations, le cas échéant, associées au jeu de données.
results	DatasetExecuteQueriesQueryResult[]	Liste des résultats, une par requête d’entrée.

DatasetExecuteQueriesSerializationSettings

Paramètres de sérialisation pour les résultats d’une requête de jeu de données

Nom	Type	Description
includeNulls	boolean	Indique si les valeurs Null (vides) doivent être incluses dans le jeu de résultats. Si elle n’est pas spécifiée, la valeur par défaut est `false`.

DatasetExecuteQueriesTableResult

Table des données

Nom	Type	Description
error	DatasetExecuteQueriesError	Détails d’une erreur, le cas échéant.
rows	object[]	Liste des lignes

Partager via