Partager via

Datasets - Update Dataset

  • Référence
Service:
Power BI REST APIs
API Version:
v1.0

Mises à jour les propriétés du jeu de données spécifié à partir de Mon espace de travail.

Autorisations

L’utilisateur doit être le propriétaire du jeu de données.

Étendue requise

Dataset.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données

Corps de la demande

Nom Type Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

Paramètres de scale-out de requête d’un jeu de données
targetStorageMode

string

Mode de stockage du jeu de données

Réponses

Nom Type Description
200 OK

Ok

Exemples

Example of changing the dataset storage mode to support large datasets
Example of changing the dataset storage mode to support small datasets
Example of updating scale-out settings of a dataset

Example of changing the dataset storage mode to support large datasets

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "targetStorageMode": "PremiumFiles"
}

Sample Response

Status code:
200

Example of changing the dataset storage mode to support small datasets

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "targetStorageMode": "Abf"
}

Sample Response

Status code:
200

Example of updating scale-out settings of a dataset

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Sample Response

Status code:
200

Définitions

Nom Description
DatasetQueryScaleOutSettings

Paramètres de scale-out de requête d’un jeu de données
UpdateDatasetRequest

Mettre à jour la demande de jeu de données

DatasetQueryScaleOutSettings

Paramètres de scale-out de requête d’un jeu de données

Nom Type Description
autoSyncReadOnlyReplicas

boolean

Indique si le jeu de données synchronise automatiquement les réplicas en lecture seule
maxReadOnlyReplicas

integer

Nombre maximal de réplicas en lecture seule pour le jeu de données (0-64, -1 pour le nombre automatique de réplicas)

UpdateDatasetRequest

Mettre à jour la demande de jeu de données

Nom Type Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

Paramètres de scale-out de requête d’un jeu de données
targetStorageMode

string

Mode de stockage du jeu de données