Datasets - Update Datasources

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Aggiornamenti le origini dati del set di dati specificato dall'area di lavoro personale.

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 avanzati del set di dati, 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.

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 tabulare.
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 API Update Parameters .
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 API Update Parameters .
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.

Ambito obbligatorio

Dataset.ReadWrite.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID del set di dati

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/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	Un'origine dati di Power BI
DatasourceConnectionDetails	Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Recupera origini dati o Recupera origini dati in gruppo.
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

Un'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 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 Recupera origini dati o Recupera origini dati in gruppo.

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 della 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