Google BigQuery (Microsoft Entra ID) (beeta)

Yhteenveto

Kohde Kuvaus
Julkaisutila Beta
Tuetut tuotteet Power BI (semanttiset mallit)
Power BI (tietovuot)
Fabric (Tietovuo Gen2)
Power Apps (tietovuot)
Tuetut todennustyypit Organisaation tili

Muistiinpano

Jotkin ominaisuudet voivat olla olemassa yhdessä tuotteessa, mutta ei toisissa käyttöönottoaikataulujen ja isäntäkohtaisten ominaisuuksien vuoksi.

Edellytykset

Tarvitset Microsoft Entra ID -tilin, jotta voit kirjautua sisään Google BigQueryhin (Microsoft Entra -tunnus).

Tuetut toiminnot

  • Tuo
  • DirectQuery (Semanttiset Power BI -mallit)

Näyttöyhteys Google BigQueryn (Microsoft Entra ID) tietoihin Power Query Desktopista

Jotta voit muodostaa yhteyden Google BigQueryhin (Microsoft Entra -tunnus) Power Query Desktopista, toimi seuraavasti:

  1. Etsi ja valitse Nouda tiedot -toiminnossa Google BigQuery (Microsoft Entra -tunnus). Lisätietoja: Mistä tiedot noudataan

    Näyttökuva Nouda tiedot -valintaikkunasta, jossa painotetaan Google BigQuery (Microsoft Entra ID) -liitintä.

  2. Määritä laskutusprojektin tunnus, joka vaaditaan tämän liittimen käyttöä varten. Jos haluat käyttää lisäasetuksia, valitse Lisäasetukset. Muussa tapauksessa valitse joko Tuo tai DirectQuery ja jatka valitsemalla OK . Lisätietoja: Näyttöyhteys lisäasetusten avulla

    Näyttökuva Google BigQuery (Microsoft Entra ID) -valintaikkunasta, jossa voit syöttää laskutusprojektin tunnuksen, valita Tuo tai DirectQuery ja valita halutessasi lisäasetukset.

  3. Google BigQuery (Microsoft Entra ID) -liitin tukee yhdistämistä Microsoft Entra ID -tilin kautta. Jatka valitsemalla Kirjaudu sisään .

    Näyttökuva todentamisvalintaikkunasta, joka ilmaisee, ettet ole tällä hetkellä kirjautuneena sisään.

  4. Kun olet kirjautunut sisään, jatka valitsemalla Näyttöyhteys.

    Näyttökuvassa on todentamisvalintaikkuna, kun olet kirjautunut sisään.

  5. Kun yhteyden muodostaminen onnistuu, näyttöön avautuu Siirtymistoiminto-ikkuna , jossa näkyvät palvelimella käytettävissä olevat tiedot. Valitse tiedot siirtymistoiminnossa. Valitse sitten joko Muunna tiedot , jos haluat muuntaa Tiedot Power Queryssa, tai Lataa tietojen lataamiseksi Power BI Desktopissa.

Näyttöyhteys Google BigQueryn (Microsoft Entra ID) tietoihin Power Query Onlinesta

Jos haluat muodostaa yhteyden Google BigQueryhin (Microsoft Entra ID) Power Query Onlinesta, toimi seuraavasti:

  1. Tee Nouda tiedot -toiminnossa haku googlella ja valitse sitten Google BigQuery (Microsoft Entra -tunnus). Lisätietoja: Mistä tiedot noudataan

    Näyttökuva Valitse tietolähde -valintaikkunasta, jossa on korostettu Google BigQuery (Microsoft Entra ID) -liitin.

  2. Google BigQuery (Microsoft Entra ID) -valintaikkunassa sinun on ehkä joko luotava uusi yhteys tai valittava aiemmin luotu yhteys. Jos olet luomassa uutta yhteyttä, anna laskutusprojektin tunnus. Jos käytät paikallisia tietoja, valitse paikallinen tietoyhdyskäytävä.

    Näyttökuva Näyttöyhteys tietolähteeseen -valintaikkunasta, jossa annat Google BigQuery (Microsoft Entra ID) -yhteysasetukset ja -tunnistetiedot.

  3. Jos haluat käyttää lisäasetuksia, valitse Lisäasetukset. Lisätietoja: Näyttöyhteys lisäasetusten avulla

  4. Kun olet kirjautunut sisään, jatka valitsemalla Seuraava .

  5. Kun yhteyden muodostaminen onnistuu, näyttöön avautuu Siirtymistoiminto-ikkuna , jossa näkyvät palvelimella käytettävissä olevat tiedot. Valitse tiedot siirtymistoiminnossa. Muunna sitten Power Queryn tiedot valitsemalla Seuraava .

Näyttöyhteys lisäasetusten avulla

Sekä Power Query Desktop että Power Query Online tarjoavat joukon lisäasetuksia, joita voit tarvittaessa lisätä kyselyäsi.

Seuraavassa taulukossa on luettelo kaikista lisäasetuksista, jotka voit määrittää Power Query Desktopissa ja Power Query Onlinessa.

Lisäasetus Kuvaus
Tallennus-ohjelmointirajapinnan käyttäminen Merkintä, joka mahdollistaa Google BigQueryn Tallennus-ohjelmointirajapinnan käytön. Tämä asetus on oletusarvoisesti true. Tämän asetuksen arvoksi voidaan määrittää false, jos se ei käytä Tallennus -ohjelmointirajapintaa ja käyttää sen sijaan REST-ohjelmointirajapintoja.
Näyttöyhteys ion aikakatkaisun kesto Vakioyhteysasetus (sekunteina), joka määrittää, kuinka kauan Power Query odottaa yhteyden valmistumista. Voit muuttaa tätä arvoa, jos yhteys ei valmistu ennen 15 sekuntia (oletusarvo).
Komennon aikakatkaisun kesto Kuinka kauan Power Query odottaa kyselyn valmistumista ja palauttaa tulokset. Oletusarvo määräytyy ohjaimen oletusarvon mukaan. Voit antaa toisen arvon muutamassa minuutissa, jotta yhteys pysyy auki pidempään.
Yleisön Uri URI, joka sisältää työvoimavarannon <tunnuksen>, joka on muutettava työvoimavarannon nimeksi, jota käytetään OIDC-määritystä määrittäessä. Audience Uri -arvon muoto on //iam.googleapis.com/locations/global/workforcePools/<workforce pool ID>/providers/azuread. Työvoimavarannon <tunnuksen> oletusarvo on powerquery-<TenantId>, jossa <TenantId> on nykyinen Power BI -vuokraajatunnuksesi. Jos päivität Audience Urin, kirjoittamaasi merkkijonoa käytetään sellaisenaan.
ProjectID Projekti, jossa haluat suorittaa alkuperäisiä kyselyitä. Tämä vaihtoehto on käytettävissä vain Power Query Desktopissa.
Alkuperäinen kysely Lisätietoja on kohdassa Tietojen tuominen tietokannasta alkuperäisen tietokantakyselyn avulla. Tässä alkuperäisen tietokantakyselytoiminnon versiossa sinun on käytettävä täydellisiä taulukoiden nimiä muodossa Database.Schema.Table, esimerkiksi SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Tämä vaihtoehto on käytettävissä vain Power Query Desktopissa.

Kun olet valinnut tarvitsemasi lisäasetukset, valitse OK Power Query Desktopissa tai Seuraava Power Query Onlinessa muodostaaksesi yhteyden Google BigQuery -tietoihisi.

Rajoitukset ja huomioitavat seikat

Tässä osiossa kuvataan Google BigQuery (Microsoft Entra ID) -liittimen rajoitukset tai huomioitavat seikat.

OIDC-määritykset

Google BigQuery (Microsoft Entra ID) -liitin käyttää Microsoft Entra ID JWT -tunnuksia yhdistääkseen Microsoft Entra ID -pohjaisen todennuksen Googlen Työvoimaliitto-ominaisuuteen. Todentamispuolen määritysten täytyy siis olla OIDC-pohjaisia , jotta ne vastaavat Microsoft Entra ID JWT -tunnuksia. Ota yhteyttä Google BigQuery -yhteyspisteeseen, jotta saat lisätietoja todentamisen määrittämisestä ja tuesta Google-puolella.

google BigQueryhin (Microsoft Entra -tunnus) Näyttöyhteys Power BI Desktopissa

Ota huomioon seuraavat rajoitukset ja tärkeät seikat, kun käytät Google BigQuery -liitintä Power BI:n kanssa.

Sisäkkäisiä kenttiä

Google BigQuery pärjää hyvin suurissa tietojoukoissa optimoidakseen suorituskykyyn liittyviä seikkoja, kun se denormalisoitu, tasoitettu ja sisäkkäinen.

Google BigQuery (Microsoft Entra ID) -liitin tukee sisäkkäisiä kenttiä, jotka ladataan tekstisarakkeina JSON-muodossa.

Näyttökuva Google BigQueryn sisäkkäisten kenttien tuesta.

Käyttäjien tulee valita Muunna tiedot ja poimia ne sitten Power Query -editorin JSON-jäsennysominaisuuksien avulla.

  1. Valitse muunna valintanauhan Muunna-välilehden Tekstisarake-luokastaJäsennä ja sitten JSON.
  2. Poimi JSON-tietuekentät Laajenna sarake -vaihtoehdon avulla.

Todentaminen Google BigQueryn Tallennus -ohjelmointirajapinnan avulla ei onnistu

Google BigQuery (Microsoft Entra ID) -liitin käyttää oletusarvoisesti Google BigQuery -Tallennus ohjelmointirajapintaa. Tätä ominaisuutta hallitaan Use Tallennus Api-lisäasetuksella. Voit kohdata ongelmia tämän ominaisuuden kanssa, jos käytät eriytettyjä käyttöoikeuksia. Tässä skenaariossa saatat saada seuraavan virhesanoman tai jättää saamatta mitään tietoja kyselystäsi:

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

Voit ratkaista tämän ongelman muuttamalla BigQuery-Tallennus -ohjelmointirajapinnan käyttöoikeuksia oikein. Näitä tallennuksen ohjelmointirajapinnan käyttöoikeuksia tarvitaan tietojen oikein käyttämiseen BigQuery Tallennus-ohjelmointirajapinnan avulla:

  • bigquery.readsessions.create: Luo uuden lukuistunnon BigQuery Tallennus-ohjelmointirajapinnan kautta.
  • bigquery.readsessions.getData: Lukee tietoja lukuistunnosta BigQuery Tallennus -ohjelmointirajapinnan kautta.
  • bigquery.readsessions.update: Päivitykset lukuistunnon BigQuery Tallennus -ohjelmointirajapinnan kautta.

Nämä käyttöoikeudet annetaan BigQuery.User yleensä -roolissa. Lisätietoja: Google BigQueryn esimääritetyt roolit ja käyttöoikeudet

Jos ongelma ei ratkea edellä olevien ohjeiden avulla, voit poistaa BigQuery-Tallennus ohjelmointirajapinnan käytöstä.

DateTime-tyyppitietoja ei voi käyttää DirectQuery-tilassa

On olemassa tunnettu ongelma, jossa DateTime-tyyppiä ei tueta DirectQueryn kautta. DateTime-tyyppisen sarakkeen valitseminen aiheuttaa "Virheellinen kysely" -virheen tai visuaalisen virheen.

Ota Microsoft Entra ID -kertakirjautuminen käyttöön Google BigQuerylle

Tuemme Microsoft Entra -tunnuksen kertakirjautumista Power BI -palvelun (pilvipalvelun) ja myös paikallisen tietoyhdyskäytävän kautta. Lisätietoja Microsoft Entra -kertakirjautumisen omisesta käyttöön kaikissa liittimissä on artikkelissa Yleiskatsaus kertakirjautumisen (SSO) käyttöön paikallisessa tietoyhdyskäytävässä Power BI:ssä. Vahvista suoraan Google-yhteyshenkilöllä, että järjestelmäsi ja tilisi on määritetty oikein Microsoft Entra -tunnuksen kertakirjautumiselle, ennen kuin yrität muodostaa yhteyden Power BI:ssä.

Microsoft Entra ID -kertakirjautuminen (SSO) Power BI -palvelu kautta

Määritä uusi yhteys Power BI -palvelu seuraavasti:

  1. Valitse Power BI -palvelu asetusluettelosta Hallinta portaali.

    Avattavan asetusvalikon näyttökuva, jossa korostetaan Hallinta portaalia.

  2. Ota Google BigQuery SSO - asetus käyttöön.

    Näyttökuva Google BigQuery -kertakirjautumisvaihtoehdosta, jossa Käytössä-painike on käytössä.

Microsoft Entra ID -kertakirjautuminen (SSO) Google BigQuerylle paikallisen tietoyhdyskäytävän kanssa

Ennen kuin voit ottaa Microsoft Entra ID -kertakirjautumisen käyttöön Google BigQuerylle, sinun on ensin otettava käyttöön Microsoft Entra ID -kertakirjautuminen kaikissa tietolähteissä, jotka tukevat Microsoft Entra ID -kertakirjautumista paikallisen tietoyhdyskäytävän kanssa. Varmista myös, että olet päivittänyt paikallisen tietoyhdyskäytävän vähintään joulukuun 2022 julkaisuversioon:

  1. Valitse Power BI -palvelu asetusluettelosta Hallinta portaali.

    Toinen näyttökuva Asetukset-valikosta, jossa on korostettu Hallinta portaali.

  2. Ota Integrointiasetukset-kohdassa Azure AD Kertakirjautuminen (SSO) käyttöön yhdyskäytävälle.

Kun olet ottanut käyttöön Microsoft Entra -kertakirjautumisen kaikille tietolähteille, ota Microsoft Entra ID -kertakirjautuminen käyttöön Google BigQuerylle:

  1. Ota Google BigQuery SSO - asetus käyttöön.

  2. Valitse Asetusluettelosta Hallitse yhdyskäytäviä .

    Näyttökuva Asetukset valikosta, jossa on korostettu Yhdyskäytävien hallinta.

  3. Valitse yhdyskäytävä ja valitse sitten Valitse tietolähde.

  4. Syötä Tietolähde Asetukset -välilehdelle arvo Laskutusprojektin tunnus -kohtaan. Laskutusprojektin tunnus -parametri vaaditaan Microsoft Entra -tunnusta käytettäessä, ja se on määritettävä lisäasetuksissa. Valitse myös Käytä DirectQuery-kyselyissä kertakirjautumista Azure AD:n kautta.