Masz poprawić fragment adresu w tysiącach rekordów, ale nie chcesz przypadkiem zmienić podobnych wartości ani nadpisać całej tabeli. Najczęściej użyjesz funkcji `REPLACE()` wewnątrz `UPDATE`, choć szczegóły zależą od silnika bazy i sposobu dopasowania tekstu.
Funkcja zmienia tekst, a UPDATE zapisuje go w tabeli
- `REPLACE()` zwraca tekst z podmienionymi wystąpieniami, ale sama nie aktualizuje rekordu.
- `UPDATE ... SET` zapisuje wynik funkcji w wybranej kolumnie.
- `WHERE` ogranicza zmianę do pasujących wierszy; bez niego możesz zmodyfikować całą tabelę.
- Silnik ma znaczenie: MySQL, PostgreSQL i SQL Server różnią się m.in. rozróżnianiem wielkości liter.
- Najpierw podgląd: wykonaj `SELECT` z tą samą funkcją i warunkiem, których użyjesz w aktualizacji.
REPLACE() podmienia tekst, ale nie zapisuje go w tabeli
Wynik działania funkcji łatwo pomylić ze zmianą danych. Samo `SELECT REPLACE(...)` pokazuje nowy tekst w rezultacie zapytania, ale wiersz w tabeli pozostaje bez zmian.
Do zapisu służy `UPDATE`. Przykładowo, aby zmienić domenę w kolumnie `email` tabeli `users`, możesz najpierw wyświetlić przewidywany wynik:
SELECT email,
REPLACE(email, '@stara-domena.pl', '@nowa-domena.pl') AS nowy_email
FROM users
WHERE email LIKE '%@stara-domena.pl';
Jeśli podgląd jest poprawny, użyj podobnego warunku w aktualizacji:
UPDATE users
SET email = REPLACE(email, '@stara-domena.pl', '@nowa-domena.pl')
WHERE email LIKE '%@stara-domena.pl';
Warunek `WHERE` ogranicza liczbę zmienianych rekordów. Bez niego funkcja zostanie zastosowana do wszystkich wierszy, również tych, w których szukany fragment nie występuje. Taki rekord może pozostać tekstowo bez zmian, ale operacja nadal obejmie całą tabelę.
Ten sam zapis działa inaczej w różnych silnikach
Zapytanie wygląda podobnie, lecz dopasowanie tekstu może się różnić. Przy migracji albo pracy na kilku bazach ten drobiazg potrafi zmienić wynik aktualizacji.
| Silnik | Przykład | Co sprawdzić |
|---|---|---|
| PostgreSQL | replace(kolumna, 'stary', 'nowy') |
Do wyrażeń regularnych służy osobna funkcja regexp_replace(). |
| MySQL | REPLACE(kolumna, 'stary', 'nowy') |
Funkcja dopasowuje szukany tekst z uwzględnieniem wielkości liter. |
| SQL Server | REPLACE(kolumna, 'stary', 'nowy') |
Dopasowanie zależy od collation, czyli reguł porównywania tekstu. Wynik może też zostać obcięty do 8000 bajtów, jeśli argument nie ma typu `varchar(max)` ani `nvarchar(max)`. |
| SQLite | replace(kolumna, 'stary', 'nowy') |
Porównanie tekstu w tej funkcji korzysta z reguły `BINARY`. |
Takie różnice potwierdzają dokumentacje PostgreSQL, MySQL 8.4, SQL Server oraz SQLite. Nie zakładaj, że dopasowanie wielkości liter będzie takie samo po zmianie silnika.
Podgląd i warunek pomagają uniknąć zbyt szerokiej podmiany
Najwięcej ryzyka kryje się w samym wzorcu. Szukanie krótkiego fragmentu, takiego jak `app`, może zmienić go także wewnątrz dłuższych słów, a zbyt ogólny warunek `WHERE` może objąć rekordy, których nie planujesz ruszać.
| Sytuacja | Możliwa przyczyna lub skutek | Co zrobić |
|---|---|---|
| Podgląd pokazuje teksty spoza planowanej grupy | Wzorzec jest za krótki albo warunek obejmuje za dużo rekordów. | Dodaj bardziej precyzyjny warunek, np. `LIKE '%@stara-domena.pl'`, i ponownie sprawdź wyniki. |
| W MySQL podmiana pomija wariant zapisany wielkimi literami | REPLACE() dopasowuje tekst z rozróżnieniem wielkości liter. |
Uwzględnij warianty zapisu w osobnych podmianach albo przygotuj regułę dopasowania odpowiednią dla silnika. |
| W SQL Server wynik jest krótszy od oczekiwanego | Typ argumentu ogranicza długość zwracanego tekstu. | Sprawdź typ kolumny i w razie potrzeby jawnie użyj `varchar(max)` lub `nvarchar(max)`. |
| Po zapytaniu wynik w tabeli się nie zmienił | Wykonano samo `SELECT REPLACE(...)` zamiast aktualizacji. | Użyj UPDATE ... SET kolumna = REPLACE(...) i sprawdź komunikat o liczbie zmienionych wierszy. |
Prawdę mówiąc, podgląd jest ważniejszy niż skrócenie samego zapytania: `SELECT` pozwala wychwycić błędny wzorzec, zanim zmienisz zapisane dane. W większej bazie warto też oszacować liczbę pasujących wierszy, używając `COUNT(*)` z tym samym warunkiem `WHERE`.
Transakcja daje szansę wycofania błędnej aktualizacji
Jeżeli silnik i konfiguracja tabel obsługują transakcje, możesz wykonać zmianę w ich obrębie, sprawdzić wynik, a dopiero potem ją zatwierdzić. W razie pomyłki zamiast zatwierdzenia wybierasz wycofanie.
BEGIN;
UPDATE users
SET email = REPLACE(email, '@stara-domena.pl', '@nowa-domena.pl')
WHERE email LIKE '%@stara-domena.pl';
SELECT email
FROM users
WHERE email LIKE '%@nowa-domena.pl';
-- Jeśli wynik jest poprawny:
COMMIT;
-- Jeśli wynik jest błędny, użyj ROLLBACK zamiast COMMIT.
Nie uruchamiaj jednocześnie `COMMIT` i `ROLLBACK`. To dwie alternatywne decyzje. Przy dużej aktualizacji sprawdź też, czy transakcja nie blokuje innych operacji zbyt długo; zmienianie danych partiami może ograniczyć obciążenie, ale wymaga starannie zaplanowanych warunków.
Przed uruchomieniem zapytania sprawdź trzy rzeczy
Przed zmianą danych oddziel wyszukiwanie tekstu od zapisu i upewnij się, że oba kroki odnoszą się do tych samych rekordów. Uważam, że to najrozsądniejszy domyślny schemat, bo pozwala sprawdzić wynik bez ryzykowania masowej podmiany na ślepo.
- Uruchom `SELECT` z funkcją `REPLACE()` i warunkiem, których zamierzasz użyć w `UPDATE`.
- Sprawdź czułość na wielkość liter, typ kolumny i limit długości właściwy dla danego silnika.
- Wykonaj aktualizację w transakcji, jeśli baza i silnik tabel na to pozwalają, a potem zatwierdź ją dopiero po kontroli wyniku.
Wtedy `REPLACE()` pozostaje precyzyjnym narzędziem do zmiany fragmentu tekstu, a nie skrótem, który po chwili trzeba odkręcać z kopii zapasowej.
