Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Ringkasan
| Benda | Deskripsi |
|---|---|
| Status Rilis | Ketersediaan Umum |
| Produk | Unggul Power BI (Model semantik) Power BI (Dataflow) Fabric (Dataflow Gen2) Power Apps (Dataflow) Dynamics 365 Customer Insights Analysis Services |
| Jenis Autentikasi Didukung | Database (Nama Pengguna/Kata Sandi) Akun Microsoft (ID Microsoft Entra) |
| Dokumentasi Referensi Fungsi | PostgreSQL.Database |
Nota
Beberapa kemampuan mungkin ada dalam satu produk tetapi tidak yang lain karena jadwal penyebaran dan kemampuan khusus host.
Prasyarat
Power BI Desktop telah menyertakan penyedia Npgsql untuk konektor PostgreSQL sejak Desember 2019, menghilangkan kebutuhan akan penginstalan tambahan. Dimulai dengan versi Oktober 2024, versi ini menggabungkan Npgsql versi 4.0.17. Penginstalan Npgsql GAC terpisah akan mengambil alih versi default ini.
Konektor PostgreSQL didukung untuk koneksi cloud dan melalui gateway data VNet atau gateway data lokal. Sejak rilis Juni 2025, gateway data lokal menyertakan penyedia Npgsql, sehingga tidak diperlukan penginstalan tambahan. Penginstalan Npgsql GAC terpisah akan mengambil alih versi default ini.
Untuk versi Power BI Desktop yang dirilis sebelum Desember 2019 dan gateway data lokal yang dirilis sebelum Juni 2025, Anda harus menginstal penyedia Npgsql di komputer lokal Anda untuk menggunakan konektor PostgreSQL. Untuk menginstal penyedia Npgsql, buka halaman rilis untuk versi 4.0.17, unduh dan jalankan file .msi. Arsitektur penyedia (32-bit atau 64-bit) harus sesuai dengan arsitektur produk tempat Anda ingin menggunakan konektor. Saat menginstal, pastikan Anda memilih Penginstalan Npgsql GAC untuk memastikan Npgsql itu sendiri ditambahkan ke komputer Anda. Npgsql 4.1 dan yang lebih baru tidak didukung karena ketidaksesuaian versi .NET.
Kemampuan yang Didukung
- Mengimpor
- DirectQuery (model semantik Power BI)
- Opsi tingkat lanjut
- Batas waktu perintah dalam menit
- Pernyataan SQL asli
- Kolom hubungan
- Menavigasi menggunakan hierarki penuh
Menyambungkan ke database PostgreSQL dari Power Query Desktop
Setelah penyedia Npgsql yang cocok diinstal, Anda dapat terhubung ke database PostgreSQL. Untuk membuat koneksi, lakukan langkah-langkah berikut:
Pilih opsi database PostgreSQL di pilihan konektor. Untuk informasi selengkapnya, buka Tempat mendapatkan data.
Dalam dialog database
PostgreSQL yang muncul, berikan nama server dan database. 
Pilih mode konektivitas data Impor atau DirectQuery.
Jika Anda menyambungkan ke database ini untuk pertama kalinya, pilih jenis autentikasi yang ingin Anda gunakan, lalu masukkan kredensial Anda. Jenis autentikasi yang tersedia adalah:
- Database (Nama pengguna dan kata sandi)
- Akun Microsoft (ID Microsoft Entra)
Untuk informasi selengkapnya tentang autentikasi, buka Autentikasi dengan sumber data.
Jika koneksi tidak dienkripsi, Anda akan diminta dengan pesan berikut.
Pilih OK untuk menyambungkan ke database dengan menggunakan koneksi yang tidak terenkripsi. Jika koneksi terenkripsi diinginkan, server PostgreSQL harus disiapkan untuk mengakomodasi koneksi SSL (buka dokumentasi PostgreSQL untuk panduan). Setelah selesai, komputer Anda mungkin diperlukan untuk menginstal sertifikat SSL server PostgreSQL ke Otoritas Sertifikasi Akar Tepercayanya.
Di Navigator, pilih informasi database yang Anda inginkan, lalu pilih Muat untuk memuat data atau Mengubah Data untuk terus mengubah data di editor Power Query.
Menyambungkan ke database PostgreSQL dari Power Query Online
Untuk membuat koneksi, lakukan langkah-langkah berikut:
Pilih opsi database PostgreSQL di pilihan konektor. Untuk informasi selengkapnya, buka Tempat mendapatkan data.
Dalam dialog database
PostgreSQL yang muncul, berikan nama server dan database. 
Pilih nama gateway data lokal yang ingin Anda gunakan.
Pilih jenis autentikasi Dasar
dan masukkan kredensial PostgreSQL Anda dalam kotak Nama Pengguna dan Kata Sandi . Jika koneksi Anda tidak dienkripsi, hapus Gunakan Koneksi Terenkripsi.
Pilih Berikutnya untuk menyambungkan ke database.
Di Navigator, pilih data yang Anda perlukan, lalu pilih Ubah data untuk mengubah data di editor Power Query.
Menyambungkan menggunakan opsi tingkat lanjut
Power Query Desktop menyediakan sekumpulan opsi tingkat lanjut yang bisa Anda tambahkan ke kueri Anda jika diperlukan.
Tabel berikut ini mencantumkan semua opsi tingkat lanjut yang bisa Anda atur di Power Query Desktop.
| Opsi tingkat lanjut | Deskripsi |
|---|---|
| Batas waktu perintah dalam menit | Jika koneksi Anda berlangsung lebih dari 10 menit (waktu habis default), Anda dapat memasukkan nilai lain dalam hitungan menit untuk menjaga koneksi tetap terbuka lebih lama. Opsi ini hanya tersedia di Power Query Desktop. |
| Perintah SQL | Untuk mendapatkan informasi, buka Impor data dari database dengan menggunakan kueri asli database. |
| Sertakan kolom hubungan | Jika dicentang, sertakan kolom yang mungkin memiliki hubungan dengan tabel lain. Jika kotak ini dikosongkan, kolom tersebut tidak ditampilkan. |
| Menavigasi menggunakan hierarki penuh | Jika dicentang, navigator menampilkan hierarki lengkap tabel dalam database yang sedang Anda sambungkan. Jika dibersihkan, navigator hanya menampilkan tabel yang kolom dan barisnya berisi data. |
Setelah Anda memilih opsi tingkat lanjut yang Anda perlukan, pilih OK di Power Query Desktop untuk menyambungkan ke database PostgreSQL Anda.
Pelipatan kueri bawaan
Secara bawaan, pelipatan kueri asli diaktifkan. Operasi yang dapat dilipat diterapkan di atas kueri asli Anda sesuai dengan logika Impor atau Kueri Langsung yang biasa. Lipatan Kueri Asli tidak berlaku dengan parameter opsional yang ada di Value.NativeQuery.
Dalam kasus yang jarang terjadi di mana pelipatan tidak berfungsi meskipun pelipatan kueri asli sudah diaktifkan, Anda dapat menonaktifkannya. Untuk menonaktifkan penggabungan kueri asli, atur EnableFolding bendera ke false untuk Value.NativeQuery di editor tingkat lanjut.
Sampel: Value.NativeQuery(target as any, query, null, [EnableFolding=false])
Pemecahan masalah
Kueri asli Anda mungkin melemparkan kesalahan berikut:
We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.
Langkah pemecahan masalah dasar adalah memeriksa apakah kueri di Value.NativeQuery melemparkan kesalahan yang sama dengan limit 1 klausa di sekitarnya:
select * from (query) _ limit 1