Partager via


Datasets - Update Parameters

Mises à jour les valeurs de paramètres 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

  • Si vous utilisez des métadonnées de jeu de données améliorées, actualisez le jeu de données pour appliquer les nouvelles valeurs de paramètre.
  • 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.

É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 jeux de données, l’administrateur doit utiliser la bibliothèque de client Azure Analysis Services pour le modèle objet tabulaire.
  • Les connexions DirectQuery sont uniquement prises en charge avec des métadonnées de jeu de données améliorées.
  • Les jeux de données avec Azure Analysis Services connexions actives ne sont pas pris en charge.
  • Maximum de 100 paramètres par demande.
  • Tous les paramètres spécifiés doivent exister dans le jeu de données.
  • Les valeurs de paramètres doivent être du type attendu.
  • La liste de paramètres ne peut pas être vide ou inclure des paramètres en double.
  • Les noms de paramètres respectent la casse.
  • Le paramètre IsRequired doit avoir une valeur non vide.
  • Les types de paramètres Any et Binary ne peuvent pas être mis à jour.

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

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

UpdateMashupParameterDetails[]

Liste des paramètres de jeu de données à mettre à jour

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.UpdateParameters
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

Définitions

Nom Description
UpdateMashupParameterDetails

Détails de la mise à jour d’un paramètre de jeu de données Power BI

UpdateMashupParametersRequest

Demande de mise à jour pour un paramètre de jeu de données Power BI

UpdateMashupParameterDetails

Détails de la mise à jour d’un paramètre de jeu de données Power BI

Nom Type Description
name

string

Nom du paramètre

newValue

string

Nouvelle valeur pour le paramètre

UpdateMashupParametersRequest

Demande de mise à jour pour un paramètre de jeu de données Power BI

Nom Type Description
updateDetails

UpdateMashupParameterDetails[]

Liste des paramètres de jeu de données à mettre à jour