Share via

Datasets - Update Dataset

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

내 작업 영역에서 지정된 데이터 세트의 속성을 업데이트.

사용 권한

사용자는 데이터 세트 소유자여야 합니다.

필수 범위

Dataset.ReadWrite.All

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
 path True

string

데이터 세트 ID

요청 본문

Name 형식 Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리
targetStorageMode

string

데이터 세트 스토리지 모드

응답

Name 형식 Description
200 OK

정상

예제

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

정의

Name Description
DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리
UpdateDatasetRequest

데이터 세트 요청 업데이트

DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리

Name 형식 Description
autoSyncReadOnlyReplicas

boolean

데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부
maxReadOnlyReplicas

integer

데이터 세트의 최대 읽기 전용 복제본 수(자동 복제본 수의 경우 0-64, -1)

UpdateDatasetRequest

데이터 세트 요청 업데이트

Name 형식 Description
queryScaleOutSettings

DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리
targetStorageMode

string

데이터 세트 스토리지 모드