Datasets - Update Parameters In Group
지정된 작업 영역에서 지정된 데이터 세트의 매개 변수 값을 업데이트.
참고
이 API 호출 과 함께 향상된 데이터 세트 메타데이터 를 사용하는 것이 좋습니다.
중요
- 향상된 데이터 세트 메타데이터를 사용하는 경우 데이터 세트를 새로 고쳐 새 매개 변수 값을 적용합니다.
- 향상된 데이터 세트 메타데이터를 사용하지 않는 경우 업데이트 데이터 원본 작업이 완료될 때까지 30분 동안 기다린 다음 데이터 세트를 새로 고칩니다.
사용 권한
- 사용자는 데이터 세트 소유자여야 합니다.
- 이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.
필수 범위
Dataset.ReadWrite.All
제한 사항
- 공용 XMLA 엔드포인트 를 사용하여 만들거나 수정한 데이터 세트는 지원되지 않습니다. 이러한 데이터 세트를 변경하려면 관리자는 테이블 형식 개체 모델에 Azure Analysis Services 클라이언트 라이브러리를 사용해야 합니다.
- DirectQuery 연결은 향상된 데이터 세트 메타데이터에서만 지원됩니다.
- Azure Analysis Services 라이브 연결이 있는 데이터 세트는 지원되지 않습니다.
- 요청당 최대 100 매개 변수입니다.
- 지정된 모든 매개 변수가 데이터 세트에 있어야 합니다.
- 매개 변수 값은 예상 형식이어야 합니다.
- 매개 변수 목록은 비어 있거나 중복 매개 변수를 포함할 수 없습니다.
- 매개 변수 이름은 대/소문자를 구분합니다.
- 매개 변수
IsRequired
에는 비어 있지 않은 값이 있어야 합니다. - 매개 변수 형식
Any
및Binary
은 업데이트할 수 없습니다.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateParameters
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
|
group
|
path | True |
string uuid |
작업 영역 ID |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
updateDetails | True |
업데이트할 데이터 세트 매개 변수 목록 |
응답
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 |
---|---|
Update |
Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보 |
Update |
Power BI 데이터 세트 매개 변수에 대한 업데이트 요청 |
UpdateMashupParameterDetails
Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보
Name | 형식 | Description |
---|---|---|
name |
string |
매개 변수 이름 |
newValue |
string |
매개 변수의 새 값 |
UpdateMashupParametersRequest
Power BI 데이터 세트 매개 변수에 대한 업데이트 요청
Name | 형식 | Description |
---|---|---|
updateDetails |
업데이트할 데이터 세트 매개 변수 목록 |