Cum să configurezi encoding-ul în Flyway

In this tutorial, you'll learn about Cum să configurezi encoding. We cover key concepts, practical examples, and best practices.

Parametrul flyway.encoding specifică encoding-ul fișierelor SQL de migrare, asigurând procesarea corectă a caracterelor speciale și diacriticelor.

Problema

Dacă fișierele SQL conțin caractere speciale (ă, î, ș, ț, €, etc.) iar encoding-ul nu este setat corect, Flyway poate genera erori de parsare sau date corupte.

Configurare de bază

# flyway.conf
flyway.encoding=UTF-8

Linia de comandă

flyway migrate \
  -url=jdbc:postgresql://localhost:5432/baza_mea \
  -encoding=UTF-8

Encoding-uri comune

# UTF-8 (recomandat, standard)
flyway.encoding=UTF-8

# ISO-8859-1 (Latin-1, pentru aplicații vechi)
flyway.encoding=ISO-8859-1

# Windows-1252 (sisteme Windows)
flyway.encoding=Windows-1252

Verificarea encoding-ului

# Verifică encoding-ul fișierelor
file -bi db/migration/V1__initial.sql
# Output: text/plain; charset=utf-8

Erori frecvente

1. Encoding implicit greșit — implicit este UTF-8. Dacă fișierele sunt în alt encoding, vor apărea caractere greșite.
2. BOM (Byte Order Mark) — unele editoare adaugă BOM în fișiere UTF-8, ceea ce poate cauza erori.
3. Inconsistență — toate fișierele ar trebui să aibă același encoding.

FAQ

# Conversie în masă
for f in db/migration/*.sql; do
  iconv -f ISO-8859-1 -t UTF-8 "$f" > "${f}.tmp" && mv "${f}.tmp" "$f"
done

Built by the developers of Doda Browser, DodaZIP, and Durga Antivirus Pro. DodaTech tools integrate seamlessly with Flyway for enhanced productivity and security.