Condividi tramite


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

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
datasetId
path True

string

groupId
path True

string (uuid)

ID dell'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

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

DatasourceConnectionDetails

Dettagli della connessione all'origine dati di Power BI. Vedere esempi in Ottenere origini dati o Recupera origini dati in.

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

DatasourceConnectionDetails

Dettagli della connessione di destinazione dell'origine dati aggiornata

datasourceSelector

Datasource

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

UpdateDatasourceConnectionRequest[]

Matrice di richieste di aggiornamento della connessione all'origine dati