Partilhar via


Datasets - Update Dataset In Group

Atualizações as propriedades do conjunto de dados especificado do workspace especificado.

Permissões

O usuário deve ser o proprietário do conjunto de dados.

Escopo necessário

Dataset.ReadWrite.All

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
datasetId
path True

string

A ID do conjunto de dados

groupId
path True

string

uuid

A ID do workspace

Corpo da solicitação

Nome Tipo Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

Consultar configurações de expansão de um conjunto de dados

targetStorageMode

string

O modo de armazenamento do conjunto de dados

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

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
{
  "targetStorageMode": "PremiumFiles"
}

Sample Response

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
{
  "targetStorageMode": "Abf"
}

Sample Response

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
{
  "queryScaleOutSettings": {
    "autoSyncReadOnlyReplicas": false,
    "maxReadOnlyReplicas": -1
  }
}

Sample Response

Definições

Nome Description
DatasetQueryScaleOutSettings

Consultar configurações de expansão de um conjunto de dados

UpdateDatasetRequest

Atualizar solicitação de conjunto de dados

DatasetQueryScaleOutSettings

Consultar configurações de expansão de um conjunto de dados

Nome Tipo Description
autoSyncReadOnlyReplicas

boolean

Se o conjunto de dados sincroniza automaticamente réplicas somente leitura

maxReadOnlyReplicas

integer

Número máximo de réplicas somente leitura para o conjunto de dados (0-64, -1 para o número automático de réplicas)

UpdateDatasetRequest

Atualizar solicitação de conjunto de dados

Nome Tipo Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

Consultar configurações de expansão de um conjunto de dados

targetStorageMode

string

O modo de armazenamento do conjunto de dados