영어로 읽기

다음을 통해 공유


Datasets - Update Parameters In Group

지정된 작업 영역에서 지정된 데이터 세트의 매개 변수 값을 업데이트.

참고

이 API 호출 과 함께 향상된 데이터 세트 메타데이터 를 사용하는 것이 좋습니다.

중요

  • 향상된 데이터 세트 메타데이터를 사용하는 경우 데이터 세트를 새로 고쳐 새 매개 변수 값을 적용합니다.
  • 향상된 데이터 세트 메타데이터를 사용하지 않는 경우 업데이트 데이터 원본 작업이 완료될 때까지 30분 동안 기다린 다음 데이터 세트를 새로 고칩니다.

사용 권한

필수 범위

Dataset.ReadWrite.All

제한 사항

  • 공용 XMLA 엔드포인트 를 사용하여 만들거나 수정한 데이터 세트는 지원되지 않습니다. 이러한 데이터 세트를 변경하려면 관리자는 테이블 형식 개체 모델에 Azure Analysis Services 클라이언트 라이브러리를 사용해야 합니다.
  • DirectQuery 연결은 향상된 데이터 세트 메타데이터에서만 지원됩니다.
  • Azure Analysis Services 라이브 연결이 있는 데이터 세트는 지원되지 않습니다.
  • 요청당 최대 100 매개 변수입니다.
  • 지정된 모든 매개 변수가 데이터 세트에 있어야 합니다.
  • 매개 변수 값은 예상 형식이어야 합니다.
  • 매개 변수 목록은 비어 있거나 중복 매개 변수를 포함할 수 없습니다.
  • 매개 변수 이름은 대/소문자를 구분합니다.
  • 매개 변수 IsRequired 에는 비어 있지 않은 값이 있어야 합니다.
  • 매개 변수 형식 AnyBinary 은 업데이트할 수 없습니다.

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

URI 매개 변수

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

string

groupId
path True

string

uuid

작업 영역 ID

요청 본문

Name 필수 형식 Description
updateDetails True

UpdateMashupParameterDetails[]

업데이트할 데이터 세트 매개 변수 목록

응답

Name 형식 Description
200 OK

정상

예제

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateParameters
{
  "updateDetails": [
    {
      "name": "DatabaseName",
      "newValue": "NewDB"
    },
    {
      "name": "MaxId",
      "newValue": "5678"
    }
  ]
}

Sample Response

정의

Name Description
UpdateMashupParameterDetails

Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보

UpdateMashupParametersRequest

Power BI 데이터 세트 매개 변수에 대한 업데이트 요청

UpdateMashupParameterDetails

Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보

Name 형식 Description
name

string

매개 변수 이름

newValue

string

매개 변수의 새 값

UpdateMashupParametersRequest

Power BI 데이터 세트 매개 변수에 대한 업데이트 요청

Name 형식 Description
updateDetails

UpdateMashupParameterDetails[]

업데이트할 데이터 세트 매개 변수 목록