Datasets - Update Dataset

Service:: Power BI REST APIs

Versione API:: v1.0

Aggiorna le proprietà per il modello semantico specificato. Il modello semantico può risiedere nell'area di lavoro personale o in un'altra area di lavoro, purché il chiamante disponga delle autorizzazioni necessarie.

Autorizzazioni

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

Ambito obbligatorio

Dataset.ReadWrite.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID set di dati

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

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

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Corpo della richiesta

{
  "targetStorageMode": "PremiumFiles"
}

Risposta di esempio

Codice di stato:: 200

Example of changing the dataset storage mode to support small datasets

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Corpo della richiesta

{
  "targetStorageMode": "Abf"
}

Risposta di esempio

Codice di stato:: 200

Example of updating scale-out settings of a dataset

Esempio di richiesta

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229

Corpo della richiesta

{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Risposta di esempio

Codice di stato:: 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

Oggetto

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

Nome	Tipo	Descrizione
autoSyncReadOnlyReplicas	boolean	Indica se il set di dati sincronizza automaticamente le repliche di sola lettura
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche)

UpdateDatasetRequest

Oggetto

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