Datasets - Update Datasources In Group

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

사용 권한

• 사용자는 데이터 세트 소유자여야 합니다.
• 이 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 매개 변수

요청 본문

응답

예제

Example

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

{
  "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"
      }
    }
  ]
}

정의

Datasource

Power BI 데이터 원본

DatasourceConnectionDetails

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

UpdateDatasourceConnectionRequest

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

UpdateDatasourcesRequest

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