PostgreSQL'deki her tip bir dizi olabilir. Sütunu text[] ya da int[] olarak tanımla, değerleri '{a,b}' veya ARRAY['a', 'b'] şeklinde yaz ve elemanları tags[1] ile oku (indeksler 1'den başlar). Bir dizinin bir değeri içerip içermediğini kontrol etmek için 'value' = ANY(tags) ya da tags @> ARRAY['value'] kullan.
1 ve 2 numaralı gönderilerde sql etiketi var. tags[1] ilk elemandır, cardinality de elemanları sayar. İki yazım biçimi de aynı değeri saklar; elemanlar ifadelerden geliyorsa ya da virgül içeriyorsa ARRAY[...] daha kolaydır.
Bir dizinin değer içerip içermediğini kontrol etmek
Üyelik için dört operatör var:
| Test | Anlamı | '{sql,json}' için doğru mu |
|---|---|---|
'sql' = ANY(tags) | değerlerden biri dizide | evet |
tags @> '{sql,json}' | dizi bunların hepsini içeriyor | evet |
tags <@ '{sql,json,go}' | her eleman bu listede | evet |
tags && '{go,json}' | dizilerin en az bir ortak elemanı var | evet |
İki etikete birden sahip olan tek gönderi 1 numara. 2 ve 3 numaralı gönderilerin {go,json} ile ortak bir elemanı var. no_go değerinin false olduğu tek gönderi 3 numara. ALL, ANY'nin karşılığıdır: karşılaştırma her eleman için doğru olmalıdır.
= ANY, SQL'in NULL kurallarına uyar. Değer bulunamazsa ve dizide bir NULL varsa sonuç false değil NULL olur. Bu yüzden WHERE NOT ('x' = ANY(tags)) beklediğin satırları eleyebilir. @> ve && ise true ya da false döndürür.
Bir GIN indeksi büyük tablolarda @>, <@, && ve = operatörlerini hızlandırır. = ANY(column) için işe yaramaz, bu yüzden indeksli aramalarda tags @> ARRAY['sql'] yaz:
CREATE INDEX posts_tags_idx ON posts USING gin (tags);
unnest ile diziyi satırlara çevirmek
unnest her eleman için bir satır döndürür, böylece tek tek elemanlar üzerinde sayma, join ya da filtreleme yapabilirsin:
sql iki gönderide, diğer etiketler birer gönderide geçiyor. Her elemanın konumunu da almak için WITH ORDINALITY ekle (unnest(tags) WITH ORDINALITY AS t(tag, pos)). Satırları yeniden bir diziye toplamak için array_agg kullan (string_agg ve array_agg sayfasına bak).
Eleman eklemek, silmek ve değiştirmek
Bu sorgu {1,2,3}, {1,2,3,4}, {2,3}, {1,9,3}, 2, {20,30} ve a, b, c döndürür. Bir UPDATE içinde aynı fonksiyonlar saklanan diziyi değiştirir: SET tags = array_append(tags, 'new') ya da SET tags = array_remove(tags, 'old'). array_remove değerin her kopyasını siler. string_to_array('a,b,c', ',') ise metni bir diziye böler.
Dizinin uzunluğunu almak
cardinality(tags) eleman sayısını döndürür, boş dizi için 0 verir. array_length(tags, 1) ise 1. boyutun uzunluğunu döndürür, boş dizi için NULL verir. Bu yüzden WHERE array_length(tags, 1) = 0 asla eşleşmez. Boş diziyi cardinality(tags) = 0 ya da tags = '{}' ile test et.
PostgreSQL dizileri birden fazla boyutlu olabilir (int[][]), ama her alt dizi aynı uzunlukta olmalıdır ve tanımlanan boyut (int[3]) zorunlu tutulmaz. İç içe ya da düzensiz veriler için genellikle JSONB daha uygundur.
Sıkça Sorulan Sorular
PostgreSQL dizileri 0'dan mı 1'den mi başlar?
Varsayılan olarak 1'den: tags[1] ilk elemandır. Sonun ötesindeki bir indeks hata vermek yerine NULL döndürür.
PostgreSQL'de IN ile = ANY arasındaki fark nedir?
x IN (1, 2, 3) sorguda yazılmış bir liste alır; x = ANY(array) ise tek bir dizi değeri alır. ANY uygulama kodu için daha uygundur, çünkü bir yer tutucu listesi kurmak yerine tek bir dizi parametresi geçebilirsin (WHERE id = ANY($1)).
Dizi sütunu mu kullanmalıyım, ayrı bir tablo mu?
Dizi, etiketler gibi satırıyla birlikte okunup yazılan kısa bir liste için uygundur. Elemanların kendi sütunlarına ya da yabancı anahtarlara ihtiyacı varsa veya tek tek güncelleniyorsa, her eleman için bir satır tutan ayrı bir tabloyu sorgulamak ve kısıtlamak daha kolaydır.
PostgreSQL'de bir dizinin boş olup olmadığını nasıl kontrol ederim?
cardinality(arr) = 0 ya da arr = '{}' kullan. array_length(arr, 1) = 0 asla eşleşmez, çünkü array_length boş bir dizi için NULL döndürür.