Datasets - Update Datasources In Group

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Aggiornamenti 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 usano metadati del set di dati avanzati, aggiornare il set di dati per ottenere dati dalle nuove origini dati.
Se non si usano 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 dell'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 Azure Analysis Services per il modello a oggetti tabulari.
Sono supportate solo queste origini dati: SQL Server, server Azure SQL, Azure Analysis Services, Azure Synapse, OData, SharePoint, Teradata e SAP HANA. Per altre origini dati, usare la chiamata Update Parameters In Group API .For other data sources, use the Update Parameters In Group API call.For other data sources, use the Update Parameters In Group API call.
La modifica del tipo di origine dati non è supportata.
Le origini dati che contengono parametri nella stringa di connessione non sono supportate.
L'aggiornamento delle 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 update Parameters In Group API .
I set di dati con criteri di aggiornamento incrementale non sono completamente supportati, la chiamata di questa API potrebbe non funzionare come previsto e il risultato dell'aggiornamento parziale delle origini dati, per superare 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
datasetId	path	True	string
groupId	path	True	string uuid	ID area di lavoro

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
updateDetails	True	UpdateDatasourceConnectionRequest[]	Matrice di richieste di aggiornamento della connessione all'origine dati

Risposte

Nome	Tipo	Descrizione
200 OK		OK

Esempio

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

Definizioni

Nome	Descrizione
Datasource	Origine dati di Power BI
DatasourceConnectionDetails	Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Get Datasources o Get Datasources In Group.
UpdateDatasourceConnectionRequest	Richiesta di aggiornamento della connessione all'origine dati del set di dati di Power BI
UpdateDatasourcesRequest	Richiesta di aggiornamento delle origini dati del set di dati di Power BI

Datasource

Origine dati di Power BI

Nome	Tipo	Descrizione
connectionDetails	DatasourceConnectionDetails	Dettagli della connessione all'origine dati
connectionString	string	(Deprecato) Origine dati stringa di connessione. Disponibile solo per DirectQuery.
datasourceId	string	ID origine dati associato, vuoto quando non associato a un gateway
datasourceType	string	Tipo di origine dati
gatewayId	string	ID 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 del cluster gateway.
name	string	(Deprecato) Nome origine dati. Disponibile solo per DirectQuery.

DatasourceConnectionDetails

Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Get Datasources o Get Datasources In Group.

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	DatasourceConnectionDetails	Dettagli della connessione di destinazione dell'origine dati aggiornata
datasourceSelector	Datasource	Dettagli della connessione dell'origine dati che richiede l'aggiornamento. Questo è obbligatorio 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	UpdateDatasourceConnectionRequest[]	Matrice di richieste di aggiornamento della connessione all'origine dati