# Pengaturan koneksi

Panduan ini menjelaskan cara terhubung ke **IoT Query** instance Anda, yang dibangun di atas **Neon PostgreSQL**.

## Parameter koneksi

Ketika **IoT Query** instance Anda disiapkan, Anda akan menerima parameter koneksi ini melalui email:

<table><thead><tr><th width="164.9091796875">Parameter</th><th>Deskripsi</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>Alamat server basis data</td></tr><tr><td><strong>Port</strong></td><td>Port koneksi (biasanya 5432)</td></tr><tr><td><strong>Nama basis data</strong></td><td>Nama basis data yang ditetapkan untuk Anda</td></tr><tr><td><strong>Nama pengguna</strong></td><td>Nama pengguna basis data Anda</td></tr><tr><td><strong>Kata sandi</strong></td><td>Kata sandi basis data yang aman</td></tr><tr><td><strong>Mode SSL</strong></td><td>Mode koneksi SSL</td></tr></tbody></table>

## Arsitektur data

Anda **IoT Query** mengatur data dalam skema tertentu:

* [`raw_business_data`](https://www.navixy.com/docs/analytics/id/schema-overview/bronze-layer#raw_business_data-structure) - Berisi tabel data bisnis (users, objects, tasks, dll.)
* [`raw_telematics_data`](https://www.navixy.com/docs/analytics/id/schema-overview/bronze-layer#raw_telematics_data-structure) - Berisi data telematika dari perangkat klien (jejak GPS, pembacaan sensor)

{% hint style="info" %}
Saat melakukan kueri data, Anda harus menentukan baik skema (mis.  `raw_business_data`) maupun tabel (mis.  `objects`) nama: `SELECT * FROM raw_business_data.objects LIMIT 10;`
{% endhint %}

## Kompatibilitas PostgreSQL

**IoT Query** sepenuhnya kompatibel dengan protokol PostgreSQL. Anda dapat terhubung menggunakan:

* Klien PostgreSQL standar (pgAdmin, DBeaver, dll.)
* Bahasa pemrograman dengan driver PostgreSQL (Python, Java, Node.js)
* Alat business intelligence yang mendukung PostgreSQL (Tableau, Power BI)

## Format string koneksi

Untuk akses programatik, gunakan format string koneksi PostgreSQL standar:

```sql
postgresql://username:password@host:port/database?sslmode=ssl_mode
```

Contoh dengan placeholder:

{% code overflow="wrap" %}

```sql
postgresql://client_user:your_password@db.example.cloud:5432/client_123_dwh?sslmode=require
```

{% endcode %}

## Keamanan koneksi

Pertimbangan keamanan penting:

* **Enkripsi SSL** - Transmisi data Anda dienkripsi sesuai mode SSL yang ditentukan
* **Konfigurasi jaringan** - Jaringan Anda harus mengizinkan koneksi keluar ke host dan port yang diberikan
* **Keamanan kredensial** - Kredensial koneksi Anda unik untuk instance Anda dan harus dijaga kerahasiaannya

### Praktik terbaik untuk koneksi

Saat bekerja dengan **IoT Query**:

* **Kelola koneksi menganggur** - Tutup koneksi saat tidak digunakan untuk membebaskan sumber daya
* **Gunakan connection pooling** - Untuk aplikasi dengan akses basis data yang sering
* **Simpan kredensial dengan aman** - Jangan pernah menanamkan kredensial di skrip atau aplikasi
* **Atur batas waktu yang sesuai** - Konfigurasikan batas waktu koneksi yang wajar sesuai kasus penggunaan Anda

## Pemecahan masalah koneksi

Jika Anda mengalami masalah koneksi:

1. Verifikasi parameter koneksi Anda sesuai dengan yang ada di email sambutan Anda
2. Konfirmasi jaringan Anda mengizinkan koneksi ke host dan port yang ditentukan
3. Pastikan klien Anda mendukung mode SSL yang diperlukan

## Langkah selanjutnya

Setelah berhasil membuat koneksi, lanjutkan ke [Ikhtisar Skema](https://www.navixy.com/docs/analytics/id/iot-query/schema-overview) bagian untuk mempelajari struktur data dan tabel yang tersedia.