Vai al contenuto principale

Power BI connector (REST API)

Utilizzare il connettore REST API Power BI per recuperare dati con i servizi OData di Cognite o altre API Cognite utilizzando GET, POST e le query GraphQL per i modelli di dati Cognite.

Beta

Le funzionalità descritte in questa sezione sono attualmente in beta testing presso alcuni clienti, pertanto sono soggette a modifiche.

Impostazione di una connessione a Cognite Data Fusion (CDF)​

Effettuare la seguente procedura per connettere un progetto Cognite Data Fusion (CDF) come origine dati in Power BI:

  1. In Power BI Desktop accedere con l'account dell'organizzazione.

  2. Nella scheda Home selezionare Get Data, quindi More. Nella finestra di dialogo Recupera dati cercare Cognite e selezionare il connettore Cognite Data Fusion (API REST).

    Individuazione del connettore API REST di CDF in Power BI

  3. Nella finestra di dialogo immettere dettagli per configurare la connessione a CDF:

    • CDF project: Immettere il nome del progetto CDF a cui si è connessi.

    • CDF organization: Immettere l'organizzazione da utilizzare per accedere a CDF.

    Configurazione del connettore API REST di CDF in Power BI

  4. Alla richiesta, accedere con le credenziali dell'account.

  5. Selezionare Connect per aprire la finestra Navigator.

  6. Selezionare la funzione o le funzioni che si desidera utilizzare, quindi selezionare Trasforma dati per aprire Power Query Editor e recuperare dati da CDF.

    Selezione di funzioni utilizzando il connettore API REST in Power BI

Utilizzare le dimensioni pagina massime supportate se si creano richieste che supportano l'impaginazione (tramite parametri limit nelle richieste GET/POST o il parametro first nelle query GraphQL). Dimensioni pagina ridotte aumentano le chiamate API e possono influire in modo significativo sui tempi di carico. Vedere la documentazione delle API Cognite per conoscere le dimensioni pagina massime supportate per ogni endpoint. Per le query GraphQL, il limite massimo è 1000 istanze per pagina.

Filtro dei dati​

Quando si utilizzano le funzioni API REST, è possibile applicare filtri lato server per ridurre i dati iniziali da caricare in Power BI.

Se si utilizza OData, Power BI può eseguire il pushdown di alcuni filtri al servizio OData quando si utilizza l'editor di Power Query.

Per le query GraphQL, è possibile applicare filtri direttamente nella query per ridurre la quantità di dati caricati in Power BI. È anche possibile utilizzare le variabili di query GraphQL per parametrizzare le query e renderle più utilizzabili.

Aggiornamento programmato​

Dopo aver pubblicato il report nel servizio Power BI, è possibile programmare gli aggiornamenti dati per mantenerli aggiornati.

Gestione degli errori​

Quando si scrivono richieste GET e POST personalizzate, è possibile ricevere errori se si fornisce un corpo o un URL non valido. Se si riceve un messaggio di errore CogniteAPIError, vedere la documentazione di riferimento delle API Cognite e modificare la richiesta.

Ultimo aggiornamento