Datasets - Update Datasources

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

Permissões

O usuário deve ser o proprietário do conjunto de dados.

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 a chamada Atualizar Parâmetros API.
• 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 faz 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 chamada à API.
• 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.

Escopo necessário

Dataset.ReadWrite.All

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

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Example

POST https://api.powerbi.com/v1.0/myorg/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