Datasets - Update Datasources

Atualizações as fontes de dados do conjunto de dados especificado de Meu workspace.

Observação

É recomendável usar metadados aprimorados do conjunto de dados com essa chamada à API.

Importante

  • A fonte de dados original e a nova fonte de dados devem ter exatamente o mesmo esquema.
  • Se você estiver usando metadados aprimorados do conjunto de dados, atualize o conjunto de dados para obter dados das novas fontes de dados.
  • Se você não estiver usando metadados aprimorados do conjunto de dados, aguarde 30 minutos para que a operação de atualização de fontes de dados seja concluída e atualize o conjunto de dados.

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 ponto de extremidade XMLA público. Para fazer alterações nessas fontes de dados, o administrador deve usar a biblioteca de clientes Azure Analysis Services para o Modelo de Objeto Tabular.
  • Somente essas fontes de dados têm suporte: SQL Server, SQL do Azure Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata e SAP HANA. Para outras fontes de dados, use a chamada à API Atualizar Parâmetros .
  • Não há suporte para a alteração do tipo de fonte de dados.
  • Não há suporte para fontes de dados que contêm parâmetros no 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 a chamada à API de Parâmetros de Atualização .
  • 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 resultado da atualização parcial das fontes de dados, para superar isso, você pode tentar executar uma atualização de 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

Nome Em Obrigatório Tipo Description
datasetId
path True

string

A ID do conjunto de dados

Corpo da solicitação

Nome Obrigatório Tipo Description
updateDetails True

UpdateDatasourceConnectionRequest[]

Uma matriz de solicitações de atualização de conexão de fonte de dados

Respostas

Nome Tipo Description
200 OK

OK

Exemplos

Example

Sample Request

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

Sample Response

Definições

Nome Description
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 em 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

Datasource

Uma fonte de dados do Power BI

Nome Tipo Description
connectionDetails

DatasourceConnectionDetails

Os detalhes da conexão da fonte de dados

connectionString

string

(Preterido) A fonte de dados cadeia de conexão. Disponível apenas para DirectQuery.

datasourceId

string

A ID da fonte de dados associada, que está vazia quando não está associada a um gateway

datasourceType

string

O tipo de fonte de dados

gatewayId

string

A ID do gateway associado, que está vazia quando não está associada a um gateway. Ao usar um cluster de gateway, a ID do gateway refere-se ao gateway primário (primeiro) no cluster e é semelhante à ID do cluster de gateway.

name

string

(Preterido) O nome da fonte de dados. Disponível apenas para DirectQuery.

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 em Grupo.

Nome Tipo Description
account

string

A conta de conexão

classInfo

string

As informações da classe de conexão

database

string

O banco de dados de conexão

domain

string

O domínio de conexão

emailAddress

string

O endereço de email de conexão

kind

string

O tipo de conexão

loginServer

string

O servidor de logon de conexão

path

string

O caminho da conexão

server

string

O servidor de conexão

url

string

A URL de conexão

UpdateDatasourceConnectionRequest

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

Nome Tipo Description
connectionDetails

DatasourceConnectionDetails

Os detalhes de conexão de destino da fonte de dados atualizada

datasourceSelector

Datasource

Os detalhes da conexão da fonte de dados que precisa de atualização. Isso é obrigatório quando um conjunto de dados tem mais de uma fonte de dados.

UpdateDatasourcesRequest

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

Nome Tipo Description
updateDetails

UpdateDatasourceConnectionRequest[]

Uma matriz de solicitações de atualização de conexão de fonte de dados