Datasets - Update Dataset In Group

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Aggiornamenti le proprietà per il set di dati specificato dall'area di lavoro specificata.

Autorizzazioni

L'utente deve essere il proprietario del set di dati.

Ambito obbligatorio

Dataset.ReadWrite.All

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
 path True

string

ID del set di dati
groupId
 path True

string

uuid

ID area di lavoro

Corpo della richiesta

Nome Tipo Descrizione
queryScaleOutSettings

DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
targetStorageMode

string

Modalità di archiviazione del set di dati

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229
Request Body
{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Sample Response

Status code:
200

Definizioni

Nome Descrizione
DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
UpdateDatasetRequest

Aggiornare la richiesta del set di dati

DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati

Nome Tipo Descrizione
autoSyncReadOnlyReplicas

boolean

Se il set di dati sincronizza automaticamente le repliche di sola lettura
maxReadOnlyReplicas

integer

Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche)

UpdateDatasetRequest

Aggiornare la richiesta del set di dati

Nome Tipo Descrizione
queryScaleOutSettings

DatasetQueryScaleOutSettings

Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
targetStorageMode

string

Modalità di archiviazione del set di dati