Errori tipici nel lavoro con gli array e come evitarli

Oggi chiudiamo il nostro viaggio avventuroso nel mondo degli array in PostgreSQL. L’argomento di oggi — gli errori tipici che potresti incontrare e, cosa ancora più importante, come evitarli. Se ti sei mai trovato a pensare “questo array fa di nuovo cose strane”, questa lezione fa proprio per te. Vediamo insieme come uscirne vivi.

Errori nella creazione degli array: problemi con i tipi di dati dentro l’array

Quando crei array in PostgreSQL, ricordati che tutti gli elementi dell’array devono essere dello stesso tipo. Per esempio:

SELECT ARRAY[1, 2, 'tre'];
-- Errore: tutti gli elementi dell’array devono essere dello stesso tipo

PostgreSQL non ti permette di mischiare numeri e stringhe nello stesso array. Se proprio ti serve, usa le conversioni:

SELECT ARRAY[1::TEXT, 2::TEXT, 'tre'];
-- Ora l’array è fatto di stringhe

Errori nell’uso di ARRAY[] con tipi di dati diversi

Di default PostgreSQL cerca di capire il tipo dell’array in base al suo contenuto. Se gli dai dati ambigui, preparati a un errore:

SELECT ARRAY[1, NULL];
-- Errore: PostgreSQL non sa come interpretare NULL

Per risolvere, specifica esplicitamente il tipo di dato:

SELECT ARRAY[1, NULL]::INTEGER[];
-- Tutto funziona come si deve

Errori nell’estrazione dei dati: problemi con gli indici degli array

Se sei abituato a programmare in Python o JavaScript, dove gli array partono da zero, in PostgreSQL ti aspetta una sorpresa. Qui gli array sono indicizzati a partire da 1.

SELECT ARRAY[10, 20, 30][0];
-- Errore: l’indice deve partire da 1

La query giusta:

SELECT ARRAY[10, 20, 30][1];
-- Risultato: 10

Errori nell’uso delle funzioni di estrazione

Funzioni come unnest() possono creare confusione se non tieni conto che “spacchettano” l’array su tutte le righe:

CREATE TEMP TABLE esempio (
    id SERIAL PRIMARY KEY,
    tags TEXT[]
);

INSERT INTO esempio (tags) VALUES (ARRAY['tag1', 'tag2']), (ARRAY['tag3']);

SELECT unnest(tags) FROM esempio;
-- Risultato:
-- tag1
-- tag2
-- tag3

Se vuoi mantenere il contesto della riga (tipo id), aggiungilo esplicitamente:

SELECT id, unnest(tags) AS tag FROM esempio;
-- Risultato:
-- id | tag
--  1 | tag1
--  1 | tag2
--  2 | tag3

Errori nel filtraggio e confronto degli array

1. Uso sbagliato degli operatori @>, <@, &&

Questi operatori servono a cose specifiche:

• @> controlla se un array contiene un altro array.
• <@ controlla se un array è contenuto in un altro.
• && controlla se due array hanno elementi in comune.

L’errore arriva se li usi a caso:

SELECT ARRAY[1, 2, 3] @> 2;
-- Errore: l’operatore @> è fatto per gli array

Corretto:

SELECT ARRAY[1, 2, 3] @> ARRAY[2];
-- Risultato: true

2. Problemi di performance senza indici

Se usi spesso operatori per array e noti che le query rallentano, probabilmente ti sei dimenticato l’indicizzazione. Ecco un esempio di indice su un array:

CREATE INDEX idx_tags ON esempio USING GIN (tags);

Ora le query con @> e && vanno molto più veloci.

Errori nella modifica degli array

1. Rimozione e aggiunta di valori

Le funzioni array_remove() e array_append() non modificano l’array “in loco”, ma restituiscono un nuovo array. Se ti aspetti che l’array originale cambi, è un errore:

UPDATE esempio
SET tags = array_remove(tags, 'tag1');
-- Ora l’array è aggiornato

Se ti dimentichi SET tags =, SQL esegue la query ma l’array resta uguale.

2. Duplicazione dei dati con array_append()

La funzione array_append() non controlla se l’elemento c’è già. Questo può portare a duplicati:

SELECT array_append(ARRAY['tag1', 'tag2'], 'tag1');
-- Risultato: {tag1, tag2, tag1}

Se vuoi evitare duplicati, usa un filtro:

SELECT array_remove(array_append(ARRAY['tag1', 'tag2'], 'tag1'), 'tag1') || 'tag1';
-- Risultato: {tag1, tag2}

Consigli per evitare errori

Per non cadere negli errori sopra quando lavori con gli array:

1. Controlla i tipi di dati. Specifica sempre il tipo dell’array se c’è ambiguità.
2. Occhio agli indici. Ricorda che in PostgreSQL gli array partono da 1.
3. Ottimizza le query con gli array. Usa gli indici per velocizzare confronti e filtraggi.
4. Testa su piccoli dataset. Se una query con array è lenta, provala su pochi dati per trovare i colli di bottiglia.
5. Evita i duplicati. Fai controlli extra quando aggiungi elementi all’array, se non vuoi ripetizioni.

Gli array in PostgreSQL, come ogni arma potente, vanno usati con rispetto e attenzione. Seguendo questi consigli, i tuoi array non saranno più la causa delle tue notti insonni (o quasi). Buona fortuna nella progettazione e ottimizzazione dei database!