Datasets - Update Datasources In Group

Atualiza as fontes de dados do conjunto de dados especificado do workspace especificado.

Permissões

• O usuário deve ser o proprietário do conjunto de dados.
• Essa chamada à API pode ser chamada por um perfil de entidade de serviço. Para obter mais informações, consulte: Perfis de entidade de serviço no Power BI Embedded.

Escopo necessário

Dataset.ReadWrite.All

Limitações

• Não há suporte para conjuntos de dados criados ou modificados usando o de ponto de extremidade XMLA público. Para fazer alterações nessas fontes de dados, o administrador deve usar a biblioteca de clientes do Azure Analysis Services para o Modelo de Objeto Tabular.
• Somente essas fontes de dados têm suporte: SQL Server, SQL Server do Azure, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata e SAP HANA. Para outras fontes de dados, use os parâmetros de atualização na chamada à API de grupo.
• Não há suporte para alterar o tipo de fonte de dados.
• Não há suporte para fontes de dados que contêm parâmetros na cadeia de conexão.
• A atualização de fontes de dados que fazem parte de tabelas mescladas ou unidas só terá suporte se você estiver usando metadados aprimorados do conjunto de dados.
• Para uma Consulta Avançada que faça referência a várias fontes de dados, somente a primeira fonte de dados será atualizada. Para superar essa limitação, defina a fonte de dados como um parâmetro e use os parâmetros de atualização na chamada à API grupo.
• Não há suporte total para conjuntos de dados com política de atualização incremental, chamar essa API pode não funcionar conforme o esperado e o resultado da atualização parcial das fontes de dados, para superar isso, você pode tentar executar uma atualização do conjunto de dados antes de chamar essa API.
  
  

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

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

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

Definições

Datasource

Uma fonte de dados do Power BI

DatasourceConnectionDetails

Os detalhes da conexão da fonte de dados do Power BI. Veja exemplos em Obter fontes de dados ou obter fontes de dados no grupo.

UpdateDatasourceConnectionRequest

Solicitação de atualização de conexão da fonte de dados do conjunto de dados do Power BI

UpdateDatasourcesRequest

Solicitação de atualização de fontes de dados do conjunto de dados do Power BI