Datasets - Update Datasources
Mises à jour les sources de données du jeu de données spécifié à partir de Mon espace de travail.
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 de 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.
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 .
- 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 de 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 .
- 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 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.
É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 connexion de source de données |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
Exemples
Example
Sample Request
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"
}
}
]
}
Sample Response
Définitions
Nom | Description |
---|---|
Datasource |
Une 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 en 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 du jeu de données Power BI |
Datasource
Une source de données Power BI
Nom | Type | Description |
---|---|---|
connectionDetails |
Détails de la connexion à la source de données |
|
connectionString |
string |
(Déconseillé) Source de données chaîne de connexion. Disponible uniquement pour DirectQuery. |
datasourceId |
string |
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 |
ID de passerelle lié, 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 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 en 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 |
Détails de connexion cible de la source de données mise à jour |
|
datasourceSelector |
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 |
Tableau de demandes de mise à jour de connexion de source de données |