Condividi tramite


PostgreSQL

Sommario

Articolo Descrizione
Stato di rilascio Disponibilità generale
Prodotti Excel
Power BI (modelli semantici)
Power BI (flussi di dati)
Infrastruttura (Dataflow Gen2)
Power Apps (flussi di dati)
Dynamics 365 Customer Insights
Servizi di Analisi
Tipi di autenticazione supportati Database (nome utente/password)
Microsoft Account (Microsoft Entra ID)
Documentazione di riferimento sulle funzioni PostgreSQL.Database

Nota

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

Prerequisiti

Power BI Desktop ha incluso il provider Npgsql per il connettore PostgreSQL a partire da dicembre 2019, eliminando la necessità di un'installazione aggiuntiva. A partire dalla versione di ottobre 2024, incorpora Npgsql versione 4.0.17. L'installazione separata di Npgsql GAC eseguirà l'override di questa versione predefinita.

Il connettore PostgreSQL è supportato per la connessione cloud e tramite il gateway dati della rete virtuale o il gateway dati locale. Dalla versione di giugno 2025, il gateway dati locale include il provider Npgsql, quindi non è necessaria alcuna installazione aggiuntiva. L'installazione separata di Npgsql GAC eseguirà l'override di questa versione predefinita.

Per le versioni di Power BI Desktop rilasciate prima di dicembre 2019 e il gateway dati locale rilasciati prima di giugno 2025, è necessario installare il provider Npgsql nel computer locale per usare il connettore PostgreSQL. Per installare il provider Npgsql, passare alla pagina delle versioni per la versione 4.0.17, scaricare ed eseguire il file .msi. L'architettura del provider (a 32 bit o a 64 bit) deve corrispondere all'architettura del prodotto in cui si intende usare il connettore. Durante l'installazione, assicurarsi di selezionare Npgsql GAC Installation (Installazione gac Npgsql) per assicurarsi che Npgsql stesso venga aggiunto al computer. Npgsql 4.1 e versioni successive non sono supportati a causa di incompatibilità delle versioni di .NET.

Screenshot del programma di installazione Npgsql con l'installazione GAC selezionata.

Funzionalità supportate

  • Importazione
  • DirectQuery (modelli semantici di Power BI)
  • Opzioni avanzate
    • Timeout del comando in minuti
    • Istruzione SQL nativa
    • Colonne delle relazioni
    • Navigare usando la gerarchia completa

Collegarsi a un database PostgreSQL tramite Power Query Desktop

Dopo aver installato il provider Npgsql corrispondente, è possibile connettersi a un database PostgreSQL. Per stabilire la connessione, seguire questa procedura:

  1. Selezionare l'opzione database PostgreSQL nella selezione del connettore. Per altre informazioni, vedere Dove ottenere i dati.

  2. Nella finestra di dialogo database PostgreSQL visualizzata, specificare il nome del server e del database.

    Screenshot del generatore di connessioni PostgreSQL in Power BI.

  3. Selezionare la modalità di connettività dati Importa oppure DirectQuery.

  4. Se ci si connette al database per la prima volta, selezionare il tipo di autenticazione da usare e quindi immettere le credenziali. I tipi di autenticazione disponibili sono:

    • Database (nome utente e password)
    • Microsoft Account (Microsoft Entra ID)

    Per altre informazioni sull'autenticazione, vedere Autenticazione con un'origine dati.

    Screenshot della finestra di dialogo di autenticazione in cui immettere il nome utente e la password di PostgreSQL.

  5. Se la connessione non è crittografata, viene visualizzato il messaggio seguente.

    Screenshot della finestra di dialogo supporto della crittografia del database SQL di Azure.

    Selezionare OK per connettersi al database usando una connessione non crittografata. Se si desidera una connessione crittografata, è necessario configurare il server PostgreSQL per supportare le connessioni SSL (vedere la documentazione di PostgreSQL per indicazioni). Al termine, potrebbe essere necessario installare il certificato SSL del server PostgreSQL nelle Autorità di Certificazione Radice Attendibili.

  6. In Strumento di navigazione selezionare le informazioni sul database desiderate, quindi selezionare Carica per caricare i dati o Trasforma dati per continuare a trasformare i dati nell'editor di Power Query.

    Screenshot di Power Query Desktop Navigator che mostra i dati dei dipendenti delle risorse umane nel database PostgreSQL.

Connettersi a una database PostgreSQL con Power Query Online

Per stabilire la connessione, seguire questa procedura:

  1. Selezionare l'opzione database PostgreSQL nella selezione del connettore. Per altre informazioni, vedere Dove ottenere i dati.

  2. Nella finestra di dialogo database PostgreSQL visualizzata, specificare il nome del server e del database.

    generatore di connessioni PostgreSQL in Power Query Online.

  3. Seleziona il nome del gateway dei dati locali che vuoi utilizzare.

  4. Selezionare il tipo di autenticazione Basic e immettere le credenziali di PostgreSQL nelle caselle Nome utente e Password.

  5. Se la connessione non è crittografata, deselezionare Usa connessione crittografata.

  6. Selezionare Avanti per connettersi al database.

  7. In Strumento di navigazione selezionare i dati necessari, quindi selezionare Trasforma i dati per trasformare i dati nell'editor di Power Query.

Connettersi tramite opzioni avanzate

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

Screenshot delle opzioni avanzate incluse nella finestra di dialogo di connessione a PostgreSQL.

Nella tabella seguente sono elencate tutte le opzioni avanzate che è possibile impostare in Power Query Desktop.

Opzione Avanzate Descrizione
Timeout del comando in minuti Se la connessione dura più di 10 minuti (timeout predefinito), è possibile immettere un altro valore in minuti per mantenere la connessione aperta più a lungo. Questa opzione è disponibile solo in Power Query Desktop.
Istruzione SQL Per informazioni, consultare Importare i dati da un database usando una query di database nativa.
Includi le colonne delle relazioni Se selezionata, include colonne che potrebbero avere relazioni con altre tabelle. Se questa casella è deselezionata, tali colonne non vengono visualizzate.
Navigare usando la gerarchia completa Se selezionata, lo strumento di navigazione visualizza la gerarchia completa delle tabelle nel database a cui ci si connette. Se deselezionato, lo strumento di navigazione visualizza solo le tabelle le cui colonne e righe contengono dati.

Dopo aver selezionato le opzioni avanzate necessarie, selezionare OK in Power Query Desktop per connettersi al database PostgreSQL.

Riduzione della query nativa

Per impostazione predefinita, la riduzione della query nativa è abilitata. Le operazioni che possono essere piegate vengono applicate sopra la query nativa in base alla normale logica di importazione o query diretta. La riduzione della query nativa non è applicabile con parametri facoltativi presenti in Value.NativeQuery.

Nel raro caso in cui il folding non funzioni con l'abilitazione del folding della query nativa, è possibile disabilitarlo. Per disabilitare la piegatura della query nativa, impostare il flag EnableFolding a false per Value.NativeQuery nell'editor avanzato.

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

Risoluzione dei problemi

La query nativa potrebbe generare l'errore seguente:

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

Un passaggio di base per la risoluzione dei problemi consiste nel verificare se la query in Value.NativeQuery genera lo stesso errore con una limit 1 clausola intorno a essa:

select * from (query) _ limit 1