Datasets - Update Datasources In Group

Referência

Service:: Power BI REST APIs

API Version:: v1.0

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

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.
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 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 Atualizar Parâmetros na API de Grupo .
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 referencia 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 Atualizar Parâmetros na API de 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 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.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
datasetId	path	True	string
groupId	path	True	string uuid	A ID do workspace

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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

Request Body

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

Status code:: 200

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