Datasets - Update Datasources
Met à jour les sources de données du jeu de données spécifié à partir de Mon espace de travail.
Remarque
Nous vous recommandons d’utiliser 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 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 métadonnées de jeu de données améliorées, attendez 30 minutes pour 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.
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 les paramètres de mise à jour 'appel d’API.
- 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 la chaîne de connexion ne sont pas prises en charge.
- La mise à jour des sources de données qui font partie de tables fusionnées ou jointes n’est prise en charge que si vous utilisez 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 sera mise à jour. Pour surmonter cette limitation, définissez la source de données en tant que paramètre et utilisez l’appel d’API Update Parameters.
- 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 le résultat de la mise à jour partielle des sources de données, pour surmonter ce problème, vous pouvez essayer d’exécuter une actualisation de jeu de données avant d’appeler cette API.
Étendue requise
Dataset.ReadWrite.All
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.UpdateDatasources
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
ID du jeu de données |
Corps de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| updateDetails | True |
Tableau de demandes de mise à jour de la connexion de source de données |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
D’ACCORD |
Exemples
Example
Exemple de requête
POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources
{
"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"
}
}
]
}
Exemple de réponse
Définitions
| Nom | Description |
|---|---|
| Datasource |
Source de données Power BI |
|
Datasource |
Détails de la 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 lede groupe. |
|
Update |
Demande de mise à jour de la connexion à la source de données du jeu de données Power BI |
|
Update |
Demande de mise à jour des sources de données de jeu de données Power BI |
Datasource
Source de données Power BI
| Nom | Type | Description |
|---|---|---|
| connectionDetails |
Détails de la connexion à la source de données |
|
| connectionString |
string |
(Déconseillé) Chaîne de connexion à la source de données. Disponible uniquement pour DirectQuery. |
| datasourceId |
string (uuid) |
ID de source de données lié, qui est vide lorsqu’il n’est pas lié à une passerelle |
| datasourceType |
string |
Type de source de données |
| gatewayId |
string (uuid) |
ID de passerelle lié, qui est vide lorsqu’il n’est pas lié à une passerelle. Lorsque vous utilisez 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 la 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 lede 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 |
Le serveur de connexion de connexion |
| path |
string |
Chemin d’accès de connexion |
| server |
string |
Le 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 |
Détails de la connexion cible de la source de données mise à jour |
|
| datasourceSelector |
Détails de connexion de la source de données qui a besoin de la 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 de jeu de données Power BI
| Nom | Type | Description |
|---|---|---|
| updateDetails |
Tableau de demandes de mise à jour de la connexion de source de données |