# Pengaturan koneksi

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

## Parameter koneksi

Saat **IoT Query** instansi Anda disiapkan, Anda akan menerima parameter koneksi berikut 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 Anda 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 schema tertentu:

* [`raw_business_data`](/docs/analytics/id/iot-query/schema-overview/bronze-layer.md#raw_business_data-structure) - Berisi tabel data bisnis (pengguna, objek, tugas, dll.)
* [`raw_telematics_data`](/docs/analytics/id/iot-query/schema-overview/bronze-layer.md#raw_telematics_data-structure) - Berisi data telematika dari perangkat klien (lintasan GPS, pembacaan sensor)

{% hint style="info" %}
Saat melakukan kueri data, Anda harus menentukan baik schema (misalnya `raw_business_data`) dan tabel (misalnya `objects`) namanya: `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 dengan mode SSL yang ditentukan
* **Konfigurasi jaringan** - Jaringan Anda harus mengizinkan koneksi keluar ke host dan port yang disediakan
* **Keamanan kredensial** - Kredensial koneksi Anda unik untuk instansi Anda dan harus dijaga keamanannya

### Praktik terbaik untuk koneksi

Saat bekerja dengan **IoT Query**:

* **Kelola koneksi yang 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 secara hardcode dalam skrip atau aplikasi
* **Atur timeout yang sesuai** - Konfigurasikan timeout koneksi yang wajar untuk kasus penggunaan Anda

## Pemecahan masalah koneksi

Jika Anda mengalami masalah koneksi:

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

## Langkah berikutnya

Setelah membuat koneksi, lanjutkan ke [Ikhtisar schema](/docs/analytics/id/iot-query/schema-overview.md) bagian untuk mempelajari struktur data dan tabel yang tersedia.


---

# Agent Instructions: 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:

```
GET https://navixy.com/docs/analytics/id/iot-query/connection-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.