Datasets - Update Parameters In Group
지정된 작업 영역에서 지정된 데이터 세트의 매개 변수 값을 업데이트합니다.
비고
이 API 호출에 향상된 데이터 세트 메타데이터 를 사용하는 것이 좋습니다.
중요합니다
- 향상된 데이터 세트 메타데이터를 사용하는 경우 데이터 세트를 새로 고쳐 새 매개 변수 값을 적용합니다.
- 향상된 데이터 세트 메타데이터를 사용하지 않는 경우 업데이트 데이터 원본 작업이 완료될 때까지 30분 동안 기다린 다음 데이터 세트를 새로 고칩니다.
Permissions
- 사용자는 데이터 세트 소유자여야 합니다.
- 이 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
샘플 요청
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"
}
]
}
샘플 응답
정의
| Name | Description |
|---|---|
|
Update |
Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보 |
|
Update |
Power BI 데이터 세트 매개 변수에 대한 업데이트 요청 |
UpdateMashupParameterDetails
Power BI 데이터 세트 매개 변수에 대한 업데이트 세부 정보
| Name | 형식 | Description |
|---|---|---|
| name |
string |
매개 변수 이름 |
| newValue |
string |
매개 변수의 새 값 |
UpdateMashupParametersRequest
Power BI 데이터 세트 매개 변수에 대한 업데이트 요청
| Name | 형식 | Description |
|---|---|---|
| updateDetails |
업데이트할 데이터 세트 매개 변수 목록 |