Datasets - Update Datasources In Group
Aggiorna le origini dati del set di dati specificato dall'area di lavoro specificata.
Nota
È consigliabile usare metadati del set di dati avanzati con questa chiamata API.
Importante
- L'origine dati originale e la nuova origine dati devono avere lo stesso schema.
- Se si usa metadati avanzati del set di dati, aggiornare il set di dati per ottenere dati dalle nuove origini dati.
- Se non si usa metadati del set di dati avanzati, attendere 30 minuti per il completamento dell'operazione di aggiornamento delle origini dati e quindi aggiornare il set di dati.
Autorizzazioni
- L'utente deve essere il proprietario del set di dati.
- Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: profili entità servizio in Power BI Embedded.
Ambito obbligatorio
Dataset.ReadWrite.All
Limitazioni
- I set di dati creati o modificati usando l'endpoint XMLA pubblico non sono supportati. Per apportare modifiche a tali origini dati, l'amministratore deve usare la libreria client di Azure Analysis Services per il modello a oggetti tabulare.
- Sono supportate solo queste origini dati: SQL Server, Azure SQL Server, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata e SAP HANA. Per altre origini dati, usare la chiamata API Update Parameters In Group.
- La modifica del tipo di origine dati non è supportata.
- Le origini dati che contengono parametri nella stringa di connessione non sono supportate.
- L'aggiornamento di origini dati che fanno parte di tabelle unite o unite è supportato solo se si usano metadati del set di dati avanzati.
- Per una query avanzata che fa riferimento a più origini dati, verrà aggiornata solo la prima origine dati. Per superare questa limitazione, definire l'origine dati come parametro e usare la chiamata API Update Parameters In Group.
- I set di dati con criteri di aggiornamento incrementale non sono completamente supportati, la chiamata a questa API potrebbe non funzionare come previsto e il risultato dell'aggiornamento parziale delle origini dati, per risolvere questo problema, è possibile provare a eseguire un aggiornamento del set di dati prima di chiamare questa API.
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/Default.UpdateDatasources
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
|
|
group
|
path | True |
string (uuid) |
ID dell'area di lavoro |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| updateDetails | True |
Matrice di richieste di aggiornamento della connessione all'origine dati |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Va bene |
Esempio
Example
Esempio di richiesta
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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"
}
}
]
}
Risposta di esempio
Definizioni
| Nome | Descrizione |
|---|---|
| Datasource |
Un'origine dati di Power BI |
|
Datasource |
Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in. |
|
Update |
Richiesta di aggiornamento della connessione all'origine dati del set di dati di Power BI |
|
Update |
Richiesta di aggiornamento delle origini dati del set di dati di Power BI |
Datasource
Un'origine dati di Power BI
| Nome | Tipo | Descrizione |
|---|---|---|
| connectionDetails |
Dettagli della connessione all'origine dati |
|
| connectionString |
string |
(Deprecato) Stringa di connessione dell'origine dati. Disponibile solo per DirectQuery. |
| datasourceId |
string (uuid) |
ID origine dati associata, vuoto quando non associato a un gateway |
| datasourceType |
string |
Tipo di origine dati |
| gatewayId |
string (uuid) |
ID del gateway associato, vuoto quando non associato a un gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster ed è simile all'ID cluster del gateway. |
| name |
string |
(Deprecato) Nome dell'origine dati. Disponibile solo per DirectQuery. |
DatasourceConnectionDetails
Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in.
| Nome | Tipo | Descrizione |
|---|---|---|
| account |
string |
Account di connessione |
| classInfo |
string |
Informazioni sulla classe di connessione |
| database |
string |
Database di connessione |
| domain |
string |
Dominio di connessione |
| emailAddress |
string |
Indirizzo di posta elettronica di connessione |
| kind |
string |
Tipo di connessione |
| loginServer |
string |
Server di accesso alla connessione |
| path |
string |
Percorso di connessione |
| server |
string |
Server di connessione |
| url |
string |
URL di connessione |
UpdateDatasourceConnectionRequest
Richiesta di aggiornamento della connessione all'origine dati del set di dati di Power BI
| Nome | Tipo | Descrizione |
|---|---|---|
| connectionDetails |
Dettagli della connessione di destinazione dell'origine dati aggiornata |
|
| datasourceSelector |
Dettagli della connessione dell'origine dati che richiede l'aggiornamento. Questa operazione è obbligatoria quando un set di dati ha più di un'origine dati. |
UpdateDatasourcesRequest
Richiesta di aggiornamento delle origini dati del set di dati di Power BI
| Nome | Tipo | Descrizione |
|---|---|---|
| updateDetails |
Matrice di richieste di aggiornamento della connessione all'origine dati |