Partilhar via

Reports - Update Datasources

Serviço:
Power BI REST APIs
Versão da API:
v1.0

Atualiza as fontes de dados do RDL (relatório paginado) especificado do Meu workspace.

Importante

A fonte de dados original e a nova fonte de dados devem ter exatamente o mesmo esquema.

Permissões

O usuário deve ser o proprietário da fonte de dados.

Escopo necessário

Reports.ReadWrite.All

Limitações

  • Só dá suporte a relatórios paginados.

  • Não há suporte para alterar o tipo de fonte de dados.

  • Não há suporte para ODBC (Open Database Connectivity). 

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Default.UpdateDatasources

Parâmetros de URI

Nome Em Obrigatório Tipo Description
reportId
 path True

string (uuid)

A ID do relatório

Corpo da solicitação

Nome Obrigatório Tipo Description
updateDetails True

UpdateRdlDatasourceDetails[]

Os detalhes da atualização das fontes de dados do relatório paginado

Respostas

Nome Tipo Description
200 OK

OKEY

Exemplos

Example

Solicitação de exemplo

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources
Corpo da solicitação
{
  "updateDetails": [
    {
      "datasourceName": "SqlDatasource",
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceName": "SqlAzureDatasource",
      "connectionDetails": {
        "server": "New-SqlAzure-Server.windows.net",
        "database": "New-SqlAzure-Database"
      }
    }
  ]
}

Resposta de exemplo

Código de status:
200

Definições

Nome Description
RdlDatasourceConnectionDetails

Os detalhes da conexão de uma fonte de dados de relatório paginada
UpdateRdlDatasourceDetails

Atualizar detalhes de uma fonte de dados de relatório paginada
UpdateRdlDatasourcesRequest

Uma solicitação para atualizar as fontes de dados de um relatório paginado

RdlDatasourceConnectionDetails

Objeto

Os detalhes da conexão de uma fonte de dados de relatório paginada

Nome Tipo Description
database

string

O banco de dados de conexão
server

string

O servidor de conexão

UpdateRdlDatasourceDetails

Objeto

Atualizar detalhes de uma fonte de dados de relatório paginada

Nome Tipo Description
connectionDetails

RdlDatasourceConnectionDetails

Os novos detalhes de conexão para a fonte de dados do relatório paginado
datasourceName

string

O nome da fonte de dados do relatório paginado

UpdateRdlDatasourcesRequest

Objeto

Uma solicitação para atualizar as fontes de dados de um relatório paginado

Nome Tipo Description
updateDetails

UpdateRdlDatasourceDetails[]

Os detalhes da atualização das fontes de dados do relatório paginado