Condividi tramite

Google BigQuery (Microsoft Entra ID)

  • Articolo

Riepilogo

Articolo Descrizione
Stato di rilascio Disponibilità generale
Prodotti supportati Power BI (modelli semantici)
Power BI (flussi di dati)
Infrastruttura (Dataflow Gen2)
Power Apps (flussi di dati)
Tipi di autenticazione supportati Organizational account

Nota

Alcune funzionalità possono essere presenti in un prodotto, ma non altre a causa di pianificazioni di distribuzione e funzionalità specifiche dell'host.

Prerequisiti

È necessario un account Microsoft Entra ID per accedere a Google BigQuery (Microsoft Entra ID).

Capacità supportate

  • Import
  • DirectQuery (modelli semantici di Power BI)

Connettersi ai dati di Google BigQuery (Microsoft Entra ID) da Power Query Desktop

Per connettersi a Google BigQuery (MICROSOFT Entra ID) da Power Query Desktop, seguire questa procedura:

  1. Nell'esperienza Recupera dati cercare e selezionare Google BigQuery (Microsoft Entra ID). Altre informazioni: Dove ottenere i dati

    Screenshot con la finestra di dialogo Recupera dati, con l'accento sul connettore Google BigQuery (Microsoft Entra ID).

  2. Specificare un ID progetto di fatturazione, necessario per l'uso di questo connettore. Per usare opzioni avanzate, selezionare Opzioni avanzate. In caso contrario, selezionare Importa o DirectQuery e quindi selezionare OK per continuare. Altre informazioni: Opzioni avanzate

    Screenshot della finestra di dialogo Google BigQuery (Microsoft Entra ID), in cui si immette l'ID del progetto di fatturazione, selezionare Importa o DirectQuery e, facoltativamente, selezionare opzioni avanzate.

  3. Il connettore Google BigQuery (Microsoft Entra ID) supporta la connessione tramite un account Microsoft Entra ID. Selezionare Accedi per continuare.

    Screenshot della finestra di dialogo di autenticazione che indica che non è stato eseguito l'accesso.

  4. Dopo l'accesso, selezionare Connetti per continuare.

    Screenshot della finestra di dialogo di autenticazione dopo l'accesso.

  5. Dopo la connessione, viene visualizzata una finestra Strumento di navigazione che visualizza i dati disponibili nel server. Selezionare i dati nello strumento di navigazione. Selezionare quindi Trasforma dati per trasformare i dati in Power Query o Carica per caricare i dati in Power BI Desktop.

Connettersi ai dati di Google BigQuery (Microsoft Entra ID) da Power Query Online

Per connettersi a Google BigQuery (MICROSOFT Entra ID) da Power Query Online, seguire questa procedura:

  1. Nell'esperienza Recupera dati eseguire una ricerca per Google e quindi selezionare Google BigQuery (Microsoft Entra ID). Altre informazioni: Dove ottenere i dati

    Screenshot della finestra di dialogo Scegli origine dati con il connettore Google BigQuery (Microsoft Entra ID) evidenziato.

  2. Nella finestra di dialogo Google BigQuery (MICROSOFT Entra ID) potrebbe essere necessario creare una nuova connessione o selezionare una connessione esistente. Se si sta creando una nuova connessione, immettere l'ID progetto di fatturazione. Se si usano dati locali, selezionare un gateway dati locale.

    Screenshot della finestra di dialogo Connetti all'origine dati in cui immettere le credenziali e le impostazioni di connessione di Google BigQuery (Microsoft Entra ID).

  3. Per usare opzioni avanzate, selezionare Opzioni avanzate. Altre informazioni: Opzioni avanzate

  4. Dopo l'accesso, selezionare Avanti per continuare.

  5. Dopo la connessione, viene visualizzata una finestra Strumento di navigazione che visualizza i dati disponibili nel server. Selezionare i dati nello strumento di navigazione. Selezionare quindi Avanti per trasformare i dati in Power Query.

Connettersi tramite opzioni avanzate

Power Query Desktop e Power Query Online offrono un set di opzioni avanzate che è possibile aggiungere alla query, se necessario.

La tabella seguente elenca tutte le opzioni avanzate che è possibile impostare in Power Query Desktop e Power Query Online.

Opzione avanzata Descrizione
Usare l'API di archiviazione Flag che abilita l'uso dell'API di archiviazione di Google BigQuery. Questa opzione è true per impostazione predefinita. Questa opzione può essere impostata su false per non usare l'API di archiviazione e usare invece le API REST.
Durata del timeout della connessione Impostazione di connessione standard (in secondi) che controlla per quanto tempo Power Query attende il completamento di una connessione. È possibile modificare questo valore se la connessione non viene completata prima di 15 secondi (valore predefinito).
Durata del timeout del comando Per quanto tempo Power Query attende il completamento e la restituzione dei risultati di una query. Il valore predefinito dipende dal valore predefinito del driver. È possibile immettere un altro valore in minuti per mantenere la connessione aperta più a lungo.
URI destinatario URI che contiene l'ID> del <pool di lavoro che deve essere modificato nel nome del pool di lavoro usato durante la configurazione della configurazione OIDC. Il formato per il valore di Audience Uri è //iam.googleapis.com/locations/global/workforcePools/<workforce pool ID>/providers/azuread. Il valore predefinito per l'ID> del< pool di forza lavoro è powerquery-<TenantId>, dove< TenantId> è l'ID tenant di Power BI corrente. Se si aggiorna l'URI del gruppo di destinatari, la stringa immessa verrà usata così come è.
ProjectID Progetto su cui si desidera eseguire query native. Questa opzione è disponibile solo in Power Query Desktop.
Query nativa Per informazioni, vedere Importare dati da un database usando una query di database nativa. In questa versione della funzionalità di query del database nativo è necessario usare nomi di tabella completi nel formato Database.Schema.Table, ad esempio SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Questa opzione è disponibile solo in Power Query Desktop.

Dopo aver selezionato le opzioni avanzate necessarie, selezionare OK in Power Query Desktop o Avanti in Power Query Online per connettersi ai dati di Google BigQuery.

Limitazioni e considerazioni

Questa sezione descrive eventuali limitazioni o considerazioni del connettore Google BigQuery (Microsoft Entra ID).

Configurazioni OIDC

Il connettore Google BigQuery (Microsoft Entra ID) usa token JWT Microsoft Entra ID per connettere l'autenticazione basata su ID Di Microsoft Entra con la funzionalità Federazione della forza lavoro di Google. Pertanto, la configurazione sul lato autenticazione deve essere una configurazione basata su OIDC per allinearsi ai token JWT dell'ID Entra Microsoft. Contattare il punto di contatto di Google BigQuery per ulteriori informazioni sulla configurazione e sul supporto dell'autenticazione sul lato Google.

Connessione a Google BigQuery (ID Microsoft Entra) in Power BI Desktop

Esistono alcuni limiti e considerazioni da tenere presenti quando si usa il connettore Google BigQuery con Power BI.

Campi annidati

Per ottimizzare le considerazioni sulle prestazioni, Google BigQuery funziona bene con set di dati di grandi dimensioni quando denormalizzati, appiattiti e annidati.

Il connettore Google BigQuery (Microsoft Entra ID) supporta i campi annidati, che vengono caricati come colonne di testo in formato JSON.

Screenshot del supporto dei campi annidati di Google BigQuery.

Gli utenti devono selezionare Trasforma dati e quindi usare le funzionalità di analisi JSON nell'editor di Power Query per estrarre i dati.

  1. Nella scheda Trasforma della barra multifunzione, la categoria Colonna di testo selezionare Analizza e quindi JSON.
  2. Estrarre i campi del record JSON usando l'opzione Espandi colonna .

Impossibile eseguire l'autenticazione con l'API Google BigQuery Storage

Il connettore Google BigQuery (Microsoft Entra ID) usa l'API Google BigQuery Storage per impostazione predefinita. Questa funzionalità è controllata dall'opzione avanzata denominata UseStorageApi. Se si usano autorizzazioni granulari, potrebbero verificarsi problemi con questa funzionalità. In questo scenario potrebbe essere visualizzato il messaggio di errore seguente o non è possibile ottenere dati dalla query:

ERROR [HY000] [Microsoft][BigQuery] (131) Unable to authenticate with Google BigQuery Storage API. Check your account permissions

È possibile risolvere questo problema modificando correttamente le autorizzazioni utente per l'API di archiviazione BigQuery. Queste autorizzazioni dell'API di archiviazione sono necessarie per accedere correttamente ai dati con l'API BigQueryStorage:

  • bigquery.readsessions.create: crea una nuova sessione di lettura tramite l'API di archiviazione BigQuery.
  • bigquery.readsessions.getData: legge i dati da una sessione di lettura tramite l'API di archiviazione BigQuery.
  • bigquery.readsessions.update: aggiorna una sessione di lettura tramite l'API di archiviazione BigQuery.

Queste autorizzazioni vengono in genere fornite nel BigQuery.User ruolo. Altre informazioni, Ruoli e autorizzazioni predefiniti di Google BigQuery

Se i passaggi precedenti non risolvono il problema, è possibile disabilitare l'API di archiviazione BigQuery.

Impossibile usare i dati di tipo DateTime in modalità DirectQuery

Esiste un problema noto per cui il tipo DateTime non è supportato tramite DirectQuery. Se si seleziona una colonna con tipo DateTime, viene generato un errore "Query non valida" o un errore visivo.

Abilitare l'accesso Single Sign-On (SSO) di Microsoft Entra ID per Google BigQuery

Microsoft Entra ID SSO è supportato sia tramite il servizio Power BI (cloud) che tramite il gateway dati locale. Per altre informazioni sull'abilitazione dell'accesso Single Sign-On di Microsoft Entra ID per tutti i connettori, vedere Panoramica dell'accesso Single Sign-On (SSO) per i gateway dati locali in Power BI. Verificare direttamente con il contatto Google che il sistema e gli account siano configurati correttamente per Microsoft Entra ID SSO prima di tentare di connettersi in Power BI.

Single Sign-On (SSO) di Microsoft Entra ID tramite servizio Power BI

Per configurare una nuova connessione in servizio Power BI:

  1. In servizio Power BI selezionare Portale di amministrazione dall'elenco delle impostazioni.

    Screenshot del menu delle impostazioni aperto, con il portale di amministrazione evidenziato.

  2. Abilitare l'opzione SSO di Google BigQuery.

    Screenshot dell'opzione Google BigQuery SSO con il pulsante Abilitato abilitato.

Microsoft Entra ID Single Sign-On (SSO) per Google BigQuery con un gateway dati locale

Prima di abilitare Microsoft Entra ID SSO for Google BigQuery, è necessario abilitare l'accesso SSO di Microsoft Entra ID per tutte le origini dati che supportano l'accesso SSO di Microsoft Entra ID con un gateway dati locale. Assicurarsi anche di aver eseguito l'aggiornamento ad almeno la versione di dicembre 2022 del gateway dati locale:

  1. In servizio Power BI selezionare Portale di amministrazione dall'elenco delle impostazioni.

    Un altro screenshot del menu Impostazioni con il portale di amministrazione evidenziato.

  2. In Impostazioni di integrazione abilitare Single Sign-On (SSO) di Azure AD per gateway.

Dopo aver abilitato Microsoft Entra ID SSO per tutte le origini dati, abilitare Microsoft Entra ID SSO for Google BigQuery:

  1. Abilitare l'opzione SSO di Google BigQuery.

  2. Selezionare Gestisci gateway dall'elenco delle impostazioni.

    Screenshot del menu Impostazioni con l'opzione Gestisci gateway evidenziata.

  3. Selezionare un gateway e quindi scegliere Scegli origine dati.

  4. Nella scheda Impostazioni origine dati immettere un valore in ID progetto di fatturazione. Il parametro ID progetto di fatturazione è obbligatorio quando si usa Microsoft Entra ID e deve essere specificato in Impostazioni avanzate. Selezionare anche Use SSO via Azure AD for DirectQuery queries (Usa SSO tramite Azure AD per le query DirectQuery).