Partager via


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
datasetId
path True

string

ID du jeu de données

Corps de la demande

Nom Obligatoire Type Description
updateDetails True

UpdateDatasourceConnectionRequest[]

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

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.

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 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

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 de source de données