# Menghubungkan Power BI

Dalam artikel ini, kami akan membahas 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 waktu-nyata, semuanya menggunakan Microsoft Power BI.

{% hint style="info" %}
panduan dokumentasi **IoT Query** suite dokumentasi dan secara khusus membahas menghubungkan Power BI ke gudang data Anda. Jika Anda masih memutuskan alat BI mana yang akan digunakan, rujuk ke [Memilih alat BI](https://www.navixy.com/docs/analytics/id/iot-query/connection-setup/selecting-bi-tools) ikhtisar.
{% endhint %}

## Fitur dasbor

* Menampilkan jumlah total kendaraan
* Memvisualisasikan status pergerakan kendaraan (bergerak/berhenti/parkir)
* Memvisualisasikan status koneksi (aktif/diam/offline)
* Tabel terperinci dengan status saat ini dari semua kendaraan
* Penyaringan berdasarkan tipe 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 terbaru)
* Akun Microsoft untuk akses Power BI Service (opsional)
* Minimum 4 GB RAM (disarankan 8 GB)
* Akses Internet untuk koneksi basis data

## Instalasi dan pengaturan

### 1. Instal Power BI Desktop

1. Unduh Power BI Desktop dari situs 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 diunduh dengan mengklik dua kali atau melalui menu Power BI Desktop: **File → Open**.

## Koneksi database

### 1. Perbarui parameter koneksi

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

* `DB_HOST` - alamat server database
* `DB_NAME` - nama database
* `DB_USER` - nama pengguna
* `DB_PASS` - kata sandi (jangan menyimpan file dengan kredensial asli di 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 diberikan dalam email sambutan Anda</td></tr><tr><td><strong>Port</strong></td><td><code>DB_PORT</code> parameter</td><td>Default 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 yang aman</td></tr><tr><td><strong>Mode SSL</strong></td><td>Pengaturan Koneksi</td><td>Atur ke <strong>require</strong> dalam 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 menghubungkan untuk pertama kali, Power BI akan meminta kredensial akses basis data.
2. Pilih **Akun basis data dan kata sandi** sebagai jenis otentikasi.
3. Masukkan kredensial yang diberikan oleh administrator Anda.
4. Atur tingkat privasi ke **Organization** atau **Private**.

## Menggunakan dasbor

Setelah mengatur koneksi, Anda dapat:

1. **Menyegarkan data** - klik tombol **Refresh** pada pita atau gunakan pintasan keyboard Ctrl+R.
2. **Gunakan filter** - terapkan filter pada panel kanan atau langsung pada elemen laporan:
   1. Filter berdasarkan tipe kendaraan
   2. Filter berdasarkan grup
   3. Filter berdasarkan status pergerakan/koneksi
3. **Telusuri data lebih dalam** - klik elemen visualisasi untuk melihat informasi rinci.
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 mengatur penyegaran rutin 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 dataset.
3. Di bagian **Scheduled refresh** konfigurasi frekuensi penyegaran.
4. Untuk menghubungkan ke basis data lokal atau pribadi, 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 ditambahkan ke daftar diizinkan untuk akses basis data.
* **Masalah Gateway:** Saat menggunakan Power BI Gateway, periksa status layanan gateway.

### Masalah performa

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

### Masalah lain

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 diperlukan
4. Bersihkan cache Power BI: **File → Options → Global → Clear items from cache**

## Langkah selanjutnya

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

* Jelajahi skema data yang tersedia dengan meninjau bagian [Ikhtisar Skema](https://www.navixy.com/docs/analytics/id/iot-query/schema-overview) untuk memahami struktur data dan hubungan dengan lebih baik.
* Mulailah dengan kueri sederhana yang berfokus pada entitas bisnis tertentu sebelum membangun dasbor yang kompleks - periksa [kueri contoh](https://www.navixy.com/docs/analytics/id/example-queries) sebagai referensi.

### **Dukungan**

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