Datasets - Update Datasources In Group

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Mises à jour les sources de données du jeu de données spécifié à partir de l’espace de travail spécifié.

Notes

Nous vous recommandons d’utiliser des métadonnées de jeu de données améliorées avec cet appel d’API.

Important

La source de données d’origine et la nouvelle source de données doivent avoir exactement le même schéma.
Si vous utilisez des métadonnées de jeu de données améliorées, actualisez le jeu de données pour obtenir des données à partir des nouvelles sources de données.
Si vous n’utilisez pas les métadonnées de jeu de données améliorées, attendez 30 minutes que l’opération de mise à jour des sources de données se termine, puis actualisez le jeu de données.

Autorisations

L’utilisateur doit être le propriétaire du jeu de données.
Cet appel d’API peut être appelé par un profil de principal de service. Pour plus d’informations, consultez : Profils de principal de service dans Power BI Embedded.

Étendue requise

Dataset.ReadWrite.All

Limites

Les jeux de données créés ou modifiés à l’aide du point de terminaison XMLA public ne sont pas pris en charge. Pour apporter des modifications à ces sources de données, l’administrateur doit utiliser la bibliothèque cliente Azure Analysis Services pour le modèle objet tabulaire.
Seules ces sources de données sont prises en charge : SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata et SAP HANA. Pour d’autres sources de données, utilisez l’appel d’API Mettre à jour les paramètres dans le groupe .
La modification du type de source de données n’est pas prise en charge.
Les sources de données qui contiennent des paramètres dans le chaîne de connexion ne sont pas prises en charge.
La mise à jour des sources de données qui font partie des tables fusionnées ou jointes n’est prise en charge que si vous utilisez des métadonnées de jeu de données améliorées.
Pour une requête avancée qui référence plusieurs sources de données, seule la première source de données est mise à jour. Pour surmonter cette limitation, définissez la source de données en tant que paramètre et utilisez l’appel d’API Mettre à jour les paramètres dans le groupe .
Les jeux de données avec une stratégie d’actualisation incrémentielle ne sont pas entièrement pris en charge. L’appel de cette API peut ne pas fonctionner comme prévu et résulter d’une mise à jour partielle des sources de données. Pour résoudre ce problème, vous pouvez essayer d’exécuter une actualisation du jeu de données avant d’appeler cette API.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string
groupId	path	True	string uuid	L’ID de l’espace de travail

Corps de la demande

Nom	Obligatoire	Type	Description
updateDetails	True	UpdateDatasourceConnectionRequest[]	Tableau de demandes de mise à jour de connexion à la source de données

Réponses

Nom	Type	Description
200 OK		Ok

Exemples

Example

Sample Request

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

Request Body

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "My-Sql-Server",
          "database": "My-Sql-Database"
        }
      },
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceSelector": {
        "datasourceType": "OData",
        "connectionDetails": {
          "url": "http://services.odata.org/V4/Northwind/Northwind.svc"
        }
      },
      "connectionDetails": {
        "url": "http://services.odata.org/V4/Odata/Northwind.svc"
      }
    }
  ]
}

Sample Response

Status code:: 200

Définitions

Nom	Description
Datasource	Une source de données Power BI
DatasourceConnectionDetails	Détails de connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans un groupe.
UpdateDatasourceConnectionRequest	Demande de mise à jour de la connexion à la source de données du jeu de données Power BI
UpdateDatasourcesRequest	Demande de mise à jour des sources de données du jeu de données Power BI

Datasource

Une source de données Power BI

Nom	Type	Description
connectionDetails	DatasourceConnectionDetails	Détails de connexion à la source de données
connectionString	string	(Déconseillé) La source de données chaîne de connexion. Disponible uniquement pour DirectQuery.
datasourceId	string	ID de source de données liée, qui est vide lorsqu’il n’est pas lié à une passerelle
datasourceType	string	Type de source de données
gatewayId	string	ID de passerelle liée, qui est vide lorsqu’il n’est pas lié à une passerelle. Lors de l’utilisation d’un cluster de passerelle, l’ID de passerelle fait référence à la passerelle principale (première) du cluster et est similaire à l’ID de cluster de passerelle.
name	string	(Déconseillé) Nom de la source de données. Disponible uniquement pour DirectQuery.

DatasourceConnectionDetails

Détails de connexion à la source de données Power BI. Consultez des exemples dans Obtenir des sources de données ou Obtenir des sources de données dans un groupe.

Nom	Type	Description
account	string	Compte de connexion
classInfo	string	Informations sur la classe de connexion
database	string	Base de données de connexion
domain	string	Domaine de connexion
emailAddress	string	Adresse e-mail de connexion
kind	string	Type de connexion
loginServer	string	Serveur de connexion
path	string	Chemin de connexion
server	string	Serveur de connexion
url	string	URL de connexion

UpdateDatasourceConnectionRequest

Demande de mise à jour de la connexion à la source de données du jeu de données Power BI

Nom	Type	Description
connectionDetails	DatasourceConnectionDetails	Détails de connexion cible de la source de données mise à jour
datasourceSelector	Datasource	Détails de connexion de la source de données qui doit être mise à jour. Cela est obligatoire lorsqu’un jeu de données a plusieurs sources de données.

UpdateDatasourcesRequest

Demande de mise à jour des sources de données du jeu de données Power BI

Nom	Type	Description
updateDetails	UpdateDatasourceConnectionRequest[]	Tableau de demandes de mise à jour de connexion à la source de données