Google BigQuery

Samenvatting

Vereiste voorwaarden

U hebt een Google-account of een Google-serviceaccount nodig om u aan te melden bij Google BigQuery.

Ondersteunde mogelijkheden

• Importeren
• DirectQuery (semantische Power BI-modellen)

Verbinding maken met Google BigQuery-gegevens vanuit Power Query Desktop

Voer de volgende stappen uit om vanuit Power Query Desktop verbinding te maken met Google BigQuery:

1. Selecteer Google BigQuery in de get data-ervaring. De ervaring voor het ophalen van gegevens in Power Query Desktop varieert tussen apps. Ga naar Waar u gegevenskunt ophalen voor meer informatie over de Power Query Desktop-ervaring voor uw app.

2. Als u geavanceerde opties wilt gebruiken, selecteert u Geavanceerde opties. Selecteer OK om door te gaan. Ga voor meer informatie naar Verbinding maken met behulp van geavanceerde opties.

   

3. De Google BigQuery-connector ondersteunt het maken van verbinding via een organisatieaccount of een serviceaccountaanmelding. In dit voorbeeld wordt het organisatieaccount gebruikt om u aan te melden. Selecteer Aanmelden om door te gaan.

   

   U kunt zich ook aanmelden met een Google-serviceaccount. In dit geval selecteert u Aanmelding van serviceaccount en voert u het e-mailadres van uw serviceaccount en de inhoud van het JSON-sleutelbestand van uw serviceaccount in. Selecteer vervolgens Connect.

4. Er wordt een dialoogvenster Aanmelden met Google weergegeven. Selecteer uw Google-account en keur verbinding met Power BI Desktop goed.

   

5. Nadat u zich hebt aangemeld, selecteert u Verbinding maken om door te gaan.

   

6. Zodra u verbinding hebt gemaakt, wordt er een Navigator-venster weergegeven en worden de gegevens weergegeven die beschikbaar zijn op de server. Selecteer uw gegevens in de navigator. Selecteer vervolgens Gegevens transformeren om de gegevens te transformeren in Power Query of laden om de gegevens in Power BI Desktop te laden.

   

Verbinding maken met Google BigQuery-gegevens vanuit Power Query Online

Voer de volgende stappen uit om verbinding te maken met Google BigQuery vanuit Power Query Online:

1. Selecteer de optie Google BigQuery in de get data-ervaring. Verschillende apps hebben verschillende manieren om toegang te krijgen tot de Power Query Online-ervaring voor het ophalen van gegevens. Ga naar Waar u gegevens kunt ophalenvoor meer informatie over hoe u toegang krijgt tot de Power Query Online 'gegevens ophalen' ervaring vanuit uw app.

   

2. In het dialoogvenster Google BigQuery Database moet u mogelijk een nieuwe verbinding maken of een bestaande verbinding selecteren. Selecteer een organisatie- of serviceaccount om u aan te melden. Als u lokale gegevens gebruikt, selecteerde u een lokale gegevensgateway. Selecteer vervolgens Aanmelden.

   

3. Er wordt een dialoogvenster Aanmelden met Google weergegeven. Selecteer uw Google-account en keur verbinding goed.

   Opmerking

   Hoewel in het dialoogvenster Aanmelden wordt opgegeven dat u doorgaat naar Power BI Desktop wanneer u zich aanmeldt, wordt u in plaats daarvan naar uw online-app verzonden.

   

4. Als u geavanceerde opties wilt gebruiken, selecteert u Geavanceerde opties. Meer informatie: Verbinding maken met geavanceerde opties

5. Nadat u zich hebt aangemeld, selecteert u Volgende om door te gaan.

   

6. Zodra u verbinding hebt gemaakt, wordt er een Navigator-venster weergegeven en worden de gegevens weergegeven die beschikbaar zijn op de server. Selecteer uw gegevens in de navigator. Selecteer vervolgens Volgende om de gegevens in Power Query te transformeren.

   

Verbinding maken met behulp van geavanceerde opties

Power Query Desktop en Power Query Online bieden zo nodig een set geavanceerde opties die u aan uw query kunt toevoegen.

De volgende tabel bevat alle geavanceerde opties die u kunt instellen in Power Query Desktop en Power Query Online.

Zodra u de geavanceerde opties hebt geselecteerd die u nodig hebt, selecteert u OK in Power Query Desktop of Volgende in Power Query Online om verbinding te maken met uw Google BigQuery-gegevens.

Implementatie van nieuwe Google BigQuery-connector (Preview)

Sinds mei 2025 hebben we een nieuwe implementatie geïntroduceerd voor de Google BigQuery-connector om de integratie met Google BigQuery te verbeteren, momenteel beschikbaar in preview. Het maakt gebruik van Arrow Database Connectivity (ADBC) in plaats van ODBC om verbinding te maken met en gegevens op te halen uit Google BigQuery, wat de prestaties verbetert, met name voor grote resultatensets. Naarmate we doorgaan met het verbeteren en toevoegen van nieuwe mogelijkheden aan deze connector, raden we u aan om een upgrade uit te voeren naar de nieuwste versie om het uit te proberen en ons feedback te geven.

Als u deze functie wilt openen in Power BI Desktop, gaat u naar opties en instellingen (onder het tabblad Bestand ) >Opties>preview-functies en schakelt u het selectievakje in om de implementatieoptie Nieuwe Google BigQuery-connector gebruiken in te schakelen. Zodra de optie is ingeschakeld, gebruiken alle zojuist gemaakte verbindingen automatisch de implementatie van de nieuwe connector.

Uw bestaande verbindingen blijven ongewijzigd. U kunt de functie als volgt uitproberen door de Implementation="2.0" vlag in GoogleBigQuery.Database uw query's toe te voegen. Deze eigenschap onderscheidt de versie van de connector die u gebruikt.

Als u deze functie wilt openen in Dataflow Gen2, gaat u, nadat u het ophalen van gegevens van Google BigQuery hebt geconfigureerd, naar de geavanceerde editor op het bovenste lint en voegt u de Implementation="2.0" vlag als volgt toe aan GoogleBigQuery.Database uw query's om deze nieuwe connector te gebruiken.

Source = GoogleBigQuery.Database([Implementation = "2.0"])

Om te helpen bij het diagnosticeren van mogelijke problemen, kunt u de Implementation '2.0' en DriverType als 'ADBC' vinden in uw Mashup-logboeken.

Momenteel heeft deze connector de volgende bekende beperkingen:

• Relaties worden niet ondersteund.
• Proxy wordt niet ondersteund.

Beperkingen en overwegingen

In deze sectie worden eventuele beperkingen of overwegingen van de Google BigQuery-connector beschreven.

Verbinding maken met Google BigQuery in Power BI Desktop

Er zijn enkele limieten en overwegingen waarmee u rekening moet houden bij het gebruik van de Google BigQuery-connector met Power BI.

Beschikbaarheid van de connector

De Google BigQuery-connector is beschikbaar in Power BI Desktop en in de Power BI-service. In de Power BI-service kan de connector worden geopend met behulp van de cloud-naar-cloud-verbinding van Power BI naar Google BigQuery.

Fout 'Toegang geweigerd'

Wanneer u vanuit Power BI Desktop verbinding probeert te maken met Google BigQuery, wordt mogelijk het volgende foutbericht weergegeven:

Datasource.Error: ODBC: ERROR [HY000][Microsoft][BigQuery] (100) Error interacting with REST API: Access Denied: Project <project name>: The user <user name> bigquery.jobs.create permissions in project <project name>.

In dit geval moet u mogelijk een factureringsproject-id invoeren in de geavanceerde optie Factureringsproject in de verbindingsinstellingen van Power Query.

Als u ook een rapport maakt in de Power BI-service met behulp van een gateway, wordt deze fout mogelijk nog steeds weergegeven. In dit geval moet u de factureringsproject-id handmatig opnemen in de M-code voor de verbinding met behulp van de Power Query-editor of de Power Query-formulebalk. Voorbeeld:

Source = GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"])

Ondersteuning voor één cloudverbinding

Google BigQuery biedt geen ondersteuning voor meerdere cloudverbindingen omdat er geen parametersveld is om meer dan één te configureren. Als gevolg hiervan kan slechts één cloudverbinding worden gebruikt.

Geneste velden

Om prestatieoverwegingen te optimaliseren, werkt Google BigQuery goed met grote gegevenssets wanneer deze worden gedenormaliseerd, afgevlakt en genest.

De Google BigQuery-connector ondersteunt geneste gegevensvelden die worden geladen als tekstkolommen met JSON-indeling.

Gebruikers moeten Transformatiegegevens selecteren en vervolgens de JSON-parseringsmogelijkheden in de Power Query-editor gebruiken om de gegevens te extraheren.

1. Selecteer op het linttabblad Transformaties de categorie Tekstkolom, parseren en vervolgens JSON.
2. Gebruik de optie Kolom uitvouwen om de JSON-recordvelden te extraheren.

Een Google-serviceaccount instellen

Ga voor meer informatie over het instellen of gebruiken van Google-serviceaccounts naar Het maken en beheren van serviceaccountsleutels in de Google-documenten.

Verifiëren via een Google-serviceaccount

Wanneer u zich verifieert via een Google-serviceaccount in Power BI Desktop, is er een specifiek referentieformaat vereist voor de connector.

• E-mailadres van serviceaccount: moet in e-mailindeling zijn.
• Inhoud van het JSON-sleutelbestand van het serviceaccount: nadat deze JSON-sleutel is gedownload, moeten alle nieuwe regels uit het bestand worden verwijderd, zodat de inhoud op één regel staat. Zodra het JSON-bestand in die indeling is, kan de inhoud in dit veld worden geplakt.

Wanneer u zich verifieert via een Google-serviceaccount in de Power BI-service of Power Query Online, moeten gebruikers basisverificatie gebruiken. Het veld Gebruikersnaam wordt toegewezen aan het veld E-mailadres van het serviceaccount en het veld Wachtwoord wordt toegewezen aan het veld JSON-sleutelbestand voor het serviceaccount . De indelingsvereisten voor elke referentie blijven hetzelfde in zowel Power BI Desktop, Power BI-service als Power Query Online.

Kan niet verifiëren met Google BigQuery Storage-API

De Google BigQuery-connector maakt standaard gebruik van de Google BigQuery Storage-API . Deze functie wordt beheerd door de geavanceerde optie UseStorageApi. Mogelijk ondervindt u problemen met deze functie als u gedetailleerde machtigingen gebruikt. In dit scenario ziet u mogelijk het volgende foutbericht of kunt u geen gegevens ophalen uit uw query:

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

U kunt dit probleem oplossen door de gebruikersmachtigingen voor de BigQuery Storage-API correct aan te passen. Deze machtigingen voor opslag-API's zijn vereist voor toegang tot gegevens correct met de BigQueryStorage-API:

• bigquery.readsessions.create: Hiermee maakt u een nieuwe leessessie via de BigQuery Storage-API.
• bigquery.readsessions.getData: leest gegevens uit een leessessie via de BigQuery Storage-API.
• bigquery.readsessions.update: Hiermee werkt u een leessessie bij via de BigQuery Storage-API.

Deze machtigingen worden doorgaans opgegeven in de BigQuery.User rol. Ga voor meer informatie naar Vooraf gedefinieerde rollen en machtigingen van Google BigQuery.

Als de bovenstaande stappen het probleem niet oplossen, kunt u de BigQuery Storage-API uitschakelen.

Kan gegevens van het type DateTime niet gebruiken in de modus Direct Query

Er is een bekend probleem waarbij het DateTime type niet wordt ondersteund via Direct Query. Als u een kolom met het DateTime type selecteert, wordt er een Invalid query fout of een visuele fout veroorzaakt.

Beperkingen voor het uitvoeren van query's op kolommen met dezelfde naam als de tabelnaam

Wanneer u een query uitvoert op een kolom met dezelfde naam als de tabelnaam, interpreteert BigQuery de kolom als een struct kolom die alle kolommen in de tabel bevat in plaats van de opgegeven kolom. Retourneert bijvoorbeeld SELECT debug FROM dataset.debug een struct met alle kolommen in de foutopsporingstabel in plaats van de opgegeven kolom voor foutopsporing. Dit gedrag is niet intuïtief en er wordt een oplossing onderzocht. Er zijn drie tijdelijke oplossingen beschikbaar:

• Tijdelijke oplossing 1: De tabel verpakken met een weergave die geen conflict veroorzaakt met de kolomnaam:CREATE VIEW dataset.new_view AS SELECT * FROM dataset.debug
• Tijdelijke oplossing 2: Wijzig de naam van de kolom om conflicten met de tabelnaam te voorkomen:ALTER TABLE dataset.debug RENAME COLUMN debug to new_debug
• Tijdelijke oplossing 3: Wijzig de SELECT-query om table.column te gebruiken om te verwijzen naar de conflictkolom:SELECT debug.debug FROM dataset.debug

Gematerialiseerde weergaven worden niet ondersteund in de Power BI Desktop-navigator

Een bekend probleem is dat de Google BigQuery-connector momenteel geen gerealiseerde weergaven ondersteunt in de Power BI Desktop-navigator.

• Tijdelijke oplossing: gebruik systeemeigen SQL-instructies voor query's om gerealiseerde weergaven op te halen uit Google BigQuery.

HTTP-fout 403: quotaExceeded (quotum overschreden: uw gebruiker heeft het quotum overschreden voor gelijktijdige aanvragen van project.lists)

• Het quotum is overschreden voor het gebruik van API-aanroepen naar Google in het klantaccount van project.lists. Wanneer meerdere rapporten tegelijkertijd worden vernieuwd, kan er een fout optreden in verschillende query's of rapporten. Om de fout te voorkomen, plant u vernieuwingen van rapporten op verschillende tijdstippen.
• Werk de query bij om een factureringsproject-id op te nemen - GoogleBigQuery.Database([BillingProject="Include-Billing-Project-Id-Here"]).
• Aanroepen van GoogleBigQuery.Database moeten zich in dezelfde query bevinden als het schema en de tabelselectie om de fout te voorkomen.

ExecuteQueryInternalAsync-fout bij gebruik van ADBC

Sommige gebruikers ondervinden problemen bij het maken van verbinding met BigQuery met behulp van het Implementation="2.0" pad en ontvangen de fout Cannot execute <ExecuteQueryInternalAsync>b__2 after 5 tries. Dit probleem kan worden veroorzaakt door enkele factoren:

• Het machtigingsprobleem dat wordt beschreven in de volgende sectie.
• Als LargeResultDataset wordt doorgegeven, probeert het stuurprogramma de uitvoer-dataset te maken met de opgegeven naam. Voor dit maken zijn de juiste machtigingen vereist.
• Wanneer er geen regio expliciet wordt opgegeven tijdens het maken van gegevenssets, stelt de BigQuery-API standaard de VS-multiregio in. Dit gedrag wordt aangestuurd door de API zelf en niet door de connector of clientconfiguratie.

Tijdelijke oplossingsopties

Handmatig gegevensset maken

Als u onverwachte standaardinstellingen voor regio's wilt voorkomen, maakt u de gegevensset handmatig in de gewenste regio met behulp van de BigQuery-console.

Configuratie van de desktopconnector

Als u Power BI Desktop gebruikt en fouten ondervindt tijdens het navigeren in tabellen:

1. Ga naar Bestand>Opties en instellingen>Opties
2. Schakel onder Preview-functies de optie Nieuwe implementatie van de Google BigQuery-connector gebruiken uit.

Als u dit bericht ontvangt, samen met aanvullende details dat Last exception: ... bevat, waarbij ... aanvullende details van de fout zijn, maak een case aan voor nader onderzoek.

Machtigingsproblemen bij het maken van verbinding met ADBC

Voor sommige omgevingen zijn mogelijk extra machtigingen vereist om verbinding te maken met behulp van Implementation="2.0"/ADBC. Dit komt doordat het ADBC-pad verschillende BigQuery-API's gebruikt om gegevens op te vragen en te laden dan ODBC. De vereiste machtigingen worden beschreven in de GitHub-opslagplaats van het stuurprogramma.

Kan gepartitioneerde modellen niet vernieuwen met ADBC

Een bekend probleem in de Google BigQuery-connector is dat gepartitioneerde semantische modellen mogelijk niet correct worden vernieuwd. Dit wordt vaak weergegeven met een Cannot execute <ReadChunkWithRetries>b__0 after 5 tries foutmelding. Er is een recente oplossing gepubliceerd voor dit probleem en moet in oktober 2025 worden geïmplementeerd. Als u dit bericht ontvangt samen met aanvullende details die Last exception: ... bevatten, waarbij ... aanvullende details van de fout zijn, maakt u een aanvraag voor nader onderzoek.