> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/id/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md).

# Menghubungkan Power BI

Dalam artikel ini, kami akan memandu Anda melalui proses menghubungkan Microsoft Power BI ke **IoT Query**. Untuk membuatnya lebih ilustratif, kami juga akan membangun dasbor yang terhubung ke basis data analitis dan memantau status kendaraan secara real-time, semuanya menggunakan Microsoft Power BI.

{% hint style="info" %}
Panduan ini merupakan bagian dari **IoT Query** rangkaian dokumentasi dan secara khusus membahas penghubungan Power BI ke data warehouse Anda. Jika Anda masih memutuskan alat BI mana yang akan digunakan, rujuk ke [Memilih alat BI](/docs/analytics/id/iot-query/connection-setup/selecting-bi-tools.md) ikhtisar.
{% endhint %}

## Fitur dashboard

* Tampilkan jumlah total kendaraan
* Memvisualisasikan status pergerakan kendaraan (bergerak/berhenti/terparkir)
* Memvisualisasikan status koneksi (aktif/siaga/offline)
* Tabel terperinci dengan status terkini semua kendaraan
* Penyaringan berdasarkan jenis kendaraan, grup, status pergerakan, dan status koneksi
* Kemampuan ekspor data dan laporan

## Persyaratan teknis

* Windows 10/11 atau Windows Server 2016+
* Microsoft Power BI Desktop (versi saat ini)
* Akun Microsoft untuk akses Power BI Service (opsional)
* Minimal RAM 4 GB (8 GB direkomendasikan)
* Akses internet untuk koneksi database

## Instalasi dan penyiapan

### 1. Instal Power BI Desktop

1. Unduh Power BI Desktop dari situs web resmi Microsoft: <https://powerbi.microsoft.com/desktop/>
2. Jalankan penginstal dan ikuti petunjuknya.

### 2. Unduh file dasbor

1. Unduh [moving\_status\_dashboard.pbix](https://raw.githubusercontent.com/SquareGPS/bi-intergrations/main/power_bi/moving_status_dashboard.pbix) file dari [repositori bi-intergrations](https://github.com/SquareGPS/bi-intergrations) -> `power_bi`. Anda dapat mengkloning seluruh repositori untuk interaksi lebih lanjut:

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Buka `moving_status_dashboard.pbix` file yang telah diunduh dengan mengeklik dua kali atau melalui menu Power BI Desktop: **File → Buka**.

## Koneksi database

### 1. Perbarui parameter koneksi

1. Setelah membuka file dasbor, buka **Transform data → Edit parameters**.
2. Perbarui parameter berikut:

* `DB_HOST` - alamat server basis data
* `DB_NAME` - nama basis data
* `DB_USER` - nama pengguna
* `DB_PASS` - kata sandi (jangan simpan file dengan kredensial asli dalam akses bersama)
* `DB_PORT` - port koneksi (default 5432)

3. Klik **OK** dan terapkan perubahan.

#### Referensi parameter koneksi

<table><thead><tr><th width="189.727294921875">Parameter Lakehouse</th><th width="214.1817626953125">Lokasi Pengaturan Power BI</th><th>Catatan</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td><code>DB_HOST</code> parameter</td><td>Alamat server database yang disediakan dalam email sambutan Anda</td></tr><tr><td><strong>Port</strong></td><td><code>DB_PORT</code> parameter</td><td>Default-nya adalah 5432 untuk PostgreSQL</td></tr><tr><td><strong>Nama basis data</strong></td><td><code>DB_NAME</code> parameter</td><td>Nama basis data yang ditetapkan untuk Anda</td></tr><tr><td><strong>Nama pengguna</strong></td><td><code>DB_USER</code> parameter</td><td>Nama pengguna basis data Anda</td></tr><tr><td><strong>Kata sandi</strong></td><td><code>DB_PASS</code> parameter</td><td>Kata sandi basis data Anda yang aman</td></tr><tr><td><strong>Mode SSL</strong></td><td>Pengaturan Koneksi</td><td>Diatur ke <strong>require</strong> di dialog Options</td></tr><tr><td><strong>Skema</strong></td><td>Query Editor</td><td>Tentukan skema (<strong>raw_business_data</strong> atau <strong>raw_telematics_data</strong>) di setiap kueri</td></tr></tbody></table>

### 2. Konfigurasikan kredensial

1. Saat terhubung untuk pertama kalinya, Power BI akan meminta kredensial akses basis data.
2. Pilih **Akun basis data dan kata sandi** sebagai jenis autentikasi.
3. Masukkan kredensial yang diberikan oleh administrator Anda.
4. Atur tingkat privasi ke **Organisasi** atau **Pribadi**.

## Menggunakan dasbor

Setelah menyiapkan koneksi, Anda dapat:

1. **Muat segar data** - klik tombol **Segarkan** pada ribbon atau gunakan pintasan keyboard Ctrl+R.
2. **Gunakan filter** - terapkan filter pada panel kanan atau langsung pada elemen laporan:
   1. Filter berdasarkan jenis kendaraan
   2. Filter berdasarkan grup
   3. Filter berdasarkan status pergerakan/koneksi
3. **Telusuri lebih dalam data** - klik elemen visualisasi untuk melihat informasi terperinci.
4. **Buat bookmark** - simpan pengaturan filter dan tampilan tertentu untuk akses cepat.

## Konfigurasi penyegaran data

### Penyegaran lokal

1. Di Power BI Desktop, buka menu **Home → Refresh**.
2. Untuk menyiapkan penyegaran reguler melalui Power BI Service, publikasikan laporan ke Power BI Service.

### Penyegaran cloud (Power BI Service)

1. (Opsional) Publikasikan dasbor ke Power BI Service menggunakan tombol **Publish** di Power BI Desktop.
2. Di Power BI Service, buka pengaturan set data.
3. Di **Scheduled refresh** bagian, konfigurasikan frekuensi penyegaran.
4. Untuk terhubung ke basis data lokal atau privat, Anda perlu menginstal dan mengonfigurasi Power BI Gateway.

## Pemecahan masalah

### Masalah koneksi database

* **Kesalahan koneksi:** Periksa kebenaran kredensial dan parameter koneksi.
* **Kesalahan firewall:** Pastikan alamat IP Anda telah ditambahkan ke allowlist untuk akses basis data.
* **Masalah Gateway:** Saat menggunakan Power BI Gateway, periksa status layanan gateway.

### Masalah performa

* **Pemuatan visualisasi yang lambat:**
  * Kurangi jumlah elemen yang ditampilkan secara bersamaan
  * Periksa mode Import/DirectQuery dalam model data
* **Penggunaan memori yang tinggi:**
  * Kurangi jumlah data yang diimpor dengan menerapkan filter pada tingkat kueri
  * Hapus kolom yang tidak diperlukan dari model data

### Masalah lainnya

Berikut beberapa trik yang dapat membantu Anda memperbaiki masalah umum:

1. Buka kembali Power BI Desktop dan file dasbor
2. Periksa pembaruan Power BI Desktop
3. Instal ulang Power BI Desktop jika perlu
4. Bersihkan cache Power BI: **File → Options → Global → Clear items from cache**

## Langkah berikutnya

Setelah berhasil menghubungkan Power BI ke instance Private Telematics Lakehouse Anda, kami menyarankan Anda untuk:

* Jelajahi skema data yang tersedia dengan meninjau bagian [Ikhtisar schema](/docs/analytics/id/iot-query/schema-overview.md) untuk lebih memahami struktur dan relasi data.
* Mulailah dengan kueri sederhana yang berfokus pada entitas bisnis tertentu sebelum membangun dashboard yang kompleks - periksa [contoh kueri](/docs/analytics/id/example-queries.md) sebagai referensi.

### **Dukungan**

Untuk pertanyaan teknis atau permintaan akses ke database demonstrasi, silakan hubungi: <support@squaregps.com>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/id/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.