Connettersi a GitHub con Power BI
Questo articolo illustra come eseguire il pull dei dati dall'account GitHub con un'app modello di Power BI. L'app modello genera un'area di lavoro con un dashboard, un set di report e un modello semantico per consentire di esplorare i dati di GitHub. L'app GitHub per Power BI permette di ottenere informazioni dettagliate su un repository GitHub con dati relativi a contributi, problemi, richieste pull e utenti attivi.
Dopo avere installato l'app modello, è possibile modificare il dashboard e il report. È quindi possibile eseguirne la distribuzione come app ai colleghi dell'organizzazione.
Connettersi all'app modello GitHub oppure leggere altre informazioni sull'integrazione di GitHub con Power BI.
È anche possibile provare l'esercitazione su GitHub. Vengono installati dati di GitHub reali sul repository pubblico per la documentazione di Power BI.
Nota
Questa app modello richiede che l'account GitHub abbia accesso al repository. Di seguito sono fornite informazioni più dettagliate sui requisiti.
Questa app modello non supporta GitHub Enterprise.
Installare l'app
Fare clic sul collegamento seguente per accedere all'app: app modello GitHub
Nella pagina di AppSource per l'app selezionare Scarica adesso.
Selezionare Installa.
Dopo l'installazione, l'app sarà visualizzata nella pagina App.
Connettersi alle origini dati
Selezionare l'icona nella pagina App per aprire l'app.
L'app viene aperta e visualizza dati di esempio.
Selezionare il collegamento Connettere i dati nel banner nella parte superiore della pagina.
Viene visualizzata la finestra di dialogo dei parametri, che consente di modificare l'origine dati cambiandola dai dati di esempio alla propria origine dati (vedere Limitazioni note), seguita dalla finestra di dialogo del metodo di autenticazione. Potrebbe essere necessario ridefinire i valori in queste finestre di dialogo.
Immettere le credenziali di GitHub e seguire il processo di autenticazione di GitHub. È possibile saltare questo passaggio se è già stato effettuato l'accesso nel browser.
Dopo aver completato la compilazione delle finestre di dialogo di connessione e avere eseguito l'accesso a GitHub, viene avviato il processo di connessione. Un banner informa che i dati vengono aggiornati e che nel frattempo vengono visualizzati dati di esempio.
I dati del report verranno aggiornati automaticamente una volta al giorno, a meno che l'aggiornamento non sia stato disabilitato durante il processo di accesso. Volendo, è anche possibile configurare un aggiornamento pianificato per mantenere aggiornati i dati del report.
Personalizza e condividi
Per personalizzare e condividere l'app, selezionare l'icona della matita nell'angolo in alto a destra della pagina.
Per informazioni sulla modifica di elementi nell'area di lavoro, vedere
Dopo aver apportato eventuali modifiche agli elementi nell'area di lavoro, è possibile pubblicare e condividere l'app. Vedere Creare e pubblicare l'app per informazioni su come eseguire questa operazione.
Elementi inclusi nell'app
I dati seguenti sono disponibili da GitHub in Power BI:
| Nome tabella | Descrizione |
|---|---|
| Contributi | La tabella dei contributi fornisce il totale delle operazioni di aggiunta, eliminazione e commit effettuate dal collaboratore, aggregato per ogni settimana. Sono inclusi i 100 collaboratori principali. |
| Problemi | Elenca tutti i problemi per il repository selezionato e include calcoli quali il tempo totale e medio per la chiusura di un problema, il totale dei problemi aperti e il totale dei problemi chiusi. Questa tabella sarà vuota se il repository non include alcun problema. |
| Richieste pull | Questa tabella contiene tutte le richieste pull per il repository e gli autori di tali richieste. Contiene anche calcoli relativi a numero di richieste pull aperte, chiuse e totali, tempo necessario per il pull delle richieste e durata media delle richieste pull. Questa tabella sarà vuota se il repository non include richieste pull. |
| Utenti | Questa tabella fornisce un elenco di utenti o collaboratori di GitHub che hanno contribuito, hanno sottoposto problemi o hanno risolto richieste pull per il repository selezionato. |
| Passaggi fondamentali | Include tutte le attività cardine per il repository selezionato. |
| DateTable | Questa tabella contiene date a partire da quella corrente e per gli anni passati che consentono di analizzare i dati di GitHub in base alla data. |
| ContributionPunchCard | Questa tabella può essere usata come una scheda perforata di collaborazione per il repository selezionato. Mostra i commit in base al giorno della settimana e all'ora del giorno. Questa tabella non è connessa ad altre tabelle nel modello. |
| RepoDetails | Questa tabella fornisce dettagli per il repository selezionato. |
Requisiti di sistema
- Account GitHub autorizzato ad accedere al repository.
- Autorizzazione concessa a Power BI per l'app GitHub durante il primo accesso. Vedere i dettagli riportati di seguito relativi alla revoca dell'accesso.
- Chiamate API disponibili sufficienti per eseguire il pull e aggiornare i dati.
Nota
Questa app modello non supporta GitHub Enterprise.
Rimuovere le autorizzazioni per Power BI
Per rimuovere le autorizzazioni per la connessione di Power BI al repository GitHub, è possibile revocare l'accesso in GitHub. Per informazioni dettagliate, vedere questo argomento della guida di GitHub.
Individuazione dei parametri
È possibile determinare il proprietario e il repository esaminando il repository in GitHub:
La prima parte, "Azure", è il proprietario e la seconda parte, "azure-sdk-for-php", è il repository stesso. Questi due elementi sono visibili nell'URL del repository:
<https://github.com/Azure/azure-sdk-for-php> .
Risoluzione dei problemi
Se necessario, è possibile verificare le credenziali per GitHub.
- In un'altra finestra del browser passare al sito Web GitHub e accedere a GitHub. Per verificare se l'accesso è stato effettuato, vedere l'angolo superiore destro del sito GitHub.
- In GitHub passare all'URL del repository a cui si vuole accedere in Power BI. Ad esempio: https://github.com/dotnet/corefx.
- In Power BI provare a connettersi a GitHub. Nella finestra di dialogo di configurazione di GitHub usare i nomi del repository e del proprietario del repository per lo stesso repository.