> 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.md).

# Penyiapan koneksi

Buat koneksi PostgreSQL ke IoT Query, konfigurasikan kredensial, pahami arsitektur skema data, dan terapkan pengaturan keamanan koneksi

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

## Parameter koneksi

Saat instans Anda **IoT Query** 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

Instans Anda **IoT Query** mengorganisasi data dalam skema tertentu:

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

{% hint style="info" %}
Saat melakukan kueri data, Anda harus menentukan baik skema (misalnya `raw_business_data`) dan tabel (misalnya `objek`) sebagai 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 pengandar PostgreSQL (Python, Java, Node.js)
* Alat kecerdasan bisnis yang mendukung PostgreSQL (Tableau, Power BI)

## Format string koneksi

Untuk akses terprogram, gunakan format string koneksi PostgreSQL standar:

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

Contoh dengan penanda:

{% 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 instans Anda dan harus dijaga keamanannya

### Praktik terbaik untuk koneksi

Saat bekerja dengan instans Anda **IoT Query**:

* **Kelola koneksi yang tidak aktif** - Tutup koneksi saat tidak digunakan untuk membebaskan sumber daya
* **Gunakan pengelompokan koneksi** - Untuk aplikasi dengan akses basis data yang sering
* **Simpan kredensial dengan aman** - Jangan pernah menanamkan kredensial secara langsung dalam skrip atau aplikasi
* **Tetapkan batas waktu yang sesuai** - Konfigurasikan batas waktu koneksi yang wajar untuk kasus penggunaan Anda

## Pemecahan masalah koneksi

Jika Anda mengalami masalah koneksi:

1. Verifikasi bahwa parameter koneksi Anda cocok dengan yang ada di email sambutan 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 skema](/docs/analytics/id/iot-query/schema-overview.md) bagian untuk mempelajari struktur data dan tabel yang tersedia.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.