Funkcje tekstowe PostgreSQL, których potrzebujesz najczęściej:
substring(text FROM start FOR length)wycina część tekstu. Pozycje zaczynają się od 1.||alboconcat()łączy teksty.split_part(text, delimiter, n)bierze jedno pole z tekstu rozdzielanego separatorem.replace(text, from, to)zamienia każde wystąpienie podciągu.
Ada dostaje Ada Lovelace i domenę example.com. concat_ws pomija brakujące nazwisko Lin, więc jej pełne imię to Lin bez spacji na końcu.
Wycinanie części tekstu
Wynik to PostgreS, gre, Post, SQL, Postgre i 0042.
substring(... FROM start FOR length)to forma ze standardu SQL;substr(text, start, length)robi to samo jako zwykła funkcja. Pomiń długość, żeby wziąć resztę tekstu.- Ujemna liczba w
leftalborightoznacza wszystko oprócz ostatnich (albo pierwszych) n znaków. - Z wyrażeniem regularnym po
FROMsubstringzwraca pierwsze dopasowanie albo pierwszą grupę w nawiasach, jeśli wzorzec ją ma.
Łączenie tekstów: ||, concat i concat_ws
|| zwraca NULL, gdy tylko jedna strona jest NULL. concat traktuje NULL jak pusty tekst i zwraca ab. concat_ws wstawia separator między wartości, które nie są NULL, i zwraca Ada, London. Gdy jedna strona || jest tekstem, liczba po drugiej stronie zostaje przekonwertowana, jak w id-42.
Żeby połączyć wartości wielu wierszy w jeden tekst, użyj string_agg.
Dzielenie, wyszukiwanie i zamiana
Wyniki to example.com, c, 4, 2026/11/17, a#b#c# i {red,green,blue}.
split_partzwraca pusty tekst, gdy pole nie istnieje. Ujemny numer pola liczy od końca (od PostgreSQL 14).position(sub IN text)istrpos(text, sub)zwracają pozycję liczoną od 1 albo 0, gdy nic nie znaleziono.replacezamienia każde wystąpienie i rozróżnia wielkość liter.regexp_replacezamienia tylko pierwsze dopasowanie, chyba że przekażesz flagę'g'; dodaj'i', żeby pominąć wielkość liter.regexp_split_to_table(text, pattern)dzieli tekst na wiersze zamiast na tablicę.
Testy wzorców w WHERE (LIKE, ILIKE, ~) opisuje strona LIKE, ILIKE i wyrażenia regularne.
Czyszczenie, dopełnianie i formatowanie
Wynik to hello, hi, 00042, Hello World, 5 i Ada has 3 items. ltrim i rtrim przycinają tylko jedną stronę. lpad i rpad obcinają też tekst, który już jest dłuższy niż docelowa długość.
length liczy znaki, a octet_length bajty; różnią się dla tekstu spoza ASCII, na przykład é. format używa %s dla wartości, %I dla identyfikatora w cudzysłowie i %L dla literału w cudzysłowie. Dzięki temu to bezpieczny sposób budowania dynamicznego SQL w funkcjach.
Ściągawka
| Zadanie | Funkcja | Przykładowy wynik |
|---|---|---|
| Wielkie, małe litery | upper(s), lower(s) | ADA, ada |
| Zaczyna się od | starts_with(s, 'pre') albo s LIKE 'pre%' | true |
| Powtórzenie, odwrócenie | repeat('ab', 3), reverse('abc') | ababab, cba |
| Pierwsze dopasowanie regex | substring(s FROM 'pattern') | dopasowany tekst |
| Wszystkie dopasowania regex | regexp_matches(s, 'pattern', 'g') | jeden wiersz na dopasowanie |
| Liczba jako tekst z formatem | to_char(1234.5, 'FM9,999.00') | 1,234.50 |
Oficjalna dokumentacja funkcji tekstowych wymienia resztę.
Najczęściej zadawane pytania
Jak sprawdzić w PostgreSQL, czy tekst zawiera podciąg?
position('needle' IN haystack) > 0 albo strpos(haystack, 'needle') > 0, a w klauzuli WHERE haystack LIKE '%needle%'. Użyj ILIKE, żeby pominąć wielkość liter, i starts_with(haystack, 'prefix') do sprawdzenia prefiksu.
Dlaczego || zwraca NULL w PostgreSQL?
Jeśli którykolwiek argument || jest NULL, wynik to NULL. Użyj concat() albo concat_ws(), które pomijają argumenty NULL, albo opakuj wartość, która może być pusta, w COALESCE(value, '').
Czy pozycje w tekstach PostgreSQL liczy się od 1?
Tak. Pozycje zaczynają się od 1, więc substring('abc' FROM 1 FOR 1) to a, a position zwraca 0, gdy tekstu nie znaleziono.
Czym różni się text od varchar w PostgreSQL?
Niczym pod względem szybkości ani miejsca. varchar(n) dodaje sprawdzanie długości; text i varchar bez długości nie mają limitu poza maksimum 1 GB na wartość. Wszystkie funkcje tekstowe przyjmują oba typy.