Bagaimana cara kerja kolom array di PostgreSQL?

Question

Accepted Answer

PostgreSQL mendukung kolom **array** — satu kolom dapat menampung *nilai ganda* dari tipe yang sama. Ini adalah fitur Postgres yang khas dan berguna untuk menyimpan daftar (tag, peran, skor) tanpa tabel terpisah, dengan operator dan fungsi untuk melakukan query.

## Mendefinisikan dan memasukkan array

```sql
CREATE TABLE posts (
  id SERIAL PRIMARY KEY,
  title TEXT,
  tags TEXT[]                         -- an array of text
);

INSERT INTO posts (title, tags) VALUES
  ('Hello', ARRAY['ruby', 'web']),    -- ARRAY[] syntax
  ('World', '{"news", "tech"}');       -- or curly-brace literal
```

Sintaks `type[]` mendeklarasikan kolom array. Anda memasukkan dengan sintaks literal `ARRAY[...]` atau `'{...}'`.

## Melakukan query pada array

```sql
-- ANY — does the array contain a value?
SELECT * FROM posts WHERE 'ruby' = ANY(tags);

-- @> containment — does the array contain ALL of these?
SELECT * FROM posts WHERE tags @> ARRAY['ruby', 'web'];

-- && overlap — do the arrays share ANY element?
SELECT * FROM posts WHERE tags && ARRAY['tech', 'news'];

-- access by index (1-based!) and length
SELECT tags[1], array_length(tags, 1) FROM posts;

-- unnest — expand an array into rows
SELECT id, unnest(tags) AS tag FROM posts;   -- one row per tag
```

Operator seperti `ANY` (berisi nilai), `@>` (containment), dan `&&` (overlap), ditambah fungsi seperti `unnest` (perluas ke baris) dan `array_agg` (agregat baris menjadi array), membuat array dapat di-query.

## Indexing array (GIN)

```sql
-- a GIN index makes array containment/membership queries fast
CREATE INDEX idx_posts_tags ON posts USING GIN (tags);
-- now WHERE tags @> ARRAY['ruby'] uses the index
```

## Kapan menggunakan array (dan kapan tidak)

```text
✓ USE for: simple lists tightly coupled to the row (tags, roles, a few scores)
  where you don't need to query/join the individual values much
✗ AVOID when: you need to query, join, or maintain the values relationally,
  or the list is large/complex → a separate related table (normalized) is better
→ Arrays are convenient but can violate normalization; use them judiciously.
```

## Mengapa ini penting

Kolom array adalah fitur PostgreSQL yang khas dan berguna, dan memahaminya berharga baik untuk memanfaatkan kemampuan Postgres maupun untuk membuat keputusan desain yang baik.

Array memungkinkan Anda menyimpan **nilai ganda dalam satu kolom** (tag, peran, daftar) tanpa tabel terpisah — nyaman untuk daftar sederhana yang terikat erat pada baris.

Memahami cara mendefinisikan, memasukkan, dan khususnya **melakukan query** pada array (operator seperti `ANY` untuk keanggotaan, `@>` untuk containment, `&&` untuk overlap, dan fungsi seperti `unnest` untuk memperluas array menjadi baris) diperlukan untuk menggunakannya secara efektif, dan mengetahui bahwa **indeks GIN** membuat query array efisien penting untuk performa.

Sama pentingnya adalah **penilaian desain** tentang kapan menggunakan array versus tabel yang terhubung dan ternormalisasi: array nyaman untuk daftar sederhana yang tidak perlu Anda query, join, atau kelola secara relasional, tetapi dapat melanggar prinsip normalisasi dan menjadi canggung ketika Anda perlu melakukan query nilai individual, join pada mereka, atau mengelola daftar yang kompleks/besar — dalam hal ini tabel yang terhubung dan terpisah adalah pilihan yang lebih baik dan ternormalisasi.

Memahami trade-off ini (array untuk kemudahan dengan daftar sederhana yang terikat, tabel terpisah untuk data yang dikelola secara relasional) mencerminkan penilaian desain yang baik.

Karena array adalah fitur Postgres yang berguna dan khas yang dapat menyederhanakan desain tertentu (menghindari tabel join untuk daftar sederhana) tetapi dapat disalahgunakan (denormalisasi data yang seharusnya relasional), memahami kolom array — cara mendefinisikan, melakukan query, dan mengindeksnya, dan yang sangat penting kapan mereka sesuai versus kapan tabel ternormalisasi lebih baik — adalah pengetahuan yang berharga dan relevan secara praktis untuk merancang skema Postgres yang menggunakan pendekatan yang tepat untuk setiap jenis data dengan nilai ganda.