PostgreSQL

Summary

Item	Description
Julkaisun tila	Yleinen saatavuus
Products	Excel Power BI (semanttiset mallit) Power BI (tietovuot) Fabric (Tietovuo Gen2) Power Apps (tietovuot) Dynamics 365 Customer Insights Analysis Services
Tuetut todennustyypit	Tietokanta (käyttäjätunnus/salasana) Microsoft-tili (Microsoft Entra -tunnus)
Funktioiden viitedokumentaatio	PostgreSQL.Database

Note

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

Prerequisites

Power BI Desktop on sisältänyt PostgreSQL-liittimen Npgsql-palvelun joulukuusta 2019 lähtien, mikä poistaa lisäasennuksen tarpeen. Lokakuun 2024 versiosta alkaen se sisältää Npgsql-version 4.0.17. Erillinen Npgsql GAC -asennus ohittaa tämän oletusversion.

PostgreSQL-liitintä tuetaan pilviyhteyden ja VNet-tietoyhdyskäytävän tai paikallisen tietoyhdyskäytävän kautta. Kesäkuun 2025 julkaisusta lähtien paikallinen tietoyhdyskäytävä sisältää Npgsql-palvelun, joten lisäasennuksia ei tarvita. Erillinen Npgsql GAC -asennus ohittaa tämän oletusversion.

Ennen joulukuuta 2019 julkaistuissa Power BI Desktop -versioissa ja ennen kesäkuussa 2025 julkaistua paikallista tietoyhdyskäytävää sinun on asennettava Npgsql-palvelu paikalliseen tietokoneeseesi, jotta voit käyttää PostgreSQL-liitintä. Asentaaksesi Npgsql-palveluntarjoajan, mene version 4.0.17 julkaisusivulle , lataa ja aja .msi-tiedosto. Palvelun arkkitehtuurin (32- tai 64-bittinen) on vastattava sen tuotteen arkkitehtuuria, jossa aiot käyttää liitintä. Kun asennat, varmista, että valitset Npgsql GAC -asennuksen varmistaaksesi, että koneeseesi lisätään Npgsql itse. Npgsql 4.1 ja uudempi versio eivät ole tuettuja .NET-version yhteensopivuuksien vuoksi.

Tuetut ominaisuudet

• Import
• DirectQuery (semanttiset Power BI -mallit)
• Lisäasetukset
  • Komennon aikakatkaisu minuutteina
  • Alkuperäinen SQL-lauseke
  • Suhteen sarakkeet
  • Siirtyminen koko hierarkian avulla

PostgreSQL-tietokantaan yhdistäminen Power Query Desktopista

Kun vastaava Npgsql-palvelu on asennettu, voit muodostaa yhteyden PostgreSQL-tietokantaan. Voit muodostaa yhteyden seuraavasti:

1. Valitse liittimen valinnasta PostgreSQL-tietokantavaihtoehto . Lisätietoja on kohdassa Mistä tiedot noudataan.

2. PostgreSQL-tietokannan valintaikkunassa anna palvelimen ja tietokannan nimi.

   

3. Valitse joko tuonti - tai DirectQuery-tietoyhteystila .

4. Jos olet muodostamassa yhteyttä tähän tietokantaan ensimmäistä kertaa, valitse käytettävä todennustyyppi ja anna tunnistetietosi. Käytettävissä olevat todennustyypit ovat:

   • Tietokanta (käyttäjänimi ja salasana)
   • Microsoft-tili (Microsoft Entra -tunnus)

   Lisätietoja todentamimisesta on artikkelissa Todentaminen tietolähteen avulla.

   

5. Jos yhteyttä ei salata, näyttöön tulee seuraava sanoma.

   

   Valitse OK yhdistääksesi tietokantaan salaamattomalla yhteydellä. Jos halutaan salattua yhteyttä, PostgreSQL-palvelin on asetettava SSL-yhteyksien vastaanottamiseen (ohjeistusta löytyy PostgreSQL-dokumentaatiosta ). Kun se on valmis, koneesi saattaa joutua asentamaan PostgreSQL-palvelimen SSL-sertifikaatti sen Trusted Root Certification Authority -järjestelmään.

6. Valitse siirtymistoiminnossa haluamasi tietokannan tiedot ja lataa tiedot valitsemalla Lataa tai jatka tietojen muuntamista Power Query editori.

   

PostgreSQL-tietokantaan yhdistäminen Power Query Onlinesta

Voit muodostaa yhteyden seuraavasti:

1. Valitse liittimen valinnasta PostgreSQL-tietokantavaihtoehto . Lisätietoja on kohdassa Mistä tiedot noudataan.

2. PostgreSQL-tietokannan valintaikkunassa anna palvelimen ja tietokannan nimi.

   

3. Valitse käytettävän paikallisen tietoyhdyskäytävän nimi.

4. Valitse Basic-tunnistautumistyyppi ja syötä PostgreSQL-tunnuksesi käyttäjätunnus - ja salasana-kenttään .

5. Jos yhteyttä ei ole salattu, tyhjennä Use Encrypted Connection.

6. Valitse Seuraava , jos haluat muodostaa yhteyden tietokantaan.

7. Valitse Navigatorissa tarvitsemasi tiedot ja valitse sitten Muunna data muuntaaksesi tiedot Power Query -editorissa.

Yhdistäminen lisäasetusten avulla

Power Query Desktop tarjoaa joukon lisäasetuksia, joita voit tarvittaessa lisätä kyselyyn.

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

Lisäasetukset	Description
Komennon aikakatkaisu minuutteina	Jos yhteys kestää yli 10 minuuttia (oletusaikakatkaisu), voit antaa toisen arvon muutamassa minuutissa, jotta yhteys pysyy auki pidempään. Tämä vaihtoehto on käytettävissä vain Power Query Desktopissa.
SQL-lauseke	Lisätietoja on kohdassa Tietojen tuominen tietokannasta alkuperäisen tietokantakyselynavulla.
Sisällytä suhdesarakkeet	Jos tämä on valittuna, sisältää sarakkeet, joilla voi olla yhteyksiä muihin taulukoihin. Jos tämä ruutu tyhjennetään, näitä sarakkeita ei näytetä.
Siirtyminen koko hierarkian avulla	Jos tämä on valittuna, siirtymistoiminto näyttää yhdistettävän tietokannan taulukoiden täydellisen hierarkian. Jos siirtymistoiminto tyhjennetään, se näyttää vain taulukot, joiden sarakkeet ja rivit sisältävät tietoja.

Kun olet valinnut tarvitsemasi edistyneet asetukset, valitse OK Power Query Desktopista yhdistääksesi PostgreSQL-tietokantaan.

Natiivin kyselyn delegointi lähteeseen

Oletusarvon mukaan alkuperäinen kyselyn delegointi lähteeseen on käytössä. Toiminnot, jotka voidaan delegoida lähteeseen, otetaan käyttöön alkuperäisen kyselyn päällä normaalin tuonti- tai Direct Query -logiikan mukaisesti. Natiivikyselyn taittelu ei ole sovellettavissa, jos Value.NativeQueryssä on valinnaisia parametreja.

Jos delegointi lähteeseen ei toimi silloin, kun alkuperäinen kyselyn delegointi lähteeseen on käytössä, voit poistaa sen käytöstä. Natiivikyselyjen taittelun poistamiseksi voi poistaa käytöstä, aseta lipuksi EnableFoldingfalseValue.NativeQuery edistyneessä editorissa.

Malli: Value.NativeQuery(target as any, query, null, [EnableFolding=false])

Troubleshooting

Alkuperäinen kyselysi saattaa aiheuttaa seuraavan virheen:

We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.

Perusvianmääritysvaihe on tarkistaa, lähettääkö Value.NativeQueryn kysely saman virheen ja sen ympärillä on lauseke limit 1 :

select * from (query) _ limit 1