Datasets - Update Datasources In Group

Service:

Power BI REST APIs

API Version:

v1.0

지정된 작업 영역에서 지정된 데이터 세트의 데이터 원본을 업데이트.

참고

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

중요

• 원래 데이터 원본과 새 데이터 원본에는 정확히 동일한 스키마가 있어야 합니다.
• 향상된 데이터 세트 메타데이터를 사용하는 경우 데이터 세트를 새로 고쳐 새 데이터 원본에서 데이터를 가져옵니다.
• 향상된 데이터 세트 메타데이터를 사용하지 않는 경우 업데이트 데이터 원본 작업이 완료될 때까지 30분 정도 기다린 다음 데이터 세트를 새로 고칩니다.

사용 권한

• 사용자는 데이터 세트 소유자여야 합니다.
• 이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All

제한 사항

• 공용 XMLA 엔드포인트 를 사용하여 만들거나 수정한 데이터 세트는 지원되지 않습니다. 이러한 데이터 원본을 변경하려면 관리자는 테이블 형식 개체 모델에 Azure Analysis Services 클라이언트 라이브러리를 사용해야 합니다.
• SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata 및 SAP HANA와 같은 데이터 원본만 지원됩니다. 다른 데이터 원본의 경우 그룹 API 호출 에서 매개 변수 업데이트 를 사용합니다.
• 데이터 원본 형식 변경은 지원되지 않습니다.
• 연결 문자열 매개 변수를 포함하는 데이터 원본은 지원되지 않습니다.
• 병합되거나 조인된 테이블의 일부인 데이터 원본 업데이트는 향상된 데이터 세트 메타데이터를 사용하는 경우에만 지원됩니다.
• 여러 데이터 원본을 참조하는 고급 쿼리의 경우 첫 번째 데이터 원본만 업데이트됩니다. 이러한 제한을 극복하려면 데이터 원본을 매개 변수로 정의하고 그룹 API에서 매개 변수 업데이트 호출을 사용합니다.
• 증분 새로 고침 정책이 있는 데이터 세트는 완전히 지원되지 않습니다. 이 API를 호출하는 것은 예상대로 작동하지 않을 수 있으며 부분 데이터 원본 업데이트의 결과일 수 있습니다. 이를 극복하기 위해 이 API를 호출하기 전에 데이터 세트 새로 고침을 실행해 볼 수 있습니다.
  
  

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string
groupId	path	True	string uuid	작업 영역 ID

요청 본문

Name	필수	형식	Description
updateDetails	True	UpdateDatasourceConnectionRequest[]	데이터 원본 연결 업데이트 요청의 배열

응답

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.UpdateDatasources

Request Body

{
  "updateDetails": [
    {
      "datasourceSelector": {
        "datasourceType": "Sql",
        "connectionDetails": {
          "server": "My-Sql-Server",
          "database": "My-Sql-Database"
        }
      },
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceSelector": {
        "datasourceType": "OData",
        "connectionDetails": {
          "url": "http://services.odata.org/V4/Northwind/Northwind.svc"
        }
      },
      "connectionDetails": {
        "url": "http://services.odata.org/V4/Odata/Northwind.svc"
      }
    }
  ]
}

Sample Response

Status code:

200

정의

Name	Description
Datasource	Power BI 데이터 원본
DatasourceConnectionDetails	Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.
UpdateDatasourceConnectionRequest	Power BI 데이터 세트 데이터 원본 연결 업데이트 요청
UpdateDatasourcesRequest	Power BI 데이터 세트 데이터 원본 업데이트 요청

Datasource

Power BI 데이터 원본

Name	형식	Description
connectionDetails	DatasourceConnectionDetails	데이터 원본 연결 세부 정보
connectionString	string	(사용되지 않음) 데이터 원본 연결 문자열. DirectQuery에만 사용할 수 있습니다.
datasourceId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 데이터 원본 ID
datasourceType	string	데이터 원본 형식
gatewayId	string	게이트웨이에 바인딩되지 않은 경우 비어 있는 바인딩된 게이트웨이 ID입니다. 게이트웨이 클러스터를 사용하는 경우 게이트웨이 ID는 클러스터의 기본(첫 번째) 게이트웨이를 참조하며 게이트웨이 클러스터 ID와 유사합니다.
name	string	(사용되지 않음) 데이터 원본 이름입니다. DirectQuery에만 사용할 수 있습니다.

DatasourceConnectionDetails

Power BI 데이터 원본 연결 세부 정보입니다. 데이터 원본 가져오기 또는 그룹 내 데이터 원본 가져오기의 예제를 참조하세요.

Name	형식	Description
account	string	연결 계정
classInfo	string	연결 클래스 정보
database	string	연결 데이터베이스
domain	string	연결 도메인
emailAddress	string	연결 전자 메일 주소
kind	string	연결 종류
loginServer	string	연결 로그인 서버
path	string	연결 경로
server	string	연결 서버
url	string	연결 URL

UpdateDatasourceConnectionRequest

Power BI 데이터 세트 데이터 원본 연결 업데이트 요청

Name	형식	Description
connectionDetails	DatasourceConnectionDetails	업데이트된 데이터 원본의 대상 연결 세부 정보
datasourceSelector	Datasource	업데이트가 필요한 데이터 원본의 연결 세부 정보입니다. 데이터 세트에 둘 이상의 데이터 원본이 있는 경우 필수입니다.

UpdateDatasourcesRequest

Power BI 데이터 세트 데이터 원본 업데이트 요청

Name	형식	Description
updateDetails	UpdateDatasourceConnectionRequest[]	데이터 원본 연결 업데이트 요청의 배열