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 |
---|---|---|---|---|
dataset
|
path | True |
string |
A ID do conjunto de dados |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
updateDetails | True |
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 |
Datasource |
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. |
Update |
Solicitação de atualização de conexão da fonte de dados do conjunto de dados do Power BI |
Update |
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 |
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 |
Os detalhes de conexão de destino da fonte de dados atualizada |
|
datasourceSelector |
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 |
Uma matriz de solicitações de atualização de conexão de fonte de dados |